Skip to main content
POST
Start a batch

Authorizations

x-preuve-key
string
header
required

Your API key (prv_...), sent as-is. It is the only credential the API needs - see the Authentication guide.

Body

application/json
clientRunId
string
required

Idempotency id for the whole batch.

scanType
enum<string>
required

Default scanType applied to every item; each item may override.

Available options:
starter,
deep
items
object[]
required
Required array length: 1 - 5 elements
name
string
enrichmentMode
enum<string>
Available options:
core,
none

Response

Existing batch replayed via clientRunId. Nothing new was created and nothing new was consumed; the body is the batch's current state.

id
string<uuid>
clientRunId
string
name
string | null
status
string
counts
object
items
object[]

One entry in a batch. Either a real run or a late-collision stub; the two are told apart by id, which is null only on the stub.