Team API

Use the Team API to inspect workspace members, invite members, and update access.

Team member object

Field	Type	Description
id	string	User ID with the usr_ prefix.
name	string	Member name.
email	string	Member email.
role	string	owner, manager, or staff.
status	string	invited, active, or suspended.
created_at	string	ISO 8601 timestamp.

List members

GET /team

Invite a member

POST /team/invitations

Required: email, role.

{
  "email": "manager@example.com",
  "role": "manager"
}

201 Created

{
  "data": {
    "id": "invitation_13fe8a",
    "email": "manager@example.com",
    "role": "manager",
    "status": "pending",
    "expires_at": "2026-09-16T09:00:00Z"
  }
}

Update a member

PATCH /team/{user_id}

Supported operations include changing a role, suspending a member, or reactivating a member.

Owner-only operations return 403 permission_denied for other roles.