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

# Run workflow

> Run a workflow manually, by triggering a new job if none is currently active.

<Note>
  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](/api-reference/api/job/create-job) instead.
</Note>

## Path parameters

<ParamField path="workflow_id" type="string" required>
  The unique identifier of the workflow to run.
</ParamField>

## Body

<ParamField body="input_files" type="array">
  One or more files to process at runtime. Provide as a multipart file upload.
</ParamField>

## Response

<ResponseField name="id" type="string" required>
  Unique identifier for the job.
</ResponseField>

<ResponseField name="workflow_id" type="string" required>
  ID of the workflow that triggered this job.
</ResponseField>

<ResponseField name="workflow_name" type="string" required>
  Name of the workflow that triggered this job.
</ResponseField>

<ResponseField name="status" type="string" required>
  Job status: `SCHEDULED`, `IN_PROGRESS`, `COMPLETED`, `STOPPED`, or `FAILED`.
</ResponseField>

<ResponseField name="created_at" type="string" required>
  ISO 8601 timestamp when the job was created.
</ResponseField>

<ResponseField name="runtime" type="string">
  Job duration.
</ResponseField>

<ResponseField name="input_file_ids" type="array">
  IDs of input files submitted with the job.
</ResponseField>

<ResponseField name="output_node_files" type="array">
  Metadata about output files produced by the job.
</ResponseField>

<ResponseField name="job_type" type="string">
  Job type. Defaults to `ephemeral`.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl --request POST \
    --url "${UNSTRUCTURED_API_URL}/api/v1/workflows/f0a1b2c3-4d5e-6f7a-8b9c-0d1e2f3a4b5c/run" \
    --header "unstructured-api-key: ${UNSTRUCTURED_API_KEY}"
  ```

  ```python Python SDK theme={null}
  import os
  from unstructured_client import UnstructuredClient
  from unstructured_client.models.operations import RunWorkflowRequest

  client = UnstructuredClient(
      api_key_auth=os.getenv("UNSTRUCTURED_API_KEY"),
      server_url=os.getenv("UNSTRUCTURED_API_URL"),
  )

  response = client.workflows.run_workflow(
      request=RunWorkflowRequest(
          workflow_id="f0a1b2c3-4d5e-6f7a-8b9c-0d1e2f3a4b5c"
      )
  )
  print(response)
  ```

  ```python Python SDK (async) theme={null}
  import asyncio
  import os
  from unstructured_client import UnstructuredClient
  from unstructured_client.models.operations import RunWorkflowRequest

  async def run_workflow():
      client = UnstructuredClient(
          api_key_auth=os.getenv("UNSTRUCTURED_API_KEY"),
          server_url=os.getenv("UNSTRUCTURED_API_URL"),
      )
      response = await client.workflows.run_workflow_async(
          request=RunWorkflowRequest(
              workflow_id="f0a1b2c3-4d5e-6f7a-8b9c-0d1e2f3a4b5c"
          )
      )
      print(response)

  asyncio.run(run_workflow())
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "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"
  }
  ```
</ResponseExample>