Publish draft
Accepts an existing draft for publication. UniPost flips the draft into a publishable state, creates result rows, and enqueues background delivery jobs.
Authorization
AuthorizationBearer <token>In header
Workspace API key.
Path Params
post_idstring
Draft post ID to publish.
Response Body
202
idstring
Draft post ID.
execution_modestring
Draft publish enqueues delivery jobs and returns before workers finish dispatch.
Valuesasync
statusstring
Initial post state after draft publish begins, then later converges to a final aggregate state.
Valuesqueued | publishing | published | partial | failed
queued_results_countinteger
How many per-account delivery results were queued.
active_job_countinteger
How many queue jobs are currently active.
resultsarray
Initial per-platform result rows created at enqueue time.
request_idstring
Request identifier for debugging and support.
400
error.codestring
Machine-readable error code.
error.normalized_codestring
Lowercase compatibility alias for the error code.
error.messagestring
Human-readable error message.
request_idstring
Request identifier for debugging and support.
401
error.codestring
Machine-readable error code.
error.normalized_codestring
Lowercase compatibility alias for the error code.
error.messagestring
Human-readable error message.
request_idstring
Request identifier for debugging and support.
402
error.codestring
Machine-readable error code.
error.normalized_codestring
Lowercase compatibility alias for the error code.
error.messagestring
Human-readable error message.
request_idstring
Request identifier for debugging and support.
409
error.codestring
Machine-readable error code.
error.normalized_codestring
Lowercase compatibility alias for the error code.
error.messagestring
Human-readable error message.
request_idstring
Request identifier for debugging and support.
500
error.codestring
Machine-readable error code.
error.normalized_codestring
Lowercase compatibility alias for the error code.
error.messagestring
Human-readable error message.
request_idstring
Request identifier for debugging and support.
Draft publish is asynchronous. UniPost now returns 202 Accepted once the draft is claimed, result rows are created, and delivery jobs are queued. Read final status from the post resource or via publish webhooks.