---
title: "List dispatch setups"
method: GET
path: "/api/v1/me/dispatch-setups"
tags: ["Dispatches"]
---

# List dispatch setups

`GET /api/v1/me/dispatch-setups`

The caller's saved dispatch setups across every jurisdiction, most recently created first, each with up to three of its most recent accessible dispatches. Setups are jurisdiction-scoped, so the gateway asks every jurisdiction's cell and merges; a page is the union of one cell page per jurisdiction — ordering is newest-first WITHIN a page, not across pages — so it can be longer OR shorter than pageSize (entire-api also masks a setup's config to the repos the caller can see and drops a setup whose repos are all gone) without meaning the list is exhausted — page until nextPageToken is null. A jurisdiction whose cell didn't answer is named in unavailableJurisdictions.

## Query parameters

- `pageSize` integer
- `pageToken` string

## Response `200`

Dispatch setups

- object
  - `items` object[], nullable, required
    - `id` string, required
    - `jurisdiction` string
    - `name` string, nullable, required
    - `isPinned` boolean, required
    - `config` object, required
    - `lastDispatchedAt` string, nullable, required
    - `createdAt` string, required
    - `updatedAt` string, required
    - `recentDispatches` object[], nullable, required
      - `id` string, required
      - `setupId` string, required
      - `jurisdiction` string
      - `status` string, required
      - `title` string, nullable, required
      - `coveredRepos` string[], nullable, required
      - `coveredRepoUlids` string[], nullable, required
      - `coveredRepoGithubIds` number[], nullable, required
      - `windowSince` string, nullable, required
      - `windowUntil` string, nullable, required
      - `voice` string, nullable, required
      - `voiceBucket` string, nullable, required
      - `createdAt` string, required
      - `updatedAt` string, required
      - `completedAt` string, nullable, required
  - `nextPageToken` string, nullable, required
  - `unavailableJurisdictions` string[]

## Other responses

- `400` — Invalid page token
- `503` — entire-api is not configured

---

[API](https://skmtc.dev/entire/apis/entire-api.md) · [All operations](https://skmtc.dev/entire/apis/entire-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/entire/entire-api/revisions/c3d737ae064e/schema)