GuidesAPI ReferenceProcessor Changelog
GuidesAPI ReferenceProcessor Changelog
    • Getting Started
    • API Versioning
    • SDKs
  • Processor Endpoints
    • POSTRun Processor
    • GETList Processor Runs
    • GETGet Processor Run
    • POSTCancel Processor Run
    • DELDelete Processor Run
    • GETGet Batch Processor Run
    • POSTCreate Processor
    • POSTUpdate Processor
    • POSTPublish Processor Version
    • GETGet Processor Version
    • GETList Processor Versions
  • Workflow Endpoints
    • POSTRun Workflow
    • GETGet Workflow Run
    • GETList Workflow Runs
    • POSTUpdate Workflow Run
    • POSTCancel Workflow Run
    • DELDelete Workflow Run
    • POSTCreate Workflow
    • POSTBatch Run Workflow
    • POSTCorrect Workflow Run Outputs
  • Parse Endpoints
    • POSTParse File
    • POSTParse File Async
    • GETGet Parser Run
    • DELDelete Parser Run
  • File Endpoints
    • POSTUpload File
    • GETGet File
    • DELDelete File
    • GETList Files
    • POSTCreate File
  • Evaluation Set Endpoints
    • GETGet Evaluation Set
    • GETList Evaluation Sets
    • POSTCreate Evaluation Set
    • GETList Evaluation Set Items
    • POSTCreate Evaluation Set Item
    • POSTUpdate Evaluation Set Item
    • DELDelete Evaluation Set Item
    • POSTBulk Create Evaluation Set Items
LogoLogo
Workflow Endpoints

POST
https://api.extend.ai/workflow_runs
POST
/workflow_runs
1curl -X POST https://api.extend.ai/workflow_runs \
2     -H "x-extend-api-version: " \
3     -H "Authorization: Bearer <token>" \
4     -H "Content-Type: application/json" \
5     -d '{
6  "workflowId": "workflow_id_here"
7}'
Try it
200Successful
1{
2  "success": true,
3  "workflowRuns": [
4    {
5      "object": "workflow_run",
6      "id": "workflow_run_TcgplCsALH1I-cvG93mWa",
7      "name": "My Workflow Run",
8      "url": "https://dashboard.extend.ai/workflows/workflow_YH1ZEST4sxgUT7w84KBGa?workflowRunId=workflow_run_TcgplCsALH1I-cvG93mWa",
9      "status": "PENDING",
10      "metadata": {},
11      "files": [
12        {
13          "object": "file",
14          "id": "file_v8gqaWzgTnSyIMZfrlEba",
15          "name": "My File",
16          "metadata": {
17            "pageCount": {},
18            "parentSplit": {}
19          },
20          "createdAt": "2025-05-12T21:34:54.455000+00:00",
21          "updatedAt": "2025-05-12T21:34:54.483000+00:00",
22          "type": "PDF",
23          "presignedUrl": {},
24          "parentFileId": {},
25          "contents": {}
26        }
27      ],
28      "initialRunAt": "2025-05-12T21:34:54.477000+00:00",
29      "reviewed": false,
30      "outputs": [],
31      "stepRuns": [],
32      "workflow": {
33        "object": "workflow",
34        "id": "workflow_YH1ZEST4sxgUT7w84KBGa",
35        "version": "1",
36        "name": "My Workflow"
37      },
38      "batchId": "batch_kCz2ht2a",
39      "failureReason": {},
40      "failureMessage": {},
41      "reviewedBy": {},
42      "rejectionNote": {},
43      "reviewedAt": {},
44      "startTime": {},
45      "endTime": {}
46    }
47  ]
48}
Was this page helpful?
Previous

Get Workflow Run

Next
Built with
Run a Workflow with files. A Workflow is a sequence of steps that process files and data in a specific order to achieve a desired outcome. A WorkflowRun will be created for each file processed. A WorkflowRun represents a single execution of a workflow against a file.
Run Workflow

Authentication

AuthorizationBearer
Bearer authentication of the form `Bearer <token>`, where token is your auth token.

Headers

x-extend-api-version"2025-04-21"Optional
API version to use for the request. If you do not specify a version, you will either receive a `400 Bad Request` or be set to a previous legacy version. See [API Versioning](/developers/api-versioning) for more details.

Request

This endpoint expects an object.
workflowIdstringRequired
The ID of the workflow to run. Example: `"workflow_BMdfq_yWM3sT-ZzvCnA3f"`
fileslist of objectsOptional
An array of files to process through the workflow. Either the `files` array or `rawTexts` array must be provided. Supported file types can be found [here](/product/general/supported-file-types). There is a limit if 50 files that can be processed at once using this endpoint. If you wish to process more at a time, consider using the [Batch Run Workflow](/developers/api-reference/workflow-endpoints/batch-run-workflow) endpoint.
rawTextslist of stringsOptional
An array of raw strings. Can be used in place of files when passing raw data. The raw data will be converted to `.txt` files and run through the workflow. If the data follows a specific format, it is recommended to use the files parameter instead. Either `files` or `rawTexts` must be provided.
versionstringOptional
An optional version of the workflow that files will be run through. This number can be found when viewing the workflow on the Extend platform. When a version number is not supplied, the most recent published version of the workflow will be used. If no published versions exist, the draft version will be used. To run the `"draft"` version of a workflow, use `"draft"` as the version. Examples: - `"3"` - Run version 3 of the workflow - `"draft"` - Run the draft version of the workflow
priorityintegerOptional>=1<=100Defaults to 50
An optional value used to determine the relative order of WorkflowRuns when rate limiting is in effect. Lower values will be prioritized before higher values.
metadatamap from strings to anyOptional
A optional metadata object that can be assigned to a specific WorkflowRun to help identify it. It will be returned in the response and webhooks. You can place any arbitrary `key : value` pairs in this object.

Response

Successfully created workflow runs
successboolean
workflowRunslist of objects
An array of WorkflowRun objects, with each WorkflowRun corresponding to a single File that was passed in.

Errors

An optional value used to determine the relative order of WorkflowRuns when rate limiting is in effect. Lower values will be prioritized before higher values.
Successfully created workflow runs

An optional version of the workflow that files will be run through. This number can be found when viewing the workflow on the Extend platform. When a version number is not supplied, the most recent published version of the workflow will be used. If no published versions exist, the draft version will be used. To run the "draft" version of a workflow, use "draft" as the version.

Examples:

  • "3" - Run version 3 of the workflow
  • "draft" - Run the draft version of the workflow

Bearer authentication of the form Bearer <token>, where token is your auth token.

An array of raw strings. Can be used in place of files when passing raw data. The raw data will be converted to .txt files and run through the workflow. If the data follows a specific format, it is recommended to use the files parameter instead. Either files or rawTexts must be provided.

API version to use for the request. If you do not specify a version, you will either receive a 400 Bad Request or be set to a previous legacy version. See API Versioning for more details.

An array of files to process through the workflow. Either the files array or rawTexts array must be provided. Supported file types can be found here. There is a limit if 50 files that can be processed at once using this endpoint. If you wish to process more at a time, consider using the Batch Run Workflow endpoint.

The ID of the workflow to run.

Example: "workflow_BMdfq_yWM3sT-ZzvCnA3f"

A optional metadata object that can be assigned to a specific WorkflowRun to help identify it. It will be returned in the response and webhooks. You can place any arbitrary key : value pairs in this object.