From 1015a11a0360eb5cbeb99494451b1a1b43685dea Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Wed, 8 Jul 2026 00:41:55 +0000
Subject: [PATCH] docs: document API key expiration options

---
 api/introduction.mdx    | 2 ++
 es/api/introduction.mdx | 2 ++
 fr/api/introduction.mdx | 2 ++
 zh/api/introduction.mdx | 2 ++
 4 files changed, 8 insertions(+)

diff --git a/api/introduction.mdx b/api/introduction.mdx
index e27b578335..40b476fa13 100644
--- a/api/introduction.mdx
+++ b/api/introduction.mdx
@@ -47,6 +47,8 @@ Generate API keys on the [API keys page](https://app.mintlify.com/settings/organ
 
 You can create up to 10 API keys per hour per organization.
 
+When you create a key, you can set it to expire in 7, 30, 60, or 90 days, or select **No expiration**. New keys default to 90 days. The API keys page shows an **Expires in …** badge for keys that expire within 7 days and an **Expired** badge for keys that have already expired. Expired keys stop working, so rotate or replace them before the expiration date.
+
 Mintlify uses two types of API keys, each scoped to a different set of endpoints:
 
 | Key type        | Prefix      | Use for                                                                              |
diff --git a/es/api/introduction.mdx b/es/api/introduction.mdx
index f7339d44da..5c7fa53e73 100644
--- a/es/api/introduction.mdx
+++ b/es/api/introduction.mdx
@@ -60,6 +60,8 @@ Puedes generar API keys en la [página de API keys](https://dashboard.mintlify.c
 
 Puedes crear hasta 10 API keys por hora y por organización.
 
+Al crear una API key, puedes configurarla para que caduque en 7, 30, 60 o 90 días, o seleccionar **Sin caducidad**. Las nuevas API keys caducan en 90 días de forma predeterminada. La página de API keys muestra una insignia **Caduca en …** para las API keys que caducan en los próximos 7 días y una insignia **Caducada** para las que ya han caducado. Las API keys caducadas dejan de funcionar, por lo que debes rotarlas o reemplazarlas antes de la fecha de caducidad.
+
 <div id="admin-api-key">
   ### Clave de la API de administrador
 </div>
diff --git a/fr/api/introduction.mdx b/fr/api/introduction.mdx
index dce160103f..86053b285b 100644
--- a/fr/api/introduction.mdx
+++ b/fr/api/introduction.mdx
@@ -60,6 +60,8 @@ Générez des clés d'API depuis la [page API keys](https://dashboard.mintlify.c
 
 Vous pouvez créer jusqu'à 10 clés d'API par heure et par organisation.
 
+Lorsque vous créez une clé, vous pouvez la faire expirer dans 7, 30, 60 ou 90 jours, ou sélectionner **Aucune expiration**. Les nouvelles clés expirent par défaut dans 90 jours. La page API keys affiche un badge **Expire dans …** pour les clés qui expirent dans les 7 jours et un badge **Expirée** pour celles qui ont déjà expiré. Les clés expirées cessent de fonctionner. Faites-les tourner ou remplacez-les avant leur date d'expiration.
+
 <div id="admin-api-key">
   ### Clé d'API administrateur
 </div>
diff --git a/zh/api/introduction.mdx b/zh/api/introduction.mdx
index cc1bd34b3f..767a9164ae 100644
--- a/zh/api/introduction.mdx
+++ b/zh/api/introduction.mdx
@@ -60,6 +60,8 @@ https://api.mintlify.com
 
 每个组织每小时最多可创建 10 个 API key。
 
+创建 API key 时，你可以将其设置为在 7、30、60 或 90 天后过期，或选择**永不过期**。新的 API key 默认在 90 天后过期。API keys 页面会为将在 7 天内过期的 API key 显示**将在 … 后过期**徽章，为已过期的 API key 显示**已过期**徽章。已过期的 API key 将停止工作，请在过期日期之前轮换或更换它们。
+
 <div id="admin-api-key">
   ### 管理员 API key
 </div>