mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
Brandon Waselnuk
658b0e7a44
* nit - said chat instead of assistant * update API intro --------- Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
39 lines
1.8 KiB
Plaintext
39 lines
1.8 KiB
Plaintext
---
|
|
title: "Introduction"
|
|
description: "Trigger updates, embed AI assistant, and more"
|
|
icon: "book-open"
|
|
---
|
|
|
|
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.
|
|
- [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.
|
|
|
|
## Authentication
|
|
|
|
You can generate an API key through [the dashboard](https://dashboard.mintlify.com/settings/organization/api-keys). API keys are associated with an entire organization and can be used across multiple deployments.
|
|
|
|
### Admin API key
|
|
|
|
The admin API key is used for the [Trigger update](/api-reference/update/trigger) and [Get update status](/api-reference/update/status) endpoints.
|
|
|
|
Admin API keys begin with the `mint_` prefix. Keep your admin API keys secret.
|
|
|
|
### Assistant API key
|
|
|
|
The assistant API key is used for the [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 server-side token that should be kept secret.
|
|
|
|
The assistant API **token** is a public token that can be referenced in your frontend code.
|
|
|
|
<Note>
|
|
Calls using the assistant API token can incur costs: either using your AI assistant credits or incurring overages.
|
|
</Note>
|