---
title: "Get Detector"
method: GET
path: "/api/v1/public/detectors/{detector_id}"
tags: ["Detectors"]
---

# Get Detector

`GET /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

Get one detector's full configuration for the key's project.

## Path parameters

- `detector_id` string, required

## Query parameters

- `project_id` string, nullable: Target project for the request. Required when authenticating with a user session token (a user credential is only meaningful scoped to a project); for an API key it is optional and, if given, must match the key's project.

## Response `200`

Successful Response

- DetectorDetail: A detector's full configuration (Postgres ``detectors`` + optional trigger). ``trigger_conditions`` comes from ``detector_triggers.conditions`` and is None when the detector has no trigger row (it then runs on every sampled trace).
  - `created_at` string, date-time, required
  - `detection_model` string, nullable, required
  - `detection_provider` string, nullable, required
  - `detection_source` string, nullable, required
  - `detector_id` string, required
  - `enable_rca` boolean, required
  - `enabled` boolean, required
  - `name` string, required
  - `output_schema` unknown, required
  - `prompt` string, required
  - `sample_rate` integer, required
  - `template` string, required
  - `trigger_conditions` unknown, required
  - `updated_at` string, date-time, required

## Other responses

- `401`: Authentication failed
- `404`: Detector not found
- `422`: Validation Error
- `500`: Failed to read detector
- `503`: Authentication 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)