Delete User Access

Removes a user's or group's explicit access to a user. The principal-id is the user's or group's API id unless the principal-id-type query parameter names another identifier: email or employee-id for a user, group-external-id for a group. Only the principal's direct grant is removed; access it inherits through a group or the organization is unaffected. The request is idempotent: a principal without a direct grant on the user also returns 204.

Required Scope

users:write

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

The user's API id, or the value of the identifier named by identifier, as on the other v3 user endpoints.

string
required

The principal as {principal-type}:{principal-id}, the id of an access-assignment returned by GET, for example user:aBc123 or group:xYz789.

Query Params
string

How id identifies the user: email or employee-id. Omit it for the user's API id.

string
enum

How principal-id identifies the principal. Users: user-id (default), email, employee-id. Groups: group-id (default), group-external-id.

Allowed:
Responses
204

The principal no longer holds a direct grant on the user.

500

The change could not be applied (write-failed). Retrying is safe.

503

Access configuration is temporarily unavailable (access-configuration-unavailable): the organization's ReBAC rollout mode could not be read, or the
deployment has no ReBAC engine (the detail says which). Retry later.

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json