Skip to content

Revoke a shell role from a user

DELETE
/api/users/{user_id}/roles

Revoke (soft-delete) a shell role grant from user_id in org.

Idempotent-ish: returns 404 if no active grant exists.

Errors

404 — no active grant for this role. 422 — unknown role string.

Authorizations

Parameters

Path Parameters

user_id
required
string format: uuid

Query Parameters

organization_id
required
string format: uuid
role
required

Role string to revoke

string

Role string to revoke

Responses

204

Successful Response

422

Validation Error

object
detail
Array<object>
object
loc
required
Array
msg
required
string
type
required
string