---
title: "Read View"
method: GET
path: "/v1/teams/{team_id}/views/{kind}"
tags: ["stations"]
---

# Read View

`GET /v1/teams/{team_id}/views/{kind}`

## Request

- Base URL: `https://api.stormy.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.stormy.ai/v1/teams/{team_id}/views/{kind}`
- Auth: none declared

Every note of one kind, newest first — the list behind a station row.

A KIND IS NOT A FOLDER, and that is the whole reason this exists beside the
station read. Calls are filed under the person they belong to: 109 sit in
`worker/local/calls/`, 41 more under `customer/robert-liu/calls/`, and more
wherever the next caller lands. Listing a directory would find one pile and
silently miss the rest, so the query is `kind:` in the frontmatter and the
location is left to the agent — which is what lets it reorganise the tree
without breaking a surface.

PROJECTED, NOT WHOLE. A row needs a title, a party and a time; a call
transcript is thousands of words. Bodies arrive when one is opened
(`path=`), never a hundred at a time to draw a list.

## Path parameters

- `team_id` string, uuid, required
- `kind` string, required

## Query parameters

- `limit` integer
- `offset` integer
- `q` string, nullable
- `path` string, nullable
- `sort` string, nullable
- `where` string, nullable

## Headers

- `authorization` string, nullable
- `x-darwin-token` string, nullable

## Response `200`

Successful Response

- ViewRead: A VIEW — every note of one kind, wherever in the tree it was filed.
  - `initialized` boolean, required
  - `kind` string
  - `items` StationItem[]
    - `path` string, required
    - `title` string, required
    - `party` string
    - `at` string
    - `needs` string, nullable
    - `rank` integer, nullable
    - `body` string
    - `body_truncated` boolean
    - `visibility` string
    - `fields` object
    - `face` string
    - `has_artifact` boolean
  - `total` integer
  - `next_offset` integer, nullable
  - `fields` SuggestedField[]
    - `key` string, required
    - `coverage` number, required
    - `distinct` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/stormy/apis/stormy-control-plane.md) · [All operations](https://skmtc.dev/stormy/apis/stormy-control-plane/llms.txt) · [OpenAPI document](https://skmtc.dev/stormy/apis/stormy-control-plane/revisions/4d811ab18158?raw)