---
title: "POST /run-status/snapshot"
method: POST
path: "/run-status/snapshot"
tags: ["Run Status"]
---

# POST /run-status/snapshot

`POST /run-status/snapshot`

## Request

- Base URL: `https://api.laver.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.laver.app/run-status/snapshot`
- Auth: one of:
  - HTTP bearer
  - API key in header `Authorization`

## Request body

- object
  - `started_at` string, date-time, required
  - `workers` integer, required
  - `dry_run` boolean
  - `board_uuid` string, uuid
  - `board_name` string
  - `machine_id` string
  - `machine_name` string
  - `runner_pid` integer, nullable
  - `source_column` string
  - `paused` object[]
    - `provider` string, required
    - `reason` string
    - `until` string, date-time, nullable
    - `host` string, nullable
  - `paused_until` string, date-time, nullable
  - `state_path` string
  - `events_path` string
  - `counts` object
  - `windows` object
    - `today` object
      - `since` string, date-time, nullable
      - `counts` object
    - `week` object
      - `since` string, date-time, nullable
      - `counts` object
    - `month` object
      - `since` string, date-time, nullable
      - `counts` object
  - `headline` object, nullable
    - `deployed_today` integer
    - `first_pass_rate` integer, nullable
    - `repair_rate` integer, nullable
    - `false_success` integer, nullable
    - `integration_conflicts` integer, nullable
  - `pipeline` string[]
  - `recent` object[]
    - `uuid` string, required
    - `state` string, required
    - `title` string
    - `provider` string, nullable
    - `agent_pid` integer, nullable
    - `transcript_path` string, nullable
    - `stage` string, nullable
    - `stage_index` integer
    - `retrying` boolean
    - `state_since` string, date-time, nullable
    - `agent_alive` boolean, nullable
    - `last_activity_at` string, date-time, nullable
    - `runtime_ms` integer, nullable
    - `remaining_ms` integer, nullable
    - `turns` integer, nullable
    - `last_action` string, nullable
    - `reason` string, nullable
    - `cost_usd` number, nullable
    - `metrics_from_transcript` boolean
  - `active` object[]
    - `uuid` string, required
    - `state` string, required
    - `title` string
    - `provider` string, nullable
    - `agent_pid` integer, nullable
    - `transcript_path` string, nullable
    - `stage` string, nullable
    - `stage_index` integer
    - `retrying` boolean
    - `state_since` string, date-time, nullable
    - `agent_alive` boolean, nullable
    - `last_activity_at` string, date-time, nullable
    - `runtime_ms` integer, nullable
    - `remaining_ms` integer, nullable
    - `turns` integer, nullable
    - `last_action` string, nullable
    - `reason` string, nullable
    - `cost_usd` number, nullable
    - `metrics_from_transcript` boolean
  - `live` object[]
    - `uuid` string, required
    - `state` string, required
    - `title` string
    - `provider` string, nullable
    - `agent_pid` integer, nullable
    - `transcript_path` string, nullable
    - `stage` string, nullable
    - `stage_index` integer
    - `retrying` boolean
    - `state_since` string, date-time, nullable
    - `agent_alive` boolean, nullable
    - `last_activity_at` string, date-time, nullable
    - `runtime_ms` integer, nullable
    - `remaining_ms` integer, nullable
    - `turns` integer, nullable
    - `last_action` string, nullable
    - `reason` string, nullable
    - `cost_usd` number, nullable
    - `metrics_from_transcript` boolean
  - `draining` object, nullable
    - `since` string, date-time, nullable
    - `remaining` string[]
  - `applied_commands` string[]
  - `outcome` union
    - 'stopped'
    - 'finished'
    - 'error'
    - 'crashed'
  - `error` string, nullable
  - `error_origin` string, nullable

## Response `2XX`

Success. This endpoint declares no response schema, so its body is not part of the generated contract.

## Other responses

- `400`: The request failed schema validation, or the handler rejected its contents. Undeclared properties are rejected on every body, path and query schema, so an unexpected field is a 400 rather than a silently ignored one.
- `401`: No credential, or one that is expired, revoked or not accepted by this endpoint.
- `429`: The rate limit was exceeded. The budget is keyed on the authenticated session user or API key, falling back to the caller IP.

---

[API](https://skmtc.dev/laver/apis/laver-api.md) · [All operations](https://skmtc.dev/laver/apis/laver-api/llms.txt) · [OpenAPI document](https://skmtc.dev/laver/apis/laver-api/revisions/91e3db25a19c?raw)