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

string
required
Unique identifier for the auto monitor setup. Used to reference it in future requests (get, update, delete).Example: "my-agent-monitor-1"
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.
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