Get Role Details
Get full details of a role including its assigned permissions.
Endpoint
/api/v1/projects/{project_id}/roles/{role_id}Method
GET
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
project_id | string | Yes | Unique ID of the project |
role_id | string | Yes | Unique ID of the role |
Headers
| Header | Required | Description |
|---|---|---|
Authorization | Yes | Bearer access token: Bearer <access_token> |
Required Permission
roles:read
Examples
curl --request GET \
--url https://auth.roled.id/api/v1/projects/2JUSLUee46xG6iEwG8JwPc/roles/2JRtjyxfZudzaJkFczgoUY \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJo...'Error Codes
| Code | HTTP Status | Description |
|---|---|---|
invalid_authorization_token | 401 | Missing or invalid authorization token |
insufficient_permission | 403 | Insufficient permission |
project_not_found | 404 | Project not found |
role_not_found | 404 | Role not found |
system_error | 500 | Internal server error |