Skip to main content
PATCH
Change a team member role
API keys cannot call this endpoint: it answers 403 FORBIDDEN_ACTION (“API keys cannot access this endpoint.”). Change roles in Heliyos under Settings, Team.
In the Heliyos MCP server: heliyos_team_members_change_role.

Authorizations

Authorization
string
header
required

A workspace API key, sent as Authorization: Bearer heliyos_.... Create one in Heliyos under Settings → API keys. A key acts as a workspace admin in the one workspace it was created in.

Path Parameters

id
string
required

The membership id, from List team members.

Pattern: ^[0-9a-fA-F]{24}$

Body

application/json
roleId
string
required

The new role's id, from List roles: OWNER, ADMIN or MEMBER, or AGENCY in an agency workspace.

Pattern: ^[0-9a-fA-F]{24}$
Example:

"66f1a8c3e4b0a1b2c3d4e5f6"

Response

The role was changed. data is an empty object.

meta
object
required
data
object
required

Empty object.