---
title: "Start Workflow"
method: POST
path: "/workflows/start"
tags: ["workflows"]
---

# Start Workflow

`POST /workflows/start`

Start PDF processing workflow for a document.

## Request body

- StartWorkflowRequest — Request schema for starting a workflow.
  - `document_id` string, uuid, required — Document UUID to process
  - `workspace_name` string, required — Workspace name
  - `reference` string, nullable — Document reference for tracking
  - `force` boolean — Force restart if workflow already exists
  - `wait` boolean — Wait for job to finish before returning
  - `timeout` integer, nullable — Max seconds to wait if wait=True

## 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)