Skip to main content
DELETE
Remove a role from a user
🔒 Admin only. Requires administrator privileges — the authenticated principal (API key, embed JWT, or any bearer token) must belong to a user with the admin role. Takes the role away from the user. Idempotent — removing a role the user does not hold changes nothing. Returns 404 if the user is unknown. An API key scoped to specific deployments answers 403 here.

Authorizations

Authorization
string
header
required

Token authentication. Send Authorization: Bearer <YOUR_TOKEN>.

Path Parameters

roleId
number
required
userId
number
required

Response

Successful response