> ## 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.

# Listar claves de API

> Lista metadatos de claves de API de la organización de la clave autenticada, con creador (ID, nombre y correo actuales), fecha de creación, alcance y revocación. Requiere una clave global; las limitadas a sitios reciben 403. No acepta ID de organización. Nunca devuelve secretos ni hashes. Incluye revocadas para detectar claves creadas y revocadas entre consultas. Ordena por creación ascendente y después por ID ascendente.

Para alertas de claves nuevas, registra primero los ID de referencia. En cada consulta fija `until` al momento actual menos un minuto, solapa `since` con la ventana correcta anterior y mantén ambos límites mientras aumentas `page_num` hasta `pagination.has_more` false. Ambos límites son inclusivos. Deduplica alertas por ID y avanza la ventana solo tras completar todas las páginas. Filtra `is_revoked` localmente si solo necesitas activas.

Es un inventario actual, no un registro de auditoría duradero ni webhook: eliminar la cuenta del creador elimina sus claves y las eliminaciones simultáneas pueden desplazar páginas. Solapar ventanas reduce huecos, pero no garantiza detectar toda creación. La herramienta MCP `list_api_keys` expone los mismos campos y filtros para claves globales y conexiones OAuth de administradores de organización, según permisos MCP.



## OpenAPI

````yaml es/api-reference/openapi.json get /api/v1/api-keys
openapi: 3.1.0
info:
  title: API de AthenaHQ
  description: >-
    La API de AthenaHQ ofrece acceso programático para gestionar tus sitios web
    y consultas para optimizar el contenido con IA.
  version: 1.0.0
  contact:
    email: support@athenahq.ai
servers:
  - url: https://api.athenahq.ai
    description: Servidor de producción
security:
  - apiKey: []
tags:
  - name: Basics
    description: Operaciones principales de la API para gestionar sitios web y consultas
  - name: Metrics
    description: Endpoints de métricas y análisis para monitorizar la visibilidad en IA
  - name: Billing
    description: Endpoints de facturación y créditos para gestionar el uso
  - name: Team Management
    description: Endpoints para gestionar miembros del equipo e invitaciones
  - name: Groups
    description: Endpoints para gestionar grupos de sitios web
  - name: Content
    description: >-
      Endpoints para acceder a los datos del centro de contenidos: pestañas, URL
      monitorizadas y desglose de consultas por URL.
  - name: Pitch Workspace
    description: >-
      Endpoints para acceder a los informes del espacio de propuestas:
      ejecuciones de propuestas con alcance de organización, con competidores,
      consultas, atributos y métricas agregadas.
  - name: Knowledge Base
    description: >-
      Endpoints para leer la base de conocimientos de la marca: datos aprobados
      sobre la marca y los pilares que los organizan.
paths:
  /api/v1/api-keys:
    get:
      tags:
        - Basics
      summary: Listar claves de API
      description: >-
        Lista metadatos de claves de API de la organización de la clave
        autenticada, con creador (ID, nombre y correo actuales), fecha de
        creación, alcance y revocación. Requiere una clave global; las limitadas
        a sitios reciben 403. No acepta ID de organización. Nunca devuelve
        secretos ni hashes. Incluye revocadas para detectar claves creadas y
        revocadas entre consultas. Ordena por creación ascendente y después por
        ID ascendente.


        Para alertas de claves nuevas, registra primero los ID de referencia. En
        cada consulta fija `until` al momento actual menos un minuto, solapa
        `since` con la ventana correcta anterior y mantén ambos límites mientras
        aumentas `page_num` hasta `pagination.has_more` false. Ambos límites son
        inclusivos. Deduplica alertas por ID y avanza la ventana solo tras
        completar todas las páginas. Filtra `is_revoked` localmente si solo
        necesitas activas.


        Es un inventario actual, no un registro de auditoría duradero ni
        webhook: eliminar la cuenta del creador elimina sus claves y las
        eliminaciones simultáneas pueden desplazar páginas. Solapar ventanas
        reduce huecos, pero no garantiza detectar toda creación. La herramienta
        MCP `list_api_keys` expone los mismos campos y filtros para claves
        globales y conexiones OAuth de administradores de organización, según
        permisos MCP.
      operationId: listApiKeys
      parameters:
        - name: since
          in: query
          required: false
          description: Incluye claves creadas en esta marca de tiempo ISO 8601 o después.
          schema:
            type: string
            format: date-time
        - name: until
          in: query
          required: false
          description: >-
            Incluye claves creadas en esta marca de tiempo ISO 8601 o antes.
            Mantén el valor fijo al paginar.
          schema:
            type: string
            format: date-time
        - name: page_num
          in: query
          required: false
          description: Número de página, empezando en cero.
          schema:
            type: integer
            minimum: 0
            default: 0
        - name: page_size
          in: query
          required: false
          description: Número de claves por página, hasta 100.
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 100
      responses:
        '200':
          description: Metadatos de claves de API, incluidas las revocadas.
          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: >-
                            Prefijo identificativo no secreto. Nunca se
                            devuelven secretos ni hashes.
                        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 de sitios web permitidos para una clave de
                            alcance limitado; vacío para una clave global.
                        is_revoked:
                          type: boolean
                          description: Indica si se ha revocado la clave.
                  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: Parámetros de consulta no válidos o since posterior a until.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
        '401':
          description: Falta la clave de API o no es válida.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
        '403':
          description: Se requiere una clave de API global.
          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: >-
        Clave de API para autenticarse. Puedes crear una
        [aquí](https://app.athenahq.ai/organization?tab=api).

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.