latestOpenAPI 3.1.02026-08-194237902.5 MB
563848e0ecc0
Permission
Delete a permission definition by 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.
delete/permissions/{id}
Path parameters
idstring required
Server-assigned identifier of the permission to delete. Treat as an opaque string; pass back exactly the id value returned by GET /permissions or POST /permissions.
Headers
tenant-idstring required
Tenant identifier that scopes the deletion to a specific tenant's permission catalog.
Response
The permission was deleted; the response body is empty.