VOOZH about

URL: https://docs.datadoghq.com/llm_observability/experiments/api/

⇱ Experiments API


For AI agents: A markdown version of this page is available at https://docs.datadoghq.com/llm_observability/experiments/api.md. A documentation index is available at /llms.txt.

Experiments API

This product is not supported for your selected Datadog site. ().

As an alternative to using Agent Observability Experiments with the Python SDK, you can use the Experiments HTTP API to create and run experiments.

Postman quickstart

Datadog highly recommends importing the Experiments Postman collection into Postman. Postman’s View documentation feature can help you better understand this API.

Request format

FieldTypeDescription
dataObject: DataThe request body is nested within a top level data field.

Example: Creating a dataset

{
 "data": {
 "type": "datasets", # request type
 "attributes": {
 "name": "Dataset example",
 "description": "Description example"
 }
 }
}

Response format

FieldTypeDescription
dataObject: DataThe request body of an experimentation API is nested within a top level data field.
metaObject: PagePagination attributes.

Example: Retrieving datasets

{
 "data": [
 {
 "id": "4ac5b6b2-dcdb-40a9-ab29-f98463f73b4z",
 "type": "datasets",
 "attributes": {
 "created_at": "2025-02-19T18:53:03.157337Z",
 "description": "Description example",
 "name": "Dataset example",
 "updated_at": "2025-02-19T18:53:03.157337Z"
 }
 }
 ],
 "meta": {
 "after": ""
 }
}

Object: Data

FieldTypeDescription
idstringThe ID of an experimentation entity.
Note: Set your ID field reference at this level.
typestringIdentifies the kind of resource an object represents. For example: experiments, datasets, etc.
attributesjsonContains all the resource’s data except for the ID.

Object: Page

FieldTypeDescription
afterstringThe cursor to use to get the next results, if any. Provide the page[cursor] query parameter in your request to get the next results.

Projects API

Request type: projects

Datasets API

Request type: datasets

Experiments API

Request type: experiments