PagerDuty integration

Lets your app list, open, acknowledge and resolve PagerDuty incidents, add notes to them, and read services, schedules and who is on call.

Connecting

On the Integrations page choose Connect on PagerDuty and fill in:

• User API token — PagerDuty → your avatar → My Profile → User Settings → Create API User Token.

Sapilon checks the key with the provider before it saves it, and stores it encrypted; it is never shown again.

• Incidents are opened and changed as the user whose token you use.

What your app can do

Only these requests are available; anything else is refused.

• GET /users/me
• GET|POST /incidents
• GET|PUT /incidents/*
• GET|POST /incidents/*/notes
• GET /services
• GET /oncalls
• GET /schedules

How the agent uses it

Use integrations.request('pagerduty', …); paths are relative to https://api.pagerduty.com.

• GET /incidents — query: { 'statuses[]': 'triggered', limit: '25' }.
• POST /incidents — needs headers: { From: '<the user's email>' }. Example: { method: 'POST', path: '/incidents', headers: { From: 'ops@acme.com' }, body: { incident: { type: 'incident', title: 'Checkout failing', service: { id: 'PSVC12', type: 'service_reference' }, urgency: 'high' } } }.
• GET|PUT /incidents/{id} — acknowledge or resolve: body: { incident: { type: 'incident', status: 'resolved' } } (with From).
• GET|POST /incidents/{id}/notes — body: { note: { content: 'Rolled back' } } (with From).
• GET /services, GET /schedules, GET /oncalls (query: { 'schedule_ids[]': 'PSCH1' }), GET /users/me.

Deleting is not allowed.

More from PagerDuty: https://developer.pagerduty.com/api-reference/