---
title: "Delete Agent Telemetry Rows"
method: DELETE
path: "/v1/agent-telemetry"
tags: ["agent-telemetry"]
---

# Delete Agent Telemetry Rows

`DELETE /v1/agent-telemetry`

Delete agent_telemetry rows by explicit ids or by filter (standalone).

Target either an explicit selection (`ids`) or everything matching a filter
(`by_filter: true` plus optional `user_id` / `api_key_id` / `name` / date
range). A selection matching zero rows succeeds with `deleted: 0`.
Master-key only.

## Request body

- AgentTelemetryDeleteRequest — Selection of agent_telemetry rows to delete.
  - `api_key_id` union
    - string
    - string[]
  - `by_filter` boolean
  - `end_date` string, date-time, nullable
  - `ids` string[], nullable
  - `name` string, nullable
  - `start_date` string, date-time, nullable
  - `user_id` union
    - string
    - string[]

## Response `200`

Successful Response

- AgentTelemetryDeleteResult — How many rows the delete removed.
  - `deleted` integer

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/mozilla-ai/apis/otari.md) · [All operations](https://skmtc.net/mozilla-ai/apis/otari/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mozilla-ai/otari/revisions/3f47ecc61aff/schema)