Skip to main content
ClaudeWave
Skill248 repo starsupdated today

mintlify-api

The mintlify-api skill enables programmatic interaction with Mintlify documentation sites through REST API calls authenticated with bearer tokens. Use it to trigger documentation rebuilds outside of Git events, retrieve site metadata such as deployment status and navigation structure, and create preview deployments for testing documentation changes before production release.

Install in Claude Code
Copy
git clone --depth 1 https://github.com/macro-inc/macro /tmp/mintlify-api && cp -r /tmp/mintlify-api/docs/.agents/skills/mintlify-api ~/.claude/skills/mintlify-api
Then start a new Claude Code session; the skill loads automatically.

SKILL.md

# 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)