POST/v1/posts/{id}/publish

publishPost

Publish a post now. Queues an immediate publish of a draft, scheduled, or failed post (202 — delivery continues in the background; poll GET /v1/posts/{id} for per-channel outcomes). Already-published posts return 409; a post already publishing is accepted as-is. Requires the workspace's dangerous-operations toggle.

Required scope:posts:write

Parameters

idpath · stringrequired

Post identifier.

Responses

202PublishPostResponse

Publish accepted.

400invalid_request validation_failed

401authentication_required invalid_api_key

403insufficient_scope feature_not_enabled dangerous_ops_disabled

404resource_not_found

409resource_conflict

429rate_limited quota_exhausted

500internal_error

Errors are RFC 9457 problem+json with a stable code and a request_id — each code above links to its own page.

Example

POST /v1/posts/{id}/publish

curl -X POST https://app.usepostify.com/v1/posts/post_9x2y3z0001/publish \
  -H "Authorization: Bearer postify_live_XXXXXXXXXXXXXXXX"