---
title: "Genai Agent Versions Query"
method: POST
path: "/agents/agent-versions/query"
tags: ["Agents"]
---

# Genai Agent Versions Query

`POST /agents/agent-versions/query`

## Request

- Base URL: `https://trace.wandb.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://trace.wandb.ai/agents/agent-versions/query`
- Auth: none declared

## Request body

- AgentVersionsQueryReq: Request to list versions for an agent.
  - `project_id` string, required
  - `agent_name` string, required
  - `sort_by` AgentSortBy[], nullable
    - `field` string, required
    - `direction` 'asc' | 'desc'
  - `limit` integer
  - `offset` integer
  - `include_costs` boolean

## Response `200`

Successful Response

- AgentVersionsQueryRes: Response containing agent version stats.
  - `versions` AgentVersionSchema[], required
    - `project_id` string, required
    - `agent_name` string, required
    - `invocation_count` integer, required
    - `span_count` integer, required
    - `total_input_tokens` integer, required
    - `total_output_tokens` integer, required
    - `total_duration_ms` integer, required
    - `error_count` integer, required
    - `first_seen` string, date-time, nullable, required
    - `last_seen` string, date-time, nullable, required
    - `total_cost_usd` number, nullable, required
    - `agent_version` string, required
  - `total_count` integer, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-16** `dd89fadfe4e4`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/wandb/apis/fastapi/changes/agents/agent-versions/query/post.md)

---

[API](https://skmtc.dev/wandb/apis/fastapi.md) - [All operations](https://skmtc.dev/wandb/apis/fastapi/llms.txt) - [OpenAPI document](https://skmtc.dev/wandb/apis/fastapi/revisions/f7643c49bf2e?raw)