Pins

Retry Failed Pin

Retry a failed pin.

Re-queues a pin that previously failed for publishing. Optionally override the board or Pinterest account to fix the root cause of the failure before retrying. The target board is preflighted the same way as on creation.

post/v1/pins/{pin_id}/retry

Request

  • Base URL: https://api.pinbridge.io (the document declares no server; this is the origin it was published from)
  • URL: https://api.pinbridge.io/v1/pins/{pin_id}/retry
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Path parameters

pin_idstring uuid required

Headers

x-api-keystring nullable
authorizationstring nullable

Request body

board_idstring nullable

New Pinterest board ID to publish to (overrides original)

account_idstring uuid nullable

New Pinterest account ID to publish with (overrides original)

Response

Successful Response

idstring uuid required
workspace_idstring uuid required
pinterest_account_idstring uuid required
status'queued' | 'deferred' | 'publishing' | 'published' | 'failed' required

Pin status enum.

media_type'image' | 'video' required

Pin media type enum.

titlestring required
descriptionstring nullable
related_termsstring[] nullable
alt_textstring nullable
dominant_colorstring nullable
cover_image_urlstring nullable
link_urlstring nullable
media_urlstring required
image_urlstring required
asset_idstring uuid nullable
board_idstring required
pinterest_pin_idstring nullable
error_codestring nullable
error_messagestring nullable
idempotency_keystring required
created_atstring date-time required
updated_atstring date-time required
published_atstring date-time nullable
failed_atstring date-time nullable

When the pin failed; set only while status is failed and cleared by a retry, like error_code

removed_from_pinterest_atstring date-time nullable

When PinBridge found that this published pin no longer exists on Pinterest (deleted there by hand or with its board). The pin keeps status published; null means it is live or has not been checked.

Changes

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