Posts

Check a post without creating it

Takes what Create a post takes and creates nothing. problems are what would stop it now; warnings are what would stop it from being scheduled or published later, such as Instagram without an image or a video. Each target says what Rizamo would do to its files, and scheduledAt when it would go out (with queue: true, the queue's next time free for all of its accounts).

post/posts/validate

Request

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

Headers

Idempotency-Keystring

1 to 255 printable characters, new for each request (a UUID); the body up to 1 MB. For 24 hours a repeat with the same key, path and body gets the first answer, with Idempotent-Replayed: true, instead of running again; 5xx, 409 and 429 answers are not kept. Errors, Retries, has the rest.

Request body

profileIdstring required

The profile (prof_) the post is for: the brand whose accounts it goes to.

textstring required

The caption, on every target that has no text of its own. A draft may have none; to go out, each target needs a text or a file (or for Facebook a link).

mediaIdsstring[]

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

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.

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" }.

status'draft' | 'scheduled'

draft (the default) never publishes. scheduled needs a future scheduledAt, or queue: true.

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.

Example request

{
  "mediaIds": [
    "med_01jbx3k9q8f7t2r5m4n6p8s0vw"
  ],
  "scheduledAt": "2026-11-03T09:00"
}

Response

OK

okboolean required

True when there are no problems: creating it would work.

scheduledAtstring date-time nullable required

When it would go out: its scheduledAt in UTC, or with queue: true the time its profile's queue would give it now (another post can take it first). Null without either.

Changes

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