Skip to main content
POST
/
v2
/
workflows
/
{workflow_id}
/
run
curl -X POST 'https://api.anyformat.ai/v2/workflows/550e8400-e29b-41d4-a716-446655440000/run/' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -F 'file=@/path/to/document.pdf'

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "accepted",
  "workflow_id": "550e8400-e29b-41d4-a716-446655440000"
}
Submit a file or text content for processing using a specific workflow. The process runs asynchronously, and you’ll receive a file UUID to poll for results.

​
Input Methods

You can submit content for processing in two ways:
  1. File Upload - Upload a binary file directly via multipart form data
  2. Text Input - Send plain text for processing
Only one input method can be used per request. Provide either file or text, not both.
The id returned in the response is a file UUID. Use it to poll for results via GET /v2/workflows/{workflow_id}/files/{id}/results/. The endpoint returns 412 while processing and 200 when results are ready.
curl -X POST 'https://api.anyformat.ai/v2/workflows/550e8400-e29b-41d4-a716-446655440000/run/' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -F 'file=@/path/to/document.pdf'

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "accepted",
  "workflow_id": "550e8400-e29b-41d4-a716-446655440000"
}

Headers

​
authorization
string | null

Path Parameters

​
workflow_id
string
required

Body

multipart/form-data
​
file
string | null
​
text
string | null

Response

Successful Response

Response for workflow run endpoint (v2) — collection UUID as identifier.

​
id
string
required
​
status
string
required
​
workflow_id
string
required