---
title: "Open, update or resolve incidents from an alerting tool (Alertmanager, Grafana, or the generic JSON shape)"
method: POST
path: "/incidents/inbound/{token}"
tags: ["Incidents"]
---

# Open, update or resolve incidents from an alerting tool (Alertmanager, Grafana, or the generic JSON shape)

`POST /incidents/inbound/{token}`

## Request

- Base URL: `https://realuptime.io/api/v1`
- URL: `https://realuptime.io/api/v1/incidents/inbound/{token}`
- Auth: none required

## Path parameters

- `token` string, required

## Query parameters

- `source` 'generic' | 'alertmanager' | 'grafana'

## Request body

- union
  - object
    - `events` object[], required
      - `key` string, required
      - `status` 'firing' | 'resolved', required
      - `title` string
      - `body` string
      - `component` string
      - `region` 'iad' | 'sjc' | 'fra' | 'nrt' | 'ord' | 'yyz' | 'lhr' | 'sin' | 'syd' | 'gru'
      - `severity` string
  - object
    - `key` string, required
    - `status` 'firing' | 'resolved', required
    - `title` string
    - `body` string
    - `component` string
    - `region` 'iad' | 'sjc' | 'fra' | 'nrt' | 'ord' | 'yyz' | 'lhr' | 'sin' | 'syd' | 'gru'
    - `severity` string

## Response `200`

One result per event, in order: opened / updated / resolved / ignored / refused.

- object
  - `source` 'generic' | 'alertmanager' | 'grafana', required
  - `results` object[], required
    - `key` string, required
    - `action` 'opened' | 'updated' | 'resolved' | 'ignored' | 'refused', required
    - `incidentId` string, nullable, required
    - `reason` string

## Other responses

- `400`: Body not JSON, or not a recognized shape. - `RU-5005` Inbound incident payload not understood: https://realuptime.io/kb/errors/ru-5005
- `401`: Webhook has a signing secret and the X-RealUptime-Signature header is missing or wrong. - `RU-5006` Inbound incident signature missing or wrong: https://realuptime.io/kb/errors/ru-5006
- `404`: Unknown or revoked token (indistinguishable from outside). - `RU-5004` Inbound incident webhook token not recognized: https://realuptime.io/kb/errors/ru-5004
- `429`: Per-token budget exceeded; Retry-After says when. - `RU-5007` Inbound incident webhook rate limited: https://realuptime.io/kb/errors/ru-5007

---

[API](https://skmtc.dev/realuptime/apis/realuptime-api-v1.md) · [All operations](https://skmtc.dev/realuptime/apis/realuptime-api-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/realuptime/apis/realuptime-api-v1/revisions/51e481084700?raw)