Mintlify
DEVELOPER · DEVELOPER
Documentation deployments, previews, static exports, automations, and agent jobs on their own key.
Acts as the person, not as itself
Each user connects their own account. Every call carries both identities — the agent and the person it is acting for — so the agent can never reach past what that individual can already do.
Credentials never touch the agent
Tokens live in the vault and attach server-side at call time. The agent holds a session, not a secret, and revoking access does not mean rotating a key.
Every call on the record
Who asked, which agent acted, which action ran, and the verdict that let it through — one audit trail across every integration, not one per vendor.
What an agent can do
Each action is granted on its own. An agent allowed to read is not thereby allowed to write, and the scope beside each row is what the acting user must have connected for it to run at all.
mintlify_get_project_update_status_by_statusidREADGet a deployment update status via GET https://api.mintlify.com/v1/project/update-status/{statusId}. Needs the Mintlify ADMIN API KEY (https://app.mintlify.com/settings/organization/api-keys).
mintlify_get_static_export_by_projectid_jobs_by_jobidREADGet a static export job via GET https://api.mintlify.com/v1/static-export/{projectId}/jobs/{jobId}. Needs the Mintlify ADMIN API KEY (https://app.mintlify.com/settings/organization/api-keys).
mintlify_get_v1_analytics_by_projectid_assistantREADList assistant conversations via GET https://api.mintlify.com/v1/analytics/{projectId}/assistant. Needs the Mintlify ADMIN API KEY (https://app.mintlify.com/settings/organization/api-keys).
mintlify_get_v1_analytics_by_projectid_assistant_caller_statsREADGet assistant caller statistics via GET https://api.mintlify.com/v1/analytics/{projectId}/assistant/caller-stats. Needs the Mintlify ADMIN API KEY (https://app.mintlify.com/settings/organization/api-keys).
mintlify_get_v1_analytics_by_projectid_assistant_threads_by_threadidREADGet an assistant conversation thread via GET https://api.mintlify.com/v1/analytics/{projectId}/assistant/threads/{threadId}. Needs the Mintlify ADMIN API KEY (https://app.mintlify.com/settings/organization/api-keys).
mintlify_get_v1_analytics_by_projectid_feedbackREADList feedback entries via GET https://api.mintlify.com/v1/analytics/{projectId}/feedback. Needs the Mintlify ADMIN API KEY (https://app.mintlify.com/settings/organization/api-keys).
mintlify_get_v1_analytics_by_projectid_feedback_by_pageREADGet feedback totals by page via GET https://api.mintlify.com/v1/analytics/{projectId}/feedback/by-page. Needs the Mintlify ADMIN API KEY (https://app.mintlify.com/settings/organization/api-keys).
mintlify_get_v1_analytics_by_projectid_searchesREADList search queries via GET https://api.mintlify.com/v1/analytics/{projectId}/searches. Needs the Mintlify ADMIN API KEY (https://app.mintlify.com/settings/organization/api-keys).
mintlify_get_v1_analytics_by_projectid_viewsREADGet page view counts via GET https://api.mintlify.com/v1/analytics/{projectId}/views. Needs the Mintlify ADMIN API KEY (https://app.mintlify.com/settings/organization/api-keys).
mintlify_get_v1_analytics_by_projectid_visitorsREADGet visitor counts via GET https://api.mintlify.com/v1/analytics/{projectId}/visitors. Needs the Mintlify ADMIN API KEY (https://app.mintlify.com/settings/organization/api-keys).
mintlify_get_v2_agent_by_projectid_job_by_idREADGet an agent job via GET https://api.mintlify.com/v2/agent/{projectId}/job/{id}. Needs the Mintlify ADMIN API KEY (https://app.mintlify.com/settings/organization/api-keys).
mintlify_post_project_preview_by_projectidWRITECreate a preview deployment via POST https://api.mintlify.com/v1/project/preview/{projectId}. Needs the Mintlify ADMIN API KEY (https://app.mintlify.com/settings/organization/api-keys). Deploys the named Git branch to a preview URL. Answers 202 with a previewUrl and a statusId; poll the statusId with the update-status tool.
mintlify_post_project_update_by_projectidWRITETrigger a documentation update via POST https://api.mintlify.com/v1/project/update/{projectId}. Needs the Mintlify ADMIN API KEY (https://app.mintlify.com/settings/organization/api-keys). PUBLISHES: this triggers a real documentation update for the project, which changes what visitors see. It answers 202 with a statusId; poll it with the update-status tool.
mintlify_post_static_export_by_projectid_jobsWRITEStart a static export job via POST https://api.mintlify.com/v1/static-export/{projectId}/jobs. Needs the Mintlify ADMIN API KEY (https://app.mintlify.com/settings/organization/api-keys). Answers 409 when an export for this project is already running and 429 when the export rate limit is reached -- both are provider limits, not call errors.
mintlify_post_v1_contentsWRITEGet Mintlify Index result contents via POST https://leaves.mintlify.com/api/universal-search/v1/contents. Needs the MINTLIFY INDEX API KEY (https://app.mintlify.com/settings/organization/api-keys). Supply at least one of `ids` or `urls` in the body, up to 20 items in total; the schema states the rule as an anyOf and Mintlify answers 400 when neither is present. `ids` are values returned by the Index search tool.
mintlify_post_v1_contextWRITEBuild Mintlify Index context via POST https://leaves.mintlify.com/api/universal-search/v1/context. Needs the MINTLIFY INDEX API KEY (https://app.mintlify.com/settings/organization/api-keys).
mintlify_post_v1_page_by_domainWRITEGet documentation page content via POST https://api.mintlify.com/discovery/v1/page/{domain}. Needs the Mintlify ASSISTANT API KEY (https://app.mintlify.com/settings/organization/api-keys). `path` is the value the search tool returns for a result, not a URL. On a deployment using `auth` or `userAuth`, pass the caller's authorized `groups` or only public pages are returned.
mintlify_post_v1_searchWRITESearch the Mintlify Index via POST https://leaves.mintlify.com/api/universal-search/v1/search. Needs the MINTLIFY INDEX API KEY (https://app.mintlify.com/settings/organization/api-keys).
mintlify_post_v1_search_by_domainWRITESearch documentation via POST https://api.mintlify.com/discovery/v1/search/{domain}. Needs the Mintlify ASSISTANT API KEY (https://app.mintlify.com/settings/organization/api-keys). Searches ONE documentation deployment, named by the `domain` path argument. For search across the whole Mintlify Index use the Index search tool, which needs the Index API key instead.
mintlify_post_v2_agent_by_projectid_jobWRITECreate an agent job via POST https://api.mintlify.com/v2/agent/{projectId}/job. Needs the Mintlify ADMIN API KEY (https://app.mintlify.com/settings/organization/api-keys). Starts an agent job that acts on the project's documentation. Answers 201 with a job id; read it back with the get-agent-job tool. Mintlify answers 429 when the project's agent concurrency is exhausted.
mintlify_post_v2_agent_by_projectid_job_by_id_messageWRITESend a follow-up message to an agent job via POST https://api.mintlify.com/v2/agent/{projectId}/job/{id}/message. Needs the Mintlify ADMIN API KEY (https://app.mintlify.com/settings/organization/api-keys).
mintlify_post_v2_assistant_by_domain_messageWRITESend an assistant message via POST https://api.mintlify.com/discovery/v2/assistant/{domain}/message. Needs the Mintlify ASSISTANT API KEY (https://app.mintlify.com/settings/organization/api-keys).
mintlify_post_v2_workflow_by_projectid_by_workflowschemaid_webhookWRITETrigger an automation webhook via POST https://api.mintlify.com/v2/workflow/{projectId}/{workflowSchemaId}/webhook. Needs the Mintlify ADMIN API KEY (https://app.mintlify.com/settings/organization/api-keys). Answers 402 when the organization's plan does not include automations and 503 when the automation runner is unavailable -- both are provider conditions rather than a bad request.
mintlify_post_workflow_by_projectid_by_workflowschemaid_triggerWRITETrigger an automation via POST https://api.mintlify.com/v1/workflow/{projectId}/{workflowSchemaId}/trigger. Needs the Mintlify ADMIN API KEY (https://app.mintlify.com/settings/organization/api-keys).
Often connected alongside
Put Mintlify behind one governed endpoint.
Same permissions, same audit trail, whatever else you connect next.