mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
Ethan Palm
428d38fb9e
* add explanation of plausible server * add info on aligning table columns * clarify API keys * add example API use cases * update link to API auth * remove passive voice
51 lines
3.1 KiB
Plaintext
51 lines
3.1 KiB
Plaintext
---
|
|
title: "Introduction"
|
|
description: "Trigger updates, embed AI assistant, and more"
|
|
keywords: ["REST API", "endpoints", "API keys"]
|
|
---
|
|
|
|
The Mintlify REST API enables you to programmatically interact with your documentation, trigger updates, and embed AI-powered chat experiences.
|
|
|
|
## Endpoints
|
|
|
|
- [Trigger update](/api-reference/update/trigger): Trigger an update of your site when desired.
|
|
- [Get update status](/api-reference/update/status): Get the status of an update and other details about your docs.
|
|
- [Create agent job](/api-reference/agent/create-agent-job): Create an agent job to automatically edit your documentation.
|
|
- [Get agent job](/api-reference/agent/get-agent-job): Retrieve the details and status of a specific agent job.
|
|
- [Get all agent jobs](/api-reference/agent/get-all-jobs): Retrieve all agent jobs for a domain.
|
|
- [Generate assistant message](/api-reference/assistant/create-assistant-message): Embed the assistant, trained on your docs, into any application of your choosing.
|
|
- [Search documentation](/api-reference/assistant/search): Search through your documentation.
|
|
|
|
### Common use cases
|
|
|
|
- **Automated deployments**: Trigger site updates at set intervals or when events occur with [Trigger update](/api-reference/update/trigger) and [Get update status](/api-reference/update/status).
|
|
- **CI/CD integration**: Update documentation as part of your deployment pipeline when code changes with [Trigger update](/api-reference/update/trigger).
|
|
- **Custom integrations**: Embed the AI assistant into your product, support portal, or internal tools with [Generate assistant message](/api-reference/assistant/create-assistant-message) and [Search documentation](/api-reference/assistant/search).
|
|
- **Automated editing**: Use agent jobs to programmatically update documentation at scale with [Create agent job](/api-reference/agent/create-agent-job), [Get agent job](/api-reference/agent/get-agent-job), and [Get all agent jobs](/api-reference/agent/get-all-jobs).
|
|
|
|
## Authentication
|
|
|
|
Generate API keys on the [API keys page](https://dashboard.mintlify.com/settings/organization/api-keys) in your dashboard. Each API key belongs to an organization--you can use keys across multiple deployments within the same organization.
|
|
|
|
You can create up to 10 API keys per hour per organization.
|
|
|
|
### Admin API key
|
|
|
|
Use the admin API key to authenticate requests to [Trigger update](/api-reference/update/trigger), [Get update status](/api-reference/update/status), and all agent endpoints.
|
|
|
|
Admin API keys begin with the `mint_` prefix. Keep your admin API keys secret.
|
|
|
|
The admin API key is a server-side token. Keep it secret.
|
|
|
|
### Assistant API key
|
|
|
|
Use the assistant API key to authenticate requests to [Generate assistant message](/api-reference/assistant/create-assistant-message) and [Search documentation](/api-reference/assistant/search) endpoints.
|
|
|
|
Assistant API keys begin with the `mint_dsc_` prefix.
|
|
|
|
The assistant API key is a public token that you can reference in frontend code.
|
|
|
|
<Note>
|
|
Calls using the assistant API token can incur costs: either using your assistant credits or incurring overages.
|
|
</Note>
|