Posts

Update a post

Changes its text, files, chain, time, targets or fields, schedules a draft (status scheduled with a future scheduledAt, or queue: true), or moves a scheduled post back to draft; what is left out stays as it is. Targets already live change on their network only with applyToPublished, where the network allows it, and edits says what happened to each.

patch/posts/{id}

Request

  • Base URL
    https://api.rizamo.com/v1
  • Auth
    HTTP bearer

Path parameters

idstring required

The post's id (post_).

Request body

textstring

The new caption, on every target that has no text of its own.

mediaIdsstring[]

Its files (med_, from Add media or an upload request), in order: on every target that has none of its own.

status'draft' | 'scheduled'

scheduled schedules a draft (with a future scheduledAt, or queue: true); draft moves a scheduled post back.

scheduledAtstring date-time nullable

When it goes out. With Z or an offset (2026-11-03T09:00:00+01:00) it is exact. Without one (2026-11-03T09:00) it is a local time in timeZone, or in the profile's time zone. Answers are in UTC.

queueboolean

Schedules it at the next time of its profile's queue (Get a profile's queue) when none of its accounts has a post then and none would pass its network's daily cap, up to 90 days ahead. Instead of scheduledAt, never with it; status becomes scheduled, and the answer's scheduledAt is the time it took. A queue with no times answers queue_empty, one with none free queue_full.

timeZonestring

Reads a scheduledAt without an offset; the profile's time zone when left out.

fieldsobject

Custom field values by key (List custom fields), such as { "campaign": "Winter menu" }.

applyToPublishedboolean

Also edit targets already live, where the network allows it. Each one's result is in edits.

Example request

{
  "scheduledAt": "2026-11-03T09:00"
}

Response

OK

idstring required
profileIdstring required
status'draft' | 'scheduled' | 'published' | 'partially_published' | 'failed' required

partially_published: some targets went out and others failed, or a target's chain stopped partway (its chainResults say where); each target has its own status.

textstring required
scheduledAtstring date-time nullable required
queuedboolean required

It took scheduledAt from its profile's queue (queue: true): the time stays as it was given when the queue's times change.

publishedAtstring date-time nullable required
createdAtstring date-time required
updatedAtstring date-time required
fieldsobject required
deletedAtstring date-time nullable required

Restore a deleted post within 30 days. After that it goes for good, unless a target is still live on its network.

sharedUntilstring date-time nullable required

When its preview links stop working, while it is shared (Share a preview of a post). Null when it is not.

Changes

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