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/jsonResponse Properties:
data: Array of returned roles.
Example:
{
"data": [
"unknown_type"
],
"meta": "unknown_type"
}403: Authentication error
Content-Type:
application/jsonResponse Properties:
errors: A list of errors.
Example:
{
"errors": [
"Bad Request"
]
}429: Too many requests
Content-Type:
application/jsonResponse 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 |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | Array of returned roles. | |
| meta | No |