v5

latestOpenAPI 3.1.02026-08-025631,1012.8 MB

Retriever Interactions

Create Interactions Bulk

Record up to 1000 interactions in one call — for backfilling history.

Each interaction is enriched (reward_value, feature_uri/context promotion) exactly like the single-create path, then written. Reward config is resolved ONCE per distinct retriever (not per interaction). Dedup and the real-time session cache are skipped — bulk writes are for historical backfill, not live in-session adaptation. Set each interaction's occurred_at to its true timestamp so temporal decay weights it by real age.

post/v1/retrievers/interactions/batch

Request body

Example request

{
  "interactions": [
    {
      "description": "Minimal click interaction (query_snapshot and document_score optional)",
      "execution_id": "exec_minimal_123",
      "feature_id": "doc_abc123",
      "interaction_type": [
        "click"
      ],
      "position": 2,
      "session_id": "sess_minimal"
    }
  ]
}

Response

Successful Response

createdinteger required

Number of interactions accepted for write.

failedinteger

Number that could not be processed (see errors).

errorsstring[]

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