Oxaide
Home/API Documentation
Infrastructure API

AI Customer Support API

Add AI-powered customer support to any application with a single API call. Build chatbots, support systems, or AI assistants on top of Oxaide.

Like Twilio for messaging or Stripe for payments — but for AI support.

Who uses this API? SaaS platforms adding AI support • Agencies building for clients • Developers creating custom chat experiences • Apps needing conversational AI

One API, Full AI Support

Send a message, get an AI response trained on your knowledge base. No ML expertise required. Works in any language or framework.

Production Ready

Scoped API keys, rate limiting, request logging, and test mode. Enterprise-grade security for your applications.

Pay Per Message

Simple credit-based pricing. Same rate for API, widget, and WhatsApp. No monthly minimums. Scale from 0 to millions.

Quick Start

Get AI responses in your app in under 5 minutes.

1
Authentication

Include your API key in the Authorization header of every request.

GET
/api/v1/agents

List your AI agents to get an agent_id for conversations.

curl https://oxaide.com/api/v1/agents \
  -H "Authorization: Bearer sk_live_your_api_key"

2
Create a Conversation

Start a new conversation with an agent. Optionally include customer info.

POST
/api/v1/conversations

Create a new conversation and get a conversation_id for sending messages.

curl https://oxaide.com/api/v1/conversations \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "123",
    "customer": {
      "email": "customer@example.com",
      "name": "John Doe"
    }
  }'

3
Send a Message

Send a message and get an AI response. Uses 1 credit per message.

POST
/api/v1/conversations/{id}/messages

Send a message to the AI and receive an intelligent response.

curl https://oxaide.com/api/v1/conversations/conv_xxx/messages \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "What are your business hours?"
  }'

Optional
Streaming Responses

Enable streaming for real-time responses using Server-Sent Events (SSE).

POST
/api/v1/conversations/{id}/messages

Add stream: true to get real-time streaming responses.

curl https://oxaide.com/api/v1/conversations/conv_xxx/messages \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Tell me about your products",
    "stream": true
  }'

API Reference

Complete list of available endpoints.

API Keys

GET
/api/v1/keysList all API keys
POST
/api/v1/keysCreate a new API key
GET
/api/v1/keys/{keyId}Get key details
PATCH
/api/v1/keys/{keyId}Update key settings
DELETE
/api/v1/keys/{keyId}Revoke a key

Conversations

GET
/api/v1/conversationsList conversations
POST
/api/v1/conversationsCreate a conversation
GET
/api/v1/conversations/{id}Get conversation with messages
DELETE
/api/v1/conversations/{id}Archive conversation

Messages

GET
/api/v1/conversations/{id}/messagesList messages
POST
/api/v1/conversations/{id}/messagesSend message, get AI response

Agents

GET
/api/v1/agentsList all agents
GET
/api/v1/agents/{id}Get agent details

Usage

GET
/api/v1/usageGet usage statistics

Rate Limits

API keys have configurable rate limits. Default limits are 60 requests per minute and 10,000 requests per day.

HeaderDescription
X-RateLimit-LimitMaximum requests per minute
X-RateLimit-RemainingRequests remaining in window
X-RateLimit-ResetUnix timestamp when limit resets
Retry-AfterSeconds to wait (when rate limited)

Error Handling

All errors return a consistent JSON structure with helpful details.

{
  "error": {
    "message": "Human-readable error message",
    "type": "authentication_error",
    "code": "invalid_api_key"
  }
}
HTTP StatusError TypeDescription
400api_errorInvalid request parameters
401authentication_errorInvalid or missing API key
403authorization_errorInsufficient permissions
404not_found_errorResource not found
429rate_limit_errorRate limit exceeded
500internal_errorServer error

Why Build on Oxaide

Focus on your product. Let us handle the AI support infrastructure.

You Build

✓ Your unique user interface

✓ Your business logic and workflows

✓ Your brand experience

✓ Your integrations (CRM, helpdesk, etc.)

Oxaide Handles

✓ AI model training and fine-tuning

✓ Knowledge base and RAG infrastructure

✓ Conversation management and context

✓ Scaling, reliability, and security

Architecture

Your AppOxaide APIAI Response

Same API powers our widget, WhatsApp integration, and now your custom apps.

Get Started Free

Ready to Build?

Create your free account and get API keys in minutes. Pay only for what you use — starting at $0.

Questions? Email api@oxaide.dev

GDPR/PDPA Compliant
AES-256 encryption
99.9% uptime SLA
Business-grade security