Skip to main content
PATCH
Edit a detector

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

detector_id
string
required

Body

application/json

Body for editing a detector; template is immutable and not accepted.

project_id
string
required
detection_model
string | null
detection_provider
string | null
detection_source
enum<string> | null
Available options:
system,
byok
enable_rca
boolean
enabled
boolean

The pause switch. Detection is ingestion-triggered, so enabling starts nothing retroactively.

name
string
output_schema
any[]

Replaces the whole output schema array

prompt
string

Detector instructions, stored verbatim. There is no reset to a template's default on update: send the canonical text to restore it.

sample_rate
integer
trigger_conditions
any[]

Replaces the whole trigger array; [] removes the trigger so every completed trace is evaluated. Each condition is {field, op, value} (metadata also takes key): model_name/environment take =, !=; cost/total_tokens/duration_ms/errors take >, >=, <, <=, =; metadata takes =, contains.

Response

Successful Response

The updated detector.

changed
string[]
required
detector
DetectorRow · object
required

A detector as the write service returns it.

updated
boolean
required