Delete Skill Plan Access

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

Required Scope

skill_plans:write

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

The skill plan id. A directory, role or other kind of plan is not found here; directories have their own endpoint.

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 skill plan.

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