List Organization Roles

GET

https://api.confident-ai.com/v1/organization/roles

GET

/v1/organization/roles

$ curl https://api.confident-ai.com/v1/organization/roles \
>      -H "CONFIDENT_API_KEY: <ORGANIZATION-API-KEY>"

200Retrieved

1 {
2   "success": true,
3   "data": {
4     "roles": [
5       {
6         "id": "role-uuid-1",
7         "name": "Admin",
8         "description": "Full administrative access",
9         "organizationId": null,
10         "policies": [
11           {
12             "id": "policy-uuid-1",
13             "name": "Manage projects"
14           }
15         ]
16       },
17       {
18         "id": "role-uuid-3",
19         "name": "Billing Manager",
20         "description": "Can manage billing only",
21         "organizationId": "ORGANIZATION-ID",
22         "policies": [
23           {
24             "id": "policy-uuid-2",
25             "name": "Manage billing"
26           }
27         ]
28       }
29     ]
30   }
31 }

Lists the roles available to your organization. This includes both global, system-defined roles (where organizationId is null) and custom roles defined by your organization.

List Organization Roles

List Organization Roles

Headers

Response

Headers

Response

$	curl https://api.confident-ai.com/v1/organization/roles \
>	-H "CONFIDENT_API_KEY: <ORGANIZATION-API-KEY>"

1	{
2	"success": true,
3	"data": {
4	"roles": [
5	{
6	"id": "role-uuid-1",
7	"name": "Admin",
8	"description": "Full administrative access",
9	"organizationId": null,
10	"policies": [
11	{
12	"id": "policy-uuid-1",
13	"name": "Manage projects"
14	}
15	]
16	},
17	{
18	"id": "role-uuid-3",
19	"name": "Billing Manager",
20	"description": "Can manage billing only",
21	"organizationId": "ORGANIZATION-ID",
22	"policies": [
23	{
24	"id": "policy-uuid-2",
25	"name": "Manage billing"
26	}
27	]
28	}
29	]
30	}
31	}