Retry Post
Queue one new delivery attempt for a failed per-destination result.
Authorization
AuthorizationBearer <token>In header
Workspace API key.
Path Parameters
idstring
Parent UniPost post ID.
resultIDstring
Failed per-destination result ID from the parent post's results array.
Response Body
200
data.idstring
The existing result ID.
data.social_account_idstring
Destination social account ID.
data.platformstring
Destination platform.
data.statusstring
"queued" after the retry job is accepted.
data.retry_policyobject
Current best-effort queue and retry snapshot.
data.retry_policy.retry_statestring
Usually scheduled after a successful enqueue.
data.retry_policy.will_retryboolean
Whether UniPost has an active retry attempt.
data.retry_policy.manual_retry_allowedboolean
False while the accepted retry job is active.
402
error.codestring
Stable uppercase error code.
error.normalized_codestring
Lowercase error-code alias.
error.messagestring
Human-readable reason the retry was rejected.
request_idstring
Request identifier for debugging and support.
409
error.codestring
Stable uppercase error code.
error.normalized_codestring
Lowercase error-code alias.
error.messagestring
Human-readable reason the retry was rejected.
request_idstring
Request identifier for debugging and support.
429
error.codestring
Stable uppercase error code.
error.normalized_codestring
Lowercase error-code alias.
error.messagestring
Human-readable reason the retry was rejected.
request_idstring
Request identifier for debugging and support.
503
error.codestring
Stable uppercase error code.
error.normalized_codestring
Lowercase error-code alias.
error.messagestring
Human-readable reason the retry was rejected.
request_idstring
Request identifier for debugging and support.
No request body
Send the Authorization header and the two path parameters only. Do not send JSON or an idempotency header.
Behavior
A retry reuses the same result record and does not create a new result row. After UniPost accepts the job, this endpoint returns the result with status queued. Fetch the parent with GET /v1/posts/{id} to follow the result and the aggregate post status.
This endpoint has no idempotency key. After a successful response, do not call it again for the same attempt. If a pending, running, or retrying job already exists, UniPost returns 409 QUEUE_JOB_ACTIVE.
Error responses
| Status | Code | What to do |
|---|---|---|
| 402 | PLAN_PLATFORM_PUBLISHING_RESTRICTED | Wait until the current plan/platform restriction is lifted, or use an eligible plan. |
| 409 | RESULT_NOT_RETRYABLE | Only a result whose current status is failed can be retried. |
| 409 | QUEUE_JOB_ACTIVE | Do not retry again. Poll the parent post while the active job runs. |
| 409 | SOCIAL_ACCOUNT_NOT_AVAILABLE | Reconnect the destination account before publishing again. |
| 409 | MEDIA_REUPLOAD_REQUIRED | Upload the original media again, then create a new publish request. |
| 429 | RATE_LIMITED | Honor Retry-After, then retry after the request, enqueue, or queue-depth window recovers. |
| 503 | POLICY_UNAVAILABLE | Retry later after UniPost can evaluate the current publishing policy. |