Reset User Access

Resets a user's access configuration by removing every explicit grant. Destructive, so the query parameter reset=true is required. Removes the view, update, manage and full-control grants of every user and group. The user itself and its ownership by the organization are kept, so global administrators and user administrators keep access. Every other grant is removed, including platform-created ones such as the user's manager, the user's own view grant, and the All Members and View Members Legacy Permission groups. A user without grants 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.

Query Params
string

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

string
enum
required

Must be true to confirm the reset (reset-confirmation-required otherwise).

Allowed:
Responses
204

The user has no explicit grants.

500

The reset 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