---
title: "Run Workflow"
method: POST
path: "/workflows/run"
tags: ["Workflow"]
---

# Run Workflow

`POST /workflows/run`

Start a workflow run and return a job ID for tracking.

Supports per-run spec overrides via `specs_override` and webhook input via
`webhook_payload`. API-triggered `read_csv` workflows must provide
`specs_override.resource_handle_id` from `/storage/csv/upload`.

## Query parameters

- `workflow_id` string, required — Workflow ID to run
- `save_json` boolean — Also save results as JSON
- `result_formats` string[], nullable — Result formats to save. Repeat the parameter for multiple values, e.g. result_formats=csv&result_formats=ndjson.

## Headers

- `x-api-key` string, nullable

## Request body

- BodyRunWorkflowWorkflowsRunPost
  - `specs_override` object, nullable — Optional specs to override first block specs
  - `webhook_payload` union — For API key auth only - can be a list or dict
    - object[]
    - object

## Response `200`

Successful Response

- WorkflowRunStartedResponse — Response when a workflow run is started.
  - `status` string, required — Run status, typically 'queued'.
  - `workflow_id` string, required — Workflow identifier.
  - `job_id` string, required — Job (run) identifier.
  - `cache_config` object, nullable — Cache configuration; only set by the custom-cache endpoint.
  - `already_started` boolean, nullable — True when the request was deduplicated via Idempotency-Key header.

## Other responses

- `400` — Request was rejected by the route's validation rules.
- `401` — Missing or invalid API key.
- `403` — Caller does not have access to this workflow.
- `404` — Workflow, run, or job not found.
- `409` — Workflow with the supplied ID already exists.
- `422` — Request body failed validation.
- `500` — Unexpected server error. Retry with backoff.

---

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