# IncidentEvent

> The IncidentEvent object in the Guv API.

## Fields

| Field | Type | Description |
| --- | --- | --- |
| `id` * | string |  |
| `incident_id` * | string |  |
| `at` * | string (date-time) |  |
| `actor` | [Actor](/docs/api/objects/actor/) |  |
| `kind` * | `note`, `status_change`, `signal`, `tool_call`, `policy_decision`, `customer_notice` |  |
| `message` * | string |  |
| `data` | object |  |

\* always present

## Example

```json
{
  "id": "string",
  "incident_id": "string",
  "at": "2026-10-22T13:05:00Z",
  "actor": {
    "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"
    }
  },
  "kind": "note",
  "message": "string",
  "data": {}
}
```

## Used by

- [Add to the timeline](/docs/api/incidents/#add-to-the-timeline)