---
title: "Preview a manual publisher dispatch thread"
method: POST
path: "/admin/jobs/publisher-dispatch/preview"
tags: ["Admin"]
---

# Preview a manual publisher dispatch thread

`POST /admin/jobs/publisher-dispatch/preview`

## Request

- Base URL: `https://api.presscart.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.presscart.com/admin/jobs/publisher-dispatch/preview`
- Auth: HTTP bearer

Renders the subject/body/attachment plan of the FIRST message a manual send would produce for the selected articles, without downloading attachment content. For a team on full dispatch the selection goes out as ONE thread with a message per article and message_count reports how many that is; omitted_attachment_count covers the whole thread and counts files exceeding a single message's attachment budget. For any other team (summary: true) the whole selection renders as a single summary digest: message_count is 1, attachments is always empty, and omitted_attachment_count is always 0 because attachments are never computed for a digest.

## Request body

- object
  - `team_id` string, uuid, required
  - `article_ids` string[], required

## Response `200`

Dispatch preview generated successfully

- DispatchPreviewResponse
  - `subject` string, required
  - `body` string, required
  - `to` string, nullable, required
  - `attachments` DispatchPreviewAttachment[], required
    - `file_name` string, required
    - `file_size` integer, required
    - `mime_type` string, nullable, required
  - `omitted_attachment_count` integer, required
  - `included_article_ids` string[], required
  - `skipped_article_ids` string[], required
  - `message_count` integer, required
  - `summary` boolean, required

## Other responses

- `400`: Invalid article selection or malformed request body
- `404`: No selected article has a live order context to preview

---

[API](https://skmtc.dev/presscart/apis/presscart-prod-api.md) · [All operations](https://skmtc.dev/presscart/apis/presscart-prod-api/llms.txt) · [OpenAPI document](https://skmtc.dev/presscart/apis/presscart-prod-api/revisions/2154581d845e?raw)