PagerDuty

Nutzungsanweisungen

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.

Parameter	Typ	Erforderlich	Beschreibung
`apiKey`	string	Ja	PagerDuty REST API Key
`statuses`	string	Nein	Comma-separated statuses to filter (triggered, acknowledged, resolved)
`serviceIds`	string	Nein	Comma-separated service IDs to filter
`since`	string	Nein	Start date filter (ISO 8601 format)
`until`	string	Nein	End date filter (ISO 8601 format)
`sortBy`	string	Nein	Sort field (e.g., created_at:desc)
`limit`	string	Nein	Maximum number of results (max 100)

Parameter	Typ	Beschreibung
`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.

Parameter	Typ	Erforderlich	Beschreibung
`apiKey`	string	Ja	PagerDuty REST API Key
`fromEmail`	string	Ja	Email address of a valid PagerDuty user
`title`	string	Ja	Incident title/summary
`serviceId`	string	Ja	ID of the PagerDuty service
`urgency`	string	Nein	Urgency level (high or low)
`body`	string	Nein	Detailed description of the incident
`escalationPolicyId`	string	Nein	Escalation policy ID to assign
`assigneeId`	string	Nein	User ID to assign the incident to

Update an incident in PagerDuty (acknowledge, resolve, change urgency, etc.).

Parameter	Typ	Erforderlich	Beschreibung
`apiKey`	string	Ja	PagerDuty REST API Key
`fromEmail`	string	Ja	Email address of a valid PagerDuty user
`incidentId`	string	Ja	ID of the incident to update
`status`	string	Nein	New status (acknowledged or resolved)
`title`	string	Nein	New incident title
`urgency`	string	Nein	New urgency (high or low)
`escalationLevel`	string	Nein	Escalation level to escalate to

Add a note to an existing PagerDuty incident.

Parameter	Typ	Erforderlich	Beschreibung
`apiKey`	string	Ja	PagerDuty REST API Key
`fromEmail`	string	Ja	Email address of a valid PagerDuty user
`incidentId`	string	Ja	ID of the incident to add the note to
`content`	string	Ja	Note content text

Parameter	Typ	Beschreibung
`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.

Parameter	Typ	Erforderlich	Beschreibung
`apiKey`	string	Ja	PagerDuty REST API Key
`query`	string	Nein	Filter services by name
`limit`	string	Nein	Maximum number of results (max 100)

Parameter	Typ	Beschreibung
`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.

Parameter	Typ	Erforderlich	Beschreibung
`apiKey`	string	Ja	PagerDuty REST API Key
`escalationPolicyIds`	string	Nein	Comma-separated escalation policy IDs to filter
`scheduleIds`	string	Nein	Comma-separated schedule IDs to filter
`since`	string	Nein	Start time filter (ISO 8601 format)
`until`	string	Nein	End time filter (ISO 8601 format)
`limit`	string	Nein	Maximum number of results (max 100)

Parameter	Typ	Beschreibung
`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