Skip to main content
POST
This endpoint uploads a file. It does not trigger processing. To upload and process in one step, use Run Workflow instead.

Request Body

This endpoint uses multipart/form-data:

Authorizations

Authorization
string
header
required

API key issued from app.anyformat.ai/api-key. Send as Authorization: Bearer <key>.

Path Parameters

workflow_id
string
required

Body

multipart/form-data
files
string[]
required

Response

Successful Response

Response from creating a file collection. Contains the collection ID and the status of each uploaded file.

id
string
required

Unique identifier of the newly created file collection.

Example:

"069dcc2c-e14c-7606-8000-2ee4fb17b4e1"

files
FileItem · object[]
required

List of files included in the collection, with their upload status.

workflow_id
string
required

The UUID of the workflow this collection belongs to.

Example:

"0686bb97-8c30-70f0-8000-97669e000eb8"

name
string | null

Human-readable name for the collection.

rejected
RejectedFileItem · object[]

Files the backend refused to accept — unsupported extension at slot-time or disguised bytes at register-time. Empty when every file uploaded cleanly.