Skip to main content
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

post_ids
array
required
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.
account_ids
array
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 JSON
  • 422 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 required
  • 403 tier_not_allowed - Scheduler tier cannot use Partner API
  • 500 retry_failed - unexpected database error (partial successes are still reported in the body)