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.io/api/v1/projects/2JUSLUee46xG6iEwG8JwPc/roles/2JRtjyxfZudzaJkFczgoUY \
  --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJo...'

{
  "success": true,
  "data": {
    "id": "2JRtjyxfZudzaJkFczgoUY",
    "created_at": "2026-07-16T14:30:00Z",
    "updated_at": "2026-07-29T08:30:00Z",
    "code": "store-manager",
    "name": "Store Manager",
    "description": "Manages store operations including products, orders, and staff",
    "permission_ids": [
      "2JUUyotLUqz5eqsuYXXDet",
      "2JUUyotLUr7SuBqkzjRbTc",
      "2JUUyotLUrApxL7zcx7Xoy",
      "2JUUyotLUrDfBK9iwe25jj",
      "2JRjbZKS7f4oRkDaAD4gAF",
      "2JRjbZKS7fJAfNjgShH3TE",
      "2JRjbZKS7h72qSpPAJBuSj"
    ]
  }
}

Error Codes

Code	HTTP Status	Description
`invalid_authorization_token`	401	Unauthorized request. The authorization token is missing or invalid.
`insufficient_permission`	403	Insufficient permissions to access this resource.
`project_not_found`	404	The requested project could not be found.
`role_not_found`	404	The requested role could not be found.
`system_error`	500	An unexpected error occurred. Please try again later.

List Roles Create Role