Playground Drafts

Return full draft subject+body for every lead in the batch.

Tenant-scope enforced via service.get_batch_drafts which calls _load_campaign_owned(campaign_id, user_id) before any row read. A user who passes another user’s batch_id gets a 404 because the campaign_id is ownership-checked first — the batch filter is only applied WITHIN an authorized campaign scope.

Intended usage from the UI: fetched once when the batch reaches terminal-all (overall pending+running == 0), and on explicit “refresh drafts” actions. NOT called on the 2s poll loop — the status endpoint returns has_draft + subject_preview for that surface.

GET /api/v1/campaigns/{campaign_id}/playground/drafts

Playground Drafts

cURL

curl --request GET \
  --url https://api.example.com/api/v1/campaigns/{campaign_id}/playground/drafts \
  --header 'Authorization: Bearer <token>'

200

{
  "campaign_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "batch_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "drafts": [
    {
      "campaign_lead_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "subject": "<string>",
      "body": "<string>",
      "generated_at": "2023-11-07T05:31:56Z",
      "prompt_version_hash": "<string>"
    }
  ]
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

campaign_id · string<uuid> · required

Query Parameters

batch_id · string<uuid> · required

Batch ID produced by POST /playground/generate.

Response

200

application/json

Successful Response

Response model for GET /campaigns/:id/playground/drafts?batch_id=....

One-shot fetch — frontend calls this when the batch reaches terminal-all OR on explicit "refresh drafts" user action. Response size can legitimately be large (50 leads × 50KB body = 2.5MB) because it is user-initiated, not a polling endpoint.

campaign_id · string<uuid> · required

batch_id · string<uuid> | null

drafts · PlaygroundDraft · object[]

Show child attributes