---
title: "Compare agent versions"
method: POST
path: "/api/{org_id}/traces/agent_signals/compare"
tags: ["Traces"]
---

# Compare agent versions

`POST /api/{org_id}/traces/agent_signals/compare`

## Request

- Base URL: `https://api.openobserve.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.openobserve.ai/api/{org_id}/traces/agent_signals/compare`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/openobserve/apis/openobserve-api-http/docs/api/:org_id/traces/agent_signals/compare/post.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `org_id` string, required

## Request body

- object: Request body for the version-compare sketch-merge endpoint.
  - `a` CompareArm, required: One arm (A or B) of a version-compare request.
    - `agent_name` string, required
    - `end_time` integer, required
    - `env` string, nullable
    - `start_time` integer, required: Span-time window of the version (kept for the response's window cards); NOT used to filter `_agent_signals` (see COMPARE_ROLLUP_LOOKBACK_MICROS).
    - `version` string, nullable
  - `b` CompareArm, required: One arm (A or B) of a version-compare request.
    - `agent_name` string, required
    - `end_time` integer, required
    - `env` string, nullable
    - `start_time` integer, required: Span-time window of the version (kept for the response's window cards); NOT used to filter `_agent_signals` (see COMPARE_ROLLUP_LOOKBACK_MICROS).
    - `version` string, nullable

## Response `200`

Success

- object

---

[API](https://skmtc.dev/openobserve/apis/openobserve-api-http.md) - [All operations](https://skmtc.dev/openobserve/apis/openobserve-api-http/llms.txt) - [OpenAPI document](https://skmtc.dev/openobserve/apis/openobserve-api-http/revisions/0529b8a10252?raw)