Sign in
flywheel

List Voice Agent Versions Route

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

get/api/v1/voice-agents/{voice_agent_id}/versions

Path parameters

voice_agent_idstring uuid required

Response

Successful Response

idstring uuid required
voice_agent_idstring uuid required
version_numberinteger required
metadata_jsonobject 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_refstring uuid nullable
base_version_idstring uuid nullable
flywheel_run_idstring uuid nullable
created_bystring uuid nullable
tenant_idstring uuid required
created_atstring date-time required

Changes