Test Agent | BookedIn Documentation

curl -X POST https://api.bookedin.ai/api/v1/agents/agent_id/test \
     -H "X-API-Key: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "message": "What are your pricing options?",
  "channel": "sms",
  "session_id": "550e8400-e29b-41d4-a716-446655440000"
}'

{
  "response": "string",
  "session_id": "string",
  "conversation_history": [
    {
      "role": "user",
      "content": "string",
      "timestamp": 1.1,
      "tool_calls": [
        {}
      ]
    }
  ],
  "tool_calls": [
    {
      "function": {
        "name": "string",
        "arguments": "string"
      }
    }
  ],
  "usage": {
    "prompt_tokens": 1,
    "completion_tokens": 1,
    "total_tokens": 1
  }
}

Test an agent’s responses without sending real messages. Useful for validating prompt configuration and tool behavior before deployment. Use the same session_id across requests to maintain conversation context.

Authentication

X-API-Keystring

Your API key from Dashboard → Settings → API Keys

Your API key from [Dashboard → Settings → API Keys](https://dashboard.bookedin.ai/settings)

Path parameters

agent_idstringRequired

Agent ID to test

Request

This endpoint expects an object.

messagestringRequired

The test message to send to the agent

channelenumOptionalDefaults to sms

Channel to simulate. Determines which channel profile's configuration and tools are used.

session_idstringOptionalformat: "uuid"

Session ID for conversation continuity. Omit to start a new conversation, provide to continue an existing one.

Response

Agent response

responsestring

The agent's generated response

session_idstring

Session ID for this conversation. Use in subsequent requests to maintain context.

conversation_historylist of objects

Full conversation history for this session

tool_callslist of objects

Tools called by the agent during response generation

usageobject

Token usage statistics

Errors

404

Not Found Error