Posts

Retry a failed post

Re-queue a FAILED post for publishing, immediately or at a future scheduledAt. Refuses posts that were already published. If the last attempt's outcome is unknown (it may have posted), responds 412 until called again with force: true — check the platform first.

post/v0/posts/{id}/retry

Request

  • Base URL: https://api.schedulin.app
  • URL: https://api.schedulin.app/v0/posts/{id}/retry
  • Auth: one of:
    • API key in header x-api-key
    • OAuth 2 (authorization code, authorization URL https://api.schedulin.app/oauth/authorize, token URL https://api.schedulin.app/oauth/token, scopes: posts:write)

Path parameters

idstring required

Request body

forceboolean

Confirm the retry after a publish attempt whose outcome is unknown. Check the platform first — the post may already be live.

scheduledAtstring date-time nullable

Future time to re-schedule the post for; omit to publish immediately.

Response

OK

idstring required
externalIdstring nullable required
captionstring required
status'SCHEDULED' | 'PROCESSING' | 'COMPLETED' | 'DRAFT' | 'FAILED' | 'DELETED' required
approvalStatus'DRAFT' | 'PENDING_APPROVAL' | 'APPROVED' | 'REJECTED' required
approvalRequestedAtstring date-time nullable required
approvalRequestedBystring nullable required
approvedAtstring date-time nullable required
approvedBystring nullable required
rejectionReasonstring nullable required
scheduledAtstring date-time nullable required
platformConfigurationobject nullable required
socialAccountIdstring required
urlstring nullable required
titlestring nullable required
postedAtstring date-time nullable required
errorMessagestring nullable required
createdAtstring date-time required
updatedAtstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.