Scheduling

Schedule or immediately publish one draft

Fans one draft out to between one and ten social accounts. Supply publishAt to set a future fire time, or omit it entirely to publish right now. A future time must be at least five minutes and at most roughly six months out. The response reports one result per account; check each entry rather than only the top-level success, because a partial failure still returns 200. Immediate publishing requires the publish capability while a future time requires schedule; either way a plan that lacks it returns 402.

post/posts/{postId}/schedule

Request

  • Base URL: https://www.juzpost.com/api/cli/v1
  • URL: https://www.juzpost.com/api/cli/v1/posts/{postId}/schedule
  • Auth: HTTP bearer

Path parameters

postIdstring uuid required

Id of the post, as returned by POST /posts or GET /posts.

Request body

socialAccountIdsstring[] required

The accounts to publish to, between one and ten. Duplicates are silently collapsed. If any id is not yours the entire request fails with 404 and does not partially schedule.

publishAtstring date-time

When to publish, as an ISO 8601 UTC instant. Must be at least 5 minutes and at most roughly 6 months in the future. Omit this field entirely to publish immediately, but that path needs the publish capability instead of schedule.

titlestring

Title to use for this run, overriding the stored one and persisted back onto the post. Note this limit is stricter than the 200 characters POST /posts accepts.

descriptionstring

Description to use for this run, overriding the stored one and persisted back onto the post. Also re-checked against each target platform's own caption limit.

hashtagsstring[]

Hashtags to use for this run, overriding the stored ones. Do not include the #.

platformOverridesobject

Per-account content overrides, keyed by social account id. Every key must be one of the ids in socialAccountIds.

publishAtOverridesobject

Per-account fire times, keyed by social account id, each an ISO 8601 UTC instant. Accounts not listed use the top-level publishAt. Every key must be one of the ids in socialAccountIds.

tiktokSettingsobject

Per-account TikTok settings, keyed by social account id. Every key must be one of the ids in socialAccountIds.

pinterestSettingsobject

Per-account Pinterest settings, keyed by social account id. Every key must be one of the ids in socialAccountIds.

blueskySettingsobject

Per-account Bluesky alt text and content warnings, keyed by social account id. Every key must be one of the ids in socialAccountIds and must name a Bluesky account.

wordpressSettingsobject

Per-account WordPress post settings for a blog post, keyed by social account id. Every key must be one of the ids in socialAccountIds and must name a WordPress account. Nothing reaches WordPress before the post fires.

Response

Timers created. Inspect results per account: a mix of scheduled and failed targets is still reported here rather than as an error status.

successboolean required

True only when no account was left failed or pending. Partial failure still returns HTTP 200 with this set to false, so always inspect results.

Changes

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