Update an auto monitor setup by external ID

Update an existing auto monitor setup by its external ID

PUT /v2/auto-monitor-setups/{external_id}

Update an auto monitor setup by external ID

cURL

curl --request PUT \
  --url https://api.traceloop.com/v2/auto-monitor-setups/{external_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "evaluators": [
    "hallucination",
    "toxicity"
  ],
  "evaluator_configs": [
    {
      "slug": "char-count",
      "scope": "session"
    },
    {
      "slug": "toxicity",
      "scope": "trace"
    },
    {
      "slug": "pii"
    }
  ],
  "selector": {}
}
'

200

{
  "created_at": "<string>",
  "env_project_id": "<string>",
  "evaluators": [
    {
      "binding_id": "<string>",
      "error_message": "<string>",
      "evaluator_id": "<string>",
      "evaluator_type": "<string>",
      "input_schema": [
        {
          "name": "<string>",
          "type": "string",
          "description": "<string>",
          "enum_values": [
            "<string>"
          ],
          "label": "<string>"
        }
      ],
      "output_schema": [
        {
          "name": "<string>",
          "type": "string",
          "description": "<string>",
          "enum_values": [
            "<string>"
          ],
          "label": "<string>"
        }
      ],
      "processed_at": "<string>",
      "scope": "trace",
      "status": "<string>"
    }
  ],
  "external_id": "<string>",
  "id": "<string>",
  "init_rules": [
    {
      "key": "<string>",
      "op": "equals",
      "source": "<string>",
      "value": "<string>",
      "value_type": "<string>"
    }
  ],
  "org_id": "<string>",
  "project_id": "<string>",
  "status": "<string>",
  "updated_at": "<string>"
}

Authorizations

Authorization · string · header · required

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

Path Parameters

external_id · string · required

Auto monitor setup external ID

Body

application/json

Fields to update

On update, both evaluators and evaluator_configs may be empty — in that case the evaluator list is not modified. If both are provided, evaluator_configs wins and evaluators is ignored.

evaluators · string[]

List of evaluator slugs to run on matched spans. Use evaluator_configs instead when you need to set a per-evaluator scope. If both fields are provided, evaluator_configs takes precedence and this field is ignored.

Example:

["hallucination", "toxicity"]

evaluator_configs · object[]

List of per-evaluator configurations. Each entry declares an evaluator slug and an optional scope (session, trace, or span) controlling the granularity at which the evaluator runs. Takes precedence over evaluators when both are provided.

Show child attributes

Example:

[
  { "slug": "char-count", "scope": "session" },
  { "slug": "toxicity", "scope": "trace" },
  { "slug": "pii" }
]

selector · object

Map of span attributes to filter which spans this monitor applies to. Keys are span attribute names (e.g. gen_ai.system, gen_ai.request.model) and values can be strings, numbers, or booleans. Example: {"gen_ai.system": "openai", "gen_ai.request.model": "gpt-4o", "gen_ai.request.max_tokens": 1000}

Response

200

application/json

OK

created_at · string

env_project_id · string

evaluators · object[]

Show child attributes

external_id · string

id · string

init_rules · object[]

Show child attributes

org_id · string

project_id · string

status · string

updated_at · string