> ## Documentation Index > Fetch the complete documentation index at: https://docs.langchain.com/llms.txt > Use this file to discover all available pages before exploring further. # Change a team's role in a workspace > Changes an organization-wide team's role in a workspace it has access to. Team members get the new role's permissions there in place of the old role's. Access policies attached to the team for the workspace stay attached. Needs organization:teams:manage-grants. ## OpenAPI ````yaml /langsmith/langsmith-platform-openapi.json patch /api/v1/platform/orgs/current/teams/{team_id}/workspaces/{workspace_id} openapi: 3.1.0 info: title: LangSmith description: >+ The LangSmith API is used to programmatically create and manage LangSmith resources. ## Host https://api.smith.langchain.com ## Authentication To authenticate with the LangSmith API, set the `X-Api-Key` header to a valid [LangSmith API key](https://docs.langchain.com/langsmith/create-account-api-key#create-an-api-key). version: 0.1.0 servers: - url: / security: [] tags: - name: run x-group: Tracing - name: runs x-group: Tracing - name: sessions x-group: Tracing - name: tracer-sessions x-group: Tracing - name: threads x-group: Threads - name: datasets x-group: Datasets - name: examples x-group: Datasets - name: evaluators x-group: Evaluation - name: experiment-view-overrides x-group: Evaluation - name: experiments x-group: Evaluation - name: annotation-queues x-group: Feedback & Annotation - name: annotation_queues x-group: Feedback & Annotation - name: feedback x-group: Feedback & Annotation - name: feedback-configs x-group: Feedback & Annotation - name: alert_rules x-group: Monitoring - name: bulk-exports x-group: Monitoring - name: charts x-group: Monitoring - name: commits x-group: Prompts & Playground - name: directories x-group: Prompts & Playground - name: hub_environments x-group: Prompts & Playground - name: playground-settings x-group: Prompts & Playground - name: prompt-webhooks x-group: Prompts & Playground - name: prompts x-group: Prompts & Playground - name: tag-transitions x-group: Prompts & Playground - name: comments x-group: Prompt Hub - name: likes x-group: Prompt Hub - name: optimization-jobs x-group: Prompt Hub - name: ownerships x-group: Prompt Hub - name: repos x-group: Prompt Hub - name: settings x-group: Prompt Hub - name: tags x-group: Prompt Hub - name: integrations x-group: Integrations & Tools - name: mcp x-group: Integrations & Tools - name: mcp_vendors x-group: Integrations & Tools - name: oauth x-group: Integrations & Tools - name: tools x-group: Integrations & Tools - name: gateway-policies x-group: LLM Gateway - name: sandboxes x-group: Sandboxes - name: issues x-group: Issues - name: issues-agent x-group: Issues - name: Organizations x-group: Administration - name: SCIM Tokens x-group: Administration - name: TTL Settings x-group: Administration - name: access_policies x-group: Administration - name: api-key x-group: Administration - name: audit-logs x-group: Administration - name: auth x-group: Administration - name: aws_marketplace x-group: Administration - name: data_planes x-group: Administration - name: me x-group: Administration - name: orgs x-group: Administration - name: service-accounts x-group: Administration - name: tenant x-group: Administration - name: ttl-settings x-group: Administration - name: usage-limits x-group: Administration - name: workspaces x-group: Administration - name: ace x-group: System - name: backfills x-group: System - name: features x-group: System - name: info x-group: System - name: model-price-map x-group: System - name: public x-group: System - name: agents x-hidden: true - name: fleet orgs - name: fleet secrets - name: fleet tenants - name: fleet threads x-hidden: true - name: fleet users - name: productfeedback x-hidden: true - name: teams - name: usage paths: /api/v1/platform/orgs/current/teams/{team_id}/workspaces/{workspace_id}: patch: tags: - teams summary: Change a team's role in a workspace description: >- Changes an organization-wide team's role in a workspace it has access to. Team members get the new role's permissions there in place of the old role's. Access policies attached to the team for the workspace stay attached. Needs organization:teams:manage-grants. parameters: - description: Team ID name: team_id in: path required: true schema: type: string format: uuid - description: Workspace ID name: workspace_id in: path required: true schema: type: string format: uuid requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/teams.UpdateTeamWorkspaceGrantPayload' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/teams.TeamWorkspaceGrant' '400': description: >- invalid team_id, workspace_id or role_id, the role is not in this organization, or the team is workspace scoped content: application/json: schema: $ref: '#/components/schemas/shared.ProblemDetails' '403': description: caller lacks organization:teams:manage-grants content: application/json: schema: $ref: '#/components/schemas/shared.ProblemDetails' '404': description: team not found, or the team has no access to this workspace content: application/json: schema: $ref: '#/components/schemas/shared.ProblemDetails' '500': description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/shared.ProblemDetails' '503': description: Service Unavailable content: application/json: schema: $ref: '#/components/schemas/shared.ProblemDetails' security: - API Key: [] Organization ID: [] - Bearer Auth: [] Organization ID: [] components: schemas: teams.UpdateTeamWorkspaceGrantPayload: type: object required: - role_id properties: role_id: description: >- RoleID is a workspace role: a built-in one, or a custom one in this organization. type: string format: uuid teams.TeamWorkspaceGrant: type: object required: - created_at - role_id - role_name - updated_at - workspace_id properties: created_at: type: string role_id: type: string format: uuid role_name: type: string updated_at: type: string workspace_id: type: string format: uuid shared.ProblemDetails: description: RFC 7807 problem details returned on V2 API errors. type: object properties: detail: type: string details: description: >- Details is a LangSmith extension carrying structured fields for ErrorClass. allOf: - $ref: '#/components/schemas/shared.ParseErrorDetails' error_class: description: |- ErrorClass is a LangSmith extension sub-categorizing a status code. Additional values require expanding this enum and adding a oneOf discriminator on Details to keep the class↔details contract typed. type: string enum: - PARSE_FAILURE instance: type: string remedy: description: Remedy is a LangSmith extension for user-recoverable errors. type: string status: type: integer title: type: string type: type: string shared.ParseErrorDetails: description: Structured fields describing an adapter parse failure. type: object required: - adapter - item_type properties: adapter: type: string item_type: type: string run_id: type: string securitySchemes: API Key: type: apiKey in: header name: X-API-Key Organization ID: type: apiKey in: header name: X-Organization-Id Bearer Auth: type: http description: >- Bearer tokens are used to authenticate from the UI. Must also specify x-tenant-id or x-organization-id (for org scoped apis). scheme: bearer ````