Appends new examples to an existing dataset and a particular version. If the version is not passed, the latest version is selected. The inserted examples will be assigned autogenerated, unique IDs.
Example payload
examples[] may contain any user-defined fields.id, created_at, updated_at.
Requests that contain these fields in any example will be rejected.{} is invalid).Valid example (create)
{
"examples": [
{ "question": "What is 2+2?", "answer": "4", "topic": "math" }
]
}
Invalid example (contains system fields)
{
"examples": [
{ "id": "ex_1", "input": "Hello" } // ❌ 'id' not allowed on create
]
}
⚠️ Beta Warning: This endpoint is in beta, read more here.
Most Arize AI endpoints require authentication. For those endpoints that require authentication, include your API key in the request header using the format
Authorization: Bearer <api-key>The unique identifier of the dataset A universally unique identifier
The unique identifier of the dataset version A universally unique identifier
Body containing dataset examples for insert (append) operation with auto-generated IDs
Array of examples to append to the dataset version
A dataset object
A dataset is a structured collection of examples used to test and evaluate LLM applications. Datasets allow you to test models consistently across any real-world scenarios and edge cases, quickly identify regressions, and track measurable improvements.
Unique identifier for the dataset
Name of the dataset
Unique identifier for the space this dataset belongs to
Timestamp for when the dataset was created
Timestamp for the last update of the dataset
List of versions associated with this dataset