---
title: "Share Sessions"
method: GET
path: "/api/v1/share/sessions"
tags: ["share-keys"]
---

# Share Sessions

`GET /api/v1/share/sessions`

## Request

- Base URL: `https://memory.kagura-ai.com` (the document declares no server; this is the origin it was published from)
- URL: `https://memory.kagura-ai.com/api/v1/share/sessions`
- Auth: none declared

List the bound context's live agent session-state, read-only (#1064).

A **read-only projection** of the #889/#906 agent session-state lane,
driven by a #1027 share key and confined to the key's bound context — so an
external, observe-only dashboard can render live agent status without
holding a privileged credential and without the agent dialling out.

Confinement and read-only-ness are structural (inherited from #1027): the
context comes from the verified share key (never the request), and write /
control verbs on the lane (`PUT`/`DELETE /contexts/{id}/state`) authenticate
against `api_keys` — a share key is rejected there outright. Approvals stay
on the cockpit/Slack operator path; this surface can only *observe*.

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- SharedSessionsResponse: The bound context's live agent session-state, for a status board (#1064).
  - `sessions` unknown, required
  - `count` unknown, required
  - `as_of` unknown, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/kagura-ai/apis/kagura-memory-cloud.md) · [All operations](https://skmtc.dev/kagura-ai/apis/kagura-memory-cloud/llms.txt) · [OpenAPI document](https://skmtc.dev/kagura-ai/apis/kagura-memory-cloud/revisions/aa9df1a21db9?raw)