Delete Opportunity Access

Removes a user's or group's explicit access to an opportunity. 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. A user who held update, manage or full-control also stops being an author of the opportunity (as in Manage Access), unless they hold the only such grant: that removal is refused with 409 last-author-protected until another user holds update, manage or full-control. The guard looks at the grants as they are when the request arrives; a user without a grant, a user at view and any group are removed as usual. Known limitation: Degreed's author sync cannot remove the last author, so such a user would otherwise stay an author without a grant. The request is idempotent: a principal without a direct grant on the opportunity also returns 204.

Required Scope

opportunity:write

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

The opportunity id, the id /api/v2/opportunities/{id} uses.

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.

Responses
204

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

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