posts

Publish a variant now

Publishes a draft, scheduled, or failed variant immediately and synchronously — the response reflects the real publish outcome rather than waiting for the scheduler. Also the retry path for a failed post: it posts instantly instead of waiting for its (past) scheduled time.

post/api/v1/variants/{variant_id}/publish-now

Request

  • Base URL: https://api.cadencz.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.cadencz.com/api/v1/variants/{variant_id}/publish-now
  • Auth: HTTP bearer

Path parameters

variant_idstring required

Response

Successful Response

idstring required
post_idstring required
channel_idstring nullable required
platformstring required
bodystring required
media_idsstring[] required
platform_targetstring nullable required
statusstring required
scheduled_atstring date-time nullable required
published_atstring date-time nullable required
provider_urlstring nullable required
errorstring nullable required
attempt_countinteger required
content_metadataobject
thread_idstring nullable
thread_positioninteger nullable

Example response

{
  "attempt_count": 0,
  "body": "Cadencz now supports scheduled Bluesky posts.",
  "channel_id": "chn_123",
  "id": "var_123",
  "media_ids": [],
  "platform": "bluesky",
  "post_id": "pst_123",
  "scheduled_at": "2026-07-08T10:30:00Z",
  "status": "scheduled"
}

Changes

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