ListUsers

Retrieve and manage all users in an organization, including deactivated or unverified ones. Filter by status, sort by attributes, and paginate results for efficient user management.

Instructions

Get the list of all users in the organization. This list includes all users even if they are deactivated or unverified.

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, modified_at, user_count.
sort_dir: Direction of sort. Options: asc, desc.
filter: Filter all users by the given string. Defaults to no filtering.
filter[status]: Filter on status attribute. Comma separated list, with possible values Active, Pending, and Disabled. 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"
}

400: Bad Request
- Content-Type: application/json
- Response Properties:
  - errors: A list of errors.
- Example:

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

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 users by the given string. Defaults to no filtering.
`filter[status]`	No	Filter on status attribute. Comma separated list, with possible values `Active`, `Pending`, and `Disabled`. 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.
`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`, `modified_at`, `user_count`.	name
`sort_dir`	No	Direction of sort.	desc

Input Schema (JSON Schema)

{
  "properties": {
    "filter": {
      "description": "Filter all users by the given string. Defaults to no filtering.",
      "type": "string"
    },
    "filter[status]": {
      "description": "Filter on status attribute.\nComma separated list, with possible values `Active`, `Pending`, and `Disabled`.\nDefaults to no filtering.",
      "example": "Active",
      "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": "User attribute to order results by. Sort order is ascending by default.\nSort order is descending if the field\nis prefixed by a negative sign, for example `sort=-name`. Options: `name`,\n`modified_at`, `user_count`.",
      "example": "name",
      "type": "string"
    },
    "sort_dir": {
      "default": "desc",
      "description": "Direction of sort.",
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string",
      "x-enum-varnames": [
        "ASC",
        "DESC"
      ]
    }
  },
  "required": [],
  "type": "object"
}

Datadog MCP Server

ListUsers

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Datadog MCP Server

Related Tools

MCP directory API