---
title: "List Voice Agent Versions Route"
method: GET
path: "/api/v1/voice-agents/{voice_agent_id}/versions"
tags: ["flywheel"]
---

# List Voice Agent Versions Route

`GET /api/v1/voice-agents/{voice_agent_id}/versions`

List all version snapshots for a voice agent, oldest first.

## Path parameters

- `voice_agent_id` string, uuid, required

## Response `200`

Successful Response

- VoiceAgentVersionRead[]
  - `id` string, uuid, required
  - `voice_agent_id` string, uuid, required
  - `version_number` integer, required
  - `metadata_json` object, required
  - `source` 'seed' | 'manual' | 'ai_suggestion' | 'promotion' | 'rollback' | 'rebase_from_prod', required — What produced a VoiceAgentVersion snapshot. - SEED: system-created bootstrap row (migration backfill, brand-new agent, brand-new agent). No prior human edit exists. - MANUAL: human-driven edit of an existing agent (admin UI, FDE tools). The remaining values are reserved for future Flywheel PRs so later writers don't require an enum migration: - AI_SUGGESTION: V0.6 aggregator-produced candidate version. - PROMOTION: V0.8 promotes a candidate version. - ROLLBACK: V0.8 reverts prod to a prior version. - REBASE_FROM_PROD: V1 drift-auto-rebase onto the current prod version.
  - `source_ref` string, uuid, nullable
  - `base_version_id` string, uuid, nullable
  - `flywheel_run_id` string, uuid, nullable
  - `created_by` string, uuid, nullable
  - `tenant_id` string, uuid, required
  - `created_at` string, date-time, required

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-03** `d65b8fefae34` — 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status

[Change history](https://skmtc.dev/getanana/apis/cleon-api/changes/api/v1/voice-agents/:voice_agent_id/versions/get.md)

---

[API](https://skmtc.dev/getanana/apis/cleon-api.md) · [All operations](https://skmtc.dev/getanana/apis/cleon-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getanana/apis/cleon-api/revisions/41c5e4645524?raw)