---
title: "Retry the failed platforms of a failed or partially failed post"
method: POST
path: "/posts/{id}/retry"
tags: ["Posts"]
---

# Retry the failed platforms of a failed or partially failed post

`POST /posts/{id}/retry`

Re-publishes ONLY the platforms that failed, on the same post — platforms that already succeeded are never re-published. Works on posts with status `failed` (every platform failed) or `warning` (some platforms failed). The retry is processed asynchronously by the publishing queue, usually within a minute; poll `GET /posts/{id}` to see the outcome (`status` becomes `published` and `published_urls` gains the platform URL on success, or the platform's entry reappears in `errors` on another failure). Each platform can be retried at most 3 times; after that, create a new post. Platforms dismissed with 'ignore' in the dashboard are not retried.

## Path parameters

- `id` string, required

## Response `200`

Retry queued

- object
  - `data` object
    - `id` string
    - `status` string
    - `platforms` string[] — The failed platforms being retried
    - `message` string

## Other responses

- `400` — Post is not retryable: `invalid_status` (post is not failed/warning), `nothing_to_retry` (no failed platforms recorded — e.g. legacy posts without per-platform tracking), or `max_retries_reached` (a failed platform has already been retried 3 times; the response lists the exhausted platforms)
- `404` — Post not found

---

[API](https://skmtc.dev/omnisocials/apis/omnisocials-api.md) · [All operations](https://skmtc.dev/omnisocials/apis/omnisocials-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/omnisocials/omnisocials-api/revisions/e53b89af0b98/schema)