Skip to content

Remove a capability revoke from a user

DELETE
/admin/users/{ref}/revokes/{capability}

Removes one of a user’s revokes, so whatever their roles and grants give them applies again. Name the capability in the path, and add team_id to remove the revoke for that team instead of the instance-wide one. Needs the users.write capability. If there’s no matching revoke, you get 404.

ref
required
integer format: int64
capability
required
string
team_id
string format: uuid

Revoke removed.

Authentication required, missing, or invalid

object
error
required

Human-readable error summary

string
Example
the request could not be completed
Example
{
"error": "authentication required: sign in and retry with a valid session or API token"
}

Authenticated but missing required capabilities

object
error
required

Human-readable error summary

string
Example
the request could not be completed

Resource not found

object
error
required

Human-readable error summary

string
Example
the request could not be completed