Publish draft

Staging Env

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

POST

/v2/agents/{agent_id}/config/model/publish

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

Maintainer:Not configured

Publishes the current draft:

Computes the diff between old live and draft snapshots.

Applies the draft snapshot to all runtime tables (agent, states, edges, etc.).

Archives the previous live version row.

Promotes the draft to a new live version with an auto-incremented version_number.

Sends a publish notification email.

Refreshes Redis caches.

version_notes is required and must be non-empty.

Request

Authorization

API Key

Add parameter in header

token

Example:

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

Path Params

Body Params application/jsonRequired

Example

{
    "version_notes": "Switched LLM to GPT-4o and updated Tamil greeting message."
}

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/publish' \
--header 'token: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "version_notes": "Switched LLM to GPT-4o and updated Tamil greeting message."
}'

Responses

🟢200

application/json

Draft published successfully. Returns new live version metadata.

Body

Example

{
    "success": true,
    "message": "Published",
    "payload": {
        "version_number": 4,
        "status": "live",
        "version_notes": "Switched LLM to GPT-4o",
        "published_at": "2026-05-01T10:45: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

Merge changes into draft

List published versions