Reset Opportunity Access

Destructive, so the query parameter reset=true is required. Removes the view, update, manage and full-control grants of every user and group, the authors', collaborators' and All Members group's included. The opportunity itself and its ownership by the organization are kept, so organization administrators are unaffected. An opportunity without grants also returns 204. Because a reset clears every update, manage and full-control grant at once, it is refused with 409 last-author-protected while any user holds one, and since one user must always keep such a grant (the single DELETE and PATCH refuse to take the last one away: Degreed's author sync cannot remove the last author), a full reset is not available for an opportunity that has one. What is available: remove every other principal one at a time with DELETE .../access/{principal} (groups, users at view, and all but one of the users at update or higher, who can also be moved to view with PATCH). A reset succeeds only when no user holds update, manage or full-control: an opportunity whose grants are all view or held by groups. The guard looks at the grants as they are when the request arrives.

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.

Responses
204

The opportunity has no explicit grants.

500

The reset 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