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

# Receive an incident from PagerDuty

> Called by PagerDuty only. A triggered incident is investigated; a resolved one becomes a postmortem draft.

This is the URL of a PagerDuty **Generic Webhook (v3)** subscription. You do not call it yourself:
the DevOps page shows the exact address beside your attached PagerDuty connection.

It takes no API key. PagerDuty signs every request with the subscription's signing secret, and
`X-PagerDuty-Signature` (`v1=<hex>`, several while PagerDuty rotates the secret) is checked over the
exact bytes before anything in the body is read. The secret is the one saved with the PagerDuty
connection the address names; without one nothing is accepted. A request that does not verify is
`401`. It acts as the person who attached the connection, checked again on every request.

> [!WARNING]
>
> AI employees are in **beta**. This answers `404` unless your deployment has switched on the beta
> and picking up work by itself, and for an address no DevOps attachment holds. Not yet run against
> a real PagerDuty account. See [DevOps](https://docs.mithunai.com/team/devops.md).

**credential\_id** `string` *required*

The saved PagerDuty connection attached to the DevOps employee.

## What is read

| `event.event_type` | Becomes |
| - | - |
| `incident.triggered` | An alert on the incident (`pagerduty-<incident id>`), investigated |
| `incident.resolved` | A postmortem to draft for the same incident |
| anything else | Nothing: answered `200` |

From `event.data` it reads the incident's `id`, `title`, `urgency` and service name (as a slug:
"Checkout API" is `checkout-api`). Nothing here can resolve an incident.

## Response

**results** `object[]` *required*

One per item filed, with `service`, `title`, `status` and `task_id`; empty when nothing was.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.