ListRoleUsers

Retrieve and manage users associated with a specific role on the Datadog MCP Server. Filter, sort, and paginate results to efficiently identify relevant user data.

Instructions

Gets all users of a role.

Path Parameters:

role_id (Required): The unique identifier of the role.

Query Parameters:

page[size]: Size for a given page. The maximum allowed value is 100.
page[number]: Specific page number to return.
sort: User attribute to order results by. Sort order is ascending by default. Sort order is descending if the field is prefixed by a negative sign, for example sort=-name. Options: name, email, status.
filter: Filter all users by the given string. Defaults to no filtering.

Responses:

200 (Success): OK
- Content-Type: application/json
- Response Properties:
  - data: Array of returned users.
  - included: Array of objects related to the users.
- Example:

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

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

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

404: Not found
- 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 users by the given string. Defaults to no filtering.
`page[number]`	No	Specific page number to return.
`page[size]`	No	Size for a given page. The maximum allowed value is 100.
`role_id`	Yes	The unique identifier of the role.
`sort`	No	User attribute to order results by. Sort order is ascending by default. Sort order is descending if the field is prefixed by a negative sign, for example `sort=-name`. Options: `name`, `email`, `status`.	name

Input Schema (JSON Schema)

{
  "properties": {
    "filter": {
      "description": "Filter all users by the given string. Defaults to no filtering.",
      "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"
    },
    "role_id": {
      "description": "The unique identifier of the role.",
      "type": "string"
    },
    "sort": {
      "default": "name",
      "description": "User attribute to order results by. Sort order is **ascending** by default.\nSort order is **descending** if the field is prefixed by a negative sign,\nfor example `sort=-name`. Options: `name`, `email`, `status`.",
      "type": "string"
    }
  },
  "required": [
    "role_id"
  ],
  "type": "object"
}

Datadog MCP Server

ListRoleUsers

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Datadog MCP Server

Related Tools

MCP directory API