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": [
"11111111-1111-1111-1111-111111111111",
"22222222-2222-2222-2222-222222222222"
],
"account_ids": ["0f4f54d4-8cce-4fb7-8c7b-befbcb8af812"]
}'
{
"ok": true,
"code": 200,
"message": "Posts queued for retry",
"data": {
"retried": 2,
"ids": [
"11111111-1111-1111-1111-111111111111",
"22222222-2222-2222-2222-222222222222"
],
"failed": ["33333333-3333-3333-3333-333333333333"],
"errors": {
"33333333-3333-3333-3333-333333333333": "Only failed or partial posts can be retried"
}
}
}
Posts
Retry Post
Retry failed or partial posts
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": [
"11111111-1111-1111-1111-111111111111",
"22222222-2222-2222-2222-222222222222"
],
"account_ids": ["0f4f54d4-8cce-4fb7-8c7b-befbcb8af812"]
}'
{
"ok": true,
"code": 200,
"message": "Posts queued for retry",
"data": {
"retried": 2,
"ids": [
"11111111-1111-1111-1111-111111111111",
"22222222-2222-2222-2222-222222222222"
],
"failed": ["33333333-3333-3333-3333-333333333333"],
"errors": {
"33333333-3333-3333-3333-333333333333": "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
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.
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": [
"11111111-1111-1111-1111-111111111111",
"22222222-2222-2222-2222-222222222222"
],
"account_ids": ["0f4f54d4-8cce-4fb7-8c7b-befbcb8af812"]
}'
{
"ok": true,
"code": 200,
"message": "Posts queued for retry",
"data": {
"retried": 2,
"ids": [
"11111111-1111-1111-1111-111111111111",
"22222222-2222-2222-2222-222222222222"
],
"failed": ["33333333-3333-3333-3333-333333333333"],
"errors": {
"33333333-3333-3333-3333-333333333333": "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 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)