Get incident

GET/api/watch/incidents/{id}

Returns one incident with the logs captured when the restart was detected.

Authorizations

Authorizationstringheader

The token you start the server with: homebutler serve --token <token>, or web.token in the config file. Send it as Authorization: Bearer <token>. When the server has a token, every /api/ route except the CORS preflight requires it, reads included.

Path parameters

idstringrequired

The incident id, from List incidents.

Example: flaky-20261025-113501.277-3c009f

Response

200 · application/json

The incident with its logs.

idstringrequired

The incident id.

containerstringrequired

The watch target that restarted.

detected_atstring<date-time>required

When the restart was detected.

restart_countintegerrequired

Docker's restart count at detection.

prev_started_atstringrequired

When the previous run started, RFC 3339 in UTC, or an empty string when unknown.

curr_started_atstringrequired

When the current run started, RFC 3339 in UTC, or an empty string when unknown.

pre_logsstringrequired

Logs captured before the restart. Empty in a list.

post_logsstringrequired

Logs captured at detection. Empty in a list.

exit_codeinteger

The exit code of the previous run.

oom_killedboolean

true when the kernel killed the process for memory.

recoveredboolean

true when the target is running again.

sourcestring

Where the incident was detected.

proxmox_classstring

The failure class, for a Proxmox guest.

proxmox_statestring

The guest state, for a Proxmox guest.

crash_analysisobject

flappingobject

cURLcURLPythonJavaScript

curl --request GET \
  --url 'http://localhost:8080/api/watch/incidents/{id}' \
  --header 'Authorization: Bearer <token>'

{
  "id": "flaky-20261025-115840.172-50551e",
  "container": "flaky",
  "detected_at": "2026-10-25T11:58:40.172139897-07:00",
  "restart_count": 6,
  "prev_started_at": "2026-10-25T18:58:24.350797511Z",
  "curr_started_at": "2026-10-25T18:58:35.810745971Z",
  "pre_logs": "(captured at detection — see post_logs for current state)",
  "post_logs": "booting\nfatal: out of cheese\nbooting\nfatal: out of cheese\nbooting\nfatal: out of cheese\nbooting\nfatal: out of cheese\nbooting\nfatal: out of cheese\nbooting\nfatal: out of cheese\nbooting"
}