Skip to main content
POST
Upload new files and attach them to a batch in one round trip
Multipart upload into an existing batch, then enqueue extraction. Completing those files is a batch page charge. Same 64 MB / format rules as the library.

Authorizations

Authorization
string
header
required

Organisation API key from Settings → API / /api/keys/. The secret is shown once. Send Authorization: Bearer sk-abacus-…. One active key per organisation. Ingest (/api/v2/ingest/*) refuses API keys — that surface is Auth0-only with ingest:read / ingest:write scopes.

Path Parameters

batch_id
integer
required

Body

multipart/form-data
{key}
any

Response

Response shape for POST /api/v2/batches/{batch_id}/upload-and-add/.

Combines two skip arrays:

  • skipped — docs that uploaded successfully but couldn't attach to the batch (already in batch, etc.). Empty in the common path.
  • upload_skipped — files rejected before upload (wrong type, too large). Lets the SPA surface partial-upload feedback inline without a separate error toast.
added
object[]
required
skipped
object[]
required
upload_skipped
object[]
required