---
title: "Generate a dispatch"
method: POST
path: "/api/v1/dispatches/generate"
tags: ["Dispatches"]
---

# Generate a dispatch

`POST /api/v1/dispatches/generate`

## Query parameters

- `jurisdiction` string

## Request body

- object
  - `repos` string[]
  - `orgs` string[]
  - `since` string
  - `until` string
  - `branches` union
    - string[]
    - 'all'
  - `voice` string

## Response `200`

Dispatch generated immediately

- object
  - `title` string, required
  - `jurisdiction` string
  - `covered_repos` string[], required
  - `branches` union, required
    - string[]
    - 'all'
  - `voice` string, nullable, required
  - `window` object, required
    - `normalized_since` string, required
    - `normalized_until` string, required
    - `first_checkpoint_created_at` string, nullable, required
    - `last_checkpoint_created_at` string, nullable, required
  - `totals` object, required
    - `checkpoints` number, required
    - `used_checkpoint_count` number, required
    - `branches` number, required
    - `files_touched` number, required
  - `generated_markdown` string, required
  - `repos` object[], required
    - `full_name` string, required
    - `sections` object[], required
      - `label` string, required
      - `bullets` object[], required
        - `checkpoint_id` string, required
        - `text` string, required
        - `source` 'cloud_analysis' | 'local_summary' | 'commit_message', required
        - `branch` string, required
        - `created_at` string, required
        - `labels` string[], required

## Other responses

- `400` — Invalid dispatch request
- `404` — Repository not found
- `429` — Rate limit exceeded
- `503` — Dispatch generation 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/c3d737ae064e/schema)