Mintlify Index REST API

Use the Mintlify Index Representational State Transfer (REST) API to retrieve technical knowledge for applications and agents. The API supports three retrieval patterns:

• context assembles source-cited content within a token budget.
• search returns ranked documentation and web results.
• contents retrieves content for selected Mintlify result IDs or result URLs.

Base URL

Send REST API requests to:

https://leaves.mintlify.com/api/universal-search/v1

Append an endpoint path to this base URL, for example /context, /search, or /contents.

Authentication

Authenticate each request with an Index API key in the Authorization header:

Authorization: Bearer mint_us_...

Index API keys begin with mint_us_.

export MINTLIFY_INDEX_API_KEY="mint_us_..."

curl -X POST "https://leaves.mintlify.com/api/universal-search/v1/context" \
  -H "Authorization: Bearer $MINTLIFY_INDEX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "How should I configure caching in Next.js 16?",
    "product": "Next.js",
    "format": "txt",
    "tokenBudget": 3000
  }'

Rate limits

REST API limits apply per Mintlify organization. All API keys in an organization share the same limit:

Requests exceeding either limit return 429 Too Many Requests. Use exponential backoff before retrying.

Errors