List organization roles | Management API Reference

List roles of an organization

get/v2/organizations/{slug}/roles

Returns a list of org-level roles for the organization.

OAuth scopes

organizations:read

The fine-grained token must include the following permissions to access this endpoint:

members_read

Path parameters

slug
Required
string
Organization slug

Response codes

Response (200)

1
{
2
  "data": [
3
    {
4
      "type": "organization_role",
5
      "attributes": {
6
        "name": "developer"
7
      }
8
    }
9
  ]
10
}

1
{
2
  "type": "object",
3
  "properties": {
4
    "data": {
5
      "type": "array",
6
      "items": {
7
        "type": "object",
8
        "properties": {
9
          "type": {
10
            "type": "string",
11
            "description": "Resource type.",
12
            "enum": [
13
              "organization_role"
14
            ]
15
          },
16
          "attributes": {
17
            "type": "object",
18
            "properties": {
19
              "name": {
20
                "type": "string",
21
                "description": "Role name.",
22
                "example": "developer"
23
              }
24
            },
25
            "required": [
26
              "name"
27
            ]
28
          }
29
        },
30
        "required": [
31
          "type",
32
          "attributes"
33
        ]
34
      }
35
    }
36
  },
37
  "required": [
38
    "data"
39
  ]
40
}