---
title: "Restart Workflow"
method: POST
path: "/workflows/restart"
tags: ["workflows"]
---

# Restart Workflow

`POST /workflows/restart`

Restart failed workflow jobs using RQ Groups.

## Request body

- RestartWorkflowRequest — Request schema for restarting a workflow.
  - `document_id` string, uuid, required — Document UUID to restart
  - `failed_only` boolean — Only restart failed jobs

## Response `200`

Successful Response

- StartWorkflowResponse — Response schema for starting a workflow.
  - `workflow_id` string, required — Workflow ID
  - `document_id` string, required — Document ID
  - `group_id` string, required — RQ Group ID for tracking
  - `status` string, required — Initial workflow status
  - `reference` string, nullable — Document reference
  - `restarted_jobs` string[], nullable — List of restarted job IDs (for restarts)

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `422` — Unprocessable Content
- `500` — Internal Server Error

---

[API](https://skmtc.net/hf/apis/extralit-v1.md) · [All operations](https://skmtc.net/hf/apis/extralit-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hf/extralit-v1/revisions/e9da3a893a88/schema)