Experiments
Archive experiment protocol
Archive a draft or published protocol. Archived protocols cannot be edited or used to create new experiments. Existing experiments keep their settings. Archiving an already archived protocol returns 409.
post/api/v2/experiments/protocols/{protocol_id}/archive
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
Query parameters
expected_updated_atstring
The updated_at value from the last read. Include the full timestamp, with fractional seconds. Returns 409 if another write changed the protocol. Omit to skip this check.
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.