Skip to main content
GET
/
roles
/
{role_id}
/
permissions
curl -X GET https://api.companyflow.com/roles/550e8400-e29b-41d4-a716-446655440000/permissions \
  -H "Authorization: Bearer YOUR_TOKEN"
{
  "success": true,
  "data": [
    {
      "id": "770e8400-e29b-41d4-a716-446655440000",
      "role_id": "550e8400-e29b-41d4-a716-446655440000",
      "action": "read",
      "resource": "employees",
      "conditions": null,
      "created_at": "2024-01-15T10:30:00Z"
    },
    {
      "id": "880e8400-e29b-41d4-a716-446655440001",
      "role_id": "550e8400-e29b-41d4-a716-446655440000",
      "action": "write",
      "resource": "employees",
      "conditions": {
        "department": "engineering"
      },
      "created_at": "2024-01-15T10:30:00Z"
    },
    {
      "id": "990e8400-e29b-41d4-a716-446655440002",
      "role_id": "550e8400-e29b-41d4-a716-446655440000",
      "action": "read",
      "resource": "departments",
      "conditions": null,
      "created_at": "2024-01-15T10:30:00Z"
    }
  ]
}
Get a complete list of all permissions assigned to a specific role. Requires Super Admin or HR Manager permissions.

Path Parameters

role_id
string
required
The unique identifier of the role (UUID format)Example: "550e8400-e29b-41d4-a716-446655440000"

Response

success
boolean
Indicates if the request was successful
data
array
Array of permission objects
curl -X GET https://api.companyflow.com/roles/550e8400-e29b-41d4-a716-446655440000/permissions \
  -H "Authorization: Bearer YOUR_TOKEN"
{
  "success": true,
  "data": [
    {
      "id": "770e8400-e29b-41d4-a716-446655440000",
      "role_id": "550e8400-e29b-41d4-a716-446655440000",
      "action": "read",
      "resource": "employees",
      "conditions": null,
      "created_at": "2024-01-15T10:30:00Z"
    },
    {
      "id": "880e8400-e29b-41d4-a716-446655440001",
      "role_id": "550e8400-e29b-41d4-a716-446655440000",
      "action": "write",
      "resource": "employees",
      "conditions": {
        "department": "engineering"
      },
      "created_at": "2024-01-15T10:30:00Z"
    },
    {
      "id": "990e8400-e29b-41d4-a716-446655440002",
      "role_id": "550e8400-e29b-41d4-a716-446655440000",
      "action": "read",
      "resource": "departments",
      "conditions": null,
      "created_at": "2024-01-15T10:30:00Z"
    }
  ]
}

Build docs developers (and LLMs) love