Manage incidents and on-call schedules with PagerDuty
Integrate PagerDuty into your workflow to list, create, and update incidents, add notes, list services, and check on-call schedules.
List incidents from PagerDuty with optional filters.
| 参数 | 类型 | 必填 | 描述 |
|---|
apiKey | string | 是 | PagerDuty REST API Key |
statuses | string | 否 | Comma-separated statuses to filter (triggered, acknowledged, resolved) |
serviceIds | string | 否 | Comma-separated service IDs to filter |
since | string | 否 | Start date filter (ISO 8601 format) |
until | string | 否 | End date filter (ISO 8601 format) |
sortBy | string | 否 | Sort field (e.g., created_at:desc) |
limit | string | 否 | Maximum number of results (max 100) |
| 参数 | 类型 | 描述 |
|---|
incidents | array | Array of incidents |
↳ id | string | Incident ID |
↳ incidentNumber | number | Incident number |
↳ title | string | Incident title |
↳ status | string | Incident status |
↳ urgency | string | Incident urgency |
↳ createdAt | string | Creation timestamp |
↳ updatedAt | string | Last updated timestamp |
↳ serviceName | string | Service name |
↳ serviceId | string | Service ID |
↳ assigneeName | string | Assignee name |
↳ assigneeId | string | Assignee ID |
↳ escalationPolicyName | string | Escalation policy name |
↳ htmlUrl | string | PagerDuty web URL |
total | number | Total number of matching incidents |
more | boolean | Whether more results are available |
Create a new incident in PagerDuty.
| 参数 | 类型 | 必填 | 描述 |
|---|
apiKey | string | 是 | PagerDuty REST API Key |
fromEmail | string | 是 | Email address of a valid PagerDuty user |
title | string | 是 | Incident title/summary |
serviceId | string | 是 | ID of the PagerDuty service |
urgency | string | 否 | Urgency level (high or low) |
body | string | 否 | Detailed description of the incident |
escalationPolicyId | string | 否 | Escalation policy ID to assign |
assigneeId | string | 否 | User ID to assign the incident to |
| 参数 | 类型 | 描述 |
|---|
id | string | Created incident ID |
incidentNumber | number | Incident number |
title | string | Incident title |
status | string | Incident status |
urgency | string | Incident urgency |
createdAt | string | Creation timestamp |
serviceName | string | Service name |
serviceId | string | Service ID |
htmlUrl | string | PagerDuty web URL |
Update an incident in PagerDuty (acknowledge, resolve, change urgency, etc.).
| 参数 | 类型 | 必填 | 描述 |
|---|
apiKey | string | 是 | PagerDuty REST API Key |
fromEmail | string | 是 | Email address of a valid PagerDuty user |
incidentId | string | 是 | ID of the incident to update |
status | string | 否 | New status (acknowledged or resolved) |
title | string | 否 | New incident title |
urgency | string | 否 | New urgency (high or low) |
escalationLevel | string | 否 | Escalation level to escalate to |
| 参数 | 类型 | 描述 |
|---|
id | string | Incident ID |
incidentNumber | number | Incident number |
title | string | Incident title |
status | string | Updated status |
urgency | string | Updated urgency |
updatedAt | string | Last updated timestamp |
htmlUrl | string | PagerDuty web URL |
Add a note to an existing PagerDuty incident.
| 参数 | 类型 | 必填 | 描述 |
|---|
apiKey | string | 是 | PagerDuty REST API Key |
fromEmail | string | 是 | Email address of a valid PagerDuty user |
incidentId | string | 是 | ID of the incident to add the note to |
content | string | 是 | Note content text |
| 参数 | 类型 | 描述 |
|---|
id | string | Note ID |
content | string | Note content |
createdAt | string | Creation timestamp |
userName | string | Name of the user who created the note |
List services from PagerDuty with optional name filter.
| 参数 | 类型 | 必填 | 描述 |
|---|
apiKey | string | 是 | PagerDuty REST API Key |
query | string | 否 | Filter services by name |
limit | string | 否 | Maximum number of results (max 100) |
| 参数 | 类型 | 描述 |
|---|
services | array | Array of services |
↳ id | string | Service ID |
↳ name | string | Service name |
↳ description | string | Service description |
↳ status | string | Service status |
↳ escalationPolicyName | string | Escalation policy name |
↳ escalationPolicyId | string | Escalation policy ID |
↳ createdAt | string | Creation timestamp |
↳ htmlUrl | string | PagerDuty web URL |
total | number | Total number of matching services |
more | boolean | Whether more results are available |
List current on-call entries from PagerDuty.
| 参数 | 类型 | 必填 | 描述 |
|---|
apiKey | string | 是 | PagerDuty REST API Key |
escalationPolicyIds | string | 否 | Comma-separated escalation policy IDs to filter |
scheduleIds | string | 否 | Comma-separated schedule IDs to filter |
since | string | 否 | Start time filter (ISO 8601 format) |
until | string | 否 | End time filter (ISO 8601 format) |
limit | string | 否 | Maximum number of results (max 100) |
| 参数 | 类型 | 描述 |
|---|
oncalls | array | Array of on-call entries |
↳ userName | string | On-call user name |
↳ userId | string | On-call user ID |
↳ escalationLevel | number | Escalation level |
↳ escalationPolicyName | string | Escalation policy name |
↳ escalationPolicyId | string | Escalation policy ID |
↳ scheduleName | string | Schedule name |
↳ scheduleId | string | Schedule ID |
↳ start | string | On-call start time |
↳ end | string | On-call end time |
total | number | Total number of matching on-call entries |
more | boolean | Whether more results are available |
