> ## Documentation Index
> Fetch the complete documentation index at: https://docs.modulex.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# incident.io Integration for AI Agents & Workflows

> Manage incidents, actions, follow-ups, workflows, schedules, escalations, custom fields, and more with incident.io — the incident management and on-call response platform.

{/* Self-hosted logo — build-time vendored from modulex.json / Iconify (see scripts/lib/logo.js). */}

<img src="https://mintcdn.com/modulexaillc/zKB2qsP6Q61VNLfB/logos/incidentio.svg?fit=max&auto=format&n=zKB2qsP6Q61VNLfB&q=85&s=1e389256a68a4c25c7a48b55e5fc92af" alt="incident.io logo" width="72" height="72" data-path="logos/incidentio.svg" />

## Overview

Add **incident.io** to any ModuleX agent or workflow. Incident management and on-call response against the incident.io REST API (`api.incident.io`). Manage incidents, actions, follow-ups, workflows, schedules, escalations, escalation paths, custom fields, incident roles, and reference data.

<Info>
  **Categories**: Monitoring & Observability · Incident Management · On Call · **Auth**: API Key · **Actions**: 46
</Info>

## Authentication

### API Key Authentication

Authenticate using your incident.io API key

<Steps>
  <Step title="Step 1">
    Log in to your incident.io dashboard
  </Step>

  <Step title="Step 2">
    Go to Settings -> API keys
  </Step>

  <Step title="Step 3">
    Create a new API key and select the permissions it should have
  </Step>

  <Step title="Step 4">
    Copy the key (it is shown only once) and paste it below
  </Step>
</Steps>

#### Required Credentials

| Field               | Description                                        | Required | Format |
| ------------------- | -------------------------------------------------- | -------- | ------ |
| incident.io API Key | Your incident.io API key from Settings -> API keys | Yes      | `-`    |

## Available Actions

<AccordionGroup>
  <Accordion title="incidents_list — List incidents from incident.io. Returns a list of incidents with their details including severity, status, and timestamps.">
    ### Parameters

    <ResponseField name="page_size" type="integer">
      Number of results to return per page (e.g., 10, 25, 50)
    </ResponseField>

    <ResponseField name="after" type="string">
      Pagination cursor to fetch the next page of results
    </ResponseField>

    <ResponseField name="sort_by" type="string">
      Sort order: 'created\_at\_newest\_first' or 'created\_at\_oldest\_first'
    </ResponseField>

    <ResponseField name="filter_mode" type="string">
      How to combine filters: 'all' or 'any'
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "incidents": {
          "items": {
            "additionalProperties": true,
            "type": "object"
          },
          "title": "Incidents",
          "type": "array"
        },
        "pagination_meta": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Pagination Meta"
        }
      },
      "required": [
        "success"
      ],
      "title": "IncidentsListOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="incidents_create — Create a new incident in incident.io. Requires idempotency_key, severity_id, and visibility. Optionally accepts name, summary, type, and status.">
    ### Parameters

    <ResponseField name="idempotency_key" type="string" required>
      Unique identifier to prevent duplicate creation (e.g., a UUID)
    </ResponseField>

    <ResponseField name="severity_id" type="string" required>
      ID of the severity level
    </ResponseField>

    <ResponseField name="visibility" type="string" required>
      Visibility of the incident: 'public' or 'private'
    </ResponseField>

    <ResponseField name="name" type="string">
      Name of the incident
    </ResponseField>

    <ResponseField name="summary" type="string">
      Brief summary of the incident
    </ResponseField>

    <ResponseField name="incident_type_id" type="string">
      ID of the incident type
    </ResponseField>

    <ResponseField name="incident_status_id" type="string">
      ID of the initial incident status
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "incident": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Incident"
        }
      },
      "required": [
        "success"
      ],
      "title": "IncidentsCreateOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="incidents_show — Retrieve detailed information about a specific incident by its ID, including custom fields and role assignments.">
    ### Parameters

    <ResponseField name="id" type="string" required>
      ID of the incident to retrieve
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "incident": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Incident"
        }
      },
      "required": [
        "success"
      ],
      "title": "IncidentsShowOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="incidents_update — Update an existing incident in incident.io. Can update name, summary, severity, status, or type.">
    ### Parameters

    <ResponseField name="id" type="string" required>
      ID of the incident to update
    </ResponseField>

    <ResponseField name="notify_incident_channel" type="boolean" required>
      Whether to notify the incident channel about this update
    </ResponseField>

    <ResponseField name="name" type="string">
      Updated name of the incident
    </ResponseField>

    <ResponseField name="summary" type="string">
      Updated summary of the incident
    </ResponseField>

    <ResponseField name="severity_id" type="string">
      Updated severity ID
    </ResponseField>

    <ResponseField name="incident_status_id" type="string">
      Updated status ID
    </ResponseField>

    <ResponseField name="incident_type_id" type="string">
      Updated incident type ID
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "incident": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Incident"
        }
      },
      "required": [
        "success"
      ],
      "title": "IncidentsUpdateOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="actions_list — List actions from incident.io. Optionally filter by incident ID.">
    ### Parameters

    <ResponseField name="incident_id" type="string">
      Filter actions by incident ID
    </ResponseField>

    <ResponseField name="incident_mode" type="string">
      Filter by incident mode: standard, retrospective, test, tutorial, or stream
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "actions": {
          "items": {
            "additionalProperties": true,
            "type": "object"
          },
          "title": "Actions",
          "type": "array"
        }
      },
      "required": [
        "success"
      ],
      "title": "ActionsListOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="actions_show — Get detailed information about a specific action from incident.io.">
    ### Parameters

    <ResponseField name="id" type="string" required>
      Action ID
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "action": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Action"
        }
      },
      "required": [
        "success"
      ],
      "title": "ActionsShowOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="follow_ups_list — List follow-ups from incident.io. Optionally filter by incident ID.">
    ### Parameters

    <ResponseField name="incident_id" type="string">
      Filter follow-ups by incident ID
    </ResponseField>

    <ResponseField name="incident_mode" type="string">
      Filter by incident mode: standard, retrospective, test, tutorial, or stream
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "follow_ups": {
          "items": {
            "additionalProperties": true,
            "type": "object"
          },
          "title": "Follow Ups",
          "type": "array"
        }
      },
      "required": [
        "success"
      ],
      "title": "FollowUpsListOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="follow_ups_show — Get detailed information about a specific follow-up from incident.io.">
    ### Parameters

    <ResponseField name="id" type="string" required>
      Follow-up ID
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "follow_up": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Follow Up"
        }
      },
      "required": [
        "success"
      ],
      "title": "FollowUpsShowOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="users_list — List all users in the incident.io workspace. Returns user details including id, name, email, and role.">
    ### Parameters

    <ResponseField name="page_size" type="integer">
      Number of results to return per page (e.g., 10, 25, 50)
    </ResponseField>

    <ResponseField name="after" type="string">
      Pagination cursor to fetch the next page of results
    </ResponseField>

    <ResponseField name="email" type="string">
      Filter users by email address
    </ResponseField>

    <ResponseField name="slack_user_id" type="string">
      Filter users by Slack user ID
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "users": {
          "items": {
            "additionalProperties": true,
            "type": "object"
          },
          "title": "Users",
          "type": "array"
        },
        "pagination_meta": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Pagination Meta"
        }
      },
      "required": [
        "success"
      ],
      "title": "UsersListOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="users_show — Get detailed information about a specific user by their ID.">
    ### Parameters

    <ResponseField name="id" type="string" required>
      The unique identifier of the user to retrieve
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "user": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "User"
        }
      },
      "required": [
        "success"
      ],
      "title": "UsersShowOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="workflows_list — List all workflows in the incident.io workspace.">
    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "workflows": {
          "items": {
            "additionalProperties": true,
            "type": "object"
          },
          "title": "Workflows",
          "type": "array"
        }
      },
      "required": [
        "success"
      ],
      "title": "WorkflowsListOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="workflows_create — Create a new workflow in incident.io.">
    ### Parameters

    <ResponseField name="name" type="string" required>
      Name of the workflow
    </ResponseField>

    <ResponseField name="folder" type="string">
      Folder to organize the workflow in
    </ResponseField>

    <ResponseField name="state" type="string">
      State of the workflow: active, draft, or disabled (Default: `draft`)
    </ResponseField>

    <ResponseField name="trigger" type="string">
      Trigger type for the workflow (Default: `incident.updated`)
    </ResponseField>

    <ResponseField name="steps" type="array">
      Array of workflow steps (defaults to \[])
    </ResponseField>

    <ResponseField name="condition_groups" type="array">
      Array of condition groups controlling when the workflow runs
    </ResponseField>

    <ResponseField name="runs_on_incidents" type="string">
      When to run: newly\_created, newly\_created\_and\_active, active, or all (Default: `newly_created`)
    </ResponseField>

    <ResponseField name="runs_on_incident_modes" type="array">
      Array of incident modes to run on (defaults to \['standard'])
    </ResponseField>

    <ResponseField name="include_private_incidents" type="boolean">
      Whether to include private incidents (Default: `true`)
    </ResponseField>

    <ResponseField name="continue_on_step_error" type="boolean">
      Whether to continue executing subsequent steps if one fails (Default: `false`)
    </ResponseField>

    <ResponseField name="once_for" type="array">
      Array of fields making the workflow run once per combination
    </ResponseField>

    <ResponseField name="expressions" type="array">
      Array of workflow expressions for advanced logic
    </ResponseField>

    <ResponseField name="delay" type="object">
      Delay configuration object
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "workflow": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Workflow"
        },
        "management_meta": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Management Meta"
        }
      },
      "required": [
        "success"
      ],
      "title": "WorkflowsCreateOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="workflows_show — Get details of a specific workflow in incident.io.">
    ### Parameters

    <ResponseField name="id" type="string" required>
      The ID of the workflow to retrieve
    </ResponseField>

    <ResponseField name="skip_step_upgrades" type="boolean">
      Skip workflow step upgrades when existing step parameters changed
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "workflow": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Workflow"
        },
        "management_meta": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Management Meta"
        }
      },
      "required": [
        "success"
      ],
      "title": "WorkflowsShowOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="workflows_update — Update an existing workflow in incident.io.">
    ### Parameters

    <ResponseField name="id" type="string" required>
      The ID of the workflow to update
    </ResponseField>

    <ResponseField name="name" type="string" required>
      New name for the workflow
    </ResponseField>

    <ResponseField name="steps" type="array" required>
      Complete array of workflow steps
    </ResponseField>

    <ResponseField name="condition_groups" type="array" required>
      Complete array of workflow condition groups
    </ResponseField>

    <ResponseField name="runs_on_incidents" type="string" required>
      When to run: newly\_created, newly\_created\_and\_active, active, or all
    </ResponseField>

    <ResponseField name="runs_on_incident_modes" type="array" required>
      Complete array of incident modes to run on
    </ResponseField>

    <ResponseField name="include_private_incidents" type="boolean" required>
      Whether to include private incidents
    </ResponseField>

    <ResponseField name="continue_on_step_error" type="boolean" required>
      Whether to continue executing subsequent steps if one fails
    </ResponseField>

    <ResponseField name="once_for" type="array" required>
      Complete array of fields that make the workflow run once
    </ResponseField>

    <ResponseField name="expressions" type="array" required>
      Complete array of workflow expressions
    </ResponseField>

    <ResponseField name="state" type="string">
      New state: active, draft, or disabled
    </ResponseField>

    <ResponseField name="folder" type="string">
      New folder for the workflow
    </ResponseField>

    <ResponseField name="delay" type="object">
      Delay configuration object
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "workflow": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Workflow"
        },
        "management_meta": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Management Meta"
        }
      },
      "required": [
        "success"
      ],
      "title": "WorkflowsUpdateOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="workflows_delete — Delete a workflow in incident.io.">
    ### Parameters

    <ResponseField name="id" type="string" required>
      The ID of the workflow to delete
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "message": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Message"
        }
      },
      "required": [
        "success"
      ],
      "title": "WorkflowsDeleteOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="schedules_list — List all schedules in incident.io.">
    ### Parameters

    <ResponseField name="page_size" type="integer">
      Number of results to return per page (e.g., 10, 25, 50)
    </ResponseField>

    <ResponseField name="after" type="string">
      Pagination cursor to fetch the next page of results
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "schedules": {
          "items": {
            "additionalProperties": true,
            "type": "object"
          },
          "title": "Schedules",
          "type": "array"
        },
        "pagination_meta": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Pagination Meta"
        }
      },
      "required": [
        "success"
      ],
      "title": "SchedulesListOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="schedules_create — Create a new schedule in incident.io.">
    ### Parameters

    <ResponseField name="name" type="string" required>
      Name of the schedule
    </ResponseField>

    <ResponseField name="timezone" type="string" required>
      Timezone for the schedule (e.g., America/New\_York)
    </ResponseField>

    <ResponseField name="rotations_config" type="object" required>
      Schedule configuration object with rotations
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "schedule": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Schedule"
        }
      },
      "required": [
        "success"
      ],
      "title": "SchedulesCreateOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="schedules_show — Get details of a specific schedule in incident.io.">
    ### Parameters

    <ResponseField name="id" type="string" required>
      The ID of the schedule
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "schedule": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Schedule"
        }
      },
      "required": [
        "success"
      ],
      "title": "SchedulesShowOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="schedules_update — Update an existing schedule in incident.io.">
    ### Parameters

    <ResponseField name="id" type="string" required>
      The ID of the schedule to update
    </ResponseField>

    <ResponseField name="name" type="string">
      New name for the schedule
    </ResponseField>

    <ResponseField name="timezone" type="string">
      New timezone for the schedule
    </ResponseField>

    <ResponseField name="rotations_config" type="object">
      Schedule configuration object with rotations
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "schedule": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Schedule"
        }
      },
      "required": [
        "success"
      ],
      "title": "SchedulesUpdateOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="schedules_delete — Delete a schedule in incident.io.">
    ### Parameters

    <ResponseField name="id" type="string" required>
      The ID of the schedule to delete
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "message": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Message"
        }
      },
      "required": [
        "success"
      ],
      "title": "SchedulesDeleteOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="escalations_list — List all escalations in incident.io.">
    ### Parameters

    <ResponseField name="page_size" type="integer">
      Number of results to return per page (e.g., 10, 25, 50)
    </ResponseField>

    <ResponseField name="after" type="string">
      Pagination cursor to fetch the next page of results
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "escalations": {
          "items": {
            "additionalProperties": true,
            "type": "object"
          },
          "title": "Escalations",
          "type": "array"
        },
        "pagination_meta": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Pagination Meta"
        }
      },
      "required": [
        "success"
      ],
      "title": "EscalationsListOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="escalations_create — Create a new escalation in incident.io.">
    ### Parameters

    <ResponseField name="idempotency_key" type="string" required>
      Unique identifier to prevent duplicate escalation creation
    </ResponseField>

    <ResponseField name="title" type="string" required>
      Title of the escalation
    </ResponseField>

    <ResponseField name="escalation_path_id" type="string">
      ID of the escalation path (required if user\_ids not provided)
    </ResponseField>

    <ResponseField name="user_ids" type="string">
      Comma-separated user IDs to notify (required if no escalation\_path\_id)
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "escalation": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Escalation"
        }
      },
      "required": [
        "success"
      ],
      "title": "EscalationsCreateOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="escalations_show — Get details of a specific escalation in incident.io.">
    ### Parameters

    <ResponseField name="id" type="string" required>
      The ID of the escalation policy
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "escalation": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Escalation"
        }
      },
      "required": [
        "success"
      ],
      "title": "EscalationsShowOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="custom_fields_list — List all custom fields from incident.io.">
    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "custom_fields": {
          "items": {
            "additionalProperties": true,
            "type": "object"
          },
          "title": "Custom Fields",
          "type": "array"
        }
      },
      "required": [
        "success"
      ],
      "title": "CustomFieldsListOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="custom_fields_create — Create a new custom field in incident.io.">
    ### Parameters

    <ResponseField name="name" type="string" required>
      Name of the custom field
    </ResponseField>

    <ResponseField name="description" type="string" required>
      Description of the custom field
    </ResponseField>

    <ResponseField name="field_type" type="string" required>
      Field type: text, single\_select, multi\_select, numeric, link, etc.
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "custom_field": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Custom Field"
        }
      },
      "required": [
        "success"
      ],
      "title": "CustomFieldsCreateOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="custom_fields_show — Get detailed information about a specific custom field from incident.io.">
    ### Parameters

    <ResponseField name="id" type="string" required>
      Custom field ID
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "custom_field": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Custom Field"
        }
      },
      "required": [
        "success"
      ],
      "title": "CustomFieldsShowOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="custom_fields_update — Update an existing custom field in incident.io.">
    ### Parameters

    <ResponseField name="id" type="string" required>
      Custom field ID
    </ResponseField>

    <ResponseField name="name" type="string" required>
      New name for the custom field
    </ResponseField>

    <ResponseField name="description" type="string" required>
      New description for the custom field
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "custom_field": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Custom Field"
        }
      },
      "required": [
        "success"
      ],
      "title": "CustomFieldsUpdateOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="custom_fields_delete — Delete a custom field from incident.io.">
    ### Parameters

    <ResponseField name="id" type="string" required>
      Custom field ID
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "message": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Message"
        }
      },
      "required": [
        "success"
      ],
      "title": "CustomFieldsDeleteOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="severities_list — List all severity levels configured in the incident.io workspace.">
    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "severities": {
          "items": {
            "additionalProperties": true,
            "type": "object"
          },
          "title": "Severities",
          "type": "array"
        }
      },
      "required": [
        "success"
      ],
      "title": "SeveritiesListOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="incident_statuses_list — List all incident statuses configured in the incident.io workspace.">
    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "incident_statuses": {
          "items": {
            "additionalProperties": true,
            "type": "object"
          },
          "title": "Incident Statuses",
          "type": "array"
        }
      },
      "required": [
        "success"
      ],
      "title": "IncidentStatusesListOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="incident_types_list — List all incident types configured in the incident.io workspace.">
    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "incident_types": {
          "items": {
            "additionalProperties": true,
            "type": "object"
          },
          "title": "Incident Types",
          "type": "array"
        }
      },
      "required": [
        "success"
      ],
      "title": "IncidentTypesListOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="incident_roles_list — List all incident roles in incident.io.">
    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "incident_roles": {
          "items": {
            "additionalProperties": true,
            "type": "object"
          },
          "title": "Incident Roles",
          "type": "array"
        }
      },
      "required": [
        "success"
      ],
      "title": "IncidentRolesListOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="incident_roles_create — Create a new incident role in incident.io.">
    ### Parameters

    <ResponseField name="name" type="string" required>
      Name of the incident role
    </ResponseField>

    <ResponseField name="description" type="string" required>
      Description of the incident role
    </ResponseField>

    <ResponseField name="instructions" type="string" required>
      Instructions for the incident role
    </ResponseField>

    <ResponseField name="shortform" type="string" required>
      Short form abbreviation for the role
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "incident_role": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Incident Role"
        }
      },
      "required": [
        "success"
      ],
      "title": "IncidentRolesCreateOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="incident_roles_show — Get details of a specific incident role in incident.io.">
    ### Parameters

    <ResponseField name="id" type="string" required>
      The ID of the incident role
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "incident_role": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Incident Role"
        }
      },
      "required": [
        "success"
      ],
      "title": "IncidentRolesShowOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="incident_roles_update — Update an existing incident role in incident.io.">
    ### Parameters

    <ResponseField name="id" type="string" required>
      The ID of the incident role to update
    </ResponseField>

    <ResponseField name="name" type="string" required>
      Name of the incident role
    </ResponseField>

    <ResponseField name="description" type="string" required>
      Description of the incident role
    </ResponseField>

    <ResponseField name="instructions" type="string" required>
      Instructions for the incident role
    </ResponseField>

    <ResponseField name="shortform" type="string" required>
      Short form abbreviation for the role
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "incident_role": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Incident Role"
        }
      },
      "required": [
        "success"
      ],
      "title": "IncidentRolesUpdateOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="incident_roles_delete — Delete an incident role in incident.io.">
    ### Parameters

    <ResponseField name="id" type="string" required>
      The ID of the incident role to delete
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "message": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Message"
        }
      },
      "required": [
        "success"
      ],
      "title": "IncidentRolesDeleteOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="incident_timestamps_list — List all incident timestamp definitions in incident.io.">
    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "incident_timestamps": {
          "items": {
            "additionalProperties": true,
            "type": "object"
          },
          "title": "Incident Timestamps",
          "type": "array"
        }
      },
      "required": [
        "success"
      ],
      "title": "IncidentTimestampsListOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="incident_timestamps_show — Get details of a specific incident timestamp definition in incident.io.">
    ### Parameters

    <ResponseField name="id" type="string" required>
      The ID of the incident timestamp
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "incident_timestamp": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Incident Timestamp"
        }
      },
      "required": [
        "success"
      ],
      "title": "IncidentTimestampsShowOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="incident_updates_list — List incident updates in incident.io. Optionally filter by incident ID.">
    ### Parameters

    <ResponseField name="incident_id" type="string">
      The ID of the incident to get updates for
    </ResponseField>

    <ResponseField name="page_size" type="integer">
      Number of results to return per page (e.g., 10, 25, 50)
    </ResponseField>

    <ResponseField name="after" type="string">
      Pagination cursor to fetch the next page of results
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "incident_updates": {
          "items": {
            "additionalProperties": true,
            "type": "object"
          },
          "title": "Incident Updates",
          "type": "array"
        },
        "pagination_meta": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Pagination Meta"
        }
      },
      "required": [
        "success"
      ],
      "title": "IncidentUpdatesListOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="schedule_entries_list — List all entries for a specific schedule in incident.io.">
    ### Parameters

    <ResponseField name="schedule_id" type="string" required>
      The ID of the schedule to get entries for
    </ResponseField>

    <ResponseField name="entry_window_start" type="string">
      Start of the filter window in ISO 8601 format
    </ResponseField>

    <ResponseField name="entry_window_end" type="string">
      End of the filter window in ISO 8601 format
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "schedule_entries": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Schedule Entries"
        },
        "pagination_meta": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Pagination Meta"
        }
      },
      "required": [
        "success"
      ],
      "title": "ScheduleEntriesListOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="schedule_overrides_create — Create a new schedule override in incident.io.">
    ### Parameters

    <ResponseField name="rotation_id" type="string" required>
      The ID of the rotation to override
    </ResponseField>

    <ResponseField name="layer_id" type="string" required>
      The ID of the layer this override applies to
    </ResponseField>

    <ResponseField name="schedule_id" type="string" required>
      The ID of the schedule
    </ResponseField>

    <ResponseField name="start_at" type="string" required>
      When the override starts in ISO 8601 format
    </ResponseField>

    <ResponseField name="end_at" type="string" required>
      When the override ends in ISO 8601 format
    </ResponseField>

    <ResponseField name="user_id" type="string">
      The ID of the user to assign
    </ResponseField>

    <ResponseField name="user_email" type="string">
      The email of the user to assign
    </ResponseField>

    <ResponseField name="user_slack_id" type="string">
      The Slack ID of the user to assign
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "override": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Override"
        }
      },
      "required": [
        "success"
      ],
      "title": "ScheduleOverridesCreateOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="escalation_paths_list — List escalation paths in incident.io.">
    ### Parameters

    <ResponseField name="page_size" type="integer">
      Number of results to return per page (e.g., 10, 25, 50)
    </ResponseField>

    <ResponseField name="after" type="string">
      Pagination cursor to fetch the next page of results
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "escalation_paths": {
          "items": {
            "additionalProperties": true,
            "type": "object"
          },
          "title": "Escalation Paths",
          "type": "array"
        },
        "pagination_meta": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Pagination Meta"
        }
      },
      "required": [
        "success"
      ],
      "title": "EscalationPathsListOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="escalation_paths_create — Create a new escalation path in incident.io.">
    ### Parameters

    <ResponseField name="name" type="string" required>
      Name of the escalation path
    </ResponseField>

    <ResponseField name="path" type="array" required>
      Array of escalation levels. Each level has targets (array of \{id, type, schedule\_id?, user\_id?, urgency}) and time\_to\_ack\_seconds
    </ResponseField>

    <ResponseField name="working_hours" type="array">
      Optional working hours config: array of \{weekday, start\_time, end\_time}
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "escalation_path": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Escalation Path"
        }
      },
      "required": [
        "success"
      ],
      "title": "EscalationPathsCreateOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="escalation_paths_show — Get details of a specific escalation path in incident.io.">
    ### Parameters

    <ResponseField name="id" type="string" required>
      The ID of the escalation path
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "escalation_path": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Escalation Path"
        }
      },
      "required": [
        "success"
      ],
      "title": "EscalationPathsShowOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="escalation_paths_update — Update an existing escalation path in incident.io.">
    ### Parameters

    <ResponseField name="id" type="string" required>
      The ID of the escalation path to update
    </ResponseField>

    <ResponseField name="name" type="string" required>
      New name for the escalation path
    </ResponseField>

    <ResponseField name="path" type="array" required>
      New escalation path: array of levels with targets and time\_to\_ack\_seconds
    </ResponseField>

    <ResponseField name="working_hours" type="array">
      New working hours config: array of \{weekday, start\_time, end\_time}
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "escalation_path": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Escalation Path"
        }
      },
      "required": [
        "success"
      ],
      "title": "EscalationPathsUpdateOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="escalation_paths_delete — Delete an escalation path in incident.io.">
    ### Parameters

    <ResponseField name="id" type="string" required>
      The ID of the escalation path to delete
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "message": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Message"
        }
      },
      "required": [
        "success"
      ],
      "title": "EscalationPathsDeleteOutput",
      "type": "object"
    }
    ```
  </Accordion>
</AccordionGroup>

## Limits & Quotas

* **Rate limit**: 1200 requests/minute per API key (default).
* **Endpoints**: most resources live under `/v2`; severities, incident
  statuses, and incident types are served under `/v1`.
* **Pagination**: list endpoints accept `page_size` plus an `after`
  cursor; the tools expose both as optional parameters and do not
  auto-loop — pass the returned cursor to fetch the next page.
* **Error model**: non-2xx responses and timeouts are caught and returned
  as `success=False` + `error` rather than raising. Plan retries on the
  agent side based on the error string.

## Related integrations

<CardGroup cols={3}>
  <Card title="CrowdStrike" href="/integrations/tools/crowdstrike" />

  <Card title="Datadog" href="/integrations/tools/datadog" />

  <Card title="Grafana" href="/integrations/tools/grafana" />
</CardGroup>

## Links

* [incident.io](https://incident.io)
