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

# POST /v2/traces/insights/{insight_id}/runs

`POST /v2/traces/insights/{insight_id}/runs`

## Path parameters

- `insight_id` string, required

## Request body

- RunAnalysisRequest
  - `time_range` InsightTimeRange
    - `start` string, date-time
    - `end` string, date-time

## Response `200`

OK

- RunAnalysisResponse
  - `run` InsightRun
    - `run_id` string
    - `status` integer
    - `stage` integer
    - `trigger` integer
    - `time_range` InsightTimeRange
      - `start` string, date-time
      - `end` string, date-time
    - `counts` InsightRunCounts
      - `candidates` integer
      - `fetched` integer
      - `summarized` integer
      - `summary_failures` integer
      - `embedded` integer
      - `clustered` integer
      - `annotated` integer
      - `annotation_failures` integer
    - `config_snapshot` 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
    - `resolved_models` InsightResolvedModels
      - `summarize` InsightModelResolution
        - `candidates` string[]
        - `selected` string
      - `describe` InsightModelResolution
        - `candidates` string[]
        - `selected` string
      - `merge` InsightModelResolution
        - `candidates` string[]
        - `selected` string
      - `annotate` InsightModelResolution
        - `candidates` string[]
        - `selected` string
      - `plan` InsightModelResolution
        - `candidates` string[]
        - `selected` string
      - `judge` InsightModelResolution
        - `candidates` string[]
        - `selected` string
      - `pinned_embedding_model` string
    - `prompt_hashes` object
    - `first_pass` InsightFirstPass
      - `method` integer
      - `k` integer
      - `seed` string
    - `algorithm_version` string
    - `root_trace_id` string
    - `cost` InsightRunCost
      - `ceiling_usd` number, double
      - `total_usd` number, double
      - `by_stage` InsightStageCost[]
        - `stage` integer
        - `usage` InsightUsage
          - `input_tokens` string
          - `output_tokens` string
          - `total_tokens` string
          - `cost_usd` number, double
    - `stage_durations` InsightStageDuration[]
      - `stage` integer
      - `duration_ms` string
    - `total_duration_ms` string
    - `error` InsightRunError
      - `code` string
      - `message` string
      - `stage` integer
      - `retryable` boolean
    - `quality` InsightQuality[]
      - `quality_id` string
      - `run_id` string
      - `dimension` integer
      - `method` integer
      - `structural` InsightStructuralQuality
        - `silhouette` number, double
        - `calinski_harabasz` number, double
        - `davies_bouldin` number, double
        - `cluster_count` integer
        - `noise_ratio` number, double
        - `size_distribution` object
      - `judge` InsightJudgeQuality
        - `intra_coherence` number, double
        - `inter_separation` number, double
        - `harmonic_composite` number, double
        - `arithmetic_composite` number, double
        - `judge_model` string
        - `judge_version` string
        - `samples` integer
        - `cost_usd` number, double
        - `prompt_hash` string
      - `created_at` string, date-time
    - `cancel_requested_at` string, date-time
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `started_at` string, date-time
    - `completed_at` string, date-time
    - `insight_id` string

---

[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/6df96c9d628e/schema)