Skip to main content
The Maitai Platform API gives you full programmatic access to every resource available in the Portal — applications, intents, agents, datasets, test sets, finetune runs, and more.

​
Base URL

All endpoints are served from: 
https://api.trymaitai.ai/api/v1

​
Authentication

Every request must include your Maitai API key in the X-Maitai-Api-Key header. 
curl https://api.trymaitai.ai/api/v1/applications \
  -H "X-Maitai-Api-Key: YOUR_MAITAI_API_KEY"
You can create API keys in the Portal under Settings → API Keys.

​
Response format

All responses follow a consistent envelope: 
{
  "data": { ... }
}

​
Pagination

Paginated endpoints accept offset and limit query parameters:
ParameterDefaultMaxDescription
offset0—Number of items to skip
limit25100Max items to return

​
Resources

Use the sidebar to navigate to specific endpoints. Each resource section lists all available operations.

Applications

Manage applications and their configuration.

Intents

Application actions nested under applications.

Intent Groups

Cross-application intent grouping.

Agents

Agents, actions, sub-agents, versions, releases, and routing.

Sentinels

Evaluation watchers for monitoring model output quality.

Sessions

Classic (non-agent) chat sessions.

Requests

Individual request/response pairs.

Datasets

Curated request sets for model training.

Test Sets

Curated request sets for model evaluation.

Test Runs

Test set execution and results.

Conversation Trees

Synthetic conversation flows.

Finetune Runs

Model finetuning jobs.

Evaluations

Evaluation runs and results.

Models

Available and finetuned models.