---
title: "Delete an AI Gateway data capture override"
method: DELETE
path: "/api/v2/data-capture/overrides/{id}"
tags: ["AI Gateway"]
---

# Delete an AI Gateway data capture override

`DELETE /api/v2/data-capture/overrides/{id}`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/data-capture/overrides/{id}`
- Auth: one of:
  - API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`
  - OAuth 2
    - Authorization code: `/oauth2/v1/authorize`
    - Token URL: `/oauth2/v1/token` scopes: `ai_gateway_config_write`
- TypeScript: <https://skmtc.dev/datadog/apis/datadog-api-v2-collection/docs/api/v2/data-capture/overrides/:id/delete.ts> (a function with typed inputs; its response is checked against the schema)

Delete an override using its `revision` and the current `configuration_revision`. If deleting the override can enable full capture for affected traffic, set `confirm_full_capture` to `true`. Returns HTTP 409 when `configuration_revision` or the override `revision` is stale, including a concurrent change during deletion. Missing revisions or required full-capture confirmation returns HTTP 400.

## Path parameters

- `id` string, uuid, required: Capture override UUID.

## Request body

- AiGatewayCaptureDeleteRequest: Request body for deleting a scoped data capture override.
  - `data` AiGatewayCaptureDeleteRequestData, required: Override identifier, revisions, and confirmation required for deletion.
    - `attributes` AiGatewayCaptureDeleteRequestDataAttributes, required: Revisions and confirmation used to delete the override.
      - `configuration_revision` string, required: Opaque revision of the organization default and all overrides. Writes require the revision returned by a current read or preview.
      - `confirm_full_capture` boolean: Set to `true` to confirm a change that can enable full capture, including a deletion that causes a `full_capture` override or the organization default to apply.
      - `mode` 'metadata_only' | 'full_capture': Capture mode for matching traffic.
      - `name` string: Display name of the override. Names need not be unique; identify overrides by `id`.
      - `operation` 'create' | 'replace' | 'delete': Proposed operation for preview. Write endpoints infer it from the HTTP method.
      - `revision` integer, required: Current override revision, required for replacement or deletion.
      - `scope` AiGatewayCaptureScope: All selected filters combine with AND, with one value per filter. The `model` and `provider` tags apply to each actual direct or routed attempt, including fallback destinations. Routes are not selectable filters. At least one filter is required. If any matching override uses `metadata_only`, that mode applies. Otherwise, if any matching override uses `full_capture`, that mode applies. The organization default applies only when no override matches. Overrides have no priority or specificity ordering.
        - `tags` object: Exact-match request tags with lowercase keys. The reserved `model` tag is the canonical model ID, and the reserved `provider` tag is the configured connection slug. The server sets both. Custom tags come from `x-dd-tag` headers. Keys and values must not have leading or trailing white space. Values are case-sensitive.
        - `team_id` string, uuid: UUID of a Datadog team. Matches the authorized team selected by the `x-ai-gateway-team` request header. Requests without this header do not match team-scoped overrides. Open-membership teams cannot scope overrides.
        - `user_id` string, uuid: Authenticated Datadog user UUID in this organization.
    - `id` string, uuid, required: UUID of the override to delete. Must match the `id` path parameter.
    - `type` 'data-capture-overrides', required: Data capture overrides resource type.

## Response `204`

No Content

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `429`: Too many requests

---

[API](https://skmtc.dev/datadog/apis/datadog-api-v2-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/revisions/3f70db624329?raw)