Skip to main content
PATCH
Update Member Role

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

user_id
string<uuid>
required
team_id
string<uuid>
required

Body

application/json

Schema for updating team member role.

role
enum<string>
required

User roles within teams (hierarchical).

  • OWNER (4): Full control including team deletion
  • ADMIN (3): All operations except team deletion
  • OPERATOR (2): Day-to-day operations (run jobs, view logs), no setup/config
  • VIEWER (1): Read-only audit access
Available options:
viewer,
operator,
admin,
owner

Response

Successful Response

Schema for team member in responses.

user_id
string<uuid>
required
role
enum<string>
required

User roles within teams (hierarchical).

  • OWNER (4): Full control including team deletion
  • ADMIN (3): All operations except team deletion
  • OPERATOR (2): Day-to-day operations (run jobs, view logs), no setup/config
  • VIEWER (1): Read-only audit access
Available options:
viewer,
operator,
admin,
owner
joined_at
string<date-time>
required
email
string | null
invited_by
string<uuid> | null