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, malformed, unknown, revoked, inactive or expired key returns 401; a key without the permission, scope or plan an operation needs returns 403.

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

Keys this body does not declare are ignored, and the response's warnings name them, until 2026-11-02; from 2026-11-02 they are refused with 422 extra_forbidden naming the accepted keys.

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.