📡 API Reference

AllXOne REST API

Integrate AI agents into your apps. Manage agents, send messages, and capture leads programmatically.

🔐 Authentication

All API requests require an API key passed via the Authorization header.

Request Header

Authorization: Bearer axo_your_api_key_here

Generate API keys from your Dashboard → API Keys.

🌐 Base URL

https://your-supabase-url.supabase.co/functions/v1

📡 Endpoints

POST /allxone-agent-chat Send Message to Agent

Send a message to an AI agent and receive a streaming response.

Request Body

{
  "agent_id": "uuid",
  "session_id": "unique-session-id",
  "messages": [
    { "role": "user", "content": "Hello, I need help" }
  ],
  "is_widget": false
}

Response

data: {"chunk": "Hello! "}
data: {"chunk": "How can "}
data: {"chunk": "I help you?"}
data: {"done": true, "full_response": "Hello! How can I help you?"}

GET /agents List Agents

Retrieve all active agents for the authenticated user.

Response

{
  "data": [
    {
      "id": "uuid",
      "name": "Sales Agent",
      "is_active": true,
      "model": "gemini-flash",
      "created_at": "2026-01-01T00:00:00Z"
    }
  ]
}

POST /leads Create Lead

Manually create a lead capture record for an agent.

Request Body

{
  "agent_id": "uuid",
  "contact_name": "John Smith",
  "contact_email": "[email protected]",
  "contact_phone": "+44 7700 900000",
  "source": "api",
  "notes": "Interested in premium plan"
}

Response

{
  "id": "uuid",
  "status": "new",
  "created_at": "2026-01-01T00:00:00Z"
}

POST /webhooks/test Test Webhook

Send a test payload to verify your webhook endpoint is receiving data.

Request Body

{
  "webhook_id": "uuid"
}

Response

{
  "success": true,
  "status_code": 200,
  "response_time_ms": 142
}

🔗 Webhook Payload Format

When a configured event occurs, AllXOne sends a POST request to your webhook URL with this payload:

{
  "event": "lead_captured",
  "agent_id": "uuid",
  "agent_name": "Sales Agent",
  "timestamp": "2026-01-01T12:00:00Z",
  "data": {
    "contact_name": "Jane Doe",
    "contact_email": "[email protected]",
    "contact_phone": "+44 7700 900000",
    "source": "widget",
    "session_id": "abc-123"
  }
}

⚡ Rate Limits

Plan	Requests/min	Concurrent
Free	10	2
Pro	60	10
Ultra	300	50
Enterprise	Custom	Unlimited

Need Help?

Contact our developer support team or explore enterprise integrations.

Contact Support

Your AI Workforce is Ready.

Join 500+ businesses already using Allxone to capture leads and serve customers around the clock.

Deploy Your Free AI Agent

Free forever. No credit card required. Upgrade anytime.