Delete Pathway Access

Removes a user's or group's explicit access to a pathway. 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, the pathway's folder or the organization is unaffected. The request is idempotent: a principal without a direct grant on the pathway also returns 204.

Required Scope

pathways:write

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

The pathway id.

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
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 pathway.

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