---
title: "Create Brief"
method: POST
path: "/brief"
---

# Create Brief

`POST /brief`

## Request

- Base URL: `https://api.callboard.fm` (the document declares no server; this is the origin it was published from)
- URL: `https://api.callboard.fm/brief`
- Auth: none declared

Stream a Promoter Brief for the given natural language query.

Events emitted via SSE:
- `{"type": "agent_complete", "agent": "<name>", "data": {...}}`
- `{"type": "brief_complete", "data": {PromoterBrief}}`
- `{"type": "stream_end"}`

## Headers

- `authorization` string, nullable

## Request body

- BriefRequest
  - `query` string, required
  - `force_low_confidence` boolean
  - `force_refresh` boolean

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/callboard/apis/callboard-api.md) · [All operations](https://skmtc.dev/callboard/apis/callboard-api/llms.txt) · [OpenAPI document](https://skmtc.dev/callboard/apis/callboard-api/revisions/9297a7e92032?raw)