---
title: "Delete a detector"
method: DELETE
path: "/api/v1/public/detectors/{detector_id}"
tags: ["Detectors"]
---

# Delete a detector

`DELETE /api/v1/public/detectors/{detector_id}`

## Request

- Base URL: `https://app.traceroot.ai`
- URL: `https://app.traceroot.ai/api/v1/public/detectors/{detector_id}`
- Auth: HTTP bearer

Hard-delete a detector; its existing findings stay readable.

Requires MEMBER role or higher in the project's workspace (the write
service decides). Not idempotent: a second delete of the same id is a 404.

Args:
    request (Request): Incoming request (rate-limit plumbing).
    response (Response): Outgoing response (rate-limit plumbing).
    auth (AccountStampedAuth): Account-scope user auth (session token or
        CLI access JWT); its resolved ``user_id`` becomes the actor.
    detector_id (str): The detector to delete.
    project_id (str): The project the detector belongs to.
    reason (str): Why it is being deleted; recorded on the audit row.
    _live (None): Write-path liveness gate (blocks a revoked JWT session).

Returns:
    DeleteDetectorResponse: The removed detector.

Raises:
    HTTPException: The write service's 400/403/404 verbatim, or a 503
        when its response is ambiguous.

## Path parameters

- `detector_id` string, required

## Query parameters

- `project_id` string, required: The project the resource belongs to
- `reason` string, required: Why the resource is being deleted; recorded on the audit row

## Response `200`

Successful Response

- DeleteDetectorResponse: A hard-deleted detector (its findings stay readable).
  - `deleted` boolean, required
  - `detector` DeletedResource, required: What a delete removed: the row's id and name, for the receipt.
    - `id` string, required
    - `name` string, required
  - `reason` string, required

## Other responses

- `400`: Invalid request
- `401`: Authentication failed or session revoked
- `403`: Insufficient role or wrong credential kind
- `404`: Not found
- `422`: Validation Error
- `503`: Write service unavailable

---

[API](https://skmtc.dev/traceroot/apis/traceroot-public-api.md) - [All operations](https://skmtc.dev/traceroot/apis/traceroot-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/traceroot/apis/traceroot-public-api/revisions/ce6aef96c0d6?raw)