Skip to main content
POST
Assign Role to Member
Assign a role to an existing team member. Use GET /teams/roles to retrieve the list of available roles and their IDs.

Example Request

Example Response

data is always an empty object. Read the member back with GET /teams/members to confirm the new role.
The business_owner role cannot be assigned via this endpoint. Fetch assignable roles from GET /teams/roles — the list excludes owner-level roles automatically.
The target user must already be an accepted member of your business. You cannot assign a role to a pending invite.

Authorizations

X-API-Key
string
header
required

Your Rolla API key

Path Parameters

userId
string<uuid>
required

User UUID of the team member

Body

application/json
role_id
string<uuid>
required

UUID of the role to assign. Retrieve assignable roles from GET /teams/roles.

Example:

"21302ed1-0e63-44e6-bb02-8db6baa2efcd"

Response

Role assigned successfully

status
integer
required
Example:

200

message
string
required
Example:

"Role assigned successfully"

success
boolean
required
Example:

true

data
object
required

Always empty.