---
title: "Retry Import"
method: POST
path: "/saved/import/{list_id}/retry"
tags: ["saved"]
---

# Retry Import

`POST /saved/import/{list_id}/retry`

Retry a failed (or needs-review) import.

Two routes, both leaving the list back in `importing` and streaming to the
same `GET /saved/import/{list_id}/stream` the initial import used:

- **replay** — for a `failed` list with a stored run. `hatchet.runs.
  aio_replay(hatchet_run_id)` resumes the stored run from its failed task,
  reusing the outputs of tasks that already succeeded (no re-fetch, no
  re-extract). A failed run by definition has a failed task to re-run;
  replay of a fully-succeeded run is deliberately never relied on.
- **fresh** — a brand-new enqueue (new run). Taken when `force=true`, when
  there's no stored run to replay (`hatchet_run_id IS NULL` — e.g. a
  pre-column list), automatically for `failed_reason=
  'post_unavailable'` (replaying a deleted/private post just re-fails on the
  same cached step, so "the creator fixed it" needs a real re-fetch), and
  always for `needs_review`: that run's tasks all *succeeded* (finalize just
  judged the result thin), so there's nothing failed to replay — retrying a
  thin list should genuinely re-run it.

The side-effect (replay/enqueue) runs BEFORE the status flip is committed:
if it throws, the request 500s while the list stays failed/needs_review —
still retryable. Committing first would strand a list in 'importing' that no
workflow will ever finish (and this route's own status gate would then 409
every future retry).

## Path parameters

- `list_id` string, uuid, required

## Query parameters

- `force` boolean

## Response `200`

Successful Response

- ImportStartedOut
  - `list_id` string, uuid, required
  - `status` string, required
  - `already_imported` boolean

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/stardrift/apis/fastapi.md) · [All operations](https://skmtc.dev/stardrift/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/stardrift/fastapi/revisions/00746572572a/schema)