Skip to main content
POST
/
api
/
v1
/
workflows
/
{workflow_id}
/
run
curl --request POST \
  --url "${UNSTRUCTURED_API_URL}/api/v1/workflows/f0a1b2c3-4d5e-6f7a-8b9c-0d1e2f3a4b5c/run" \
  --header "unstructured-api-key: ${UNSTRUCTURED_API_KEY}"

{
  "id": "a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
  "workflow_id": "f0a1b2c3-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
  "workflow_name": "my-workflow",
  "status": "SCHEDULED",
  "created_at": "2026-04-29T10:00:00Z",
  "runtime": null,
  "input_file_ids": null,
  "output_node_files": null,
  "job_type": "ephemeral"
}

Documentation Index

Fetch the complete documentation index at: https://docs.unstructured.io/llms.txt

Use this file to discover all available pages before exploring further.

This endpoint creates a workflow that persists until it is explicitly deleted (a long-lived workflow). To create a workflow that exists only for the duration of a single job run using local files as input, use the create job endpoint instead.

​
Path parameters

​
workflow_id
string
required
The unique identifier of the workflow to run.

​
Body

​
input_files
array
One or more files to process at runtime. Provide as a multipart file upload.

​
Response

​
id
string
required
Unique identifier for the job.
​
workflow_id
string
required
ID of the workflow that triggered this job.
​
workflow_name
string
required
Name of the workflow that triggered this job.
​
status
string
required
Job status: SCHEDULED, IN_PROGRESS, COMPLETED, STOPPED, or FAILED.
​
created_at
string
required
ISO 8601 timestamp when the job was created.
​
runtime
string
Job duration.
​
input_file_ids
array
IDs of input files submitted with the job.
​
output_node_files
array
Metadata about output files produced by the job.
​
job_type
string
Job type. Defaults to ephemeral.
curl --request POST \
  --url "${UNSTRUCTURED_API_URL}/api/v1/workflows/f0a1b2c3-4d5e-6f7a-8b9c-0d1e2f3a4b5c/run" \
  --header "unstructured-api-key: ${UNSTRUCTURED_API_KEY}"

{
  "id": "a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
  "workflow_id": "f0a1b2c3-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
  "workflow_name": "my-workflow",
  "status": "SCHEDULED",
  "created_at": "2026-04-29T10:00:00Z",
  "runtime": null,
  "input_file_ids": null,
  "output_node_files": null,
  "job_type": "ephemeral"
}