Start a processing pipeline

View as Markdown
Multipart upload of one or more files plus a JSON `options` part (declared files, actions, webhook URL, TTL). Files are sent as repeated parts named `files` (matched to `options.files[].field` by filename; undeclared ones get default processing), or — outside the generated SDKs — as one part per `options.files[].field`. The platform parses the files, runs the requested actions, emits signed webhooks, and holds the result until the TTL expires.

Authentication

AuthorizationBearer

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

Request

This endpoint expects a multipart form with multiple files.
optionsobjectRequired

The JSON-encoded options multipart part.

filesfilesRequired

The files to process, one multipart part each (part name files).

Response

Pipeline accepted.
processingIdstring
expiresAtdatetime
statusUrlstring

Errors

400
Bad Request Error
403
Forbidden Error