posts

Update a post variant

Updates editable copy or media for a draft, scheduled, or failed variant.

patch/api/v1/variants/{variant_id}

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}
  • Auth: HTTP bearer

Path parameters

variant_idstring required

Request body

bodystring nullable
media_idsstring[] nullable
platform_targetstring nullable
channel_idstring nullable

Assign a channel to an unscheduled draft.

Example request

{
  "body": "Updated post copy for Bluesky.",
  "media_ids": []
}

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.