Retrieve a single permission by its ID
GET/permissions/:id
Returns the permission record identified by {id}. Use this when you already have a specific permission id (obtained from POST /permissions or GET /permissions) and need its full details; for browsing the full catalog, use GET /permissions instead.
Preconditions: the caller must be authenticated and hold the READ_PERMISSION permission for the tenant.
On success, returns the matching permission (id, resource, action, description); createdAt and updatedAt are always null in the current implementation. Returns 404 when no permission with that id exists for the tenant.
Request
Responses
- 200
- 400
- 404
- 500
The permission matching the given id, including its resource, action, and description. Note: createdAt and updatedAt are always null in the current implementation.
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 value and tenant-id header, or use GET /permissions to look up a valid id.
An unexpected error occurred while retrieving the permission, typically a downstream data-service failure. Retry the request or contact support if the error persists.