Merge branch 'sync/github-main-2026-09-11' into 'main'

Reconcile diverged mirror: merge GitHub main into GitLab main

See merge request deepl-org/deepl/clapi-track/api-docs-mirror!256

Author: Lucas Mathis

.mintignore

@@ -1,3 +1 @@
 reviews/*
-api-reference/openapi.json
-api-reference/voice/voice.asyncapi.json

_assets/images/download-csv-usage-report.png

@@ -1,6 +1,7 @@
 ---
 openapi: get /v2/admin/analytics/custom-tags
 title: "Get custom tag usage analytics"
+description: "Retrieve DeepL API usage broken down by custom tag for a date range, optionally aggregated by day, with paginated results."
 ---
 
 ## Date range

_assets/images/group-by-day-option.png

@@ -1,6 +1,7 @@
 ---
 openapi: get /v2/admin/analytics
 title: "Get usage analytics"
+description: "Retrieve organization-wide DeepL API usage for a date range, optionally grouped by API key or by API key and day."
 ---
 
 ## Date range

api-reference/admin-api/get-custom-tag-usage-analytics.mdx

@@ -1,4 +1,5 @@
 ---
 openapi: post /v2/admin/developer-keys
 title: "Create a developer key"
+description: "Create a new DeepL API key for your organization as an admin, using the Admin API."
 ---

api-reference/admin-api/get-usage-analytics.mdx

@@ -1,4 +1,5 @@
 ---
 openapi: put /v2/admin/developer-keys/deactivate
 title: "Deactivate a developer key"
+description: "Deactivate a DeepL API key as an admin so it can no longer be used to authenticate requests."
 ---

api-reference/admin-api/managing-developer-keys/create-key.mdx

@@ -1,4 +1,5 @@
 ---
 openapi: get /v2/admin/developer-keys
 title: "Get developer keys"
+description: "List every DeepL API key in your organization as an admin, including each key's label and usage limits."
 ---

api-reference/admin-api/managing-developer-keys/deactivate-key.mdx

@@ -1,4 +1,5 @@
 ---
 openapi: put /v2/admin/developer-keys/label
 title: "Rename a developer key"
+description: "Change the label on an existing DeepL API key as an admin, using the Admin API."
 ---

api-reference/admin-api/managing-developer-keys/get-keys.mdx

@@ -1,4 +1,5 @@
 ---
 openapi: put /v2/admin/developer-keys/limits
 title: "Set developer key limits"
+description: "Set or update the usage limit on an individual DeepL API key as an admin."
 ---