Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.getmaito.com/llms.txt

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

​
API Overview

The Maito REST API exposes the same core product model used by the app, CLI, SDK, background worker, and MCP server.

​
Base URL

https://api.getmaito.com/v1
All documented REST endpoints are versioned under /v1.

​
What The API Covers

  • Account sets and default publishing accounts
  • Documents and document context retrieval
  • Draft creation, revision, scheduling, publishing, and draft chat state
  • Social destinations and OAuth handoff
  • Publishing queue items
  • Newsletter settings, domains, subscribers, segments, issues, sends, and analytics
  • Public newsletter subscription and unsubscribe flows
  • Public utility tools
  • Supporting product routes exposed by the SDK or CLI

​
What Is Intentionally Omitted

Provider webhooks, Clerk webhooks, internal newsletter runtime routes, and browser-only social callback shells are not documented as public developer API. They exist for deployed infrastructure and should not be treated as integration contracts.

​
Surfaces

SurfaceURLPurpose
REST APIhttps://api.getmaito.com/v1HTTP API for app, SDK, CLI, and external automation.
MCPhttps://mcp.getmaito.com/mcpRemote MCP endpoint for assistant clients.
SDKpackages/sdkTyped TypeScript client around the REST API.
CLIpackages/cliCommand-line client using the REST API.

​
Example Request

curl -X GET "https://api.getmaito.com/v1/drafts" \
  -H "Authorization: Bearer $MAITO_API_KEY" \
  -H "Accept: application/json"

​
Versioning

The public path prefix is /v1. Breaking changes should be made behind a new versioned prefix or introduced through backward-compatible contract expansion.