---
title: "Read a coherent browser snapshot"
method: GET
path: "/api/v1/ui/snapshot"
---

# Read a coherent browser snapshot

`GET /api/v1/ui/snapshot`

Returns 304 without projection reads when If-None-Match matches the current durable cursor, normalized intent, and effective capabilities.

## Query parameters

- `view` string
- `project_uid` string
- `status` string[]
- `owner` string[]
- `label` string[]
- `relationship` string[]
- `text` string
- `selected_issue_uid` string
- `include_graph` boolean
- `include_history` boolean
- `local_date` string
- `time_zone` string
- `limit` integer

## Headers

- `If-None-Match` string

## Response `200`

OK

- UISnapshotResponseBody
  - `capabilities` UICapabilities, required
    - `actor_policy` string, required
    - `allowed_actions` string[]
    - `close_requires_evidence` boolean
    - `expires_at` string, date-time
    - `scope` TokenScopeOut
      - `kind` 'issue_subtree', required
      - `project_uid` string, required
      - `root_issue_uid` string, required
    - `token_audit_read` boolean
    - `updates` 'sse' | 'poll', required
    - `writable` boolean, required
  - `catalog` UIProject[], required
    - `project` ProjectOut, required
      - `active` boolean, required
      - `created_at` string, date-time, required
      - `deleted_at` string, date-time
      - `id` integer, required
      - `metadata` object, required
      - `name` string, required
      - `revision` integer, required
      - `stats` ProjectStatsOut
        - `closed` integer, required
        - `last_event_at` string, date-time, nullable, required
        - `open` integer, required
      - `uid` string, required
    - `stats` ProjectStats
      - `Closed` integer, required
      - `LastEventAt` string, date-time, nullable, required
      - `Open` integer, required
  - `collection` UIIssue[], required
    - `assignment_expires_on` string, date-time
    - `author` string, required
    - `body` string, required
    - `closed_at` string, date-time
    - `closed_reason` string
    - `created_at` string, date-time, required
    - `deadline_on_date` string
    - `deleted_at` string, date-time
    - `id` integer, required
    - `labels` string[], required
    - `metadata` object, required
    - `occurrence_key` string
    - `owner` string
    - `priority` integer
    - `project_id` integer, required
    - `project_name` string, required
    - `project_uid` string
    - `qualified_id` string, required
    - `recurrence_id` integer
    - `revision` integer, required
    - `scheduled_on_date` string
    - `short_id` string, required
    - `status` string, required
    - `title` string, required
    - `uid` string, required
    - `updated_at` string, date-time, required
  - `collection_links` UILink[], required
    - `author` string, required
    - `created_at` string, date-time, required
    - `from_issue_id` integer, required
    - `from_issue_uid` string, required
    - `from_qualified_id` string, required
    - `from_status` string, required
    - `id` integer, required
    - `to_issue_id` integer, required
    - `to_issue_uid` string, required
    - `to_qualified_id` string, required
    - `to_status` string, required
    - `type` string, required
  - `contract_version` string, required
  - `cursor` integer, required
  - `graph` UIGraph
    - `edges` UIGraphEdge[], required
      - `from_uid` string, required
      - `kind` string, required
      - `layout` boolean, required
      - `to_uid` string, required
    - `issues` UIIssue[], required
      - `assignment_expires_on` string, date-time
      - `author` string, required
      - `body` string, required
      - `closed_at` string, date-time
      - `closed_reason` string
      - `created_at` string, date-time, required
      - `deadline_on_date` string
      - `deleted_at` string, date-time
      - `id` integer, required
      - `labels` string[], required
      - `metadata` object, required
      - `occurrence_key` string
      - `owner` string
      - `priority` integer
      - `project_id` integer, required
      - `project_name` string, required
      - `project_uid` string
      - `qualified_id` string, required
      - `recurrence_id` integer
      - `revision` integer, required
      - `scheduled_on_date` string
      - `short_id` string, required
      - `status` string, required
      - `title` string, required
      - `uid` string, required
      - `updated_at` string, date-time, required
    - `links` UILink[], required
      - `author` string, required
      - `created_at` string, date-time, required
      - `from_issue_id` integer, required
      - `from_issue_uid` string, required
      - `from_qualified_id` string, required
      - `from_status` string, required
      - `id` integer, required
      - `to_issue_id` integer, required
      - `to_issue_uid` string, required
      - `to_qualified_id` string, required
      - `to_status` string, required
      - `type` string, required
    - `unresolved_refs` UIGraphUnresolvedRef[], required
      - `kind` string, required
      - `other_uid` string, required
      - `side` string, required
      - `uid` string, required
  - `origin` string, required
  - `origin_stable` boolean, required
  - `selected` UISelectedAuthority
    - `comments` Comment[], required
      - `author` string, required
      - `body` string, required
      - `created_at` string, date-time, required
      - `id` integer, required
      - `issue_id` integer, required
      - `teammate` string
      - `uid` string, required
    - `history` Event[], required
      - `actor` string, required
      - `content_hash` string, required
      - `created_at` string, date-time, required
      - `hlc_counter` integer, required
      - `hlc_physical_ms` integer, required
      - `id` integer, required
      - `issue_id` integer
      - `issue_short_id` string
      - `issue_uid` string
      - `origin_instance_uid` string, required
      - `payload` string, required
      - `project_id` integer, required
      - `project_name` string, required
      - `project_uid` string, required
      - `related_issue_id` integer
      - `related_issue_short_id` string
      - `related_issue_uid` string
      - `type` string, required
      - `uid` string, required
    - `issue` UIIssue
      - `assignment_expires_on` string, date-time
      - `author` string, required
      - `body` string, required
      - `closed_at` string, date-time
      - `closed_reason` string
      - `created_at` string, date-time, required
      - `deadline_on_date` string
      - `deleted_at` string, date-time
      - `id` integer, required
      - `labels` string[], required
      - `metadata` object, required
      - `occurrence_key` string
      - `owner` string
      - `priority` integer
      - `project_id` integer, required
      - `project_name` string, required
      - `project_uid` string
      - `qualified_id` string, required
      - `recurrence_id` integer
      - `revision` integer, required
      - `scheduled_on_date` string
      - `short_id` string, required
      - `status` string, required
      - `title` string, required
      - `uid` string, required
      - `updated_at` string, date-time, required
    - `labels` IssueLabel[], required
      - `author` string, required
      - `created_at` string, date-time, required
      - `issue_id` integer, required
      - `label` string, required
    - `links` UILink[], required
      - `author` string, required
      - `created_at` string, date-time, required
      - `from_issue_id` integer, required
      - `from_issue_uid` string, required
      - `from_qualified_id` string, required
      - `from_status` string, required
      - `id` integer, required
      - `to_issue_id` integer, required
      - `to_issue_uid` string, required
      - `to_qualified_id` string, required
      - `to_status` string, required
      - `type` string, required
    - `recurrences` Recurrence[], required
      - `author` string, required
      - `created_at` string, date-time, required
      - `deleted_at` string, date-time
      - `dtstart` string, required
      - `id` integer, required
      - `last_materialized_uid` string
      - `next_occurrence_key` string
      - `project_id` integer, required
      - `revision` integer, required
      - `rrule` string, required
      - `template_body` string, required
      - `template_labels` string[], required
      - `template_metadata` object, required
      - `template_owner` string
      - `template_priority` integer
      - `template_title` string, required
      - `timezone` string, required
      - `uid` string, required
      - `updated_at` string, date-time, required
    - `state` string, required

## Other responses

- `304` — Snapshot unchanged

## Changes

- **2026-09-19** `62eb7bbfff42` — 3 info
  - added the optional property `collection/items/assignment_expires_on` to the response with the `200` status
  - added the optional property `graph/issues/items/assignment_expires_on` to the response with the `200` status
  - added the optional property `selected/issue/assignment_expires_on` to the response with the `200` status
- **2026-09-16** `2916e577ef54` — 1 breaking, 7 info
  - the response property `catalog/items/stats` became optional for the status `200`
  - added the optional property `capabilities/allowed_actions` to the response with the `200` status
  - added the optional property `capabilities/close_requires_evidence` to the response with the `200` status
  - added the optional property `capabilities/expires_at` to the response with the `200` status
  - …4 more
- **2026-09-15** `d55881e28f7f` — 1 info
  - added the optional property `selected/comments/items/teammate` to the response with the `200` status
- **2026-08-12** `8dcdcccff2a4` — 3 info
  - added the optional property `collection/items/deadline_on_date` to the response with the `200` status
  - added the optional property `graph/issues/items/deadline_on_date` to the response with the `200` status
  - added the optional property `selected/issue/deadline_on_date` to the response with the `200` status
- …earlier changes not shown

[Full history](https://skmtc.dev/kenn-io/apis/kata/changes/api/v1/ui/snapshot/get.md)

---

[API](https://skmtc.dev/kenn-io/apis/kata.md) · [All operations](https://skmtc.dev/kenn-io/apis/kata/llms.txt) · [OpenAPI document](https://skmtc.dev/kenn-io/apis/kata/revisions/eec9b2fb4675?raw)