Skip to main content
POST
Create Interactions Bulk

Authorizations

Authorization
string
header
required

Mixpeek API key, sent as Authorization: Bearer mxp_sk_.... Create one in Studio under Settings → API Keys, or with an admin key via POST /v1/organizations/users/{user_email}/api-keys. A missing header returns 403; an invalid or revoked key returns 401.

X-Namespace
string
header
required

Namespace id (ns_...), not the namespace name. This scopes the request rather than authenticating it, and it is required on every operation marked x-mixpeek-namespace-scoped.

Body

application/json

Record many interactions in one call — for backfilling historical logs.

The intended use is migrating an existing click/purchase history into Mixpeek: send the interactions in chunks (≤ 1000 per call) with each one's occurred_at set to its true timestamp, so learned-fusion temporal decay weights them correctly. Backfilled events bypass the real-time session cache.

interactions
SearchInteraction · object[]
required

Interactions to record (1-1000). For historical backfill, set each interaction's occurred_at to its true time.

Required array length: 1 - 1000 elements

Response

Successful Response

Result of a bulk interaction write.

created
integer
required

Number of interactions accepted for write.

failed
integer
default:0

Number that could not be processed (see errors).

errors
string[]

Per-interaction error messages (indexed), if any failed.

results
BulkInteractionItemResult · object[]

Per-item results with assigned interaction IDs.