---
title: "Retry Failed Pin"
method: POST
path: "/v1/pins/{pin_id}/retry"
tags: ["Pins"]
---

# Retry Failed Pin

`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

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.

## Path parameters

- `pin_id` string, uuid, required

## Headers

- `x-api-key` string, nullable
- `authorization` string, nullable

## Request body

- PinRetryRequest: Optional overrides when retrying a failed pin.
  - `board_id` string, nullable: New Pinterest board ID to publish to (overrides original)
  - `account_id` string, uuid, nullable: New Pinterest account ID to publish with (overrides original)

## Response `200`

Successful Response

- PinResponse: Response schema for a pin.
  - `id` string, uuid, required
  - `workspace_id` string, uuid, required
  - `pinterest_account_id` string, uuid, required
  - `status` 'queued' | 'deferred' | 'publishing' | 'published' | 'failed', required: Pin status enum.
  - `media_type` 'image' | 'video', required: Pin media type enum.
  - `title` string, required
  - `description` string, nullable
  - `related_terms` string[], nullable
  - `alt_text` string, nullable
  - `dominant_color` string, nullable
  - `cover_image_url` string, nullable
  - `link_url` string, nullable
  - `media_url` string, required
  - `image_url` string, required
  - `asset_id` string, uuid, nullable
  - `board_id` string, required
  - `pinterest_pin_id` string, nullable
  - `error_code` string, nullable
  - `error_message` string, nullable
  - `idempotency_key` string, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `published_at` string, date-time, nullable
  - `failed_at` string, date-time, nullable: When the pin failed; set only while status is failed and cleared by a retry, like error_code
  - `removed_from_pinterest_at` string, 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.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/pinbridge/apis/pinbridge-api.md) · [All operations](https://skmtc.dev/pinbridge/apis/pinbridge-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pinbridge/apis/pinbridge-api/revisions/b17603589d01?raw)