POST
/v1/experiment/{experiment_id}/insertInsert experiment events
Inserts a set of events into an experiment. Supply the events array with event data such as inputs, outputs, scores, metadata, and tags. The response provides the row identifiers generated or accepted for the inserted events.
- IdempotentThe SDK sends
Idempotency-Key, so a retried request is only applied once.
experiment_idstringrequired
The unique experiment identifier in UUID format.
Payload containing the experiment events to insert.
eventsarray<object>required
A list of experiment events to insert
200Returns an object containing `row_ids`, an array of identifiers corresponding one-to-one with the inserted events.
row_idsarray<string>required
The ids of all rows that were inserted, aligning one-to-one with the rows provided as input
400Returned when `events` is missing or a request value fails validation.
401Returned when the request does not include a valid API key.
403Returned when the API key does not have permission to insert experiment events.
429Returned when the API receives too many requests too quickly.
500Returned when an internal server error occurs.
Error handling
A 400 is returned when events is missing or the request does not satisfy the event schema. A 401 is returned without a valid API key, and a 403 is returned when the API key lacks permission to insert events. A 429 indicates that requests are being sent too quickly, while a 500 indicates an internal server error.