Create or replace draft

Staging Env

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

POST

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

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

Maintainer:Not configured

Creates a new draft (or replaces the existing one) for the agent.

The server assembles the full config snapshot: frontend supplies agent_name, main_prompt, and agent_configuration. The state_machine and connection_config are read from the current live DB state automatically.

⚠️ Replaces any previously unsaved draft without warning.

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": "",
    "agent_configuration": {}
}

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/draft' \
--header 'token: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "agent_name": "Formi Sales Bot v2",
    "main_prompt": "",
    "agent_configuration": {}
}'

Responses

🟢200

application/json

Draft created or replaced successfully.

Body

Example

{
    "success": true,
    "message": "Draft created",
    "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

🔴500

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

Delete Tool

Get current draft