> ## 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. # Add members to a team > Adds organization members to a team and returns a status for each identity: CREATED when it was added, UNCHANGED when it was already a member, and FAILED when it is not an organization identity in this organization. A workspace scoped team only takes people who are members of its workspace, and also records their workspace identity. An organization scoped team records each person's workspace identity in every workspace it is granted into. The other identities are still added. A workspace scoped team needs workspaces:teams:manage-members in its workspace, and an organization scoped team needs organization:teams:manage-members. ## OpenAPI ````yaml /langsmith/langsmith-platform-openapi.json post /api/v1/platform/orgs/current/teams/{team_id}/members 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}/members: post: tags: - teams summary: Add members to a team description: >- Adds organization members to a team and returns a status for each identity: CREATED when it was added, UNCHANGED when it was already a member, and FAILED when it is not an organization identity in this organization. A workspace scoped team only takes people who are members of its workspace, and also records their workspace identity. An organization scoped team records each person's workspace identity in every workspace it is granted into. The other identities are still added. A workspace scoped team needs workspaces:teams:manage-members in its workspace, and an organization scoped team needs organization:teams:manage-members. 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.AddTeamMembersPayload' responses: '207': description: Multi-Status content: application/json: schema: $ref: '#/components/schemas/teams.AddTeamMembersResponse' '400': description: invalid team_id or identity_ids content: application/json: schema: $ref: '#/components/schemas/shared.ProblemDetails' '403': description: >- caller lacks workspaces:teams:manage-members in the team's workspace, or organization:teams:manage-members for an organization scoped team content: application/json: schema: $ref: '#/components/schemas/shared.ProblemDetails' '404': description: team not found 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.AddTeamMembersPayload: type: object required: - identity_ids properties: identity_ids: description: IdentityIDs are the organization identities of the users to add. type: array maxItems: 100 minItems: 1 items: type: string format: uuid teams.AddTeamMembersResponse: type: object required: - statuses properties: statuses: type: array items: $ref: '#/components/schemas/teams.TeamMemberStatus' 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 teams.TeamMemberStatus: type: object required: - id - status properties: description: type: string id: type: string format: uuid status: type: string enum: - CREATED - UNCHANGED - FAILED 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 ````