Push a capture batch

Push many captures in a single request. Each item is processed independently, so a malformed entry fails on its own without rejecting the whole batch.

Authentication

x-api-keystring

Your Living Brain API key. Create one from the dashboard; keys are scoped to an organization and carry the role of the member they were issued to.

Path parameters

brainIdstringRequired
Brain id

Headers

x-subject-idstringRequired
Identifies the end user the request is made on behalf of. Brains are owned by a subject, so this determines which brains the caller can see.

Request

This endpoint expects an object.
itemslist of objectsRequired
Captures to ingest

Response

ingestedinteger
Number of sources ingested
sourceslist of objects
One ingest source per accepted item, in the order submitted.

Errors

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error
429
Too Many Requests Error