End team maintenance

Ends team-wide maintenance now and resumes monitoring. Your team's Slack and Microsoft Teams integrations are notified that maintenance ended. On a team that isn't in maintenance, nothing changes.

An Incidents API token acts on its own team. With a global API token, pick the team with team_name or team_id. Read-only tokens can't end maintenance.

DELETE https://incidents.betterstack.com/api/v2/team-maintenance

Query parameters

team_name
string
team_id
string

Headers

Authorization
required string
204
401

Response body

{
  "errors": "Invalid Team API token. How to find your Team API token: https://betterstack.com/docs/uptime/api/getting-started-with-uptime-api/#get-an-incidents-api-token"
}
403

Response body

{
  "errors": "This API token is read-only and cannot be used for write operations."
}
422

Response body

{
  "errors": "This token has access to multiple teams. Please use `team_name` or `better_stack_team_id` to specify the team"
}

Example cURL

Example
curl --request DELETE \
  --url https://incidents.betterstack.com/api/v2/team-maintenance \
  --header "Authorization: Bearer $TOKEN"