---
title: "List Screen Presses"
method: GET
path: "/v1/teams/{team_id}/screens/presses"
tags: ["agent runtime"]
---

# List Screen Presses

`GET /v1/teams/{team_id}/screens/presses`

Every control on one generated screen that has been pressed, and the
run each press opened — one entry per key, the latest press winning.

This is what a page reads on mount so that a button whose run is done
comes back DONE, with its run id in hand for the report, instead of idle
and ready to send the same thing again (owner, 2026-09-01: "the status of
this button actually has been absolutely reset … absolutely unacceptable").

## Path parameters

- `team_id` string, uuid, required

## Query parameters

- `screen` string, required

## Headers

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

## Response `200`

Successful Response

- ScreenPressesResponse
  - `screen` string, required
  - `presses` ScreenPress[]
    - `control_key` string, required
    - `run_id` string, required
    - `status` string, required
    - `outcome` 'done' | 'failed' | 'running', required
    - `goal` string, nullable
    - `error` string, nullable
    - `created_at` string, date-time, nullable
    - `finished_at` string, date-time, nullable
    - `sent` SentLine[]
      - `to` string, required
      - `channel` string
      - `status` string
      - `id` string, nullable
      - `at` string, date-time, nullable
      - `error` string, nullable

## Other responses

- `422` — Validation Error

## Changes

> 33 revisions in range; 1 not diffed.

- **2026-09-05** `362369ea5c03` — 1 info
  - added the optional property `presses/items/sent` to the response with the `200` status
- **2026-09-02** `032c0f4e1565` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/stormy/apis/stormy-control-plane/changes/v1/teams/:team_id/screens/presses/get.md)

---

[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/52151384d62a?raw)