Sign in

v1

latestOpenAPI 3.0.02026-07-141,4077,1665.2 MB
LLM Observability

Upload records to an LLM Observability dataset

Upload records to a dataset from a file. The request is a multipart/form-data upload containing a single file part. Currently only CSV is supported. The CSV must include an input column. Optional columns are id, expected_output, metadata, and tags.

The response is a Server-Sent Events stream (text/event-stream) emitting progress updates while records are processed. The stream emits the following named events:

  • progress: incremental record counts written so far.
  • completed: terminal event with a JSON body containing records_created.
  • error: terminal event with a JSON body containing an error message.
post/api/v2/llm-obs/v2/{project_id}/datasets/{dataset_id}/records/upload

Path parameters

project_idstring required

The ID of the LLM Observability project.

dataset_idstring required

The ID of the LLM Observability dataset.

Query parameters

deduplicateboolean

Whether to skip records whose input already exists in the dataset. Defaults to false.

overwriteboolean

Whether to overwrite existing records that share the same user-provided id. Defaults to true.

tagsstring[]

Tags to apply to every uploaded record, in addition to any tags defined on individual rows. Can be repeated, e.g. tags=env:prod&tags=team:ai.

include[user_data]boolean

Whether to enrich the response with user metadata.

Response

OK