Create a chatbot

POST 
/api/v1/chatbots

Creates a new chatbot with status: "draft" and deployment.status: "pending". Creation does not provision any infrastructure or start a deployment. The first deploy must be done from the WizChat dashboard, which provisions the underlying infrastructure; the v1 /deploy endpoint only re-deploys a chatbot that has already been deployed once. Restricted API keys (those locked to specific chatbot IDs) cannot create chatbots. Plan limits are enforced transactionally. Note: newly created chatbots have no aiConfig (no LLM model). Before triggering a deployment, use POST /api/v1/chatbots/{id}/apply to set spec.core.aiConfig.llmModel and related fields. Required scope: chatbots:write.

Request

Responses

201

Chatbot created. chatbot.status is "draft"; deployment.status is "pending". First deploy must use the dashboard.

400

Bad Request — invalid input

401

Unauthorized — missing or invalid API key

403

Forbidden — key lacks required scope

429

Too Many Requests — rate limit exceeded