Publish a draft now

Publishes the Draft now, under create post's rules and safety limits. Success deletes the Draft and its media, writes a publish record and returns the post id, no webhook. A known failure keeps the content; a scheduled time already passed is cleared. The responses say more.

post/v1/drafts/{id}/publish

Request

Base URL: https://api.curviate.com
URL: https://api.curviate.com/v1/drafts/{id}/publish
Auth: HTTP bearer

Path parameters

idstring required

Draft id (drf_...).

Response

Published. The Draft and its media are deleted and a publish record is written. No webhook is sent: this response is the result.

object'post_created' required

Response type discriminator.

idstring nullable required

The published post's id.

Example response

{
  "safety_warning": {
    "row": "profile_views",
    "reset_at": "2026-09-05T00:00:00.000Z",
    "hint": {
      "parameter": "profile_views.ceiling",
      "message": "This account is at its ceiling for profile_views. This action went through because profile_views.posture is warn, and it counted: 101 of 100 this window. Raise profile_views.ceiling, or wait for the window to reset at 2026-09-05T00:00:00.000Z."
    },
    "reason": "ceiling",
    "blocked": false
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.