---
name: mintlify-api
description: Interact with the Mintlify REST API to manage deployments, trigger builds, and query documentation site metadata programmatically.
license: MIT
compatibility: Any HTTP client. Authentication via API key.
metadata:
  author: mintlify
  version: "1.0"
title: mintlify-api
canonical_url: https://skilld.dev/gh/macro-inc/macro/mintlify-api
last_updated: 2026-09-27T07:38:55.000Z
---

> **Skill from skilld.dev.** Follow the instructions below for this session. You do not need to install anything.
>
> If the user asked to install this Skill, run `npx skilld install macro-inc/macro/mintlify-api`. Install writes the Skill files into the project, so every session loads them.

# Mintlify API

Use the Mintlify API to manage documentation sites programmatically. This skill covers deployment management, build triggers, and site metadata queries.

## Authentication

All API requests require an API key passed in the `Authorization` header:

```
Authorization: Bearer <your-api-key>
```

Generate API keys from the [Mintlify dashboard](https://dashboard.mintlify.com) under Settings > API Keys.

## Core capabilities

### Trigger deployments

Programmatically trigger a documentation rebuild when your codebase changes outside of Git push events.

### Query site metadata

Retrieve information about your documentation site including deployment status, configured domains, and navigation structure.

### Manage preview deployments

Create and manage preview deployments for pull requests and branches to review documentation changes before they go live.

## Resources

- [API reference](https://mintlify.com/docs/api)
- [Dashboard](https://dashboard.mintlify.com)
- [Deployment guide](https://mintlify.com/docs/deploy)