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| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
204The principal no longer holds a direct grant on the opportunity.
500The change could not be applied (write-failed). Retrying is safe.
503Access 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.

