AI Gateway
Replace an AI Gateway data capture override
Replace an override using its revision and the current configuration_revision. Changes to capture overrides don't affect routing rules. Returns HTTP 409 when configuration_revision or the override revision is stale, including a concurrent change during replacement. Missing revisions or required full-capture confirmation returns HTTP 400.
put/api/v2/data-capture/overrides/{id}
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/tokenScopesai_gateway_config_write
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Path parameters
idstring uuid required
Capture override UUID.
Data capture override ID.
Request body
Example request
{
"data": {
"attributes": {
"configuration_revision": "capture-revision-1",
"metadata_capture": [
"tool_usage",
"tool_output_size",
"tool_names"
],
"mode": "metadata_only",
"name": "Research",
"operation": "create",
"revision": 1,
"scope": {
"tags": {
"env": "prod"
}
}
},
"id": "11111111-1111-4111-8111-111111111111",
"type": "data-capture-overrides"
}
}Response
OK
Example response
{
"data": {
"attributes": {
"metadata_capture": [
"tool_usage",
"tool_output_size",
"tool_names"
],
"mode": "metadata_only",
"name": "Research",
"revision": 1,
"scope": {
"tags": {
"env": "prod"
}
}
},
"id": "11111111-1111-4111-8111-111111111111",
"type": "data-capture-overrides"
}
}Changes
Changes to this operation have not been checked yet.