PagerDuty tools
The 12 PagerDuty operations your product runs on your customer's account through Connect. All of them use the same endpoint, POST /api/tools/{tool}/execute.
- List incidentsGETLists the incidents of the account created in the last month, or in the range of since and until. There is no filter by status, service or assignee here, so read status, service and assignments in each item. Page with limit and offset while more is true.
- Get incidentGETReturns one incident with its status, urgency, priority, service, assignments, acknowledgements and escalation policy.
- Create incidentPOSTCreates an incident on a service, which notifies the escalation policy of the service, or the users in assignments. Needs type, title and service. Send assignments or escalation_policy, never both. An incident the user assigns to themselves starts acknowledged, without notifying them.
- Update incidentPUTAcknowledges, resolves, reassigns or escalates an incident, or changes its title, urgency, priority or service. Send type and only the fields to change. Reassigning or escalating notifies the new responders, and setting status on a resolved incident reopens it.
- List incident notesGETLists the notes of an incident, each with its content, author and creation time.
- Create incident notePOSTAdds a note to an incident, signed by the user of the connection. An incident holds up to 2000 notes.
- List incident log entriesGETLists the timeline of an incident: triggers, notifications, acknowledgements, assignments, escalations, notes and resolution, each with the agent and the time. Page with limit and offset while more is true.
- List servicesGETLists the services of the account, each with its id, name, status and escalation policy. The id is what Create incident and Update incident ask for. Page with limit and offset while more is true.
- List on-callsGETLists who is on call, one entry per user, escalation policy and level, with the schedule when the shift comes from one. Without since and until it returns the on-calls of right now. Page with limit and offset while more is true.
- List usersGETLists the users of the account, with id, name, email and role. The id goes in the assignee of Create incident and Update incident. Page with limit and offset while more is true.
- List escalation policiesGETLists the escalation policies of the account, each with its id, name and escalation rules. The id goes in the escalation_policy of Create incident and Update incident. Page with limit and offset while more is true.
- List prioritiesGETLists the incident priorities of the account, from the most to the least severe, such as P1 to P5. The id goes in the priority of Create incident and Update incident. An account that has not set up priorities has none.
Toolkits in the same category
See all 100 toolkitsSee Connect applied to your product.
Try it for 15 days with no card, or walk our team through your use case.
