# Incident routes: acknowledge, open, resolve

URL: /code/api/incident/verbs · Id: `page:code/api/incident/verbs`

> The Incident Verbs acknowledge, open, resolve as api.sb routes, with inputs, result, refusals and an example.

Reference for [Incident](/business/nouns/incident), one group of [Incident routes](/code/api/incident).

### Incident.acknowledge
Acknowledge records that an on-call Worker owns an open Incident and stops its escalation. [Verb page](/business/nouns/incident/acknowledge?interface=api).

```text
POST /{namespace}/incidents/{incident}/acknowledge
```

Path: `incident`. Emits [`Incident.acknowledged`](/business/events/Incident.acknowledged).

**Inputs**

| Input | Type | Required | Description |
| --- | --- | --- | --- |
| `incident` | [Incident](/business/nouns/incident) | Yes | The open Incident. |

**Returns**

| Output | Type | Required | Description |
| --- | --- | --- | --- |
| `incident` | [Incident](/business/nouns/incident) | Yes | The acknowledged Incident. |

**Refuses when**

| Check | Error | Fix | Then call |
| --- | --- | --- | --- |
| The key is valid, but its scopes do not allow this operation. | [`forbidden`](/code/api/errors/forbidden) | Use a key whose scopes cover the operation, or ask an owner of the namespace to grant them. | None. |

**Example**

```bash
curl -X POST https://api.sb/leaseline.app/incidents/incident_2XOYkIEno0/acknowledge \
  -H "Authorization: Bearer $STARTUP_BUILDER_API_KEY"
```

```json
{
  "api": "https://api.sb/leaseline.app",
  "incident": {
    "$id": "https://api.sb/leaseline.app/incidents/incident_2XOYkIEno0",
    "$type": "Incident",
    "status": "pending",
    "mode": "try",
    "severity": "minor",
    "detectedAt": "2026-10-22T12:00:00Z"
  },
  "action": {
    "$id": "https://api.sb/leaseline.app/actions/act_br07HsG8MG",
    "operation": "Incident.acknowledge",
    "status": "done"
  },
  "links": {
    "self": "https://api.sb/leaseline.app/actions/act_br07HsG8MG"
  }
}
```

### Incident.open
Open starts an Incident from a failing Monitor, an error spike or a Metric past its threshold, and pages the on-call Worker. [Verb page](/business/nouns/incident/open?interface=api).

```text
POST /{namespace}/incidents/open
```

Body, as JSON: the inputs. Emits [`Incident.opened`](/business/events/Incident.opened).

**Inputs**

| Input | Type | Required | Description |
| --- | --- | --- | --- |
| `severity` | `string` | Yes | `sev1` stops Customers, `sev2` degrades a core path, `sev3` degrades one feature. |
| `cause` | `string` | Yes | The Monitor, error group or Metric that tripped it. |

**Returns**

| Output | Type | Required | Description |
| --- | --- | --- | --- |
| `incident` | [Incident](/business/nouns/incident) | Yes | The open Incident. |

**Refuses when**

| Check | Error | Fix | Then call |
| --- | --- | --- | --- |
| The key is valid, but its scopes do not allow this operation. | [`forbidden`](/code/api/errors/forbidden) | Use a key whose scopes cover the operation, or ask an owner of the namespace to grant them. | None. |

**Example**

```bash
curl -X POST https://api.sb/leaseline.app/incidents/open \
  -H "Authorization: Bearer $STARTUP_BUILDER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"severity":"sev1","cause":"Example cause"}'
```

```json
{
  "api": "https://api.sb/leaseline.app",
  "incident": {
    "$id": "https://api.sb/leaseline.app/incidents/incident_2XOYkIEno0",
    "$type": "Incident",
    "status": "pending",
    "mode": "try",
    "severity": "minor",
    "detectedAt": "2026-10-22T12:00:00Z"
  },
  "action": {
    "$id": "https://api.sb/leaseline.app/actions/act_br07HsG8MG",
    "operation": "Incident.open",
    "status": "done"
  },
  "links": {
    "self": "https://api.sb/leaseline.app/actions/act_br07HsG8MG"
  }
}
```

### Incident.resolve
Resolve closes an Incident once its Monitors pass, posts the resolution to the status page and opens the review Task. [Verb page](/business/nouns/incident/resolve?interface=api).

```text
POST /{namespace}/incidents/{incident}/resolve
```

Path: `incident`. Body, as JSON: the other inputs. Emits [`Incident.resolved`](/business/events/Incident.resolved).

**Inputs**

| Input | Type | Required | Description |
| --- | --- | --- | --- |
| `incident` | [Incident](/business/nouns/incident) | Yes | The Incident to close. |
| `summary` | `text` | Yes | What failed and what fixed it. |

**Returns**

| Output | Type | Required | Description |
| --- | --- | --- | --- |
| `incident` | [Incident](/business/nouns/incident) | Yes | The resolved Incident. |

**Refuses when**

| Check | Error | Fix | Then call |
| --- | --- | --- | --- |
| The key is valid, but its scopes do not allow this operation. | [`forbidden`](/code/api/errors/forbidden) | Use a key whose scopes cover the operation, or ask an owner of the namespace to grant them. | None. |

**Example**

```bash
curl -X POST https://api.sb/leaseline.app/incidents/incident_2XOYkIEno0/resolve \
  -H "Authorization: Bearer $STARTUP_BUILDER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"summary":"Example summary"}'
```

```json
{
  "api": "https://api.sb/leaseline.app",
  "incident": {
    "$id": "https://api.sb/leaseline.app/incidents/incident_2XOYkIEno0",
    "$type": "Incident",
    "status": "pending",
    "mode": "try",
    "severity": "minor",
    "detectedAt": "2026-10-22T12:00:00Z"
  },
  "action": {
    "$id": "https://api.sb/leaseline.app/actions/act_br07HsG8MG",
    "operation": "Incident.resolve",
    "status": "done"
  },
  "links": {
    "self": "https://api.sb/leaseline.app/actions/act_br07HsG8MG"
  }
}
```