ListRoles

Retrieve and manage all roles with their names and unique identifiers on the Datadog MCP Server. Filter, sort, and paginate results to streamline role identification and administration.

Instructions

Returns all roles, including their names and their unique identifiers.

Query Parameters:

page[size]: Size for a given page. The maximum allowed value is 100.
page[number]: Specific page number to return.
sort: Sort roles depending on the given field. Sort order is ascending by default. Sort order is descending if the field is prefixed by a negative sign, for example: sort=-name.
filter: Filter all roles by the given string.
filter[id]: Filter all roles by the given list of role IDs.

Responses:

200 (Success): OK
- Content-Type: application/json
- Response Properties:
  - data: Array of returned roles.
- Example:

{
  "data": [
    "unknown_type"
  ],
  "meta": "unknown_type"
}

403: Authentication error
- Content-Type: application/json
- Response Properties:
  - errors: A list of errors.
- Example:

{
  "errors": [
    "Bad Request"
  ]
}

429: Too many requests
- Content-Type: application/json
- Response Properties:
  - errors: A list of errors.
- Example:

{
  "errors": [
    "Bad Request"
  ]
}

Input Schema

Name	Required	Description	Default
`filter`	No	Filter all roles by the given string.
`filter[id]`	No	Filter all roles by the given list of role IDs.
`page[number]`	No	Specific page number to return.
`page[size]`	No	Size for a given page. The maximum allowed value is 100.
`sort`	No	Sorting options for roles.	name

Input Schema (JSON Schema)

{
  "properties": {
    "filter": {
      "description": "Filter all roles by the given string.",
      "type": "string"
    },
    "filter[id]": {
      "description": "Filter all roles by the given list of role IDs.",
      "type": "string"
    },
    "page[number]": {
      "default": 0,
      "description": "Specific page number to return.",
      "example": 0,
      "format": "int64",
      "type": "integer"
    },
    "page[size]": {
      "default": 10,
      "description": "Size for a given page. The maximum allowed value is 100.",
      "example": 10,
      "format": "int64",
      "type": "integer"
    },
    "sort": {
      "default": "name",
      "description": "Sorting options for roles.",
      "enum": [
        "name",
        "-name",
        "modified_at",
        "-modified_at",
        "user_count",
        "-user_count"
      ],
      "type": "string",
      "x-enum-varnames": [
        "NAME_ASCENDING",
        "NAME_DESCENDING",
        "MODIFIED_AT_ASCENDING",
        "MODIFIED_AT_DESCENDING",
        "USER_COUNT_ASCENDING",
        "USER_COUNT_DESCENDING"
      ]
    }
  },
  "required": [],
  "type": "object"
}

Datadog MCP Server

ListRoles

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Datadog MCP Server

Related Tools

MCP directory API