---
title: "The assistants in reach"
method: GET
path: "/v1/assistants"
tags: ["assistants"]
---

# The assistants in reach

`GET /v1/assistants`

## Request

- Base URL: `https://www.pendingyou.com`
- URL: `https://www.pendingyou.com/v1/assistants`
- Auth: OAuth 2 (authorization code, authorization URL `https://www.pendingyou.com/oauth/authorize`, token URL `https://www.pendingyou.com/oauth/token`, scopes: `assistants:read`)

Each sign-in, its computer and how it hears answers, and its agents: live, recent or quiet, their open cards, and the sessions running now with the terminal each runs in. Live ones first.

## Headers

- `Pending-You-Version` '2026-10-05'
- `Pending-You-Client` string
- `DPoP` string
- `If-None-Match` string

## Response `200`

The assistants in reach

- AssistantList
  - `assistants` Assistant[], required
    - `id` string, required
    - `app` union, required
      - 'claude-code' | 'codex' | 'cursor' | 'gemini-cli' | 'opencode' | 'pi' | 'grok' | 'muse' | 'chatgpt' | 'claude' | 'dots' | 'other' | 'webhook'
      - string
    - `appName` string, required
    - `name` string, required
    - `machine` object
      - `id` string, required
      - `name` string, required
    - `hears` union
      - 'instant' | 'every-15-min' | 'hourly' | 'while-working' | 'by-hand'
      - string
    - `agents` object[], required
      - `id` string, required
      - `name` string, required
      - `about` string
      - `state` union, required
        - 'live' | 'recent' | 'quiet'
        - string
      - `liveAt` string, date-time
      - `closedAt` string, date-time
      - `openCards` integer, required
      - `liveSessions` object[], required
        - `appSessionId` string, required
        - `cwd` string
        - `areaId` string
        - `liveAt` string, date-time, required
        - `terminal` object
          - `app` 'herdr', required
          - `paneId` string, required
          - `server` string

## Other responses

- `304`: Not modified: If-None-Match named this answer’s ETag.
- `400`: invalid
- `401`: invalid_token, invalid_dpop_proof or use_dpop_nonce (OAuth, with WWW-Authenticate)
- `403`: app_not_available; insufficient_scope (OAuth, with WWW-Authenticate naming the scope)
- `429`: rate_limited
- `500`: server_error
- `503`: unavailable

---

[API](https://skmtc.dev/pendingyou/apis/pending-you-person-api.md) · [All operations](https://skmtc.dev/pendingyou/apis/pending-you-person-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pendingyou/apis/pending-you-person-api/revisions/4c0d997495a6?raw)