Posts
Retry Post
Retry failed or partial posts
POST
Reset failed/partial posts so they re-enter the scheduler. This lets you retrigger multiple posts (or a subset of their accounts) after fixing upstream media/platform issues.
Body Parameters
Array of post IDs (min 1, max 20) to retry. Each post must belong to your
authenticated key scope; IDs outside scope are rejected per entry.
Optional filter (max 10). When provided, only the matching account rows on
each post are retried; otherwise, all failed/partial accounts are reset. Must
contain at least one UUID when present.
Behavior
The
errors object only appears when at least one post/account could not be
retried. Successful responses without failures omit the field entirely.Error Responses
400 invalid_json- body is not valid JSON422 invalid_payload- payload failed schema rules (missing IDs, too many IDs)401- authentication failed (missing/invalid/revoked token)402 subscription_required- active Creator/Professional/Business plan required403 tier_not_allowed- Scheduler tier cannot use Partner API500 retry_failed- unexpected database error (partial successes are still reported in the body)
