Run Workflow

Run a workflow with a file. A workflow is a sequence of steps that process files and data in a specific order to achieve a desired outcome. See [Async Processing](https://docs.extend.ai/2026-02-09/developers/async-processing) for a full guide on polling helpers and webhooks. ## Polling with the SDK The SDK provides a `createAndPoll` / `create_and_poll` method that handles polling automatically, returning when the run reaches a terminal state (`PROCESSED`, `FAILED`, `CANCELLED`, `NEEDS_REVIEW`, or `REJECTED`): <Tabs> <Tab title="TypeScript"> ```typescript const result = await client.workflowRuns.createAndPoll({ workflow: { id: "wf_abc123" }, file: { url: "https://..." } }); // Returns when the workflow run reaches a terminal state console.log(result.status); console.log(result.stepRuns); ``` </Tab> <Tab title="Python"> ```python result = client.workflow_runs.create_and_poll( workflow={"id": "wf_abc123"}, file={"url": "https://..."} ) # Returns when the workflow run reaches a terminal state print(result.status) print(result.step_runs) ``` </Tab> <Tab title="Java"> ```java var result = client.workflowRuns().createAndPoll(WorkflowRunCreateRequest.builder() .workflow(WorkflowReference.builder().id("wf_abc123").build()) .file(FileInput.builder().url("https://...").build()) .build()); // Returns when the workflow run reaches a terminal state System.out.println(result.getStatus()); System.out.println(result.getStepRuns()); ``` </Tab> </Tabs> <Warning>Workflow runs can take a long time. Complex workflows may run for hours. For long-running workflows, consider using [webhooks](https://docs.extend.ai/2026-02-09/product/webhooks/configuration) instead of polling.</Warning>