> ## 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. # Grant a team a role in a workspace > Gives an organization-wide team a role in a workspace. Team members who are members of the workspace get the role's permissions there, and their workspace identities are recorded as the team's members in the workspace. The grant also creates the team's workspace scoped team in the workspace, named after the team and the workspace id, with no members or access policies. A team has at most one grant per workspace. A workspace scoped team's grant is set when it is created, so it cannot be granted. Needs organization:teams:manage-grants. ## OpenAPI ````yaml /langsmith/langsmith-platform-openapi.json post /api/v1/platform/orgs/current/teams/{team_id}/workspaces 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: post: tags: - teams summary: Grant a team a role in a workspace description: >- Gives an organization-wide team a role in a workspace. Team members who are members of the workspace get the role's permissions there, and their workspace identities are recorded as the team's members in the workspace. The grant also creates the team's workspace scoped team in the workspace, named after the team and the workspace id, with no members or access policies. A team has at most one grant per workspace. A workspace scoped team's grant is set when it is created, so it cannot be granted. Needs organization:teams:manage-grants. parameters: - description: Team ID name: team_id in: path required: true schema: type: string format: uuid requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/teams.CreateTeamWorkspaceGrantPayload' responses: '201': description: Created headers: Location: description: URL of the grant schema: type: string content: application/json: schema: $ref: '#/components/schemas/teams.TeamWorkspaceGrant' '400': description: >- invalid team_id, workspace_id or role_id, the workspace or 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 content: application/json: schema: $ref: '#/components/schemas/shared.ProblemDetails' '409': description: the team already has 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.CreateTeamWorkspaceGrantPayload: type: object required: - role_id - workspace_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 workspace_id: 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 ````