Experiments
Publish experiment protocol
Publish a valid draft protocol. The protocol must have a name and subject type. Supplied references and settings must be valid. An exposure schedule or targeting rules require an environment. Enabled limits require their values. Configurable template fields must have a value before they can be locked.
Independent configuration errors are returned together in the JSON:API errors array with source.pointer values that identify the fields. Earlier request and reference checks can stop on the first error. A failed request leaves the protocol unchanged.
post/api/v2/experiments/protocols/{protocol_id}/publish
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.
Path parameters
protocol_idstring uuid required
The UUID of the protocol.
Example:550e8400-e29b-41d4-a716-446655440000
Response
OK
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.