Skip to main content
POST
/
v1
/
bot
/
create
Create Agent
curl --request POST \
  --url https://api.boostgpt.co/v1/bot/create \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "project_id": "<string>",
  "name": "<string>",
  "model": "<string>",
  "instruction": "<string>",
  "status": 0
}
'
{
  "bot": {
    "id": "<string>",
    "uuid": "<string>",
    "subdomain": "<string>",
    "provider_key": "<string>",
    "avatar": "<string>",
    "name": "<string>",
    "model": "<string>",
    "reasoning_type": "<string>",
    "max_reply_tokens": "<string>",
    "top": 123,
    "instruction": "<string>",
    "ratelimit_message": "<string>",
    "ratelimit_seconds": 123,
    "ratelimit_requests": 123,
    "no_answer_reply": "<string>",
    "require_login": 123,
    "memory": 123,
    "hide_branding": 123,
    "branding": {
      "seo": {
        "title": "<string>",
        "keywords": "<string>",
        "description": "<string>"
      },
      "logo": {
        "url": "<string>",
        "enabled": true
      },
      "theme": "<string>",
      "favicon": {
        "url": "<string>",
        "enabled": true
      },
      "tagline": {
        "content": "<string>",
        "enabled": true
      },
      "navigation": {
        "links": [
          {}
        ],
        "enabled": true
      },
      "description": {
        "content": "<string>",
        "enabled": true
      },
      "placeholder": "<string>",
      "accent_color": "<string>",
      "background_color": "<string>",
      "message_greetings": {
        "enabled": true,
        "greetings": [
          "<string>"
        ]
      },
      "conversation_starters": {
        "enabled": true,
        "prompts": [
          "<string>"
        ]
      }
    },
    "status": 123,
    "active_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "integrations": [
      {}
    ],
    "avatar_link": "<string>",
    "domain": "<string>"
  }
}

Authorizations

Authorization
string
header
required

Enter your API key

Body

application/json
project_id
string
required

The project ID

name
string
required

The name of the agent

model
string
required

The AI model to use (e.g., 'gpt-5.1', 'gemini-2.5-flash')

instruction
string

System instructions for the agent

status
enum<integer>

Agent status (0 = inactive, 1 = active)

Available options:
0,
1

Response

Agent created successfully

Complete agent details (for Create/Read operations)

bot
object

Agent/Bot object (used in list responses)