DAdatadog
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

  • Base URL
    https://api.datadoghq.com
  • URL
    https://api.datadoghq.com/api/v2/roles
  • Auth
    • API key in header DD-API-KEY and API key in header DD-APPLICATION-KEY
    • or OAuth 2
      Authorization code: /oauth2/v1/authorize
      Token URL: /oauth2/v1/token scopes: user_access_manage

Request body

Example request

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

Response

OK

Example response

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

Changes

No recorded changes to this operation across all 1 revision of this API.