---
title: "Generate a dispatch (cell-backed)"
method: POST
path: "/api/v1/me/dispatches"
tags: ["Dispatches"]
---

# Generate a dispatch (cell-backed)

`POST /api/v1/me/dispatches`

Forwards to the cell of the jurisdiction named in ?jurisdiction= (default: the caller's home), which resolves the repos locally and persists the run — a dispatch covers repos in exactly one jurisdiction and lives in that cell. May return with generation already complete or failed (200/201), or still in progress (202) — poll GET /me/dispatches/:dispatchId?jurisdiction=<its jurisdiction> by the returned id until the run reaches a terminal status. A 404 names a repo not placed in (or not visible in) that jurisdiction.

## Query parameters

- `jurisdiction` string

## Request body

- object
  - `repos` string[]
  - `since` string, required
  - `until` string, required
  - `branches` string[], required
  - `voice` string

## Response `200`

Dispatch generated and persisted

- object
  - `id` string, required
  - `setupId` string, required
  - `jurisdiction` string
  - `status` 'generating' | 'complete' | 'failed', required
  - `title` string, nullable, required
  - `coveredRepos` string[], required
  - `coveredRepoUlids` string[], required
  - `coveredRepoGithubIds` number[], required
  - `branches` string[], required
  - `voice` string, nullable, required
  - `window` object, required
    - `normalizedSince` string, required
    - `normalizedUntil` string, required
    - `firstCheckpointCreatedAt` string, nullable, required
    - `lastCheckpointCreatedAt` string, nullable, required
  - `totals` object, required
    - `checkpoints` number, required
    - `usedCheckpointCount` number, required
    - `branches` number, required
    - `filesTouched` number, required
  - `repos` object[], required
    - `fullName` string, required
    - `sections` object[], required
      - `label` string, required
      - `bullets` object[], required
        - `checkpointId` string, required
        - `text` string, required
        - `source` 'cloud_analysis' | 'local_summary' | 'commit_message', required
        - `branch` string, required
        - `createdAt` string, required
        - `labels` string[], required
  - `generatedMarkdown` string, required
  - `isPersisted` boolean, required
  - `errorMessage` string, nullable, required
  - `createdAt` string, required
  - `updatedAt` string, required
  - `completedAt` string, nullable, required

## Other responses

- `202` — Dispatch run created; generation is still in progress
- `400` — Invalid dispatch request
- `404` — Repository not found in the jurisdiction, or inaccessible
- `429` — Rate limit exceeded
- `503` — entire-api is not configured, or generation is unavailable

---

[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/1134b24b642f/schema)