API Documentation
Build powerful integrations with Engium's RESTful API. Access all platform features programmatically with comprehensive documentation and code examples.
Quick Start
1. Get Your API Key
Generate an API key from your account settings dashboard. Keep it secure and never commit it to public repositories.
2. Make Your First Request
curl -X GET https://api.engium.app/v1/conversations \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json"
3. Handle the Response
{
"data": [
{
"id": "conv_123",
"customer": { ... },
"messages": [ ... ],
"status": "open"
}
],
"pagination": { ... }
}API Endpoints
Authentication
/api/auth/loginAuthenticate and receive access token
/api/auth/refreshRefresh expired access token
/api/auth/logoutInvalidate current session
Conversations
/api/conversationsList all conversations with pagination
/api/conversations/:idGet specific conversation details
/api/conversations/:id/messagesSend a message in a conversation
/api/conversations/:idUpdate conversation status or tags
Bookings
/api/bookingsList all bookings
/api/bookingsCreate a new booking
/api/bookings/:idUpdate booking details
/api/bookings/:idCancel a booking
AI Services
/api/ai/analyzeAnalyze message sentiment and intent
/api/ai/suggestGet AI response suggestions
/api/ai/categorizeAuto-categorize conversation
Official SDKs
Python
Full-featured Python SDK with type hints
pip install engiumNode.js
TypeScript-ready SDK for Node applications
npm i @engium/sdkRuby
Idiomatic Ruby gem for Rails apps
gem install engiumRate Limits
Free Plan
100 requests/hour
Starter & Pro
1,000 requests/hour
Enterprise
Custom limits
Ready to Build?
Get your API key and start integrating Engium into your applications today.
