---
title: "Mintlify integration for LuumenAI"
url: "https://www.luumen.ai/integrations/mintlify/"
entity: SoftwareIntegration
category: "Source control & CI/CD"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# Mintlify integration for LuumenAI

Read docs analytics and feedback, then ship doc fixes as approved deployments

## What LuumenAI can do with Mintlify

LuumenAI connects to Mintlify with an API token and exposes 14 tools (9 read-only · 5 write). Reads answer immediately; writes are shown as a plan and require approval by default, configurable per tool by an administrator.

## Key facts

- Authentication: API token
- Tools available: 14 tools (9 read-only · 5 write)
- Plan: available on all plans
- Category: Source control & CI/CD

## About Mintlify with LuumenAI

Connect Mintlify and Luumen can read your docs telemetry directly: page views split by human and AI traffic, search terms and their click-through, per-page feedback, and full assistant conversation history. When the data points at a page that needs work, Luumen can start a docs agent job, trigger a preview for a branch, or queue a production update — each as a previewed, approved step. Authentication is by API key.

## Example tools

Read-only (9 in total):

- `MINTLIFY_GET_AGENT_JOB` — Retrieve the status and details (status, PR link, model, source repo/ref) of a docs agent job.
- `MINTLIFY_GET_ASSISTANT_CALLER_STATS` — Get assistant query counts broken down by caller type (web, api, other, total) for a date range.
- `MINTLIFY_GET_ASSISTANT_CONVERSATIONS` — Export the AI assistant conversation history (question, answer, cited sources, resolution status) for a Mintlify project, optionally filtered by date.
- `MINTLIFY_GET_FEEDBACK` — Export a project's user feedback (thumbs / contextual comments / agent feedback), optionally filtered by date, source and status.
- `MINTLIFY_GET_FEEDBACK_BY_PAGE` — Get feedback counts (thumbs up/down, code, total) aggregated per documentation page path for a date range.
- `MINTLIFY_GET_PAGE_VIEWS` — Export per-path and site-wide content view counts split by human vs AI traffic.
- `MINTLIFY_GET_SEARCH_QUERIES` — Export documentation search terms ordered by hit count (with CTR and top clicked page).
- `MINTLIFY_GET_UNIQUE_VISITORS` — Export per-path and site-wide approximate distinct visitor counts split by human vs AI traffic.

Write and destructive (5 in total, approval required by default):

- `MINTLIFY_CREATE_AGENT_JOB` — Start a background documentation agent job from a natural-language prompt.
- `MINTLIFY_SEND_AGENT_MESSAGE` — Send a follow-up instruction to an existing, in-progress docs agent job (asynchronous).
- `MINTLIFY_TRIGGER_AUTOMATION` — Trigger a custom-schedule automation (workflow) to run immediately.
- `MINTLIFY_TRIGGER_PREVIEW` — Create or update a preview deployment of the docs project for a Git branch (redeploys if a preview already exists for that branch).
- `MINTLIFY_TRIGGER_UPDATE` — Queue a production deployment of the docs project from its configured branch.

## Frequently asked questions

### How does LuumenAI connect to Mintlify?

Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.

### Can LuumenAI change things in Mintlify on its own?

Read actions answer immediately. Anything that writes is shown as a plan and requires approval by default. Administrators configure that per tool.

### Is there an audit trail?

Every call to Mintlify — read or write, approved or declined — is recorded with the actor, the input, and the result.

Full page: https://www.luumen.ai/integrations/mintlify/