Delete custom scope
The endpoint provides functionality to delete a custom scope.
HTTP request
DELETE https://$instanceId.id.nevis.cloud/nevis/api/v1/scopes/$scopeId
Parameters
| Parameter | In | Type | Required / Optional | Description |
|---|---|---|---|---|
instanceId | path | string | required | The ID of your Identity Cloud instance |
scopeId | path | string | required | The ID of the custom scope |
Example request
scopeId=your-custom-scope-id
curl --request DELETE "https://$instanceId.id.nevis.cloud/nevis/api/v1/scopes/$scopeId" \
--header "Authorization: Bearer $accessKey"
HTTP response
On success
HTTP/1.1 204 is returned if the custom scope is successfully deleted.
On failure
HTTP/1.1 401 is returned if the authorization fails due to an invalid access key.
HTTP/1.1 404 is returned if no custom scope is found with the given scopeId, with a detailed message.
HTTP/1.1 500 is returned if an unexpected error occurs.