AI Chatbot API Documentation
Complete reference for building with the Vatdi API
Vatdi provides a fully documented REST API covering chatbot creation, training data management, conversation handling, analytics retrieval, and webhook configuration. Every endpoint includes request and response schemas, authentication details, rate limits, and working code examples.
How It Works
Generate Your API Key
Navigate to Settings > API Keys in your Vatdi dashboard. Create a new key with the appropriate scoped permissions for your use case.
Make Your First Request
Use curl or your preferred HTTP client to call the /v1/chatbots endpoint with your Bearer token. Verify a 200 response listing your chatbots.
Explore Endpoint Reference
Browse the full endpoint reference with request/response schemas, query parameters, and copy-paste code examples in JavaScript, Python, and PHP.
Authentication and API Keys
Authenticate using API keys generated from your Vatdi dashboard. Keys support scoped permissions so you can create read-only keys for analytics and write keys for chatbot management. All requests use Bearer token authentication over HTTPS.
Core API Endpoints
The API covers five domains: Chatbots (CRUD operations), Training (upload, index, delete sources), Conversations (send messages, retrieve history, stream responses), Analytics (metrics, reports, exports), and Webhooks (configure, test, manage). Each endpoint follows REST conventions with predictable URL structures.
Rate Limits and Best Practices
Rate limits are applied per API key and vary by plan. The API returns standard HTTP headers indicating your current usage and remaining quota. Implement exponential backoff for 429 responses and use pagination for list endpoints to optimize performance.
Frequently Asked Questions
The base URL is https://api.vatdi.com/v1/. All endpoints are prefixed with this URL.
Yes. List endpoints support cursor-based pagination with limit and after parameters. Default page size is 20 items.
Yes. Official SDKs are available for JavaScript (npm), Python (pip), and PHP (Composer). Community SDKs exist for Go and Ruby.
The API returns standard HTTP status codes. Error responses include a JSON body with error type, message, and a request ID for debugging.
Yes. Use api-sandbox.vatdi.com for testing. Sandbox keys are rate-limited but fully functional with no production side effects.
Start Building with the Vatdi API
Full API reference, SDKs, and sandbox environment ready for you.