executeStepAsync

Execute a document processing step asynchronously

POST/api/steps-async/{stepId}

Process documents using the specified Step configuration asynchronously.

Supported file formats:

image/jpeg (JPEG)
image/png (PNG)
image/gif (GIF)
image/bmp (BMP)
image/webp (WebP)
application/pdf (PDF)

Size limits:

Maximum file size: 100MB
URL download timeout: 30 seconds

Request methods:

multipart/form-data: Direct file upload
application/json with base64: Base64-encoded image
application/json with URL: Image URL for automatic download

Async workflow:

Submit document for processing (returns execution_id)
Poll /api/steps-async/status/{executionId} for completion
Retrieve extracted data when status is SUCCESS

Authorization

ApiKeyAuth

AuthorizationBearer <token>

Bearer token for API authentication

In: header

Path Parameters

stepId*string

Step ID for processing

Request Body

image*string

Image file to process (see supported formats)

document_metadata?string

Custom metadata as JSON string or object. Returned in status endpoint and webhooks

Response Body

`application/json`

curl -X POST "https://app.docutray.com/api/steps-async/cm5vm9hx30001m5cgh0p9v8qa" \  -H "Content-Type: application/json" \  -d '{    "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAAA=="  }'

{
  "id": "cm5vm9hx30001m5cgh0p9v8qa",
  "status": "ENQUEUED",
  "step_id": "cm5vm9hx30001m5cgh0p9v8qb",
  "step_name": "Invoice Processing"
}

{
  "message": "Validation error",
  "errors": [
    "string"
  ]
}

{
  "error": "Invalid API key"
}

{
  "message": "Step not found or access denied"
}

{
  "message": "Step not found or access denied"
}

{
  "message": "URL download timeout (30000ms)"
}

{
  "message": "File exceeds maximum allowed size (100MB)"
}

{
  "message": "Unsupported Content-Type. Use multipart/form-data or application/json."
}

{
  "error": "Rate limit exceeded",
  "limitType": "minute",
  "limit": 0,
  "remaining": 0,
  "resetTime": 0,
  "retryAfter": 0
}

{
  "message": "Internal server error: Failed to initiate step processing"
}

executeStepAsync

Execute a document processing step asynchronously

Authorization

Path Parameters

Request Body

Response Body

202application/json

400application/json

401application/json

403application/json

404application/json

408application/json

413application/json

415application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`