API Documentation
Technical blueprints for the Mindsentry AI ecosystem. Build, scale, and automate your agents with precision.
Introduction
The Mindsentry API is organized around REST. It has predictable resource-oriented URLs, accepts JSON-encoded request bodies, returns JSON-encoded responses, and uses standard HTTP response codes.
API Environment
Production: https://api.mindsentry.io/api
Access Control
Access is granted via Bearer tokens. All endpoints require HTTPS encryption.
Authentication
Include your API key in the Authorization header of every request.
Warning: Never commit API keys to version control.
/api/chat/sendChat & Logic
Send a message to the AI orchestrator. This endpoint performs RAG by retrieving context from your documents and generating a grounded response.
Parameters
| Field | Type | Req |
|---|---|---|
message The text query or prompt. | string | YES |
sessionId UUID to maintain conversation state. | string | NO |
topK Number of chunks to retrieve (1-10). | number | NO |
Example Requset
curl -X POST "https://api.mindsentry.io/api/chat/send" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"message": "Summarize the support policy",
"topK": 5
}'/api/training-data/youtube/importYouTube Ingestion
Trigger an asynchronous ingest of a YouTube video or playlist. Transcripts are automatically fetched and indexed.
Parameters
| Field | Type | Req |
|---|---|---|
url Valid YouTube URL. | string | YES |
importType "video", "playlist", or "channel". | string | YES |
Example Requset
curl -X POST "https://api.mindsentry.io/api/training-data/youtube/import" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"url": "https://www.youtube.com/watch?v=ABC123",
"importType": "video"
}'/api/tenant/usersManage Agents
List all agents and users associated with your tenant account. Retrieve roles, usage statistics, and login status.
Parameters
| Field | Type | Req |
|---|---|---|
role Filter by: Admin, User, Support. | string | NO |
Example Requset
curl -X GET "https://api.mindsentry.io/api/tenant/users" \
-H "Authorization: Bearer YOUR_API_KEY"Error Codes
Request succeeded.
Invalid parameters.
Invalid API Key.
Limit exceeded.
Resource missing.
System failure.
Need developer support?
Contact our integration team for dedicated assistance.