# Incidents — API reference

> Open, acknowledge, comment, escalate, resolve. REST endpoints with request and response fields, examples in curl, JavaScript, Python, Go and PHP, and an in-browser Try it console.

Source: https://upfour.io/docs/api/incidents

[Developers](https://upfour.io/docs/api.md)/Alerting & response

Open, acknowledge, comment, escalate, resolve.

Base URL `https://app.upfour.io/v1`. Send your key as `Authorization: Bearer <key>`; every key acts on your real Company, so [test without paging anyone](https://upfour.io/docs/api/testing.md). New here? Start with the [quickstart](https://upfour.io/docs/api/quickstart.md). The examples read the key from `UP4_API_KEY`.

## Everyday

[GET **List incidents** /incidents](https://upfour.io/docs/api/incidents/list-incidents.md)[POST **Create an incident** /incidents](https://upfour.io/docs/api/incidents/create-an-incident.md)[GET **Get an incident** /incidents/{incidentID}](https://upfour.io/docs/api/incidents/get-an-incident.md)

## Control

[POST **Acknowledge an incident** /incidents/{incidentID}/acknowledge](https://upfour.io/docs/api/incidents/acknowledge-an-incident.md)[PUT **Acknowledge an incident using PUT** /incidents/{incidentID}/acknowledge](https://upfour.io/docs/api/incidents/acknowledge-an-incident-using-put.md)[POST **Escalate an incident** /incidents/{incidentID}/escalate](https://upfour.io/docs/api/incidents/escalate-an-incident.md)[POST **Reopen an incident** /incidents/{incidentID}/reopen](https://upfour.io/docs/api/incidents/reopen-an-incident.md)[PUT **Reopen an incident using PUT** /incidents/{incidentID}/reopen](https://upfour.io/docs/api/incidents/reopen-an-incident-using-put.md)[POST **Resolve an incident** /incidents/{incidentID}/resolve](https://upfour.io/docs/api/incidents/resolve-an-incident.md)[PUT **Resolve an incident using PUT** /incidents/{incidentID}/resolve](https://upfour.io/docs/api/incidents/resolve-an-incident-using-put.md)

## Communication

[GET **List incident comments** /incidents/{incidentID}/comments](https://upfour.io/docs/api/incidents/list-incident-comments.md)[POST **Add an incident comment** /incidents/{incidentID}/comments](https://upfour.io/docs/api/incidents/add-an-incident-comment.md)[DEL **Delete an incident comment** /incidents/{incidentID}/comments/{commentID}](https://upfour.io/docs/api/incidents/delete-an-incident-comment.md)[GET **Get an incident timeline** /incidents/{incidentID}/timeline](https://upfour.io/docs/api/incidents/get-an-incident-timeline.md)[POST **Add an incident update** /incidents/{incidentID}/updates](https://upfour.io/docs/api/incidents/add-an-incident-update.md)

## Context

[GET **List incident attachments** /incidents/{incidentID}/attachments](https://upfour.io/docs/api/incidents/list-incident-attachments.md)[POST **Upload an incident attachment** /incidents/{incidentID}/attachments](https://upfour.io/docs/api/incidents/upload-an-incident-attachment.md)[DEL **Delete an incident attachment** /incidents/{incidentID}/attachments/{attachmentID}](https://upfour.io/docs/api/incidents/delete-an-incident-attachment.md)[GET **Get an incident attachment** /incidents/{incidentID}/attachments/{attachmentID}](https://upfour.io/docs/api/incidents/get-an-incident-attachment.md)[GET **Get an incident domain case** /incidents/{incidentID}/domain-case](https://upfour.io/docs/api/incidents/get-an-incident-domain-case.md)[GET **Get an incident group** /incidents/{incidentID}/group](https://upfour.io/docs/api/incidents/get-an-incident-group.md)

## Analysis and playbooks

[GET **Get incident AI details** /incidents/{incidentID}/ai](https://upfour.io/docs/api/incidents/get-incident-ai-details.md)[POST **Generate an incident postmortem** /incidents/{incidentID}/ai/postmortem](https://upfour.io/docs/api/incidents/generate-an-incident-postmortem.md)[POST **Generate an incident summary** /incidents/{incidentID}/ai/summary](https://upfour.io/docs/api/incidents/generate-an-incident-summary.md)[PUT **Rate an incident AI result** /incidents/{incidentID}/ai/{kind}/rating](https://upfour.io/docs/api/incidents/rate-an-incident-ai-result.md)[GET **Get incident playbook progress** /incidents/{incidentID}/runbook-progress](https://upfour.io/docs/api/incidents/get-incident-playbook-progress.md)[PUT **Update incident playbook step completion** /incidents/{incidentID}/runbook-steps/{stepID}/completion](https://upfour.io/docs/api/incidents/update-incident-playbook-step-completion.md)