> ## Documentation Index > Fetch the complete documentation index at: https://docs.athenahq.ai/llms.txt > Use this file to discover all available pages before exploring further. # Lister les clés API > Répertorie les métadonnées des clés API de l’organisation de la clé authentifiée : créateur de chaque clé (ID, nom et e-mail actuels), date de création, périmètre et statut de révocation. Nécessite une clé API globale ; les clés limitées à certains sites reçoivent 403. Aucun ID d’organisation n’est accepté. Les secrets et empreintes ne sont jamais renvoyés. Les clés révoquées sont incluses pour détecter une clé créée et révoquée entre deux interrogations. Résultats classés par date de création croissante, puis ID croissant. Pour les alertes de nouvelles clés, enregistrez d’abord une référence des ID. À chaque interrogation, fixez `until` à l’heure actuelle moins une minute, faites chevaucher `since` avec la précédente fenêtre réussie et gardez les deux bornes fixes en incrémentant `page_num` jusqu’à ce que `pagination.has_more` soit false. Les deux bornes sont inclusives. Dédupliquez les alertes par ID et avancez la fenêtre enregistrée seulement après la réussite de toutes les pages. Filtrez `is_revoked` localement si seules les clés actives vous intéressent. Il s’agit d’un inventaire actuel, pas d’un journal d’audit durable ni d’un webhook : la suppression du compte d’un créateur retire ses clés et les suppressions simultanées peuvent décaler les pages. Les fenêtres chevauchantes réduisent les lacunes mais ne garantissent pas la détection de toutes les créations. L’outil MCP `list_api_keys` expose les mêmes champs et filtres aux clés API globales et aux connexions OAuth d’administrateurs d’organisation, sous réserve des autorisations MCP. ## OpenAPI ````yaml fr/api-reference/openapi.json get /api/v1/api-keys openapi: 3.1.0 info: title: API AthenaHQ description: >- L’API AthenaHQ permet de gérer vos sites et prompts par programme pour l’optimisation de contenu par IA. version: 1.0.0 contact: email: support@athenahq.ai servers: - url: https://api.athenahq.ai description: Serveur de production security: - apiKey: [] tags: - name: Basics description: Opérations API principales pour gérer sites et prompts - name: Metrics description: Points de terminaison de métriques et analyses de visibilité IA - name: Billing description: Points de facturation et crédits pour gérer la consommation - name: Team Management description: Points de terminaison de gestion des membres et invitations - name: Groups description: Points de terminaison de gestion des groupes de sites - name: Content description: >- Points de terminaison Content Hub : onglets, URL suivies et détail des prompts par URL. - name: Pitch Workspace description: >- Points de terminaison des rapports Pitch Workspace : exécutions à l’échelle de l’organisation avec concurrents, prompts, attributs et métriques agrégées. - name: Knowledge Base description: >- Endpoints de lecture de la base de connaissances de la marque — faits approuvés et piliers qui les organisent. paths: /api/v1/api-keys: get: tags: - Basics summary: Lister les clés API description: >- Répertorie les métadonnées des clés API de l’organisation de la clé authentifiée : créateur de chaque clé (ID, nom et e-mail actuels), date de création, périmètre et statut de révocation. Nécessite une clé API globale ; les clés limitées à certains sites reçoivent 403. Aucun ID d’organisation n’est accepté. Les secrets et empreintes ne sont jamais renvoyés. Les clés révoquées sont incluses pour détecter une clé créée et révoquée entre deux interrogations. Résultats classés par date de création croissante, puis ID croissant. Pour les alertes de nouvelles clés, enregistrez d’abord une référence des ID. À chaque interrogation, fixez `until` à l’heure actuelle moins une minute, faites chevaucher `since` avec la précédente fenêtre réussie et gardez les deux bornes fixes en incrémentant `page_num` jusqu’à ce que `pagination.has_more` soit false. Les deux bornes sont inclusives. Dédupliquez les alertes par ID et avancez la fenêtre enregistrée seulement après la réussite de toutes les pages. Filtrez `is_revoked` localement si seules les clés actives vous intéressent. Il s’agit d’un inventaire actuel, pas d’un journal d’audit durable ni d’un webhook : la suppression du compte d’un créateur retire ses clés et les suppressions simultanées peuvent décaler les pages. Les fenêtres chevauchantes réduisent les lacunes mais ne garantissent pas la détection de toutes les créations. L’outil MCP `list_api_keys` expose les mêmes champs et filtres aux clés API globales et aux connexions OAuth d’administrateurs d’organisation, sous réserve des autorisations MCP. operationId: listApiKeys parameters: - name: since in: query required: false description: Inclure les clés créées à cet horodatage ISO 8601 ou après. schema: type: string format: date-time - name: until in: query required: false description: >- Inclut les clés créées au plus tard à cet horodatage ISO 8601. Gardez-le fixe pendant la pagination. schema: type: string format: date-time - name: page_num in: query required: false description: Numéro de page à partir de zéro. schema: type: integer minimum: 0 default: 0 - name: page_size in: query required: false description: Clés par page, jusqu’à 100. schema: type: integer minimum: 1 maximum: 100 default: 100 responses: '200': description: Métadonnées de clé API, clés révoquées incluses. content: application/json: schema: type: object required: - api_keys - pagination properties: api_keys: type: array items: type: object required: - id - name - key_prefix - created_at - created_by - is_global - website_ids - is_revoked properties: id: type: string format: uuid name: type: string key_prefix: type: string description: >- Préfixe d’identification non secret. Secrets et empreintes ne sont jamais renvoyés. created_at: type: string format: date-time created_by: type: object required: - id - name - email properties: id: type: string format: uuid name: type: string nullable: true email: type: string is_global: type: boolean website_ids: type: array items: type: string format: uuid description: >- ID des sites web autorisés pour une clé à périmètre limité ; vide pour une clé globale. is_revoked: type: boolean description: Indique si la clé est révoquée. pagination: type: object required: - page_num - page_size - has_more properties: page_num: type: integer page_size: type: integer has_more: type: boolean '400': description: Paramètres de requête invalides ou since postérieur à until. content: application/json: schema: type: object properties: error: type: string required: - error '401': description: Clé API absente ou invalide. content: application/json: schema: type: object properties: error: type: string required: - error '403': description: Une clé API globale est requise. content: application/json: schema: type: object properties: error: type: string required: - error security: - apiKey: [] components: securitySchemes: apiKey: type: apiKey in: header name: x-api-key description: >- Clé API d’authentification. Créez-en une [ici](https://app.athenahq.ai/organization?tab=api). ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.