---
title: "Delete End User"
method: DELETE
path: "/api/v1/end-users/{external_id}"
tags: ["end-users"]
---

# Delete End User

`DELETE /api/v1/end-users/{external_id}`

## Request

- The document declares no server URL.
- Auth: one of:
  - API key in header `Otari-Key`
  - API key in header `x-api-key`

Delete an end user of the calling service key by the id the service names it by.

Requires a service key. An id no live end user of the key's user goes by answers 404. The end user's telemetry
and agent traces are erased; its row and spend are kept, so a request naming it again revives it with what it had
spent. An id with a '.' or '..' segment is refused with 400; ``DELETE /end-users?external_id=`` takes any id.

## Path parameters

- `external_id` string, required: The id the service names the end user by in a request's user field

## Response `204`

Successful Response

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-19** `74e66d6329e7`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/mozilla-ai/apis/otari/changes/api/v1/end-users/:external_id/delete.md)

---

[API](https://skmtc.dev/mozilla-ai/apis/otari.md) · [All operations](https://skmtc.dev/mozilla-ai/apis/otari/llms.txt) · [OpenAPI document](https://skmtc.dev/mozilla-ai/apis/otari/revisions/98fe156839e6?raw)