Skip to main content
POST
File matched items into a batch and start processing
Kick classified items into their default black-hole batches. Same black_hole billing as automatic assignment.

Authorizations

Authorization
string
header
required

Auth0 access token for a signed-in user. Send Authorization: Bearer <token>. The SPA and desktop agent use this. Prefer an organisation API key for server-to-server integrations.

Body

application/json

POST /api/v2/ingest/items/process/ body (CONTRACT §2.9).

item_ids
string[]
required
Maximum array length: 500
Required string length: 1 - 40
mode
enum<string>
required
  • new - new
  • append_latest - append_latest
Available options:
new,
append_latest
struct_slug
string
required
Required string length: 1 - 200

Response

200 body of POST /api/v2/ingest/items/process/.

batch
object
required

{id, name, web_url} — the batch shape shared by §2.8/§2.9.

assigned
integer
required
skipped
object[]
required