Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.mutagent.io/llms.txt

Use this file to discover all available pages before exploring further.

API Reference

The MutagenT REST API provides programmatic access to all platform features. For the easiest integration, use the official SDKs (TypeScript or Python) which wrap this API with type safety.

Base URL

https://api.mutagent.io

Authentication

All API requests require authentication. MutagenT supports two authentication methods:
curl -H "x-api-key: your_api_key_here" \
  https://api.mutagent.io/api/prompt
API Key scoping determines which headers are required. Workspace-scoped keys require no additional headers. Organization-scoped keys require x-workspace-id. User-scoped keys require both x-workspace-id and x-organization-id. See API Keys for details.

Rate Limits

PlanRequests/minuteRequests/day
Free601,000
Pro30010,000
EnterpriseCustomCustom

Response Format

All responses are JSON:
{
  "data": { ... },
  "meta": {
    "requestId": "req_xxxx",
    "timestamp": "2024-01-01T00:00:00Z"
  }
}

Error Responses

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid prompt ID",
    "details": { ... }
  },
  "meta": {
    "requestId": "req_xxxx"
  }
}

Common Status Codes

CodeDescription
200Success
201Created
400Bad Request
401Unauthorized
403Forbidden
404Not Found
429Rate Limited
500Server Error

SDKs

We recommend using our official SDKs instead of direct API calls:

TypeScript SDK

Type-safe TypeScript/JavaScript SDK

Python SDK

Type-safe Python SDK — sync and async
For most use cases, use the TypeScript SDK or Python SDK instead of raw HTTP. The SDKs handle authentication, request/response typing, pagination, retries, and tracing automatically. Detailed per-endpoint reference documentation is coming soon.