from line 1
1---
2title: Roles
3url: https://platform.claude.com/docs/en/api/compliance/organizations/roles
4---
5
61# Roles
72
83## List Compliance Roles
94
10**get** `/v1/compliance/organizations/{org_uuid}/roles`
5**GET** `/v1/compliance/organizations/{org_uuid}/roles`
116
127List Compliance Roles
138
14### Path Parameters
9### Path parameters
1510
1611- `org_uuid: string`
1712
1813 The organization UUID
1914
20### Query Parameters
15### Query parameters
2116
2217- `limit: optional number`
2318
2419 Maximum results (default: 500, max: 1000)
2520
21 default: 500, maximum: 1000, minimum: 1
22
2623- `page: optional string`
2724
2825 Opaque pagination token from a previous response's `next_page` field. Pass this to retrieve the next page of results. Clients should treat this value as an opaque string and not attempt to parse or interpret its contents, as the format may change without notice.
2926
30### Header Parameters
27### Headers
3128
3229- `"x-api-key": optional string`
3330
3431### Returns
3532
36- `data: array of object { id, created_at, description, 2 more }`
33- `data: array of object`
3734
3835 List of roles
3936
from line 64
6764
6865### Example
6966
70```http
67```bash
7168curl https://api.anthropic.com/v1/compliance/organizations/$ORG_UUID/roles \
7269 -H "Authorization: Bearer $ANTHROPIC_COMPLIANCE_API_KEY"
7370```
7471
75#### Response
72#### Response (200)
7673
7774```json
7875{
from line 89
9289
9390## Get Compliance Role
9491
95**get** `/v1/compliance/organizations/{org_uuid}/roles/{role_id}`
92**GET** `/v1/compliance/organizations/{org_uuid}/roles/{role_id}`
9693
9794Get Compliance Role
9895
99### Path Parameters
96### Path parameters
10097
10198- `org_uuid: string`
10299
from line 103
106103
107104 The role ID (tagged ID, e.g., rbac_role_abc123)
108105
109### Header Parameters
106### Headers
110107
111108- `"x-api-key": optional string`
112109
from line 131
134131
135132### Example
136133
137```http
134```bash
138135curl https://api.anthropic.com/v1/compliance/organizations/$ORG_UUID/roles/$ROLE_ID \
139136 -H "Authorization: Bearer $ANTHROPIC_COMPLIANCE_API_KEY"
140137```
141138
142#### Response
139#### Response (200)
143140
144141```json
145142{
from line 148
151148}
152149```
153150
154## Domain Types
151## Domain types
155152
156153### Role List Response
157154
158- `RoleListResponse object { id, created_at, description, 2 more }`
155- `RoleListResponse object`
159156
160157 Role information for compliance responses.
161158
from line 178
181178
182179### Role Retrieve Response
183180
184- `RoleRetrieveResponse object { id, created_at, description, 2 more }`
181- `RoleRetrieveResponse object`
185182
186183 Role information for compliance responses.
187184
from line 202
205202
206203 Role last-updated timestamp (ISO 8601)
207204
208# Permissions
205## Roles › Permissions
209206
210## List Compliance Role Permissions
207### List Compliance Role Permissions
211208
212**get** `/v1/compliance/organizations/{org_uuid}/roles/{role_id}/permissions`
209**GET** `/v1/compliance/organizations/{org_uuid}/roles/{role_id}/permissions`
213210
214211List Compliance Role Permissions
215212
216### Path Parameters
213#### Path parameters
217214
218215- `org_uuid: string`
219216
from line 220
223220
224221 The role ID (tagged ID, e.g., rbac_role_abc123)
225222
226### Query Parameters
223#### Query parameters
227224
228225- `limit: optional number`
229226
230227 Maximum results (default: 500, max: 1000)
231228
229 default: 500, maximum: 1000, minimum: 1
230
232231- `page: optional string`
233232
234233 Opaque pagination token from a previous response's `next_page` field. Pass this to retrieve the next page of results. Clients should treat this value as an opaque string and not attempt to parse or interpret its contents, as the format may change without notice.
235234
236### Header Parameters
235#### Headers
237236
238237- `"x-api-key": optional string`
239238
240### Returns
239#### Returns
241240
242- `data: array of object { action, resource_id, resource_type }`
241- `data: array of object`
243242
244243 List of permissions
245244
from line 262
263262
264263 Token to retrieve the next page. Use this as the 'page' parameter in your next request
265264
266### Example
265#### Example
267266
268```http
267```bash
269268curl https://api.anthropic.com/v1/compliance/organizations/$ORG_UUID/roles/$ROLE_ID/permissions \
270269 -H "Authorization: Bearer $ANTHROPIC_COMPLIANCE_API_KEY"
271270```
272271
273#### Response
272##### Response (200)
274273
275274```json
276275{
from line 284
285284 "next_page": "cGFnZV90b2tlbl9leGFtcGxlXzE3MzQ1Njc4OTA="
286285}
287286```
288
289## Domain Types
290
291### Permission List Response
292
293- `PermissionListResponse object { action, resource_id, resource_type }`
294
295 Permission granted by a role.
296
297 - `action: string`
298
299 Action permitted on the resource
300
301 - `resource_id: string`
302
303 Identifier of the resource the permission applies to
304
305 - `resource_type: string`
306
307 Type of resource the permission applies to
308287
No line in this hunk matches that.