API Documentation

The AI Workspace API That Powers Team Intelligence

Build intelligent applications for teams and customers with our comprehensive REST API. Create AI workspaces, deploy agents, access 10+ AI models, and scale to millions of conversations. More powerful than OpenAI's Assistant API with 99.9% uptime guaranteed.

Token-Based Authentication

Secure your API requests with JWT tokens generated on login. Our authentication system provides enterprise-grade security for all your API operations.

JWT Token Authentication

Secure tokens generated on login with automatic refresh

Multi-User Support

Manage team members with role-based access control

OAuth Integration

Support for Google OAuth and custom SSO solutions

# Login to get auth token
curl -X POST
-H "Content-Type: application/json" \
-d '{
"email": "[email protected]",
"password": "secure_password"
}' \
https://api.insertchat.com/v2/auth/login
# Response with token
{
"token": "eyJhbGciOiJIUzI1NiIs...",
"user": { ... },
"app": { ... }
}

Core API Capabilities

Everything you need to build AI-powered applications at scale.

AI Workspace Management

Create intelligent workspaces where teams collaborate with AI agents trained on company knowledge.

  • • Create team & private AI agents
  • • Configure behavior & personality
  • • Deploy for internal & external use
  • • Manage workspace permissions

Chat & Messaging

Full conversation management with real-time messaging and history tracking.

  • • Create & manage conversations
  • • Send & receive messages
  • • Track conversation history
  • • Pin & archive chats

Knowledge Management

Centralize company knowledge to power both team productivity and customer interactions.

  • • Upload documents & files
  • • Scrape websites & sitemaps
  • • Import YouTube videos
  • • Organize team knowledge bases

Team Collaboration

Enable seamless collaboration within AI workspaces across your organization.

  • • Team workspace management
  • • Role-based access control
  • • Cross-team collaboration
  • • Shared agent libraries

Analytics & Feedback

Track performance, gather feedback, and analyze usage patterns.

  • • Usage statistics
  • • Feedback collection
  • • Performance metrics
  • • Conversation analytics

Multi-Channel Support

Deploy agents across multiple channels including web, WhatsApp, and more.

  • • Embeddable chat widgets
  • • WhatsApp integration
  • • Webhook support
  • • Custom channel adapters

Advanced Capabilities

Enterprise-grade features for sophisticated AI implementations.

White-Label Solutions

Fully customize the appearance and branding of your AI agents with white-label configurations.

  • • Custom domain configuration
  • • Brand copyright settings
  • • SMTP email customization
  • • Complete UI theming

Voice & Audio Support

Enable voice interactions with built-in speech-to-text and text-to-speech capabilities.

  • • Speech-to-text transcription
  • • Text-to-speech synthesis
  • • Multiple voice options
  • • Audio file processing

Webhooks & Integrations

Connect your agents to external systems with webhooks and custom integrations.

  • • Real-time event notifications
  • • Custom webhook endpoints
  • • Stripe payment integration
  • • Third-party service connectors

Custom Tools & Actions

Extend agent capabilities with custom tools and action schemas for specialized tasks.

  • • Define custom actions
  • • Validate action schemas
  • • Tool configuration
  • • Factory tool templates

Quick Examples

Get started with common API operations.

Create an AI Agent

curl -X POST
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "Support Agent",
"prompt": "You are a helpful support assistant",
"model": "gpt-5"
}' \
https://api.insertchat.com/v2/{app_uid}/agents

Send a Message

curl -X POST
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"content": "How can I help you today?",
"role": "assistant"
}' \
https://api.insertchat.com/v2/embeds/{agent_uid}/chats/{chat_uid}/messages

Upload Knowledge Documents

curl -X PUT
-H "Authorization: Bearer YOUR_TOKEN" \
-F "[email protected]" \
https://api.insertchat.com/v2/{app_uid}/sources/ingest/documents/{agent_uid}

Complete API Documentation

Explore our comprehensive REST API documentation with interactive examples.

Interactive API Documentation

Test endpoints and explore our API with Postman

Complete endpoint documentation with request/response examples

Interactive testing environment with live API calls

Code generation for multiple programming languages

Authentication setup and environment configuration guides

99.9% Uptime

Enterprise-grade reliability with 24/7 monitoring and automatic failover.

API Status

Developer Support

Get help from our developer community and dedicated API support team.

Get Support

Ready to transform your entire business?

Join leading enterprises that use InsertChat to revolutionize team productivity and customer interactions

Start your trial today

No credit card required • Setup in 5 minutes your AI Workspace & AI Agents