Sign in

v1

latestOpenAPI 3.1.02026-07-2617125852.3 KB
WorkspaceMember

Patch workspace member

Requires one of the following scopes: workspace_members:update, workspace_members:all, all:update, all:all

patch/api/v2/workspace-members/{id}

Path parameters

idstring uuid required
Example:019f94cd-afbe-71bd-a336-0017af637bf5

The ID of the item to update

Request body

nicknamestring nullable

Private workspace member nickname visible only to the workspace owner

role'owner' | 'admin' | 'editor' | 'view' | 'client'

THe role of the workspace member defining their access level. While the "owner" role is listed in the enum, it cannot be created via the API, and is only assigned to the user who creates the workspace.

Example request

{
  "nickname": "Finance lead",
  "role": "editor"
}

Response

The updated Workspace Member

idstring uuid required

Unique identifier for the workspace member

emailstring email required

Email address of the workspace member

user_idstring uuid required

User ID of the workspace member

user_emailstring email nullable

Email address of the user

nicknamestring nullable

Private workspace member nickname visible only to the workspace owner

role'owner' | 'admin' | 'editor' | 'view' | 'client' required

THe role of the workspace member defining their access level. While the "owner" role is listed in the enum, it cannot be created via the API, and is only assigned to the user who creates the workspace.

timestamp_createdstring date-time required

Timestamp when the workspace member was created

workspace_idstring uuid required

ID of the workspace this member belongs to

acceptedboolean required

Whether the member has accepted the workspace invitation

issuer_idstring uuid nullable

ID of the user who added this member to the workspace

permissionsstring[] nullable

The permissions for this workspace member. Used in the app to restrict access to certain sections

Example response

{
  "id": "019f94cd-83fa-704b-a013-af8dc24b51ef",
  "email": "user@example.com",
  "user_id": "019f94cd-83fa-704b-a013-af8e479c3d70",
  "user_email": "user@example.com",
  "nickname": "Finance lead",
  "name": {
    "first": "John",
    "last": "Smith"
  },
  "role": "editor",
  "timestamp_created": "2026-07-24T15:45:24.474Z",
  "workspace_id": "019f94cd-83fa-704b-a013-af8f70cf7b25",
  "issuer_id": "019f94cd-83fa-704b-a013-af9030155d6f",
  "permissions": [
    "unibox.all"
  ]
}