v1

latestOpenAPI 3.0.02026-07-141,4077,1665.2 MB

Roles

Create role

Create a new role for your organization.

The following read permissions are automatically added to every new role, even if they are not included in the request:

Dashboards Read
Notebooks Read
Monitors Read
APM Read
Vulnerability Management Read
RUM Apps Read
Incidents Read
SLOs Read
CI Visibility Read
CD Visibility Read

post/api/v2/roles

Request body

Example request

{
  "data": {
    "attributes": {
      "name": "developers"
    },
    "relationships": {
      "permissions": {
        "data": [
          {
            "type": "permissions"
          }
        ]
      }
    },
    "type": "roles"
  }
}

Response

Example response

{
  "data": {
    "attributes": {
      "name": "developers"
    },
    "relationships": {
      "permissions": {
        "data": [
          {
            "type": "permissions"
          }
        ]
      }
    },
    "type": "roles"
  }
}