---
title: "GET /api/v1/instance"
method: GET
path: "/api/v1/instance"
---

# GET /api/v1/instance

`GET /api/v1/instance`

## Response `200`

OK

- InstanceResponseBody
  - `auth` AuthInfoOut, required
    - `actor` string
    - `allowed_actions` string[]
    - `close_requires_evidence` boolean
    - `expires_at` string, date-time
    - `kind` string, required
    - `scope` TokenScopeOut
      - `kind` 'issue_subtree', required
      - `project_uid` string, required
      - `root_issue_uid` string, required
    - `token_audit_read` boolean
  - `instance_uid` string, required
  - `issue_subtree_tokens` boolean, required
  - `schema_version` integer, required
  - `version` string, required
  - `web_ui_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
  - `web_ui_contract_version` string

## Other responses

- `default` — Error

## Changes

- **2026-09-16** `2916e577ef54` — 11 info
  - added the optional property `auth/allowed_actions` to the response with the `200` status
  - added the optional property `auth/close_requires_evidence` to the response with the `200` status
  - added the optional property `auth/expires_at` to the response with the `200` status
  - added the optional property `auth/scope` to the response with the `200` status
  - …7 more
- **2026-08-07** `7184ab405564` — 2 info
  - added the optional property `web_ui_contract_version` to the response with the `200` status
  - added the required property `web_ui_capabilities` to the response with the `200` status

[Change history](https://skmtc.dev/kenn-io/apis/kata/changes/api/v1/instance/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)