Revert to archived version

Staging Env

https://staging-api.formi.co.in

POST

/v2/agents/{agent_id}/config/model/versions/{version_number}/revert

Last modified:2026-05-01 13:30:51

Maintainer:Not configured

Rolls back the agent to a specific archived version:

Computes the diff between current live and the target version.

Applies the target snapshot to all runtime tables.

Marks the current live version as reverted.

Creates a new live version row (is_revert=true, reverted_from_version=N) with a new version_number.

Sends a revert notification email.

Refreshes Redis caches.

Rules:

Target must have status archived. Cannot revert to live, draft, or reverted.

version_notes is required (explain why you're reverting).

Request

Authorization

API Key

Add parameter in header

token

Example:

token: ********************

Path Params

Body Params application/jsonRequired

Example

{
    "version_notes": "v4 broke Tamil STT detection. Rolling back to v2 until hotfix is ready."
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://staging-api.formi.co.in/v2/agents//config/model/versions//revert' \
--header 'token: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "version_notes": "v4 broke Tamil STT detection. Rolling back to v2 until hotfix is ready."
}'

Responses

🟢200

application/json

Revert successful. Returns the new live version metadata.

Body

Example

{
    "success": true,
    "message": "Reverted",
    "payload": {
        "version_number": 5,
        "status": "live",
        "version_notes": "v4 broke Tamil STT detection. Rolling back to v2 until hotfix is ready.",
        "published_at": "2026-05-01T11:00:00+05:30",
        "change_summary": {
            "changed": {
                "agent_configuration.LLM.conversation_llm.model_name": {
                    "old": "gpt-4-turbo",
                    "new": "gpt-4o"
                }
            },
            "unchanged": [
                "agent_name",
                "main_prompt",
                "connection_config"
            ]
        }
    }
}

🟠400

🟠409

🔴500

Modified at 2026-05-01 13:30:51

Get version detail

Get All Agents