---
title: "Query Variant Revisions"
method: POST
path: "/variants/revisions/query"
tags: ["Variants"]
---

# Query Variant Revisions

`POST /variants/revisions/query`

## Request

- Base URL: `/api` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/api/variants/revisions/query`
- Auth: API key in header `Authorization`

Query variant revisions by their IDs.

This endpoint allows batch fetching of multiple revisions at once,
which is more efficient than making individual requests.

Args:
    payload: Request containing list of revision IDs to fetch

Returns:
    RevisionsQueryResponse: Response containing the count and list of revisions

## Query parameters

- `resolve` boolean, nullable

## Request body

- RevisionsQueryRequest: Request model for querying revisions by IDs
  - `revision_ids` string[], required
  - `resolve` boolean, nullable

## Response `200`

Successful Response

- RevisionsQueryResponse: Response model for revision query
  - `count` integer
  - `revisions` AppVariantRevision[]
    - `id` string, nullable
    - `variant_id` string, nullable
    - `revision` integer, required
    - `modified_by` string, nullable
    - `config` ConfigDB, required
      - `config_name` string, required
      - `parameters` object
    - `created_at` string, required
    - `commit_message` string, nullable

## Other responses

- `422`: Validation Error

## Changes

- **2026-03-07** `20311f763505`: 2 info
  - added the new optional `query` request parameter `resolve`
  - added the new optional request property `resolve`
- **2026-02-13** `72fe88316d15`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/agenta-ai/apis/agenta-api/changes/variants/revisions/query/post.md)

---

[API](https://skmtc.dev/agenta-ai/apis/agenta-api.md) - [All operations](https://skmtc.dev/agenta-ai/apis/agenta-api/llms.txt) - [OpenAPI document](https://skmtc.dev/agenta-ai/apis/agenta-api/revisions/6d5b448e6a4f?raw)