Delete a permission definition by ID
DELETE/permissions/:id
Permanently removes the permission record identified by {id} from the tenant's permission catalog. Use this to retire a resource/action pair that is no longer needed.
Preconditions: the caller must be authenticated and hold the DELETE_PERMISSION permission for the tenant.
On success, returns an empty response body. Returns 404 when no permission with that id exists for the tenant.
Request
Responses
- 204
- 400
- 404
- 500
The permission was deleted; the response body is empty.
Returned when the request is malformed, such as an invalid id format.
No permission with the given id exists in this tenant's catalog. Verify the id and tenant-id header before retrying.
An unexpected error occurred while deleting the permission, typically a downstream data-service failure. Retry the request or contact support if the error persists.