Experiments
Create experiment protocol
Create a draft protocol with a name and optional description and migration metadata. The organization's default subject type is selected. Use PATCH to configure the draft, then publish it before creating experiments from it.
post/api/v2/experiments/protocols
Request
- Base URLhttps://api.datadoghq.com
- Auth
- API key in header DD-API-KEY and API key in header DD-APPLICATION-KEY
- or OAuth 2Authorization code/oauth2/v1/authorizeToken URL/oauth2/v1/tokenScopesproduct_analytics_experiments_write
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Request body
Example request
{
"data": {
"attributes": {
"name": "Checkout conversion"
},
"type": "protocols"
}
}Response
Created
Example response
{
"data": {
"attributes": {
"archived_at": "2026-07-31T14:00:00Z",
"created_at": "2026-07-31T12:00:00Z",
"metric_groups": [],
"name": "Checkout conversion",
"status": "PUBLISHED",
"updated_at": "2026-01-01T00:00:00Z"
},
"id": "550e8400-e29b-41d4-a716-446655440000",
"type": "protocols"
}
}Changes
Changes to this operation have not been checked yet.