Skip to main content
PATCH
Update a workspace member's role
You’re viewing API version 2026-09, which is deprecated and stops working on October 1, 2027. To see the current version, select 2026-10 in the menu at the top of the sidebar. To move your integration, see Upgrading to 2026-10.

Authorizations

Authorization
string
header
required

Personal API key, e.g. Authorization: Bearer sajn_sk_.... Not scope-limited — acts as the issuing user.

Headers

authorization
string
required

Bearer token for API authentication

Idempotency-Key
string

Makes retries safe. A retry with the same key and the same request replays the stored response for 24 hours (header Idempotent-Replayed: true); the same key with a different request returns 400.

Maximum string length: 255

Path Parameters

userId
string
required

Body

application/json

Body

Update a workspace member

roleId
string
required

Workspace role ID to assign. Look up IDs via GET /api/v1/workspace-roles.

Response

Workspace member

Workspace member

userId
string
required

User ID — the stable handle for this member

email
string
required
name
string | null
required
role
object
required

Workspace role

status
enum<string>
required
Available options:
active,
inactive
lastActiveAt
unknown
required
joinedAt
any
required

When the user was added to the workspace