PagerDuty
Connects to the PagerDuty REST API. An agent can list, create, acknowledge, and resolve incidents, list services, and find who's on-call.
Add to an agent node's tools array with _node_type: "tool-pagerduty". See Connector Reference — How connectors are used.
Authentication
| Field | Required | Description |
|---|---|---|
api_token | Yes | PagerDuty REST API token, sent as Authorization: Token token=<api_token>. |
from_email | No | Email address sent as the From header, required by PagerDuty for some write endpoints. |
{
"name": "pagerduty",
"_node_type": "tool-pagerduty",
"api_token": "{{ secret.PAGERDUTY_API_TOKEN }}",
"from_email": "ops@example.com"
}
Tools
pd_list_incidents
List PagerDuty incidents filtered by status or service.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
status | string | No | Filter by status: triggered, acknowledged, resolved |
service | string | No | Filter by service ID |
limit | number | No | Max incidents (default 20) |
Returns: A newline-separated list of [<id>] <status> <title> lines, or "No incidents found.". Sorted by creation time, newest first.
pd_create_incident
Create a new PagerDuty incident and trigger alerts.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
title | string | Yes | Incident title |
service_id | string | Yes | PagerDuty service ID |
urgency | string | No | high or low (default high) |
details | string | No | Incident body/description |
escalation_policy | string | No | Escalation policy ID (accepted as input but not currently included in the request body) |
Returns: A confirmation message with the new incident's title and ID.
pd_resolve_incident
Resolve a PagerDuty incident, ending all active alerts.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Incident ID |
note | string | No | Resolution or acknowledgement note (accepted as input but not currently sent in the request) |
Returns: A confirmation message: Incident <id> resolved..
pd_acknowledge_incident
Acknowledge a PagerDuty incident to stop re-notifying.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Incident ID |
note | string | No | Resolution or acknowledgement note (accepted as input but not currently sent in the request) |
Returns: A confirmation message: Incident <id> acknowledged..
pd_list_services
List PagerDuty services and their current status.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
limit | number | No | Max services (default 25) |
Returns: A newline-separated list of [<id>] <name> status=<status> lines.
pd_who_is_on_call
Find who is currently on-call for a schedule or all schedules.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
schedule_id | string | No | Schedule ID (empty = all schedules) |
Returns: A newline-separated list of <user> on-call for: <escalation policy> lines, or "No on-call entries found.".