---
title: "PATCH /v2/traces/insights/{insight_id}"
method: PATCH
path: "/v2/traces/insights/{insight_id}"
---

# PATCH /v2/traces/insights/{insight_id}

`PATCH /v2/traces/insights/{insight_id}`

## Path parameters

- `insight_id` string, required

## Query parameters

- `update_mask` string, field-mask

## Request body

- InsightConfig
  - `display_name` string
  - `enabled` boolean
  - `schedule` InsightSchedule
    - `cron` string — Empty disables scheduled analysis. Non-empty values are validated by the service as cron expressions with a minimum cadence of one hour.
  - `window` string
  - `sampling_percentage` number, double
  - `filters` TraceFilter[] — Uses the same canonical field/op/values filter dialect as traces, logs, and unified telemetry queries.
    - `field` string
    - `op` string
    - `values` string[]
  - `models` InsightModels
    - `chat` InsightModelRef[]
      - `id` string
    - `embeddings` InsightModelRef[]
      - `id` string
    - `judges` InsightModelRef[]
      - `id` string
  - `profile` integer
  - `max_traces` integer
  - `conversation_pass_mode` integer
  - `first_pass_method` integer
  - `max_cost_per_run` number, double
  - `filter_operator` string

## Response `200`

OK

- UpdateInsightResponse
  - `insight` Insight
    - `insight_id` string
    - `config` InsightConfig
      - `display_name` string
      - `enabled` boolean
      - `schedule` InsightSchedule
        - `cron` string — Empty disables scheduled analysis. Non-empty values are validated by the service as cron expressions with a minimum cadence of one hour.
      - `window` string
      - `sampling_percentage` number, double
      - `filters` TraceFilter[] — Uses the same canonical field/op/values filter dialect as traces, logs, and unified telemetry queries.
        - `field` string
        - `op` string
        - `values` string[]
      - `models` InsightModels
        - `chat` InsightModelRef[]
          - `id` string
        - `embeddings` InsightModelRef[]
          - `id` string
        - `judges` InsightModelRef[]
          - `id` string
      - `profile` integer
      - `max_traces` integer
      - `conversation_pass_mode` integer
      - `first_pass_method` integer
      - `max_cost_per_run` number, double
      - `filter_operator` string
    - `created_at` string, date-time
    - `updated_at` string, date-time

---

[API](https://skmtc.net/orq-ai/apis/orq-ai-api.md) · [All operations](https://skmtc.net/orq-ai/apis/orq-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/orq-ai/orq-ai-api/revisions/2cd7e7f7bcb4/schema)