Traceloop

Traceloop auto-monitor-setups API

The auto-monitor-setups API from Traceloop — 2 operation(s) for auto-monitor-setups.

GitHub OpenAPI

Operations 5

GET /v2/auto-monitor-setups List auto monitor setups
POST /v2/auto-monitor-setups Create an auto monitor setup
DELETE /v2/auto-monitor-setups/{external_id} Delete an auto monitor setup by external ID
GET /v2/auto-monitor-setups/{external_id} Get an auto monitor setup by external ID
PUT /v2/auto-monitor-setups/{external_id} Update an auto monitor setup by external ID

Documentation

📖
Documentation
https://www.traceloop.com/docs/api-reference/introduction

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/traceloop/refs/heads/main/openapi/traceloop-auto-monitor-setups-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/traceloop/refs/heads/main/json-schema/traceloop-schema.json

Other Resources

🔗
Examples
https://raw.githubusercontent.com/api-evangelist/traceloop/refs/heads/main/examples/traceloop-examples.yml
🔗
Vocabulary
https://raw.githubusercontent.com/api-evangelist/traceloop/refs/heads/main/vocabulary/traceloop-vocabulary.yml
🔗
JSONLDContext
https://raw.githubusercontent.com/api-evangelist/traceloop/refs/heads/main/json-ld/traceloop-context.jsonld
🔗
APIsJSON
https://raw.githubusercontent.com/api-evangelist/traceloop/refs/heads/main/apis.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/traceloop-auto-monitor-setups-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

traceloop-auto-monitor-setups-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Traceloop Auto Monitor Setups API
  version: 1.0.0
  contact: {}
servers:
- url: https://api.traceloop.com
tags:
- name: auto-monitor-setups
paths:
  /v2/auto-monitor-setups:
    get:
      description: List all auto monitor setups for the organization with optional filters
      parameters:
      - description: Filter by status (e.g., pending, completed)
        in: query
        name: status
        schema:
          type: string
      - description: Filter by external ID
        in: query
        name: external_id
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/response.AutoMonitorSetupResponse'
                type: array
        '500':
          description: Internal error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/response.ErrorResponse'
      summary: List auto monitor setups
      tags:
      - auto-monitor-setups
    post:
      description: 'Create a new auto monitor setup for automatic monitor creation.


        The `selector` field is a map of span attribute key-value pairs used to filter which spans

        this monitor applies to. Keys are span attribute names and values can be strings, numbers, or booleans.


        Common selector keys:

        - `gen_ai.system` — LLM provider (e.g. "openai", "anthropic")

        - `gen_ai.request.model` — model name (e.g. "gpt-4o", "claude-3-5-sonnet")

        - `gen_ai.request.max_tokens` — max tokens (number)

        - Any other span attribute from your traces'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/request.CreateAutoMonitorSetupInput'
        description: Auto monitor setup configuration
        required: true
      responses:
        '201':
          description: Created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/response.AutoMonitorSetupResponse'
        '400':
          description: Invalid input
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/response.ErrorResponse'
        '500':
          description: Internal error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/response.ErrorResponse'
      summary: Create an auto monitor setup
      tags:
      - auto-monitor-setups
  /v2/auto-monitor-setups/{external_id}:
    delete:
      description: Delete an auto monitor setup by its external ID
      parameters:
      - description: Auto monitor setup external ID
        in: path
        name: external_id
        required: true
        schema:
          type: string
      responses:
        '204':
          description: No content
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/response.ErrorResponse'
        '500':
          description: Internal error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/response.ErrorResponse'
      summary: Delete an auto monitor setup by external ID
      tags:
      - auto-monitor-setups
    get:
      description: Get a specific auto monitor setup by its external ID
      parameters:
      - description: Auto monitor setup external ID
        in: path
        name: external_id
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/response.AutoMonitorSetupResponse'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/response.ErrorResponse'
        '500':
          description: Internal error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/response.ErrorResponse'
      summary: Get an auto monitor setup by external ID
      tags:
      - auto-monitor-setups
    put:
      description: Update an existing auto monitor setup by its external ID
      parameters:
      - description: Auto monitor setup external ID
        in: path
        name: external_id
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/request.UpdateAutoMonitorSetupInput'
        description: Fields to update
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/response.AutoMonitorSetupResponse'
        '400':
          description: Invalid input
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/response.ErrorResponse'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/response.ErrorResponse'
        '500':
          description: Internal error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/response.ErrorResponse'
      summary: Update an auto monitor setup by external ID
      tags:
      - auto-monitor-setups
components:
  schemas:
    response.AutoMonitorEvaluatorResponse:
      properties:
        binding_id:
          type: string
        error_message:
          type: string
        evaluator_id:
          type: string
        evaluator_type:
          type: string
        input_schema:
          items:
            $ref: '#/components/schemas/evaluator.Property'
          type: array
        output_schema:
          items:
            $ref: '#/components/schemas/evaluator.Property'
          type: array
        processed_at:
          type: string
        status:
          type: string
      type: object
    response.AutoMonitorSetupResponse:
      properties:
        created_at:
          type: string
        env_project_id:
          type: string
        evaluators:
          items:
            $ref: '#/components/schemas/response.AutoMonitorEvaluatorResponse'
          type: array
        external_id:
          type: string
        id:
          type: string
        init_rules:
          items:
            $ref: '#/components/schemas/types.Rule'
          type: array
        org_id:
          type: string
        project_id:
          type: string
        status:
          type: string
        updated_at:
          type: string
      type: object
    types.Rule:
      properties:
        key:
          type: string
        op:
          $ref: '#/components/schemas/types.ComparisonOperator'
        source:
          type: string
        value:
          type: string
        value_type:
          type: string
      type: object
    request.CreateAutoMonitorSetupInput:
      properties:
        evaluators:
          description: List of evaluator slugs to run on matched spans
          example:
          - hallucination
          - toxicity
          items:
            type: string
          minItems: 1
          type: array
        external_id:
          description: Unique identifier for the auto monitor setup, used to reference it in future requests
          example: my-agent-monitor-1
          type: string
        selector:
          description: '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}'
          type: object
      required:
      - evaluators
      - external_id
      type: object
    response.ErrorResponse:
      description: Standard error response structure
      properties:
        error:
          example: error message
          type: string
      type: object
    types.ComparisonOperator:
      enum:
      - equals
      - not_equals
      - contains
      - not_contains
      - in
      - not_in
      type: string
      x-enum-varnames:
      - ComparisonOperatorEquals
      - ComparisonOperatorNotEquals
      - ComparisonOperatorContains
      - ComparisonOperatorNotContains
      - ComparisonOperatorIn
      - ComparisonOperatorNotIn
    evaluator.PropertyType:
      enum:
      - string
      - int
      - float
      - boolean
      - enum
      type: string
      x-enum-varnames:
      - StringType
      - IntType
      - FloatType
      - BooleanType
      - EnumType
    evaluator.Property:
      properties:
        description:
          type: string
        enum_values:
          description: The allowed values for this property. Only applicable when `type` is `enum`.
          items:
            type: string
          type: array
        label:
          type: string
        name:
          type: string
        type:
          $ref: '#/components/schemas/evaluator.PropertyType'
      required:
      - name
      - type
      type: object
    request.UpdateAutoMonitorSetupInput:
      properties:
        evaluators:
          description: List of evaluator slugs to run on matched spans
          example:
          - hallucination
          - toxicity
          items:
            type: string
          type: array
        selector:
          description: '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}'
          type: object
      type: object
  securitySchemes:
    BearerAuth:
      description: Type "Bearer" followed by a space and JWT token.
      in: header
      name: Authorization
      type: apiKey