Delete Content Access

Removes a user's or group's explicit access to a content item. 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 item also returns 204.

Required Scope

content:write

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

The content type segment, the same one used by the other v3 content endpoints: articles, assessments, books, courses, events, podcasts, posts, tasks
or videos.

string
required

The content 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 content item.

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