Sign in
flywheel

Rollback Route

Restore a voice agent to any prior version.

Creates a new VoiceAgentVersion(source=ROLLBACK) whose metadata_json matches the target version and re-materializes runtime tool tables. The response is the new version row.

Restore reverts prompt, settings, and integration tools/scenarios. KB attachments are re-derived from current live state (not snapshot-restored) because KBs are shared live resources.

post/api/v1/voice-agents/{voice_agent_id}/rollback

Path parameters

voice_agent_idstring uuid required

Request body

target_version_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