Skip to main content
The Mind-e API lets you send chat messages, manage web sources, check credits, and more — all programmatically.

​
Base URL

All API endpoints are relative to this base URL. For example, to send a chat message:

​
Authentication

Most API endpoints require authentication using a Bearer token. Pass your API key in the Authorization header:
Create API keys in your dashboard settings. Keys can be scoped to a specific agent or work across all your agents.
Some endpoints are public (no authentication required) — these are used by the embeddable chat widget. They are marked as “Public” in the documentation.

​
Request format

  • Send JSON in the request body with Content-Type: application/json
  • File uploads use multipart/form-data
  • Query parameters are passed in the URL

​
Response format

All responses return JSON with a success field:
On error:

​
HTTP status codes

​
Rate limiting

API requests are rate limited. When rate limited, the response includes these headers: If you receive a 429 response, wait until the reset time before retrying.

​
Credits

API chat requests consume credits just like widget conversations. The response includes a credits object showing how many credits were used and your remaining balance.