Anthropic

Anthropic Workspace Members API

Manage workspace membership and roles

GitHub OpenAPI
Business capability
Tenant Identity Federation BC-4230.50

Operations 5

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /organizations/workspaces/{workspace_id}/members List a workspace's members · Anthropic List Workspace Members #
Ask an LLM
“Who has access to a particular workspace?”
“Can I page through a workspace's member list?”
Tell an agent
List the members of workspace {workspace_id}.
Show {limit} members of workspace {workspace_id}.
POST /organizations/workspaces/{workspace_id}/members Add a user to a workspace · Anthropic Add Workspace Member #
Ask an LLM
“How do I give a teammate access to a workspace?”
“What role should I assign when adding someone to a workspace?”
Tell an agent
Add user {user_id} to workspace {workspace_id} as {workspace_role}.
Grant {user_id} access to workspace {workspace_id} with role {workspace_role}.
GET /organizations/workspaces/{workspace_id}/members/{user_id} Look up a user's workspace membership · Anthropic Get Workspace Member #
Ask an LLM
“What role does a specific user have in this workspace?”
“Is a given user a member of a workspace?”
Tell an agent
Show user {user_id}'s membership in workspace {workspace_id}.
Get the role of {user_id} in workspace {workspace_id}.
POST /organizations/workspaces/{workspace_id}/members/{user_id} Change a member's workspace role · Anthropic Update Workspace Member #
Ask an LLM
“How do I change someone's role in a workspace?”
“Can I promote a workspace member to admin?”
Tell an agent
Change user {user_id}'s role in workspace {workspace_id} to {workspace_role}.
Promote {user_id} to {workspace_role} in {workspace_id}.
DELETE /organizations/workspaces/{workspace_id}/members/{user_id} Remove a user from a workspace · Anthropic Remove Workspace Member #
Ask an LLM
“How do I revoke a user's access to one workspace?”
“Can I take someone out of a workspace but keep them in the org?”
Tell an agent destructive · confirm first
Remove user {user_id} from workspace {workspace_id}.
Revoke {user_id}'s workspace access in {workspace_id}.

Documentation

📖
Documentation
https://docs.anthropic.com/en/api/admin-api/users/get-user
📖
Documentation
https://docs.anthropic.com/en/api/prompt-tools-generate
📖
Documentation
https://docs.anthropic.com/en/api/usage-cost-api
📖
Documentation
https://platform.claude.com/docs/en/managed-agents/overview
📖
Documentation
https://platform.claude.com/docs/en/managed-agents/agent-setup
📖
Documentation
https://platform.claude.com/docs/en/managed-agents/sessions
📖
Documentation
https://platform.claude.com/docs/en/managed-agents/environments

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/anthropic/refs/heads/main/openapi/anthropic-workspace-members-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/anthropic/refs/heads/main/json-schema/anthropic-workspace-member-list-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/anthropic/refs/heads/main/json-schema/anthropic-workspace-member-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/anthropic/refs/heads/main/json-schema/anthropic-workspace-member-deleted-response-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/anthropic/refs/heads/main/json-schema/anthropic-add-workspace-member-request-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/anthropic/refs/heads/main/json-schema/anthropic-update-workspace-member-request-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/anthropic:anthropic-workspace-members-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

anthropic-workspace-members-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Anthropic Admin Workspace Members API
  description: Manage administrative functions for Anthropic organizations, workspaces, users, invites, and API keys.
  version: 1.0.0
  contact:
    name: Anthropic
    url: https://www.anthropic.com
    email: support@anthropic.com
  license:
    name: Anthropic API License
    url: https://www.anthropic.com/terms
servers:
- url: https://api.anthropic.com/v1
  description: Production Server
security:
- AdminApiKeyAuth: []
tags:
- name: Workspace Members
  description: Manage workspace membership and roles
paths:
  /organizations/workspaces/{workspace_id}/members:
    get:
      summary: Anthropic List Workspace Members
      description: Retrieves a paginated list of members for a specific workspace.
      operationId: listWorkspaceMembers
      tags:
      - Workspace Members
      parameters:
      - $ref: '#/components/parameters/AnthropicVersion'
      - $ref: '#/components/parameters/WorkspaceId'
      - $ref: '#/components/parameters/Limit'
      - $ref: '#/components/parameters/BeforeId'
      - $ref: '#/components/parameters/AfterId'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WorkspaceMemberList'
              examples:
                WorkspaceMemberListExample:
                  $ref: '#/components/examples/WorkspaceMemberListExample'
        4XX:
          $ref: '#/components/responses/ErrorResponse'
      x-microcks-operation:
        dispatcher: FALLBACK
        dispatcherRules: "{\n  \"dispatcher\": \"FALLBACK\",\n  \"fallback\": \"WorkspaceMemberListExample\"\n}\n"
    post:
      summary: Anthropic Add Workspace Member
      description: Adds a user as a member of a workspace.
      operationId: addWorkspaceMember
      tags:
      - Workspace Members
      parameters:
      - $ref: '#/components/parameters/AnthropicVersion'
      - $ref: '#/components/parameters/WorkspaceId'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AddWorkspaceMemberRequest'
            examples:
              AddWorkspaceMemberRequestExample:
                $ref: '#/components/examples/AddWorkspaceMemberRequestExample'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WorkspaceMember'
              examples:
                WorkspaceMemberExample:
                  $ref: '#/components/examples/WorkspaceMemberExample'
        4XX:
          $ref: '#/components/responses/ErrorResponse'
      x-microcks-operation:
        dispatcher: FALLBACK
        dispatcherRules: "{\n  \"dispatcher\": \"FALLBACK\",\n  \"fallback\": \"WorkspaceMemberExample\"\n}\n"
  /organizations/workspaces/{workspace_id}/members/{user_id}:
    get:
      summary: Anthropic Get Workspace Member
      description: Retrieves membership details for a specific user in a workspace.
      operationId: getWorkspaceMember
      tags:
      - Workspace Members
      parameters:
      - $ref: '#/components/parameters/AnthropicVersion'
      - $ref: '#/components/parameters/WorkspaceId'
      - $ref: '#/components/parameters/UserId'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WorkspaceMember'
              examples:
                WorkspaceMemberExample:
                  $ref: '#/components/examples/WorkspaceMemberExample'
        4XX:
          $ref: '#/components/responses/ErrorResponse'
      x-microcks-operation:
        dispatcher: FALLBACK
        dispatcherRules: "{\n  \"dispatcher\": \"FALLBACK\",\n  \"fallback\": \"WorkspaceMemberExample\"\n}\n"
    post:
      summary: Anthropic Update Workspace Member
      description: Updates the role of a workspace member.
      operationId: updateWorkspaceMember
      tags:
      - Workspace Members
      parameters:
      - $ref: '#/components/parameters/AnthropicVersion'
      - $ref: '#/components/parameters/WorkspaceId'
      - $ref: '#/components/parameters/UserId'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateWorkspaceMemberRequest'
            examples:
              UpdateWorkspaceMemberRequestExample:
                $ref: '#/components/examples/UpdateWorkspaceMemberRequestExample'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WorkspaceMember'
              examples:
                WorkspaceMemberExample:
                  $ref: '#/components/examples/WorkspaceMemberExample'
        4XX:
          $ref: '#/components/responses/ErrorResponse'
      x-microcks-operation:
        dispatcher: FALLBACK
        dispatcherRules: "{\n  \"dispatcher\": \"FALLBACK\",\n  \"fallback\": \"WorkspaceMemberExample\"\n}\n"
    delete:
      summary: Anthropic Remove Workspace Member
      description: Removes a user from a workspace.
      operationId: removeWorkspaceMember
      tags:
      - Workspace Members
      parameters:
      - $ref: '#/components/parameters/AnthropicVersion'
      - $ref: '#/components/parameters/WorkspaceId'
      - $ref: '#/components/parameters/UserId'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WorkspaceMemberDeletedResponse'
              examples:
                WorkspaceMemberDeletedResponseExample:
                  $ref: '#/components/examples/WorkspaceMemberDeletedResponseExample'
        4XX:
          $ref: '#/components/responses/ErrorResponse'
      x-microcks-operation:
        dispatcher: FALLBACK
        dispatcherRules: "{\n  \"dispatcher\": \"FALLBACK\",\n  \"fallback\": \"WorkspaceMemberDeletedResponseExample\"\n}\n"
components:
  parameters:
    WorkspaceId:
      name: workspace_id
      in: path
      required: true
      description: Unique identifier for the workspace
      schema:
        type: string
      example: wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ
    UserId:
      name: user_id
      in: path
      required: true
      description: Unique identifier for the user
      schema:
        type: string
      example: user_01WCz1FkmYMm4gnmykNKUu3Q
    BeforeId:
      name: before_id
      in: query
      required: false
      description: ID of the object to use as a cursor for pagination. Returns the page of results immediately before this object.
      schema:
        type: string
    AfterId:
      name: after_id
      in: query
      required: false
      description: ID of the object to use as a cursor for pagination. Returns the page of results immediately after this object.
      schema:
        type: string
    AnthropicVersion:
      name: anthropic-version
      in: header
      required: true
      description: The version of the Anthropic API to use
      schema:
        type: string
        example: '2023-06-01'
    Limit:
      name: limit
      in: query
      required: false
      description: Number of items to return per page. Defaults to 20. Ranges from 1 to 1000.
      schema:
        type: integer
        default: 20
        minimum: 1
        maximum: 1000
  schemas:
    WorkspaceMember:
      type: object
      required:
      - type
      - user_id
      - workspace_id
      - workspace_role
      properties:
        type:
          type: string
          enum:
          - workspace_member
          default: workspace_member
          description: Object type identifier
        user_id:
          type: string
          description: Unique user identifier
        workspace_id:
          type: string
          description: Unique workspace identifier
        workspace_role:
          $ref: '#/components/schemas/WorkspaceRole'
    WorkspaceMemberList:
      type: object
      required:
      - data
      - has_more
      - first_id
      - last_id
      properties:
        data:
          type: array
          description: List of workspace members
          items:
            $ref: '#/components/schemas/WorkspaceMember'
        first_id:
          type: string
          nullable: true
          description: First ID in the data list for pagination
        has_more:
          type: boolean
          description: Indicates if there are more results available
        last_id:
          type: string
          nullable: true
          description: Last ID in the data list for pagination
    WorkspaceRole:
      type: string
      enum:
      - workspace_user
      - workspace_developer
      - workspace_admin
      - workspace_billing
      description: Role within the workspace
    Error:
      type: object
      required:
      - type
      - message
      properties:
        type:
          type: string
          description: Error type identifier
        message:
          type: string
          description: Human-readable error message
    UpdateWorkspaceMemberRequest:
      type: object
      required:
      - workspace_role
      properties:
        workspace_role:
          $ref: '#/components/schemas/WorkspaceRole'
    AddWorkspaceMemberRequest:
      type: object
      required:
      - user_id
      - workspace_role
      properties:
        user_id:
          type: string
          description: ID of the user to add
        workspace_role:
          $ref: '#/components/schemas/WorkspaceRole'
    WorkspaceMemberDeletedResponse:
      type: object
      required:
      - type
      - user_id
      - workspace_id
      properties:
        type:
          type: string
          enum:
          - workspace_member_deleted
          default: workspace_member_deleted
          description: Deletion confirmation type
        user_id:
          type: string
          description: ID of the removed user
        workspace_id:
          type: string
          description: ID of the workspace
  examples:
    WorkspaceMemberExample:
      summary: Workspace Member Response
      value:
        type: workspace_member
        user_id: user_01WCz1FkmYMm4gnmykNKUu3Q
        workspace_id: wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ
        workspace_role: workspace_developer
    ErrorExample:
      summary: Error Response
      value:
        type: invalid_request_error
        message: The request was invalid or malformed.
    UpdateWorkspaceMemberRequestExample:
      summary: Update Workspace Member Request
      value:
        workspace_role: workspace_admin
    AddWorkspaceMemberRequestExample:
      summary: Add Workspace Member Request
      value:
        user_id: user_01WCz1FkmYMm4gnmykNKUu3Q
        workspace_role: workspace_developer
    WorkspaceMemberListExample:
      summary: Workspace Member List Response
      value:
        data:
        - type: workspace_member
          user_id: user_01WCz1FkmYMm4gnmykNKUu3Q
          workspace_id: wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ
          workspace_role: workspace_developer
        - type: workspace_member
          user_id: user_02XDa2GlnYNn5hoozlNLVu4R
          workspace_id: wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ
          workspace_role: workspace_user
        first_id: user_01WCz1FkmYMm4gnmykNKUu3Q
        has_more: false
        last_id: user_02XDa2GlnYNn5hoozlNLVu4R
    WorkspaceMemberDeletedResponseExample:
      summary: Workspace Member Deleted Response
      value:
        type: workspace_member_deleted
        user_id: user_01WCz1FkmYMm4gnmykNKUu3Q
        workspace_id: wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ
  responses:
    ErrorResponse:
      description: Error Response
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          examples:
            ErrorExample:
              $ref: '#/components/examples/ErrorExample'
  securitySchemes:
    AdminApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: Your Admin API key for authentication (starts with sk-ant-admin...).