# Incident

> The Incident object in the Guv API.

## Fields

| Field | Type | Description |
| --- | --- | --- |
| `id` * | string |  |
| `scope` * | `platform`, `project` |  |
| `title` * | string |  |
| `summary` | string or null |  |
| `severity` * | [IncidentSeverity](/docs/api/objects/incident-severity/) |  |
| `status` * | [IncidentStatus](/docs/api/objects/incident-status/) |  |
| `source` * | `alert`, `probe`, `detector`, `customer_report`, `agent`, `human` |  |
| `cell` | string or null |  |
| `workspace_id` | string or null |  |
| `project_id` | string or null |  |
| `affected` | array of [ResourceRef](/docs/api/objects/resource-ref/) |  |
| `opened_by` | [Actor](/docs/api/objects/actor/) |  |
| `assigned_agent` | string or null |  |
| `customer_visible` | boolean |  |
| `opened_at` * | string (date-time) |  |
| `mitigated_at` | string (date-time) or null |  |
| `resolved_at` | string (date-time) or null |  |
| `postmortem_url` | string (uri) or null |  |

\* always present

## Example

```json
{
  "id": "inc_01jbx2m9k7q4r8t5v6w3y0z1pr",
  "scope": "platform",
  "title": "api will run out of memory in about 6 hours",
  "summary": "string",
  "severity": "sev1",
  "status": "open",
  "source": "alert",
  "cell": "lon1-a",
  "workspace_id": "string",
  "project_id": "string",
  "affected": [
    {
      "type": "service",
      "id": "svc_01jbx2m9k7q4r8t5v6w3y0z1sv",
      "name": "web",
      "url": "/v1/projects/primecarers/services/web"
    }
  ],
  "opened_by": {
    "type": "agent",
    "id": "tok_01jbx2m9k7q4r8t5v6w3y0z1tk",
    "display": "Stewart Webb via agent claude-code-on-stewart-laptop",
    "via_agent": {
      "id": "tok_01jbx2m9k7q4r8t5v6w3y0z1tk",
      "name": "claude-code-on-stewart-laptop"
    },
    "on_behalf_of": {
      "id": "usr_01jbx2m9k7q4r8t5v6w3y0z1us",
      "display": "Stewart Webb"
    }
  },
  "assigned_agent": "sentinel",
  "customer_visible": false,
  "opened_at": "2026-10-22T13:05:00Z",
  "mitigated_at": "2026-10-22T13:05:00Z",
  "resolved_at": "2026-10-22T13:05:00Z",
  "postmortem_url": "https://guv.dev/"
}
```

## Used by

- [Open an incident](/docs/api/incidents/#open-an-incident)
- [Get an incident](/docs/api/incidents/#get-an-incident)
- [Update an incident](/docs/api/incidents/#update-an-incident)