Skip to main content
Publishes the draft as a new, numbered version and makes it live. Published versions never change; conversations already under way carry on, and new ones follow the new version. Nothing broken may be left in the draft’s checks.
Needs the agents:write scope.

Path parameters

Body

Request

Response

201 Created — the new version, now live. A version has its number, the note it was published with, who published it (by; null when published through the API), when (at), how many blocks it has and how many call the AI (ai_blocks), and whether it is the live one.

Errors

Every refusal is {"error": {"code", "message", "field"}}; field is there when one input is at fault. Any request can also be refused for its key, its account or its rate (key_required, invalid_key, account_suspended, plan_excludes_api, address_not_allowed, rate_limited); see the overview.