---
title: "Restore an agent to a previously-deployed config version (greeting / voice / prompt+model only, never secrets), then record a new active version whose rolled_back_from_version_id points at the version that was live before. Scoped via agent_assignments; requires agents:write."
method: POST
path: "/v1/agents/rollback"
---

# Restore an agent to a previously-deployed config version (greeting / voice / prompt+model only, never secrets), then record a new active version whose rolled_back_from_version_id points at the version that was live before. Scoped via agent_assignments; requires agents:write.

`POST /v1/agents/rollback`

## Request

- Base URL: `https://www.kaicalls.com/api`
- URL: `https://www.kaicalls.com/api/v1/agents/rollback`
- Auth: HTTP bearer

## Request body

- object
  - `agent_id` string, required
  - `version_number` integer: Target version number (one of version_number / version_id required).
  - `version_id` string: Target version id (one of version_number / version_id required).
  - `reason` string

## Response `200`

Rollback applied; returns the new active config version.

---

[API](https://skmtc.dev/kaicalls/apis/kaicalls-public-api.md) · [All operations](https://skmtc.dev/kaicalls/apis/kaicalls-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kaicalls/apis/kaicalls-public-api/revisions/e607fc6cf36e?raw)