ListIncidentTeams

Retrieve incident teams for an organization, optionally including related users. Filter teams by name or paginate results to manage large datasets efficiently.

Instructions

Get all incident teams for the requesting user's organization. If the include[users] query parameter is provided, the included attribute will contain the users related to these incident teams.

Query Parameters:

include: Specifies which types of related objects should be included in the response.
page[size]: Size for a given page. The maximum allowed value is 100.
page[offset]: Specific offset to use as the beginning of the returned page.
filter: A search query that filters teams by name.

Responses:

200 (Success): OK
- Content-Type: application/json
- Response Properties:
  - data: An array of incident teams.
  - included: Included related resources which the user requested.
- Example:

{
  "data": [
    {
      "attributes": {
        "name": "team name"
      },
      "id": "00000000-7ea3-0000-0000-000000000000",
      "type": "teams"
    }
  ],
  "included": [
    "unknown_type"
  ],
  "meta": "unknown_type"
}

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

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

401: Unauthorized
- Content-Type: application/json
- Response Properties:
  - errors: A list of errors.
- Example:

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

403: Forbidden
- 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
`filter`	No	A search query that filters teams by name.
`include`	No	Object related to an incident.
`page[offset]`	No	Specific offset to use as the beginning of the returned page.
`page[size]`	No	Size for a given page. The maximum allowed value is 100.

Input Schema (JSON Schema)

{
  "properties": {
    "filter": {
      "description": "A search query that filters teams by name.",
      "example": "ExampleTeamName",
      "type": "string"
    },
    "include": {
      "description": "Object related to an incident.",
      "enum": [
        "users",
        "attachments"
      ],
      "type": "string",
      "x-enum-varnames": [
        "USERS",
        "ATTACHMENTS"
      ]
    },
    "page[offset]": {
      "default": 0,
      "description": "Specific offset to use as the beginning of the returned page.",
      "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"
    }
  },
  "required": [],
  "type": "object"
}

Datadog MCP Server

ListIncidentTeams

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Datadog MCP Server

Related Tools

MCP directory API