# Reopen incident

This will reopen a resolved incident.

[endpoint]
base_url = "https://uptime.betterstack.com"
path = "/api/v3/incidents/{incident_id}/reopen"
method = "POST"

[[path_param]]
name = "incident_id"
description = "The ID of the incident you want to reopen."
required = true
type = "string"

[[body_param]]
name = "reopened_by"
description = "User e-mail or a custom identifier of the entity that reopened the incident."
required = false
type = "string"

[[header]]
name = "Authorization"
description = "Bearer `$TOKEN`"
required = true
type = "string"

[/endpoint]

[responses]
[[response]]
status = 200
description = '''Returned when an incident was reopened successfully.'''
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"
        }
      }
    }
  }
}'''

[[response]]
status = 403
description = '''Returned when the incident is shared with your team, and you don't have permission to reopen it.'''
body = '''{
  "errors": "You can't reopen this incident because it was shared with your team."
}'''

[[response]]
status = 409
description = '''Returned when the incident is not resolved, the monitor has another open incident, or the reopen window has expired.'''
body = '''{
  "errors": "Incident is not resolved."
}'''

[/responses]

#### Example cURL

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

[info]
#### Looking for the details of a specific parameter?
Explore [the list of all incidents API parameters](https://betterstack.com/docs/uptime/api/incidents-api-response-params/)
[/info]