Explore documentation
  1. Welcome to Incidents 👋
  2. Frequently Asked Questions
  3. On-call scheduling and alerting
    1. Get started
    2. Slack and other integrations ↗
    3. Tag on-call in Slack
    4. Mobile apps ↗
    5. Connecting external calendars
    6. Advanced guide
  4. Incident management
    1. Get started
    2. Post mortems
    3. Metadata & Catalog
    4. Screening alerts
    5. Reporting ↗
  5. Monitoring
    1. Get started
    2. Working with monitors
    3. Customizing monitors
    4. Monitor types
  6. Status pages
    1. Get started
    2. Advanced guide
  7. Incidents API
    1. Getting an API token
    2. Pagination
    3. Monitors
    4. Heartbeats
    5. On-call & incidents
      1. On-call schedule
      2. On-call schedule events
      3. On-call schedule rotations
      4. Escalation policies
      5. Escalation policy groups
      6. Severities
      7. Severity groups
      8. Incidents
        1. List incidents GET
        2. Get incident GET
        3. List incident timeline GET
        4. Create incident POST
        5. Acknowledge incident POST
        6. Resolve incident POST
        7. Reopen incident POST
        8. Escalate incident POST
        9. Remove incident DELETE
      9. Comments
    6. Status pages
    7. Metadata
    8. Integrations
    9. Team members
    10. Organization roles
    11. Usage
    12. Reporting

Reopen incident

This will reopen a resolved incident.

POST https://incidents.betterstack.com/api/v3/incidents/{incident_id}/reopen

URL parameters

incident_id
required string

The ID of the incident you want to reopen.

Headers

Authorization
required string

Bearer $TOKEN

Body parameters

reopened_by
string

User e-mail or a custom identifier of the entity that reopened the incident.

200

Returned when an incident was reopened successfully.

Response body

{
  "data": {
    "id": "123456789",
    "type": "incident",
    "attributes": {
      "name": "uptime homepage",
      "url": "https://uptime.betterstack.com/",
      "http_method": "get",
      "cause": "Status 500",
      "incident_group_id": null,
      "started_at": "2020-03-09T17:37:56.662Z",
      "acknowledged_at": null,
      "acknowledged_by": null,
      "resolved_at": "2020-03-09T19:37:56.662Z",
      "resolved_by": "John Doe",
      "reopened_at": "2020-03-09T20:37:56.662Z",
      "reopened_by": "Jane Doe",
      "response_content": "\n404 Not Found\n\nNot Found\nThe requested URL /fail was not found on this server.\n",
      "response_options": "{}",
      "regions": [
        "us",
        "eu",
        "as",
        "au"
      ],
      "response_url": null,
      "screenshot_url": null,
      "origin_url": null,
      "escalation_policy_id": null,
      "call": true,
      "sms": true,
      "email": true,
      "push": true
    },
    "relationships": {
      "monitor": {
        "data": {
          "id": "2",
          "type": "monitor"
        }
      }
    }
  }
}
403

Returned when the incident is shared with your team, and you don't have permission to reopen it.

Response body

{
  "errors": "You can't reopen this incident because it was shared with your team."
}
409

Returned when the incident is not resolved, the monitor has another open incident, or the reopen window has expired.

Response body

{
  "errors": "Incident is not resolved."
}

Example cURL

Example
curl --request POST \
  --url https://incidents.betterstack.com/api/v3/incidents/123456/reopen \
  --header "Authorization: Bearer $TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{"reopened_by": "jane@example.com"}'


Previous article

Resolve incident

Next article

Escalate incident