Merge changes into draft

Staging Env

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

PATCH

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

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

Maintainer:Not configured

Partially updates the draft by merging supplied fields into the existing snapshot. Fields not included in the request are preserved unchanged.

If no draft exists yet, one is auto-created from the current live state before applying the patch.

Merge rules:

agent_name / main_prompt: replaced entirely if provided.

agent_configuration: deep-merged (nested keys are merged, not replaced).

state_machine: structured patch — upsert states/edges by id, delete by id list.

Request

Authorization

API Key

Add parameter in header

token

Example:

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

Path Params

Body Params application/jsonRequired

Example

{
    "agent_name": "Formi Sales Bot v2",
    "main_prompt": "Updated system prompt here.",
    "agent_configuration": {
        "LLM": {
            "conversation_llm": {
                "model_name": "gpt-4o"
            }
        }
    },
    "state_machine": {
        "states": [
            {
                "state_id": 10,
                "name": "greeting_state",
                "template_id": 3,
                "state_prompt": "",
                "variables": {
                    "tone": "friendly"
                }
            }
        ],
        "edges": [
            {
                "edge_id": 42,
                "from_node": 10,
                "to_node": 11,
                "prompt": "If the user says goodbye, transition.",
                "transition_metadata": {}
            }
        ],
        "deleted_state_ids": [
            99
        ],
        "deleted_edge_ids": [
            55
        ]
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PATCH 'https://staging-api.formi.co.in/v2/agents//config/model/draft' \
--header 'token: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "agent_name": "Formi Sales Bot v2",
    "main_prompt": "Updated system prompt here.",
    "agent_configuration": {
        "LLM": {
            "conversation_llm": {
                "model_name": "gpt-4o"
            }
        }
    },
    "state_machine": {
        "states": [
            {
                "state_id": 10,
                "name": "greeting_state",
                "template_id": 3,
                "state_prompt": "",
                "variables": {
                    "tone": "friendly"
                }
            }
        ],
        "edges": [
            {
                "edge_id": 42,
                "from_node": 10,
                "to_node": 11,
                "prompt": "If the user says goodbye, transition.",
                "transition_metadata": {}
            }
        ],
        "deleted_state_ids": [
            99
        ],
        "deleted_edge_ids": [
            55
        ]
    }
}'

Responses

🟢200

application/json

Draft merged successfully.

Body

Example

{
    "success": true,
    "message": "Draft merged",
    "payload": {
        "draft_id": 17,
        "agent_id": 5,
        "status": "draft",
        "config_snapshot": {
            "agent_name": "Formi Sales Bot",
            "main_prompt": "You are a helpful sales assistant...",
            "agent_configuration": {
                "LLM": {
                    "conversation_llm": {
                        "model_name": "gpt-4o",
                        "temperature": 0.7
                    }
                },
                "TTS": {
                    "provider": "elevenlabs",
                    "voice_id": "abc123"
                },
                "STT": {
                    "provider": "deepgram",
                    "language": "en-IN"
                },
                "welcome_message": "Hello! How can I help you today?"
            },
            "state_machine": {
                "states": [
                    {
                        "state_id": 10,
                        "name": "greeting_state",
                        "template_id": 3,
                        "state_prompt": "",
                        "variables": {
                            "tone": "friendly"
                        }
                    }
                ],
                "edges": [
                    {
                        "edge_id": 42,
                        "from_node": 10,
                        "to_node": 11,
                        "prompt": "If the user says goodbye, transition.",
                        "transition_metadata": {}
                    }
                ]
            },
            "connection_config": {}
        },
        "created_at": "2026-05-01T10:30:00+05:30"
    }
}

🟠400

🟠409

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

Discard draft

Publish draft