Roles

get

Authorizations

bearer

AuthorizationstringRequired

Pass a Service Account Key as the Bearer token to authenticate. e.g. 'sk:xxxxxxx'

Query parameters

afterstringOptional

limitnumberOptional

Responses

200Success

application/json

and

get

/v1/roles

HTTPcURLJavaScriptPython

GET /v1/roles HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200Success

{
  "paging": {
    "next": {
      "after": "text"
    }
  },
  "data": [
    {
      "id": "text",
      "name": "text",
      "is_system": true
    }
  ]
}

get

Authorizations

bearer

AuthorizationstringRequired

Pass a Service Account Key as the Bearer token to authenticate. e.g. 'sk:xxxxxxx'

Path parameters

roleIdstringRequired

Responses

200Success

application/json

idstringRequired

Unique ID

namestringRequired

Name of Role

is_systembooleanRequired

If true, this a Role defined and managed by the system.

get

/v1/roles/{roleId}

HTTPcURLJavaScriptPython

GET /v1/roles/{roleId} HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200Success

{
  "id": "text",
  "name": "text",
  "is_system": true
}