Deploy the draft for testing

​

Puts the current draft on the bot's test channel so you can talk to it. Writing the draft does not do this.

Any violation stops the deployment, not only the ones that stop a publication.

To talk to it you need that channel's configuration, from the Channels API.

Path Parameters

  • bot_id
    Type: stringFormat: uuid
    required

Responses

  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for put/bots/{bot_id}/test
curl https://api.landbot.io/v0-alpha/bots/123e4567-e89b-12d3-a456-426614174000/test \
  --request PUT \
  --header 'Authorization: Token YOUR_AGENT_TOKEN'

{
  "data": {
    "bot_id": "123e4567-e89b-12d3-a456-426614174000",
    "diagram": {
      "nodes": {
        "hidden": {
          "id": "hidden",
          "path": "hidden",
          "template": "hidden",
          "params": {}
        },
        "welcome": {
          "id": "welcome",
          "path": "welcome",
          "template": "var_text",
          "params": {
            "version": 3,
            "text": "Hi! What is your name?",
            "destination": "name"
          }
        }
      },
      "connections": {
        "hidden.success--welcome": {
          "id": "hidden.success--welcome",
          "type": "success",
          "sourcePath": "hidden",
          "targetPath": "welcome"
        }
      }
    },
    "save_state": "IS_PRESAVED",
    "has_unpublished_changes": true,
    "violations": [
      {
        "code": "string",
        "message": "string",
        "block_id": null,
        "param": null,
        "connections": [
          {
            "source_path": "string",
            "type": "string"
          }
        ]
      }
    ],
    "required_tier": "sandbox",
    "edited_at": "2026-09-16T09:18:19"
  }
}

The draft is deployed and ready to be exercised