Deploy Botsify AI Agent — POST /api/v1/deploy-ai-agent

Use this endpoint to push your Botsify AI agent to production. You can deploy the current active version, target a specific saved version by ID, or optionally create a brand-new named version on the fly and deploy it in a single request. Once deployed, live conversations will immediately use the deployed configuration.

Request

POST https://app.botsify.com/api/v1/deploy-ai-agent Authorization: Bearer token — include your token in the Authorization: Bearer <token> header.

Body Parameters

integer

The ID of the version to deploy. When omitted, the currently active version is deployed. You can retrieve available version IDs from the List Agent Versions endpoint.

string

When provided, Botsify creates a new version snapshot with this name from the current agent configuration and deploys it. Takes precedence over version_id if both are supplied.

Example — Deploy the Active Version

curl --request POST \
  --url "https://app.botsify.com/api/v1/deploy-ai-agent" \
  --header "Authorization: Bearer <your_token>" \
  --header "Content-Type: application/json" \
  --data '{}'

Example — Deploy a Specific Version

curl --request POST \
  --url "https://app.botsify.com/api/v1/deploy-ai-agent" \
  --header "Authorization: Bearer <your_token>" \
  --header "Content-Type: application/json" \
  --data '{
    "version_id": 12
  }'

Example — Create a New Version and Deploy

curl --request POST \
  --url "https://app.botsify.com/api/v1/deploy-ai-agent" \
  --header "Authorization: Bearer <your_token>" \
  --header "Content-Type: application/json" \
  --data '{
    "new_version_name": "v4.0 — Summer Release"
  }'

Response

A successful deployment returns 200 OK with details about the deployed version.

{
  "success": true,
  "deployed_version": {
    "id": 15,
    "name": "v4.0 — Summer Release",
    "is_active": true,
    "deployed_at": "2024-06-15T08:00:00Z"
  },
  "message": "Agent deployed successfully."
}

Authorization

Bots & Agents

Agent Versions

Messaging

Users & Analytics

WhatsApp

Deploy Botsify AI Agent — POST /api/v1/deploy-ai-agent

Request

Body Parameters

Example — Deploy the Active Version

Example — Deploy a Specific Version

Example — Create a New Version and Deploy

Response

​Request

​Body Parameters

​Example — Deploy the Active Version

​Example — Deploy a Specific Version

​Example — Create a New Version and Deploy

​Response

Request

Body Parameters

Example — Deploy the Active Version

Example — Deploy a Specific Version

Example — Create a New Version and Deploy

Response