Source: https://docs.claude.com/en/api/admin-api/workspace_members/update-workspace-member

Agent Skills are now available! Learn more about extending Claude's capabilities with Agent Skills .

Claude Docs home page

English

Search...

Ctrl K

Search...

Navigation

Workspace Member Management

Update Workspace Member

Home Developer Guide API Reference Model Context Protocol (MCP) Resources Release Notes

cURL

cURL

Copy

curl "https://api.anthropic.com/v1/organizations/workspaces/wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ/members/user_01WCz1FkmYMm4gnmykNKUu3Q" \
  --header "anthropic-version: 2023-06-01" \
  --header "content-type: application/json" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{
    "workspace_role": "workspace_user"
  }'

200

4XX

Copy

{
  "type": "workspace_member",
  "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q",
  "workspace_id": "wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ",
  "workspace_role": "workspace_user"
}

POST

/

v1

/

organizations

/

workspaces

/

{workspace_id}

/

members

/

{user_id}

cURL

cURL

Copy

curl "https://api.anthropic.com/v1/organizations/workspaces/wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ/members/user_01WCz1FkmYMm4gnmykNKUu3Q" \
  --header "anthropic-version: 2023-06-01" \
  --header "content-type: application/json" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{
    "workspace_role": "workspace_user"
  }'

200

4XX

Copy

{
  "type": "workspace_member",
  "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q",
  "workspace_id": "wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ",
  "workspace_role": "workspace_user"
}

The Admin API is unavailable for individual accounts. To collaborate with teammates and add members, set up your organization in Console → Settings → Organization.

Headers

​

x-api-key

string

required

Your unique Admin API key for authentication.

This key is required in the header of all Admin API requests, to authenticate your account and access Anthropic's services. Get your Admin API key through the Console .

​

anthropic-version

string

required

The version of the Claude API you want to use.

Read more about versioning and our version history here .

Path Parameters

​

user_id

string

required

ID of the User.

​

workspace_id

string

required

ID of the Workspace.

Body

application/json

​

workspace_role

enum<string>

required

New workspace role for the User.

Available options:

workspace_user,

workspace_developer,

workspace_admin,

workspace_billing

Response

200

application/json

Successful Response

​

type

enum<string>

default:workspace_member

required

Object type.

For Workspace Members, this is always "workspace_member".

Available options:

| Title | Const | | --- | --- | | Type | workspace_member |

​

user_id

string

required

ID of the User.

Examples:

"user_01WCz1FkmYMm4gnmykNKUu3Q"

​

workspace_id

string

required

ID of the Workspace.

Examples:

"wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ"

​

workspace_role

enum<string>

required

Role of the Workspace Member.

Available options:

workspace_user,

workspace_developer,

workspace_admin,

workspace_billing

Was this page helpful?

YesNo

Add Workspace Member Delete Workspace Member

Assistant

Responses are generated using AI and may contain mistakes.