Skip to main content
POST
Create an Auto Monitor Setup
An auto monitor setup is an asynchronous process that attempts to create a Traceloop monitor based on the selector you provide. The selector is matched against your incoming spans — when a match is found, the monitor is created and the specified evaluators begin running on those spans.
All API requests require authentication. Pass your API key as a Bearer token in the Authorization header. See Authentication for details.

Request Body

external_id
string
required
Unique identifier for the auto monitor setup. Used to reference it in future requests (get, update, delete).Example: "my-agent-monitor-1"
evaluators
string[]
required
List of evaluator slugs to run on matched spans. Must contain at least one evaluator.Example: ["answer-relevancy", "toxicity-detector"]See the full list of available slugs in the Evaluator Slugs reference.
selector
object[]
An array of filter rules used to match spans. Each rule specifies an attribute key, a value to match, and a source indicating where the attribute lives. Only spans matching all provided rules will be evaluated.Each rule has the following fields:All available span and resource attributes can be found in your Traceloop traces page.

Example Request

Response

201 Created

Returns the created auto monitor setup object. The init_rules array reflects the stored selector — same shape as the input selector. The status field indicates the current state of the setup process:

400 Bad Request

Returned when the request body is invalid (e.g. missing required fields or empty evaluators array).

500 Internal Server Error