v1Resources/Posts/postRecover a post's failed destinations

Recover a post's failed destinations

Creates a new draft post for the destinations where a post failed to publish, so you can fix it and send it again. Use it on a post whose status is partial (some destinations went live, some failed) or error (none went live). The draft copies the original content and media and targets only the failed connections. Nothing is published or scheduled: edit the draft if the network rejected the content, then schedule or publish it like any other post. The draft can target only those failed destinations, so adding another connection to it is refused with 409. The live destinations on the original post are never changed. The failed destinations move to the draft and can no longer be retried from the original, so a partial post then shows as active. Calling this again for the same post returns the same draft with 201 instead of creating a second one. If that draft was deleted, the call returns 409 and no new recovery is made. A destination is left on the original when its outcome is uncertain (the network may already have the post), when a retry is already queued, or when its platform is not currently offered. If no destination qualifies, the call returns 422. Series posts, posts that belong to a multi-client post and imported posts can't be recovered here. The API key's user must be active and have access to Social and to the post's client. If recovery isn't available for your workspace, the call returns 404. Send no request body.

post/api/v1/posts/{id}/recover-failed
posts:write
Query parameters
idstringrequired
The post that failed to publish, by id or public id.
Response
dataobjectoptional
idstringoptional
The recovery draft's id. Use it to edit, schedule or publish the draft.
publicIdstringoptional
The recovery draft's public id, or null if it has none.
statusstringoptional
The recovery draft's status: draft for a new recovery. A repeat call returns the existing draft's current status, for example scheduled once someone has scheduled it.
connectionIdsarray of stringoptional
The connections the draft publishes to: the original post's failed destinations.
Errors
400The request is missing a required parameter or is otherwise malformed.
401Missing, invalid, expired, or revoked API key.
403The key lacks the required scope, or isn't authorized for this client/location.
404The resource wasn't found, or doesn't belong to your agency.
409The post changed while the draft was being created, a recovery for this post already exists or was deleted, or the post belongs to a multi-client post. Refresh the post and try again.
422The post can't be recovered: its status is not partial or error, it belongs to a series, no failed destination qualifies, or a failed destination's connection is disconnected or not offered.
429Too many requests. Retry after the number of seconds in the Retry-After header.
500The recovery draft could not be created. Refresh the post and try again.
503The post operation could not be completed.
post/api/v1/posts/{id}/recover-failed
Your API key
id *
{}

Guides that use this resource