# Maitai

## Docs

- [Add sub agent](https://docs.trymaitai.com/api-reference/agents/add-sub-agent.md): Attach an existing agent as a sub-agent of a parent agent.
- [Add supplied action](https://docs.trymaitai.com/api-reference/agents/add-supplied-action.md): Clone a supplied action from the catalog onto an agent. The catalog row is never modified. The clone is a new agent_action with provenance stamped in ``meta.supplied``. Returns 409 when the agent already has an action with the same name.
- [Create agent](https://docs.trymaitai.com/api-reference/agents/create-agent.md): Create a new agent under an application. Requires `application_id` and `agent_name`.
- [Create agent action](https://docs.trymaitai.com/api-reference/agents/create-agent-action.md): Add a new action (LLM, API, or webhook capability) to an agent.
- [Create routing rule](https://docs.trymaitai.com/api-reference/agents/create-routing-rule.md): Create a new conditional routing rule for an agent.
- [Delete agent](https://docs.trymaitai.com/api-reference/agents/delete-agent.md): Permanently delete an agent and its actions.
- [Delete agent action](https://docs.trymaitai.com/api-reference/agents/delete-agent-action.md): Permanently remove an action from an agent.
- [Delete agent release](https://docs.trymaitai.com/api-reference/agents/delete-agent-release.md): Remove a named release.
- [Delete form fields](https://docs.trymaitai.com/api-reference/agents/delete-form-fields.md): Remove all form fields from an agent, clearing its input form.
- [Delete routing rule](https://docs.trymaitai.com/api-reference/agents/delete-routing-rule.md): Permanently delete a routing rule.
- [Diff agent versions](https://docs.trymaitai.com/api-reference/agents/diff-agent-versions.md): Structured diff between two agent versions. Pass `from` and `to` as version strings (e.g. "1.2.0"), a release name, or "draft" (the default for `to`). Returns per-section deltas: agent fields, actions added/removed/ changed (dotted config paths), sub-agents, and routing rules.
- [Disable action](https://docs.trymaitai.com/api-reference/agents/disable-action.md): Disable an action so the agent no longer invokes it.
- [Disable agent system step](https://docs.trymaitai.com/api-reference/agents/disable-agent-system-step.md): Disable an optional runtime system step (`processing` or `progress`).
- [Disable sub agent](https://docs.trymaitai.com/api-reference/agents/disable-sub-agent.md): Disable a sub-agent relationship without removing it.
- [Enable action](https://docs.trymaitai.com/api-reference/agents/enable-action.md): Re-enable a previously disabled action.
- [Enable agent system step](https://docs.trymaitai.com/api-reference/agents/enable-agent-system-step.md): Enable an optional runtime system step (`processing` or `progress`).
- [Enable sub agent](https://docs.trymaitai.com/api-reference/agents/enable-sub-agent.md): Re-enable a previously disabled sub-agent relationship.
- [Get agent](https://docs.trymaitai.com/api-reference/agents/get-agent.md): Retrieve an agent by ID. Use `detailed=true` to include actions, sub-agents, and full config.
- [Get agent action](https://docs.trymaitai.com/api-reference/agents/get-agent-action.md): Retrieve a single action by ID. Pass `include_intent=true` to also resolve the backing intent (application action): LLM actions are captured in the chat pipeline under `intent = action_name` within the agent's application, so intent-level tooling (test sets, configs with fallback models, monitors) k…
- [Get agent invocation](https://docs.trymaitai.com/api-reference/agents/get-agent-invocation.md): Poll an asynchronous agent invocation started with `wait=false`. Requires the `request_id` returned by the invoke call.
- [Get agent session detail](https://docs.trymaitai.com/api-reference/agents/get-agent-session-detail.md): Retrieve an agent session including all its requests and responses.
- [Get agent session timeline](https://docs.trymaitai.com/api-reference/agents/get-agent-session-timeline.md): Retrieve the chronological timeline of events in an agent session.
- [Get agent status](https://docs.trymaitai.com/api-reference/agents/get-agent-status.md): One-shot release/version status: whether the draft has unpublished changes, the latest published version, total version count, and every named release with the version it pins.
- [Get agent system step config](https://docs.trymaitai.com/api-reference/agents/get-agent-system-step-config.md): Get the resolved model/params config for a system step (model, temperature, max_tokens, etc.). Shared across agents in the application.
- [Get agent system step prompt](https://docs.trymaitai.com/api-reference/agents/get-agent-system-step-prompt.md): Get a system step's shared prompt: `template` (ordered {{reference}} tokens) and `blocks` (segment metadata + content), plus whether it's an override. Stored on the agent's application — affects all agents in that application.
- [Get agent task timeline](https://docs.trymaitai.com/api-reference/agents/get-agent-task-timeline.md): Retrieve the timeline for a specific task within an agent session.
- [Get agent task tree](https://docs.trymaitai.com/api-reference/agents/get-agent-task-tree.md): Retrieve the hierarchical tree of sub-tasks spawned from a root task.
- [Get agent version](https://docs.trymaitai.com/api-reference/agents/get-agent-version.md): Retrieve a specific agent version snapshot by version string.
- [Get form fields](https://docs.trymaitai.com/api-reference/agents/get-form-fields.md): Retrieve the form field definitions for an agent's input form.
- [Get routing config](https://docs.trymaitai.com/api-reference/agents/get-routing-config.md): Retrieve the routing configuration and all routing rules for an agent.
- [Get routing result](https://docs.trymaitai.com/api-reference/agents/get-routing-result.md): Retrieve detailed routing result evaluations for an agent.
- [Import agents](https://docs.trymaitai.com/api-reference/agents/import-agents.md): Import one or more code-defined agents into Maitai from a canonical manifest. The manifest describes the agents, their capabilities (actions), and handoffs (sub-agents) in a framework-agnostic shape. The endpoint: 1. Resolves or creates the target application. 2. Pre-flights every manifest agent aga…
- [Invoke agent](https://docs.trymaitai.com/api-reference/agents/invoke-agent.md): Run an agent and wait for its final response. Targets the draft by default; pass `version` (e.g. "1.2.0") or `release` (e.g. "production") to pin. Body: `{message}` or `{messages: [...]}`, plus optional `session_id`, `max_iterations`, and `secrets` ({NAME: value} for actions that declare `{{secrets.…
- [List action versions](https://docs.trymaitai.com/api-reference/agents/list-action-versions.md): List published versions of an action.
- [List agent actions](https://docs.trymaitai.com/api-reference/agents/list-agent-actions.md): List all actions (capabilities) configured for an agent.
- [List agent releases](https://docs.trymaitai.com/api-reference/agents/list-agent-releases.md): List all named releases (e.g. production, staging) for an agent.
- [List agent sessions](https://docs.trymaitai.com/api-reference/agents/list-agent-sessions.md): List paginated agent sessions, optionally filtered by version.
- [List agent system steps](https://docs.trymaitai.com/api-reference/agents/list-agent-system-steps.md): List the agent runtime system steps for this agent's application. Prompt and model/params are shared across agents in the same application.
- [List agent versions](https://docs.trymaitai.com/api-reference/agents/list-agent-versions.md): List published versions of an agent, ordered by most recent.
- [List agents](https://docs.trymaitai.com/api-reference/agents/list-agents.md): List all agents belonging to your company. Optionally include sub-agents and actions. Pass ``application_id`` to scope the listing to one application — avoids O(total agents) work on large tenants when callers (e.g. ``maitai agents import --diff``) only need agents under one app.
- [List sub agents](https://docs.trymaitai.com/api-reference/agents/list-sub-agents.md): List all sub-agents attached to a parent agent.
- [List supplied actions](https://docs.trymaitai.com/api-reference/agents/list-supplied-actions.md): List Maitai-supplied actions available to clone onto an agent. Returns curated catalog entries only (no action_config). Cloned actions become normal agent actions and are managed via the standard action CRUD endpoints.
- [Patch agent](https://docs.trymaitai.com/api-reference/agents/patch-agent.md): Partially update an agent using JSON Merge Patch semantics (RFC 7386): nested objects merge recursively, `null` deletes a key, scalars/arrays replace. Unlike PUT, `agent_config` and `meta` are merged onto the existing values instead of replaced wholesale — e.g. `{"agent_config": {"high_performance":…
- [Patch agent action](https://docs.trymaitai.com/api-reference/agents/patch-agent-action.md): Partially update an action using JSON Merge Patch semantics (RFC 7386). Unlike PUT (which replaces `action_config` wholesale), nested objects merge recursively and `null` deletes a key — e.g. `{"action_config": {"prompt": "..."}}` changes just the prompt, and `{"action_config": {"model_config": {"mo…
- [Publish action version](https://docs.trymaitai.com/api-reference/agents/publish-action-version.md): Publish the current action configuration as a new versioned snapshot.
- [Publish agent version](https://docs.trymaitai.com/api-reference/agents/publish-agent-version.md): Publish the current draft agent configuration as a new versioned snapshot.
- [Remove sub agent](https://docs.trymaitai.com/api-reference/agents/remove-sub-agent.md): Detach a sub-agent from its parent.
- [Reorder routing rule](https://docs.trymaitai.com/api-reference/agents/reorder-routing-rule.md): Reorder a routing rule to a new position.
- [Reset agent system step config](https://docs.trymaitai.com/api-reference/agents/reset-agent-system-step-config.md): Reset a system step's model/params config to defaults.
- [Reset agent system step prompt](https://docs.trymaitai.com/api-reference/agents/reset-agent-system-step-prompt.md): Reset a system step's shared prompt to the canonical seed by clearing your company's override (no-op if there is none).
- [Restore action version](https://docs.trymaitai.com/api-reference/agents/restore-action-version.md): Restore a published action version into the editable draft, so new changes build on it. Overwrites the current action draft with that version's snapshot.
- [Restore agent version](https://docs.trymaitai.com/api-reference/agents/restore-agent-version.md): Restore a published version into the editable draft, so new changes build on it. Overwrites the current draft with that version's snapshot (publish again to create a new version from it).
- [Test routing rule](https://docs.trymaitai.com/api-reference/agents/test-routing-rule.md): Test a routing rule against provided input values.
- [Update agent](https://docs.trymaitai.com/api-reference/agents/update-agent.md): Update agent fields such as name, description, config, or status.
- [Update agent action](https://docs.trymaitai.com/api-reference/agents/update-agent-action.md): Update an action's name, type, description, config, or invocation mode.
- [Update agent system step config](https://docs.trymaitai.com/api-reference/agents/update-agent-system-step-config.md): Update model/params for a system step. Body is a config object, e.g. `{model, temperature, max_tokens}`. For the respond step, set structured JSON via `metadata.request_parameters.response_format`. Top-level keys merge — include existing `metadata` when writing it. Shared across the application.
- [Update agent system step prompt](https://docs.trymaitai.com/api-reference/agents/update-agent-system-step-prompt.md): Update a system step's shared prompt. Body: `{template, blocks:[{reference, content}]}`. Only editable block content and template token order may change — blocks cannot be added or removed. Shared across agents in the application.
- [Update form fields](https://docs.trymaitai.com/api-reference/agents/update-form-fields.md): Replace all form field definitions for an agent.
- [Update routing config](https://docs.trymaitai.com/api-reference/agents/update-routing-config.md): Update the routing mode (llm or rules) and default route for an agent.
- [Update routing rule](https://docs.trymaitai.com/api-reference/agents/update-routing-rule.md): Update the conditions, route, or label of an existing routing rule.
- [Upsert agent release](https://docs.trymaitai.com/api-reference/agents/upsert-agent-release.md): Create or update a named release, optionally pinning it to a version.
- [Get agent request analytics](https://docs.trymaitai.com/api-reference/analytics/get-agent-request-analytics.md): Get request analytics for an agent.
- [Get application action fault rate analytics](https://docs.trymaitai.com/api-reference/analytics/get-application-action-fault-rate-analytics.md): Get fault-rate analytics for an application intent.
- [Get application action request analytics](https://docs.trymaitai.com/api-reference/analytics/get-application-action-request-analytics.md): Get request analytics for an application intent.
- [Get application fault rate analytics](https://docs.trymaitai.com/api-reference/analytics/get-application-fault-rate-analytics.md): Get fault-rate analytics for an application.
- [Get application request analytics](https://docs.trymaitai.com/api-reference/analytics/get-application-request-analytics.md): Get request analytics for an application.
- [Get company application activity analytics](https://docs.trymaitai.com/api-reference/analytics/get-company-application-activity-analytics.md): Get per-application request activity for the company.
- [Get company model usage analytics](https://docs.trymaitai.com/api-reference/analytics/get-company-model-usage-analytics.md): Get per-model token usage for the company.
- [Get company request analytics](https://docs.trymaitai.com/api-reference/analytics/get-company-request-analytics.md): Get company-level request analytics.
- [Get intent group fault rate analytics](https://docs.trymaitai.com/api-reference/analytics/get-intent-group-fault-rate-analytics.md): Get fault-rate analytics for an intent group.
- [Get intent group request analytics](https://docs.trymaitai.com/api-reference/analytics/get-intent-group-request-analytics.md): Get request analytics for an intent group.
- [Create application](https://docs.trymaitai.com/api-reference/applications/create-application.md): Create a new application under your company.
- [Delete application](https://docs.trymaitai.com/api-reference/applications/delete-application.md): Permanently delete an application and all its associated intents.
- [Get application](https://docs.trymaitai.com/api-reference/applications/get-application.md): Retrieve a single application by ID with full detail.
- [Get application config](https://docs.trymaitai.com/api-reference/applications/get-application-config.md): Retrieve the configuration object for an application.
- [List application models](https://docs.trymaitai.com/api-reference/applications/list-application-models.md): List all models assigned to an application.
- [List application sessions](https://docs.trymaitai.com/api-reference/applications/list-application-sessions.md): List paginated chat sessions for an application.
- [List application workflow runs](https://docs.trymaitai.com/api-reference/applications/list-application-workflow-runs.md): List paginated workflow execution runs for an application.
- [List applications](https://docs.trymaitai.com/api-reference/applications/list-applications.md): List all applications belonging to your company. Use `detailed=true` to include full configuration.
- [Update application](https://docs.trymaitai.com/api-reference/applications/update-application.md): Update an application's name, reference name, or other fields.
- [Update application config](https://docs.trymaitai.com/api-reference/applications/update-application-config.md): Replace the configuration object for an application.
- [Create composition](https://docs.trymaitai.com/api-reference/compositions/create-composition.md): Create a dataset composition.
- [Delete composition](https://docs.trymaitai.com/api-reference/compositions/delete-composition.md): Delete a composition.
- [Get composition](https://docs.trymaitai.com/api-reference/compositions/get-composition.md): Retrieve a single composition by ID.
- [List composition versions](https://docs.trymaitai.com/api-reference/compositions/list-composition-versions.md): List all versions for a composition lineage.
- [List compositions](https://docs.trymaitai.com/api-reference/compositions/list-compositions.md): List dataset compositions for your company.
- [List compositions by application intent](https://docs.trymaitai.com/api-reference/compositions/list-compositions-by-application-intent.md): List compositions for an application intent.
- [List compositions by intent group](https://docs.trymaitai.com/api-reference/compositions/list-compositions-by-intent-group.md): List compositions for an intent group.
- [Update composition](https://docs.trymaitai.com/api-reference/compositions/update-composition.md): Update a composition by creating a new version.
- [Validate rl composition](https://docs.trymaitai.com/api-reference/compositions/validate-rl-composition.md): Validate that datasets can form an RL composition.
- [Delete conversation tree](https://docs.trymaitai.com/api-reference/conversation-trees/delete-conversation-tree.md): Permanently delete a conversation tree and all its versions.
- [Get conversation tree](https://docs.trymaitai.com/api-reference/conversation-trees/get-conversation-tree.md): Retrieve a conversation tree configuration and its node structure.
- [Get conversation tree status](https://docs.trymaitai.com/api-reference/conversation-trees/get-conversation-tree-status.md): Check the execution status of a conversation tree data generation run.
- [List conversation tree versions](https://docs.trymaitai.com/api-reference/conversation-trees/list-conversation-tree-versions.md): List all saved versions of a conversation tree.
- [List conversation trees](https://docs.trymaitai.com/api-reference/conversation-trees/list-conversation-trees.md): List synthetic conversation trees. Optionally filter by `application_id`.
- [API Coverage](https://docs.trymaitai.com/api-reference/coverage.md): What the Developer API covers, what is intentionally excluded, and where to find generated references.
- [Add dataset requests bulk](https://docs.trymaitai.com/api-reference/datasets/add-dataset-requests-bulk.md): Add requests to a dataset using the Portal bulk payload shape.
- [Add dataset tag](https://docs.trymaitai.com/api-reference/datasets/add-dataset-tag.md): Add a tag to a dataset.
- [Add requests to dataset](https://docs.trymaitai.com/api-reference/datasets/add-requests-to-dataset.md): Add request/response pairs to a dataset. Accepts either body shape: - `{"requests": [{"request_id": "..."}]}` (canonical) - `{"request_ids": ["...", "..."]}` (convenience — flat string array)
- [Apply dataset prune](https://docs.trymaitai.com/api-reference/datasets/apply-dataset-prune.md): Apply dataset pruning.
- [Apply dataset regex replacements](https://docs.trymaitai.com/api-reference/datasets/apply-dataset-regex-replacements.md): Apply regex replacements to dataset rows.
- [Augment dataset reasoning](https://docs.trymaitai.com/api-reference/datasets/augment-dataset-reasoning.md): Augment dataset rows with reasoning.
- [Cancel dataset generation](https://docs.trymaitai.com/api-reference/datasets/cancel-dataset-generation.md): Cancel AI dataset generation.
- [Cancel dataset s3 import](https://docs.trymaitai.com/api-reference/datasets/cancel-dataset-s3-import.md): Cancel an in-progress S3 dataset import.
- [Clone dataset](https://docs.trymaitai.com/api-reference/datasets/clone-dataset.md): Clone a dataset.
- [Create dataset](https://docs.trymaitai.com/api-reference/datasets/create-dataset.md): Create a new training dataset linked to an intent group.
- [Delete dataset](https://docs.trymaitai.com/api-reference/datasets/delete-dataset.md): Permanently delete a dataset and disassociate its requests. Pass ``?cascade=lineage`` to delete the entire version lineage instead of only the specified version. Returns 409 if a continuous learning run still references any targeted version.
- [Estimate dataset generation cost](https://docs.trymaitai.com/api-reference/datasets/estimate-dataset-generation-cost.md): Estimate AI dataset generation cost.
- [Get dataset](https://docs.trymaitai.com/api-reference/datasets/get-dataset.md): Retrieve a single dataset by ID.
- [Get dataset delete impact](https://docs.trymaitai.com/api-reference/datasets/get-dataset-delete-impact.md): Describe what would be deleted if this dataset (or its lineage) were removed.
- [Get dataset prompt](https://docs.trymaitai.com/api-reference/datasets/get-dataset-prompt.md): Get a generated prompt summary for a dataset.
- [Get dataset regex replacements applicable count](https://docs.trymaitai.com/api-reference/datasets/get-dataset-regex-replacements-applicable-count.md): Count dataset rows that would be affected by regex replacements.
- [Get dataset request distribution](https://docs.trymaitai.com/api-reference/datasets/get-dataset-request-distribution.md): Get request distribution facets for a dataset.
- [Get dataset request reasoning](https://docs.trymaitai.com/api-reference/datasets/get-dataset-request-reasoning.md): Get reasoning for one dataset request.
- [Get dataset s3 syncer info](https://docs.trymaitai.com/api-reference/datasets/get-dataset-s3-syncer-info.md): Get S3 syncer service account and external ID details.
- [Get dataset status](https://docs.trymaitai.com/api-reference/datasets/get-dataset-status.md): Get dataset import/generation status.
- [Get estimated dataset request count](https://docs.trymaitai.com/api-reference/datasets/get-estimated-dataset-request-count.md): Estimate dataset request count for the provided filters.
- [List dataset request ids](https://docs.trymaitai.com/api-reference/datasets/list-dataset-request-ids.md): List request IDs included in a dataset.
- [List dataset requests](https://docs.trymaitai.com/api-reference/datasets/list-dataset-requests.md): List the request/response pairs included in a dataset.
- [List dataset tags](https://docs.trymaitai.com/api-reference/datasets/list-dataset-tags.md): List tags for a dataset.
- [List dataset versions](https://docs.trymaitai.com/api-reference/datasets/list-dataset-versions.md): List dataset versions.
- [List datasets](https://docs.trymaitai.com/api-reference/datasets/list-datasets.md): List all training datasets for your company.
- [List datasets by intent](https://docs.trymaitai.com/api-reference/datasets/list-datasets-by-intent.md): List datasets for an application intent.
- [List datasets by intent group](https://docs.trymaitai.com/api-reference/datasets/list-datasets-by-intent-group.md): List datasets for an intent group.
- [List datasets by tags](https://docs.trymaitai.com/api-reference/datasets/list-datasets-by-tags.md): List datasets matching tag filters.
- [List datasets by test set](https://docs.trymaitai.com/api-reference/datasets/list-datasets-by-test-set.md): List datasets that are associated with a test set.
- [List eligible dataset requests](https://docs.trymaitai.com/api-reference/datasets/list-eligible-dataset-requests.md): List requests eligible for addition to a dataset.
- [List valid dataset tags](https://docs.trymaitai.com/api-reference/datasets/list-valid-dataset-tags.md): List valid dataset tags.
- [Pause dataset generation](https://docs.trymaitai.com/api-reference/datasets/pause-dataset-generation.md): Pause AI dataset generation.
- [Preview dataset generation](https://docs.trymaitai.com/api-reference/datasets/preview-dataset-generation.md): Preview AI-generated dataset rows.
- [Preview dataset prune](https://docs.trymaitai.com/api-reference/datasets/preview-dataset-prune.md): Preview dataset pruning.
- [Reimport dataset s3 source](https://docs.trymaitai.com/api-reference/datasets/reimport-dataset-s3-source.md): Re-run S3 import for a dataset.
- [Remove dataset requests bulk](https://docs.trymaitai.com/api-reference/datasets/remove-dataset-requests-bulk.md): Remove requests from a dataset using the Portal bulk payload shape.
- [Remove dataset tag](https://docs.trymaitai.com/api-reference/datasets/remove-dataset-tag.md): Remove a tag from a dataset.
- [Remove requests from dataset](https://docs.trymaitai.com/api-reference/datasets/remove-requests-from-dataset.md): Remove request/response pairs from a dataset. Accepts either body shape: - `{"requests": [{"request_id": "..."}]}` (canonical) - `{"request_ids": ["...", "..."]}` (convenience — flat string array)
- [Resume dataset generation](https://docs.trymaitai.com/api-reference/datasets/resume-dataset-generation.md): Resume AI dataset generation.
- [Sample clone dataset](https://docs.trymaitai.com/api-reference/datasets/sample-clone-dataset.md): Create a sampled clone of a dataset.
- [Search added dataset requests](https://docs.trymaitai.com/api-reference/datasets/search-added-dataset-requests.md): Search requests already added to a dataset.
- [Search eligible dataset requests](https://docs.trymaitai.com/api-reference/datasets/search-eligible-dataset-requests.md): Search requests eligible for addition to a dataset.
- [Set dataset tags](https://docs.trymaitai.com/api-reference/datasets/set-dataset-tags.md): Replace all tags on a dataset.
- [Start dataset generation](https://docs.trymaitai.com/api-reference/datasets/start-dataset-generation.md): Start AI dataset generation.
- [Update dataset](https://docs.trymaitai.com/api-reference/datasets/update-dataset.md): Update a dataset's name, description, or sampling configuration.
- [Validate dataset s3 source](https://docs.trymaitai.com/api-reference/datasets/validate-dataset-s3-source.md): Validate an S3 source before dataset import.
- [Create evaluation criteria](https://docs.trymaitai.com/api-reference/evaluation-criteria/create-evaluation-criteria.md): Create evaluation criteria.
- [Delete evaluation criteria](https://docs.trymaitai.com/api-reference/evaluation-criteria/delete-evaluation-criteria.md): Delete evaluation criteria.
- [List available evaluation criteria](https://docs.trymaitai.com/api-reference/evaluation-criteria/list-available-evaluation-criteria.md): List built-in evaluation criteria options.
- [List evaluation criteria](https://docs.trymaitai.com/api-reference/evaluation-criteria/list-evaluation-criteria.md): List saved evaluation criteria.
- [Update evaluation criteria](https://docs.trymaitai.com/api-reference/evaluation-criteria/update-evaluation-criteria.md): Update evaluation criteria.
- [Create evaluation](https://docs.trymaitai.com/api-reference/evaluations/create-evaluation.md): Start a batch evaluation run against selected sentinels and requests.
- [Get evaluation](https://docs.trymaitai.com/api-reference/evaluations/get-evaluation.md): Retrieve an evaluation run. Use `full=true` to include all request data.
- [Get evaluation results](https://docs.trymaitai.com/api-reference/evaluations/get-evaluation-results.md): Retrieve per-request evaluation scores and sentinel verdicts for a run.
- [List evaluations](https://docs.trymaitai.com/api-reference/evaluations/list-evaluations.md): List all evaluation runs for your company.
- [Cancel finetune run](https://docs.trymaitai.com/api-reference/finetune-runs/cancel-finetune-run.md): Cancel a running finetune job.
- [Create finetune run](https://docs.trymaitai.com/api-reference/finetune-runs/create-finetune-run.md): Start a new model finetuning job using a training dataset.
- [Get finetune run](https://docs.trymaitai.com/api-reference/finetune-runs/get-finetune-run.md): Retrieve a finetune run with its configuration and current status.
- [Get finetune run metrics](https://docs.trymaitai.com/api-reference/finetune-runs/get-finetune-run-metrics.md): Retrieve training loss and accuracy metrics for a finetune run.
- [List finetune runs](https://docs.trymaitai.com/api-reference/finetune-runs/list-finetune-runs.md): List all finetune runs for your company. Optionally filter by `status`.
- [Get intent group](https://docs.trymaitai.com/api-reference/intent-groups/get-intent-group.md): Retrieve a single intent group by ID. Use `detailed=true` (default) for full details.
- [Get intent group config](https://docs.trymaitai.com/api-reference/intent-groups/get-intent-group-config.md): Retrieve the configuration for an intent group.
- [List intent group compositions](https://docs.trymaitai.com/api-reference/intent-groups/list-intent-group-compositions.md): List all dataset compositions for an intent group.
- [List intent group datasets](https://docs.trymaitai.com/api-reference/intent-groups/list-intent-group-datasets.md): List all training datasets for an intent group.
- [List intent group models](https://docs.trymaitai.com/api-reference/intent-groups/list-intent-group-models.md): List all models assigned to an intent group.
- [List intent group requests](https://docs.trymaitai.com/api-reference/intent-groups/list-intent-group-requests.md): List paginated requests for an intent group with optional date range and message filtering.
- [List intent group sentinels](https://docs.trymaitai.com/api-reference/intent-groups/list-intent-group-sentinels.md): List all sentinels attached to an intent group.
- [List intent group test sets](https://docs.trymaitai.com/api-reference/intent-groups/list-intent-group-test-sets.md): List all test sets associated with an intent group.
- [List intent groups](https://docs.trymaitai.com/api-reference/intent-groups/list-intent-groups.md): List all intent groups for your company with pagination.
- [List intents by group](https://docs.trymaitai.com/api-reference/intent-groups/list-intents-by-group.md): List all intents belonging to an intent group across applications.
- [Update intent group config](https://docs.trymaitai.com/api-reference/intent-groups/update-intent-group-config.md): Replace the configuration for an intent group.
- [Create application intent](https://docs.trymaitai.com/api-reference/intents/create-application-intent.md): Create a new intent (application action) for an application.
- [Delete application intent](https://docs.trymaitai.com/api-reference/intents/delete-application-intent.md): Delete an intent (application action) from an application.
- [Disable intent notifications](https://docs.trymaitai.com/api-reference/intents/disable-intent-notifications.md): Disable fault notifications for an intent.
- [Enable intent notifications](https://docs.trymaitai.com/api-reference/intents/enable-intent-notifications.md): Enable fault notifications for an intent.
- [Get application intent](https://docs.trymaitai.com/api-reference/intents/get-application-intent.md): Retrieve a single intent by ID within an application.
- [Get intent config](https://docs.trymaitai.com/api-reference/intents/get-intent-config.md): Retrieve the configuration for a specific intent.
- [List application intents](https://docs.trymaitai.com/api-reference/intents/list-application-intents.md): List all intents (application actions) for an application with details.
- [Reset intent config](https://docs.trymaitai.com/api-reference/intents/reset-intent-config.md): Reset an intent's configuration to the application/default configuration.
- [Update intent config](https://docs.trymaitai.com/api-reference/intents/update-intent-config.md): Replace the configuration for a specific intent.
- [Attach model inference pool](https://docs.trymaitai.com/api-reference/models/attach-model-inference-pool.md): Attach an inference pool to a model.
- [Create base model](https://docs.trymaitai.com/api-reference/models/create-base-model.md): Create a Maitai base model registry entry.
- [Detach model inference pool](https://docs.trymaitai.com/api-reference/models/detach-model-inference-pool.md): Detach an inference pool from a model.
- [Disable model](https://docs.trymaitai.com/api-reference/models/disable-model.md): Disable a model so it is no longer used for inference.
- [Enable model](https://docs.trymaitai.com/api-reference/models/enable-model.md): Re-enable a previously disabled model for inference.
- [Execute swap model ref](https://docs.trymaitai.com/api-reference/models/execute-swap-model-ref.md): Execute a model ref replacement.
- [Get model](https://docs.trymaitai.com/api-reference/models/get-model.md): Get model details.
- [Get model inference pool](https://docs.trymaitai.com/api-reference/models/get-model-inference-pool.md): Get the inference pool attached to a model.
- [Get model inference pool debug](https://docs.trymaitai.com/api-reference/models/get-model-inference-pool-debug.md): Get debug details for a model's inference pool.
- [Get model repoint options](https://docs.trymaitai.com/api-reference/models/get-model-repoint-options.md): Get repointing options for a model.
- [List available models](https://docs.trymaitai.com/api-reference/models/list-available-models.md): List all models available to your company, including base and finetuned models.
- [List model inference pool attach candidates](https://docs.trymaitai.com/api-reference/models/list-model-inference-pool-attach-candidates.md): List inference pools that can be attached to a model.
- [List models](https://docs.trymaitai.com/api-reference/models/list-models.md): List enabled models for your company. Optionally filter by `model_type`.
- [List models by application](https://docs.trymaitai.com/api-reference/models/list-models-by-application.md): List models for an application.
- [List models by intent](https://docs.trymaitai.com/api-reference/models/list-models-by-intent.md): List models for an intent.
- [List models by intent group](https://docs.trymaitai.com/api-reference/models/list-models-by-intent-group.md): List models for an intent group.
- [Patch model registry](https://docs.trymaitai.com/api-reference/models/patch-model-registry.md): Patch model registry metadata.
- [Preview swap model ref](https://docs.trymaitai.com/api-reference/models/preview-swap-model-ref.md): Preview replacing a model ref.
- [Repoint model](https://docs.trymaitai.com/api-reference/models/repoint-model.md): Repoint a model.
- [Activate monitor](https://docs.trymaitai.com/api-reference/monitors/activate-monitor.md): Set status to ACTIVE so production sampling fires. Idempotent.
- [Create monitor](https://docs.trymaitai.com/api-reference/monitors/create-monitor.md): Create a reusable production monitor. New monitors land in `DRAFT`.
- [Create monitor target](https://docs.trymaitai.com/api-reference/monitors/create-monitor-target.md): Attach the monitor to an intent / workflow / agent with a sample rate.
- [Delete monitor](https://docs.trymaitai.com/api-reference/monitors/delete-monitor.md): Soft-delete a monitor (also detaches all targets).
- [Delete monitor release](https://docs.trymaitai.com/api-reference/monitors/delete-monitor-release.md): Delete a named release.
- [Delete monitor target](https://docs.trymaitai.com/api-reference/monitors/delete-monitor-target.md): Detach (soft-delete) a monitor target.
- [Disable monitor target](https://docs.trymaitai.com/api-reference/monitors/disable-monitor-target.md): Disable a target without detaching it (sampling stops). Idempotent.
- [Enable monitor target](https://docs.trymaitai.com/api-reference/monitors/enable-monitor-target.md): Re-enable a monitor target so sampling resumes for it. Idempotent.
- [Get default monitor version](https://docs.trymaitai.com/api-reference/monitors/get-default-monitor-version.md): Return the version runtime would use right now (default release or latest).
- [Get monitor](https://docs.trymaitai.com/api-reference/monitors/get-monitor.md): Retrieve a monitor by ID. Use `include_targets=false` to skip target loading.
- [Get monitor activity](https://docs.trymaitai.com/api-reference/monitors/get-monitor-activity.md): Time-bucketed monitor outcome counts (overall or per target). Query params: `monitor_target_id`, `bucket_seconds`, `start_seconds`, `end_seconds`. Defaults: 24h lookback, 1h buckets.
- [Get monitor metrics](https://docs.trymaitai.com/api-reference/monitors/get-monitor-metrics.md): Aggregated counts + rates for the monitor over a window. Query params: `monitor_target_id` (scope to one target), `start_seconds`, `end_seconds`. Defaults match the activity endpoint (24h lookback).
- [Get monitor metrics by target](https://docs.trymaitai.com/api-reference/monitors/get-monitor-metrics-by-target.md): Per-target metrics rollup (one row per attached target). Targets with zero activity in the window still appear (with zeroed counts) so the caller can compare against the configured sample rate.
- [Get monitor target metrics](https://docs.trymaitai.com/api-reference/monitors/get-monitor-target-metrics.md): Aggregated counts + rates for a single attached target.
- [Get monitor target sparkline](https://docs.trymaitai.com/api-reference/monitors/get-monitor-target-sparkline.md): Per-target error rate sparkline (used by the At-a-Glance cards).
- [Get monitor version](https://docs.trymaitai.com/api-reference/monitors/get-monitor-version.md): Retrieve a specific monitor version snapshot.
- [Get run global](https://docs.trymaitai.com/api-reference/monitors/get-run-global.md): Drill into a single ``monitor_run`` (resolution trace, source ids, etc.).
- [Get run scoped](https://docs.trymaitai.com/api-reference/monitors/get-run-scoped.md): Get a single run and verify it belongs to the given monitor.
- [Get target sample](https://docs.trymaitai.com/api-reference/monitors/get-target-sample.md): Return the most recent production payload for a monitor target. Powers the wizard's "design against a real sample" UX (autocomplete JSON paths, preview the runner-input shape) and is also useful for agents asking "what does this intent / workflow / agent actually emit?" before they author resolution…
- [List monitor releases](https://docs.trymaitai.com/api-reference/monitors/list-monitor-releases.md): List named releases for a monitor (default release first).
- [List monitor targets](https://docs.trymaitai.com/api-reference/monitors/list-monitor-targets.md): List targets attached to a monitor.
- [List monitor versions](https://docs.trymaitai.com/api-reference/monitors/list-monitor-versions.md): List published versions for a monitor (newest first).
- [List monitors](https://docs.trymaitai.com/api-reference/monitors/list-monitors.md): List monitors for your company. Supports `search`, `status`, pagination.
- [List monitors by target](https://docs.trymaitai.com/api-reference/monitors/list-monitors-by-target.md): Find every active monitor attached to ``(target_type, target_id)``. Useful for agents asking "what monitors are watching workflow 123?" or "is anything monitoring this intent group?". Required query params: ``target_type``, ``target_id``. Optional: ``enabled_only=true``.
- [List runs by source](https://docs.trymaitai.com/api-reference/monitors/list-runs-by-source.md): Reverse lookup: every monitor run that evaluated the given event. Required: ``source_type`` (request|workflow|agent), ``source_type_id``. Optional: ``limit`` (default 25, max 100).
- [List runs for monitor](https://docs.trymaitai.com/api-reference/monitors/list-runs-for-monitor.md): List runs scoped to a single monitor.
- [List runs global](https://docs.trymaitai.com/api-reference/monitors/list-runs-global.md): List monitor runs across every monitor in your company. All filters are optional. Useful for "show me failures from the last hour" style queries — pass ``outcome=failed&start_seconds=...``.
- [Pause monitor](https://docs.trymaitai.com/api-reference/monitors/pause-monitor.md): Set status to PAUSED so production sampling stops. Idempotent.
- [Preview monitor](https://docs.trymaitai.com/api-reference/monitors/preview-monitor.md): Run the monitor judge + resolution against an ad-hoc payload. Body is :class:`MonitorPreviewRequest`. Defaults to the working draft so agents iterating on ``monitor.config`` can see the verdict immediately. Pass ``use=version`` / ``use=release`` / ``use=adhoc`` to preview a different config. No ``mo…
- [Promote monitor release](https://docs.trymaitai.com/api-reference/monitors/promote-monitor-release.md): Make ``release_name`` the default release for the monitor. Convenience for agents — same as ``POST /releases`` with the existing name + ``is_default=true``, but doesn't require knowing the version.
- [Publish monitor version](https://docs.trymaitai.com/api-reference/monitors/publish-monitor-version.md): Publish a new version of the monitor (snapshot + semver bump).
- [Update monitor](https://docs.trymaitai.com/api-reference/monitors/update-monitor.md): Update name, description, status, runner config, resolution config, or meta.
- [Update monitor target](https://docs.trymaitai.com/api-reference/monitors/update-monitor-target.md): Update the attachment's sample rate, enabled flag, or meta bag.
- [Upsert monitor release](https://docs.trymaitai.com/api-reference/monitors/upsert-monitor-release.md): Create or update a named release pointing at a specific monitor version.
- [API Reference](https://docs.trymaitai.com/api-reference/overview.md): Programmatically manage Maitai resources using the REST API.
- [List fallbacks](https://docs.trymaitai.com/api-reference/reports/list-fallbacks.md): List recent fallbacks.
- [List fallbacks by intent](https://docs.trymaitai.com/api-reference/reports/list-fallbacks-by-intent.md): List recent fallbacks for an intent.
- [List faults](https://docs.trymaitai.com/api-reference/reports/list-faults.md): List recent faults.
- [List faults by intent](https://docs.trymaitai.com/api-reference/reports/list-faults-by-intent.md): List recent faults for an intent.
- [Get request](https://docs.trymaitai.com/api-reference/requests/get-request.md): Retrieve a single request and its corresponding response.
- [List requests](https://docs.trymaitai.com/api-reference/requests/list-requests.md): List requests filtered by application_id + intent_id, with date range.
- [Update request response](https://docs.trymaitai.com/api-reference/requests/update-request-response.md): Update/correct a response for a request. Send `message_content` (string) in the body.
- [Search](https://docs.trymaitai.com/api-reference/search/search.md): Return a recommended Maitai CLI/API execution plan for a free-form query. Useful for agent IDEs (Cursor, Claude Code) that want to translate a natural-language ask like "how do I import an OpenAI agent" into a concrete sequence of Maitai operations, known pitfalls, and related tools — the same shape…
- [Create sentinel](https://docs.trymaitai.com/api-reference/sentinels/create-sentinel.md): Create a new sentinel to monitor model output quality for an intent group.
- [Delete sentinel](https://docs.trymaitai.com/api-reference/sentinels/delete-sentinel.md): Permanently delete a sentinel.
- [Generate new sentinel](https://docs.trymaitai.com/api-reference/sentinels/generate-new-sentinel.md): Generate a new sentinel.
- [Generate sentinels](https://docs.trymaitai.com/api-reference/sentinels/generate-sentinels.md): Generate sentinels.
- [Get sentinel](https://docs.trymaitai.com/api-reference/sentinels/get-sentinel.md): Retrieve a single sentinel by ID.
- [List sentinels](https://docs.trymaitai.com/api-reference/sentinels/list-sentinels.md): List all sentinels (evaluation watchers) for your company.
- [List sentinels by application](https://docs.trymaitai.com/api-reference/sentinels/list-sentinels-by-application.md): List sentinels for an application.
- [List sentinels by application human needs](https://docs.trymaitai.com/api-reference/sentinels/list-sentinels-by-application-human-needs.md): List human-needs sentinels for an application.
- [List sentinels by intent group](https://docs.trymaitai.com/api-reference/sentinels/list-sentinels-by-intent-group.md): List sentinels for an intent group.
- [List sentinels by intent name](https://docs.trymaitai.com/api-reference/sentinels/list-sentinels-by-intent-name.md): List sentinels for an intent group name.
- [List simple sentinels](https://docs.trymaitai.com/api-reference/sentinels/list-simple-sentinels.md): List lightweight sentinel rows.
- [Regenerate sentinel](https://docs.trymaitai.com/api-reference/sentinels/regenerate-sentinel.md): Regenerate a sentinel.
- [Regenerate sentinel correction](https://docs.trymaitai.com/api-reference/sentinels/regenerate-sentinel-correction.md): Regenerate a sentinel correction prompt.
- [Regenerate sentinel evaluation](https://docs.trymaitai.com/api-reference/sentinels/regenerate-sentinel-evaluation.md): Regenerate a sentinel evaluation prompt.
- [Regenerate sentinel qualification](https://docs.trymaitai.com/api-reference/sentinels/regenerate-sentinel-qualification.md): Regenerate a sentinel qualification prompt.
- [Regenerate sentinels](https://docs.trymaitai.com/api-reference/sentinels/regenerate-sentinels.md): Regenerate multiple sentinels.
- [Update sentinel](https://docs.trymaitai.com/api-reference/sentinels/update-sentinel.md): Update a sentinel's name, severity, directives, or configuration.
- [Update sentinel directive](https://docs.trymaitai.com/api-reference/sentinels/update-sentinel-directive.md): Update a sentinel directive.
- [Get session](https://docs.trymaitai.com/api-reference/sessions/get-session.md): Retrieve a single session by ID. Requires `application_id` query param.
- [Get session timeline](https://docs.trymaitai.com/api-reference/sessions/get-session-timeline.md): Retrieve the chronological request timeline for a session. Requires `application_id` query param.
- [List sessions](https://docs.trymaitai.com/api-reference/sessions/list-sessions.md): List classic (non-agent) chat sessions. Optionally filter by `application_id`.
- [Set session feedback](https://docs.trymaitai.com/api-reference/sessions/set-session-feedback.md): Submit feedback (rating, notes) for a session.
- [Compare test runs](https://docs.trymaitai.com/api-reference/test-runs/compare-test-runs.md): Compare completed test runs by test-set request.
- [Create test run](https://docs.trymaitai.com/api-reference/test-runs/create-test-run.md): Create and start a new test run against a test set. Optionally apply a prompt-template tweak by setting `config.prompt_template` on the request body. Fetch the inferred template first via `GET /v1/test-sets/{test_set_id}/prompt-template`, edit the literal text around the `{{var_N}}` placeholders in…
- [Delete test run](https://docs.trymaitai.com/api-reference/test-runs/delete-test-run.md): Permanently delete a test run and its results.
- [Evaluate test run](https://docs.trymaitai.com/api-reference/test-runs/evaluate-test-run.md): Re-evaluate all requests for a test run.
- [Evaluate test run request](https://docs.trymaitai.com/api-reference/test-runs/evaluate-test-run-request.md): Re-evaluate a single request in a test run.
- [Get test run](https://docs.trymaitai.com/api-reference/test-runs/get-test-run.md): Retrieve a single test run with its configuration and summary results.
- [Get test run progress](https://docs.trymaitai.com/api-reference/test-runs/get-test-run-progress.md): Check how many requests have completed in a running test run.
- [Get test run progress by test set](https://docs.trymaitai.com/api-reference/test-runs/get-test-run-progress-by-test-set.md): Get progress for active test runs on a test set.
- [Get test run request comparison](https://docs.trymaitai.com/api-reference/test-runs/get-test-run-request-comparison.md): Compare two test-run request results.
- [Get test run results](https://docs.trymaitai.com/api-reference/test-runs/get-test-run-results.md): Get aggregate test-run results.
- [List test run items](https://docs.trymaitai.com/api-reference/test-runs/list-test-run-items.md): List workflow test-run item results. Requires type=workflow.
- [List test run requests](https://docs.trymaitai.com/api-reference/test-runs/list-test-run-requests.md): List individual request results from a test run with scores and responses.
- [List test run requests with filters](https://docs.trymaitai.com/api-reference/test-runs/list-test-run-requests-with-filters.md): List individual test-run request results with Portal filters.
- [List test run review segments](https://docs.trymaitai.com/api-reference/test-runs/list-test-run-review-segments.md): List workflow review segments. Requires type=workflow.
- [List test runs](https://docs.trymaitai.com/api-reference/test-runs/list-test-runs.md): List test runs for your company. Requires `intent_group_id` query param.
- [List test runs by intent group](https://docs.trymaitai.com/api-reference/test-runs/list-test-runs-by-intent-group.md): List test runs for an intent group.
- [List test runs by test set](https://docs.trymaitai.com/api-reference/test-runs/list-test-runs-by-test-set.md): List test runs for a test set.
- [Resume test run](https://docs.trymaitai.com/api-reference/test-runs/resume-test-run.md): Resume a workflow test run. Requires type=workflow.
- [Retry test run](https://docs.trymaitai.com/api-reference/test-runs/retry-test-run.md): Retry a test run.
- [Stop test run](https://docs.trymaitai.com/api-reference/test-runs/stop-test-run.md): Stop a running test run.
- [Update test run item](https://docs.trymaitai.com/api-reference/test-runs/update-test-run-item.md): Update a workflow test-run item. Requires type=workflow.
- [Update test run status](https://docs.trymaitai.com/api-reference/test-runs/update-test-run-status.md): Update test-run status.
- [Add requests to test set](https://docs.trymaitai.com/api-reference/test-sets/add-requests-to-test-set.md): Add request/response pairs to a test set. Accepts either body shape: - `{"requests": [{"request_id": "..."}]}` (canonical) - `{"request_ids": ["...", "..."]}` (convenience — flat string array)
- [Add single request to test set](https://docs.trymaitai.com/api-reference/test-sets/add-single-request-to-test-set.md): Add one request to a test set using the Portal payload shape.
- [Add test set requests bulk](https://docs.trymaitai.com/api-reference/test-sets/add-test-set-requests-bulk.md): Add requests to a test set using the Portal bulk payload shape.
- [Clone test set](https://docs.trymaitai.com/api-reference/test-sets/clone-test-set.md): Clone a test set. Include sample_mode to create a sampled clone.
- [Convert test set to workflow](https://docs.trymaitai.com/api-reference/test-sets/convert-test-set-to-workflow.md): Convert a regular test set into a workflow test set.
- [Convert workflow test set to requests](https://docs.trymaitai.com/api-reference/test-sets/convert-workflow-test-set-to-requests.md): Convert a workflow test set into a regular request-based test set.
- [Create test set](https://docs.trymaitai.com/api-reference/test-sets/create-test-set.md): Create a new test set for evaluating model performance.
- [Delete test set](https://docs.trymaitai.com/api-reference/test-sets/delete-test-set.md): Permanently delete a test set.
- [Get test set](https://docs.trymaitai.com/api-reference/test-sets/get-test-set.md): Retrieve a single test set by ID.
- [Get test set prompt template](https://docs.trymaitai.com/api-reference/test-sets/get-test-set-prompt-template.md): Infer the prompt template a test run would apply across this test set. Returns the inferred per-message template (literal text plus `{{var_N}}` placeholders), regexes used to extract per-request values from each captured request, and a small slice of sample variable bindings. Use this to discover wh…
- [Get test set request distribution](https://docs.trymaitai.com/api-reference/test-sets/get-test-set-request-distribution.md): Get request distribution facets for a test set.
- [List eligible test set requests](https://docs.trymaitai.com/api-reference/test-sets/list-eligible-test-set-requests.md): List requests eligible for addition to a test set.
- [List test set requests](https://docs.trymaitai.com/api-reference/test-sets/list-test-set-requests.md): List the request/response pairs included in a test set.
- [List test set session facets](https://docs.trymaitai.com/api-reference/test-sets/list-test-set-session-facets.md): List session facets for requests in a test set.
- [List test sets](https://docs.trymaitai.com/api-reference/test-sets/list-test-sets.md): List all test sets for your company with pagination.
- [List test sets by application intent](https://docs.trymaitai.com/api-reference/test-sets/list-test-sets-by-application-intent.md): List test sets for an application intent.
- [List test sets by dataset](https://docs.trymaitai.com/api-reference/test-sets/list-test-sets-by-dataset.md): List test sets associated with a dataset.
- [List test sets by intent group](https://docs.trymaitai.com/api-reference/test-sets/list-test-sets-by-intent-group.md): List test sets for an intent group.
- [List test sets by intent group name](https://docs.trymaitai.com/api-reference/test-sets/list-test-sets-by-intent-group-name.md): List test sets by intent group name.
- [List test sets created from dataset](https://docs.trymaitai.com/api-reference/test-sets/list-test-sets-created-from-dataset.md): List test sets created from a dataset.
- [Remove requests from test set](https://docs.trymaitai.com/api-reference/test-sets/remove-requests-from-test-set.md): Remove request/response pairs from a test set. Accepts either body shape: - `{"requests": [{"request_id": "..."}]}` (canonical) - `{"request_ids": ["...", "..."]}` (convenience — flat string array)
- [Remove single request from test set](https://docs.trymaitai.com/api-reference/test-sets/remove-single-request-from-test-set.md): Remove one request from a test set using the Portal payload shape.
- [Remove test set requests bulk](https://docs.trymaitai.com/api-reference/test-sets/remove-test-set-requests-bulk.md): Remove requests from a test set using the Portal bulk payload shape.
- [Search eligible test set requests](https://docs.trymaitai.com/api-reference/test-sets/search-eligible-test-set-requests.md): Search requests eligible for addition to a test set.
- [Update test set](https://docs.trymaitai.com/api-reference/test-sets/update-test-set.md): Update a test set's name, description, or metadata.
- [Update test set request response](https://docs.trymaitai.com/api-reference/test-sets/update-test-set-request-response.md): Update the expected response on one test-set request.
- [Update test set request tags](https://docs.trymaitai.com/api-reference/test-sets/update-test-set-request-tags.md): Update tags on one test-set request.
- [Check workflow transforms](https://docs.trymaitai.com/api-reference/workflows/check-workflow-transforms.md): Check if a workflow script defines transform_session.
- [Clear workflow default release](https://docs.trymaitai.com/api-reference/workflows/clear-workflow-default-release.md): Clear the workflow default release pointer.
- [Create workflow](https://docs.trymaitai.com/api-reference/workflows/create-workflow.md): Create a workflow and upload its script.
- [Create workflow chat completion](https://docs.trymaitai.com/api-reference/workflows/create-workflow-chat-completion.md): Execute a workflow using the chat-completions contract.
- [Create workflow release](https://docs.trymaitai.com/api-reference/workflows/create-workflow-release.md): Create a named workflow release pointer.
- [Delete workflow](https://docs.trymaitai.com/api-reference/workflows/delete-workflow.md): Soft-delete a workflow.
- [Delete workflow accessory](https://docs.trymaitai.com/api-reference/workflows/delete-workflow-accessory.md): Delete a workflow accessory file by key.
- [Delete workflow datastore](https://docs.trymaitai.com/api-reference/workflows/delete-workflow-datastore.md): Delete a workflow datastore schema.
- [Delete workflow release](https://docs.trymaitai.com/api-reference/workflows/delete-workflow-release.md): Delete a named workflow release pointer.
- [Get default workflow script](https://docs.trymaitai.com/api-reference/workflows/get-default-workflow-script.md): Fetch the default workflow script template.
- [Get workflow](https://docs.trymaitai.com/api-reference/workflows/get-workflow.md): Retrieve a workflow by ID.
- [Get workflow artifact files](https://docs.trymaitai.com/api-reference/workflows/get-workflow-artifact-files.md): List deployed workflow script and accessory artifacts.
- [Get workflow run](https://docs.trymaitai.com/api-reference/workflows/get-workflow-run.md): Fetch a single workflow run by session ID.
- [Get workflow schema](https://docs.trymaitai.com/api-reference/workflows/get-workflow-schema.md): Fetch workflow input schema and transform availability.
- [Get workflow script](https://docs.trymaitai.com/api-reference/workflows/get-workflow-script.md): Fetch a workflow script decomposed into code, schemas, and transform.
- [Get workflow transform info](https://docs.trymaitai.com/api-reference/workflows/get-workflow-transform-info.md): Fetch workflow transform_session availability.
- [Get workflow version artifact files](https://docs.trymaitai.com/api-reference/workflows/get-workflow-version-artifact-files.md): List artifact files frozen in a workflow version.
- [List workflow datastores](https://docs.trymaitai.com/api-reference/workflows/list-workflow-datastores.md): List workflow datastores that can provide data to executions.
- [List workflow releases](https://docs.trymaitai.com/api-reference/workflows/list-workflow-releases.md): List workflow release pointers.
- [List workflow runs](https://docs.trymaitai.com/api-reference/workflows/list-workflow-runs.md): List workflow runs by workflow_id or application_id.
- [List workflow versions](https://docs.trymaitai.com/api-reference/workflows/list-workflow-versions.md): List published workflow versions.
- [List workflows](https://docs.trymaitai.com/api-reference/workflows/list-workflows.md): List workflows available to your company.
- [Preview workflow transform](https://docs.trymaitai.com/api-reference/workflows/preview-workflow-transform.md): Dry-run transform_session for one session without persisting output.
- [Publish workflow version](https://docs.trymaitai.com/api-reference/workflows/publish-workflow-version.md): Publish a new immutable workflow version.
- [Update workflow](https://docs.trymaitai.com/api-reference/workflows/update-workflow.md): Update workflow metadata, script, schemas, or transform code.
- [Update workflow release](https://docs.trymaitai.com/api-reference/workflows/update-workflow-release.md): Update a named workflow release pointer.
- [Upload workflow accessory](https://docs.trymaitai.com/api-reference/workflows/upload-workflow-accessory.md): Upload or replace a workflow accessory file.
- [Upload workflow datastore](https://docs.trymaitai.com/api-reference/workflows/upload-workflow-datastore.md): Upload records or link an S3 URI for a workflow datastore.
- [Upsert workflow datastore](https://docs.trymaitai.com/api-reference/workflows/upsert-workflow-datastore.md): Create or update a workflow datastore schema.
- [Validate workflow script](https://docs.trymaitai.com/api-reference/workflows/validate-workflow-script.md): Validate workflow code, transform code, or schema snippets.
- [API Action](https://docs.trymaitai.com/build/agents/capabilities/api_action.md): Integrating external services into your agent workflows
- [LLM Action](https://docs.trymaitai.com/build/agents/capabilities/llm_action.md): Specialized sub-tasks with unique prompts and model configs
- [Subagent](https://docs.trymaitai.com/build/agents/capabilities/subagent.md): Recursive hierarchical delegation to specialized agents
- [Supplied Actions](https://docs.trymaitai.com/build/agents/capabilities/supplied_actions.md): Ready-made capabilities from the Maitai catalog you can add to any agent
- [Webhook](https://docs.trymaitai.com/build/agents/capabilities/webhook.md): Handling asynchronous callbacks and long-running tasks
- [Create Agent](https://docs.trymaitai.com/build/agents/create_agent.md): Defining the identity, context, and execution mode of your AI Agent
- [Compositions](https://docs.trymaitai.com/build/models/compositions.md): Creating dataset recipes for optimal fine-tuning
- [Dataset Creation](https://docs.trymaitai.com/build/models/dataset_creation.md): How to capture and generate data for fine-tuning
- [Dataset Preparation](https://docs.trymaitai.com/build/models/dataset_preparation.md): Reviewing, fixing, and augmenting your training data
- [Deployment](https://docs.trymaitai.com/build/models/deployment.md): Promoting fine-tuned models to production endpoints
- [Fine-tune Runs](https://docs.trymaitai.com/build/models/fine_tune_runs.md): Executing and monitoring managed training
- [Reasoning Augmentation](https://docs.trymaitai.com/build/models/reasoning_augmentation.md): Teach your model to think step-by-step with structured chain-of-thought augmentation
- [Validation](https://docs.trymaitai.com/build/models/validation.md): Reviewing automated results and checking for regressions
- [Data Generation](https://docs.trymaitai.com/build/scts/data_generation.md): Creating robust synthetic datasets for training and testing
- [Visualizer](https://docs.trymaitai.com/build/scts/visualizer.md): Mapping out potential conversation paths and logic
- [Commands](https://docs.trymaitai.com/cli-reference/commands.md): Full CLI command reference for resource commands and raw API.
- [CLI Reference](https://docs.trymaitai.com/cli-reference/overview.md): Command-line interface for the Maitai Platform Developer API.
- [API → Agent](https://docs.trymaitai.com/examples/api_to_agent.md): Turn an API into a structured Agent by importing endpoints as API Call actions, organizing them into domain subagents, and encoding the API docs as instructions.
- [Build an Agent](https://docs.trymaitai.com/examples/build_agent.md): Create a new Agent, add capabilities, and configure how it executes
- [Configuration](https://docs.trymaitai.com/examples/configuration.md): Common Portal configuration patterns (application / intent / intent group)
- [Debug a Request with Reruns + Evaluations](https://docs.trymaitai.com/examples/debug_request_reruns.md): Test variations of a single request (model/messages) and evaluate them with Sentinels
- [Fine-tune a Model](https://docs.trymaitai.com/examples/fine_tuning.md): End-to-end workflow: Dataset → Composition → Run → Validation
- [Import Data](https://docs.trymaitai.com/examples/import_data.md): Upload your data to the Portal to build custom models specific to your application
- [Quality Loop (Fault → Fix → Regression Test)](https://docs.trymaitai.com/examples/quality_loop.md): A repeatable Portal workflow to fix failures and prevent them from coming back
- [Sentinel Workflow](https://docs.trymaitai.com/examples/sentinel_workflow.md): How to create a Sentinel for an Intent Group and validate it against real traffic
- [Execute Test Runs](https://docs.trymaitai.com/examples/test_runs.md): Monitor model performance improvements with Test Runs
- [Create Test Sets](https://docs.trymaitai.com/examples/test_sets.md): Turn real requests into a regression suite you can rerun as you iterate
- [Authentication](https://docs.trymaitai.com/get_started/authentication.md): Authenticate using a Maitai API key (and optionally provider keys).
- [Base URL](https://docs.trymaitai.com/get_started/base_url.md): Integrate Maitai with your existing OpenAI SDK implementation by changing the base URL and adding a few headers.
- [Core Concepts](https://docs.trymaitai.com/get_started/core_concepts.md): The mental model: Company → Application → Intent, plus Sessions, Intent Groups, and quality tooling.
- [Introduction](https://docs.trymaitai.com/get_started/introduction.md): What Maitai is, and the fastest way to get value
- [Quickstart](https://docs.trymaitai.com/get_started/quickstart.md): Send your first request through Maitai and view it in the Portal.
- [Sessions](https://docs.trymaitai.com/observe/agent_sessions.md): Debug multi-turn behavior (including agent runs) via session timelines and task details.
- [Request Overview](https://docs.trymaitai.com/observe/request_overview.md): Inspect a single request, create reruns, and compare prompt/model changes.
- [Applications](https://docs.trymaitai.com/observe/resources/applications.md): How Applications are represented in the Portal (lists, detail pages, and tabs)
- [Intent Groups](https://docs.trymaitai.com/observe/resources/intent_groups.md): How Intent Groups work in the Portal (cross-application organization)
- [Intents](https://docs.trymaitai.com/observe/resources/intents.md): How Intents (ApplicationActions) work in the Portal
- [Agent Call](https://docs.trymaitai.com/sdk/agent_call.md): Send a request to an Agent you built in the Portal.
- [Model Request](https://docs.trymaitai.com/sdk/chat.md): Create chat completions with Maitai metadata (Application, Intent, Session).
- [Evaluate](https://docs.trymaitai.com/sdk/evaluate.md): Detect faults in LLM output
- [Logging (Bring Your Own Inference)](https://docs.trymaitai.com/sdk/indexing.md): Run inference with your own provider client, then send Maitai the raw request/response with maitai.log() for monitoring, debugging, and Test Sets — without routing inference through Maitai.
- [Reasoning](https://docs.trymaitai.com/sdk/reasoning.md): Use chain-of-thought and extended thinking with a single, provider-agnostic API.
- [Structured Output](https://docs.trymaitai.com/sdk/structured_output.md): Generate consistent JSON using JSON Schema (or Pydantic models in Python).
- [Tool Calling](https://docs.trymaitai.com/sdk/tool_calling.md): Define tools and let the model call them (OpenAI-style tool calling).
- [Speech to text](https://docs.trymaitai.com/sdk/transcription.md): Convert audio files to text using Maitai's speech-to-text API.
- [Evaluations](https://docs.trymaitai.com/test/evaluations/overview.md): How Maitai evaluates requests using Sentinels (one-off, batch runs, and global results)
- [Evaluating a Request](https://docs.trymaitai.com/test/evaluations/request_evaluations.md): Run one-off evaluations on a single request (and compare versions)
- [Evaluation Results](https://docs.trymaitai.com/test/evaluations/results.md): Filter and drill down into evaluation outcomes across your traffic
- [Evaluation Runs](https://docs.trymaitai.com/test/evaluations/runs.md): Run sentinels across a time range of real requests for an app + intent
- [Monitor Configuration](https://docs.trymaitai.com/test/monitors/configuration.md): Pick a runner type, write a resolution, and preview against a real sample
- [Monitors](https://docs.trymaitai.com/test/monitors/overview.md): Sample live production traffic, judge outputs against rules, and surface verdicts for review
- [Reviewing Monitor Results](https://docs.trymaitai.com/test/monitors/results.md): Track activity, drill into individual runs, and answer 'is this Monitor healthy?'
- [Monitor Targets](https://docs.trymaitai.com/test/monitors/targets.md): Attach a Monitor to one or more intents, workflows, or agents at a sample rate
- [Versions and Releases](https://docs.trymaitai.com/test/monitors/versions.md): Freeze a Monitor as an immutable snapshot and pin production to it
- [Sentinel Configuration](https://docs.trymaitai.com/test/sentinels/configuration.md): Edit directives, examples, severity, and include options
- [Generating Sentinels](https://docs.trymaitai.com/test/sentinels/generation.md): Create a new Sentinel from an Intent Group using expectation + condition
- [Monitoring with Sentinels](https://docs.trymaitai.com/test/sentinels/monitoring.md): Find faults, drill into requests, and track fault rate over time
- [Sentinels](https://docs.trymaitai.com/test/sentinels/overview.md): Intent-group-level watchers that evaluate model outputs
- [Regenerating Sentinels](https://docs.trymaitai.com/test/sentinels/regeneration.md): Iterate quickly: regenerate qualification/evaluation/correction logic with feedback
- [Test Set Creation](https://docs.trymaitai.com/test/test_sets/creation.md): How to create and manage Test Sets from real requests in the Portal
- [Test Run Execution](https://docs.trymaitai.com/test/test_sets/execution.md): Create and run Test Runs for a Test Set in the Portal
- [Regression Monitoring](https://docs.trymaitai.com/test/test_sets/regression.md): Use Test Runs and comparisons to detect regressions over time
- [Interpreting Results](https://docs.trymaitai.com/test/test_sets/results.md): Understand Test Run scores, distributions, and comparisons in the Portal
- [Scoring & Rubrics](https://docs.trymaitai.com/test/test_sets/rubrics.md): How Maitai scores Test Runs and how to interpret criteria breakdowns

## OpenAPI Specs

- [openapi](https://docs.trymaitai.com/openapi.yaml)