Boring Marketingdocs

Generate Brief

Generate a content brief from a queue item. Returns 202 — poll for completion.

POSThttps://api.boringmarketing.com/brands/{brand_id}/brief

Generates a structured content brief from a queue item. The brief includes strategy, outline, section guidance, and brand context.

Requires a valid API key with available daily calls. There is no separate gating beyond the standard tier call limit — every paid tier (Builder, Pro, Agency) can produce briefs.

Path parameters

brand_idstringrequired

The brand UUID.

Request body

queue_item_idstringrequired

The queue item ID from GET /brands/{id}/queue.

Response (202 Accepted)

{
  "run_id": "brief-run-uuid",
  "status": "queued"
}

Duration: 1-3 minutes. Poll GET /brands/{id}/runs/{run_id}.

After completion, fetch the brief via GET /brands/{id}/briefs.

Example

curl -X POST \
  -H "X-API-Key: $BM_API_KEY" \
  -H "Content-Type: application/json" \
  https://api.boringmarketing.com/brands/$BRAND_ID/brief \
  -d '{"queue_item_id": "qi-uuid-1"}'