Skip to main content
POST
/
api
/
partner
/
v1
/
posts
/
retry
curl --request POST \
  --url https://www.genviral.io/api/partner/v1/posts/retry \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "post_ids": ["post_abc123", "post_def456"],
  "account_ids": ["0f4f54d4-8cce-4fb7-8c7b-befbcb8af812"]
}'

{
  "ok": true,
  "code": 200,
  "message": "Posts queued for retry",
  "data": {
    "retried": 2,
    "ids": ["post_abc123", "post_def456"],
    "failed": ["post_xyz999"],
    "errors": {
      "post_xyz999": "Only failed or partial posts can be retried"
    }
  }
}
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 workspace; IDs outside your 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

curl --request POST \
  --url https://www.genviral.io/api/partner/v1/posts/retry \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "post_ids": ["post_abc123", "post_def456"],
  "account_ids": ["0f4f54d4-8cce-4fb7-8c7b-befbcb8af812"]
}'

{
  "ok": true,
  "code": 200,
  "message": "Posts queued for retry",
  "data": {
    "retried": 2,
    "ids": ["post_abc123", "post_def456"],
    "failed": ["post_xyz999"],
    "errors": {
      "post_xyz999": "Only failed or partial posts can be retried"
    }
  }
}
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)
  • 500 retry_failed — unexpected database error (partial successes are still reported in the body)