---
title: "Get permissions for a role"
method: GET
path: "/v2/organisations/{organisation_id}/roles/{role_id}"
tags: ["Gateway GRPC"]
---

# Get permissions for a role

`GET /v2/organisations/{organisation_id}/roles/{role_id}`

## Request

- Base URL: `https://api.cautio.in` (the document declares no server; this is the origin it was published from)
- URL: `https://api.cautio.in/v2/organisations/{organisation_id}/roles/{role_id}`
- Auth: HTTP bearer

## Path parameters

- `organisation_id` string, required
- `role_id` string, required

## Response `200`

- GetRolePermissionsResponseDto
  - `data` GetRolePermissionsResponseDataDto, required
    - `organisation_id` string, required: Organisation ID
    - `role_id` string, required: Role ID
    - `items` ModuleDto[], required: Modules specific to role
      - `name` string, required: Module Name
      - `submodules` SubModuleDto[], required: SubModules under this Module
        - `name` string, required: SubModule Name
        - `permissions` PermissionDto[], required: Permissions under this SubModule
          - `id` string, required: Permission ID UUID
          - `description` string: Optional description
          - `action` string, required: Action definition

---

[API](https://skmtc.dev/cautio/apis/cautio-api.md) - [All operations](https://skmtc.dev/cautio/apis/cautio-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cautio/apis/cautio-api/revisions/214e6d1d2b6c?raw)