> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wekall.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar agentes del workspace

> Retorna la lista paginada de agentes IA de voz configurados en el workspace.



## OpenAPI

````yaml /openapi.json get /api/v1/vicky/agents
openapi: 3.0.0
info:
  title: WeKall API
  description: >-
    API de WeKall para integraciones externas y automatizacion.


    Conecta tus sistemas con la plataforma WeKall para gestionar agentes de voz
    IA, llamadas, campanas, mensajeria WhatsApp y mas.


    ## Autenticacion


    Usa el endpoint `POST /api/v1/auth/token` con tus credenciales (`client_id`
    + `client_secret`) para obtener un access token. Incluye el token en el
    header `Authorization: Bearer {token}` de cada request.


    ## Productos disponibles


    - **Vicky AI** -- Agentes de voz IA, llamadas, campanas, grabaciones,
    reportes, billing

    - **Messenger Hub** -- WhatsApp, broadcast transaccional, chats, contactos

    - **Notes AI** -- Transcripcion y resumen

    - **Contact Center** -- Gestion de agentes humanos (proximamente)

    - **Business Phone** -- Telefonia cloud PBX (proximamente)


    ## Rate limiting


    100 requests/minuto por IP. El endpoint de autenticacion tiene un limite de
    10 requests/minuto.
  version: '1.0'
  contact: {}
servers:
  - url: https://apis.wekall.co
    description: Produccion
  - url: http://localhost:4001
    description: Local (desarrollo)
security: []
tags:
  - name: Auth
    description: Autenticacion y generacion de tokens
  - name: Vicky AI
    description: Agentes de voz IA, llamadas, campanas, grabaciones, reportes y billing
  - name: Messenger Hub
    description: WhatsApp, broadcast transaccional, chats y contactos
  - name: Notes AI
    description: >-
      Transcripciones de reuniones, conversaciones por vendedor y reuniones
      programadas
paths:
  /api/v1/vicky/agents:
    get:
      tags:
        - Vicky AI
      summary: Listar agentes del workspace
      description: >-
        Retorna la lista paginada de agentes IA de voz configurados en el
        workspace.
      operationId: VickyController_getAgents
      parameters:
        - name: page
          required: false
          in: query
          description: Numero de pagina
          schema:
            default: 1
            example: 1
            type: number
        - name: limit
          required: false
          in: query
          description: Resultados por pagina
          schema:
            default: 10
            example: 10
            type: number
        - name: sort
          required: false
          in: query
          description: Orden de resultados
          schema:
            default: desc
            type: string
            enum:
              - asc
              - desc
      responses:
        '200':
          description: Lista de agentes
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListAgentsResponseDto'
        '401':
          description: Token invalido o expirado
        '403':
          description: Sin acceso al producto Vicky AI
      security:
        - bearer: []
components:
  schemas:
    ListAgentsResponseDto:
      type: object
      properties:
        items:
          description: Lista de agentes
          type: array
          items:
            $ref: '#/components/schemas/AgentItemDto'
        total:
          type: number
          example: 104
          description: Total de agentes
        page:
          type: number
          example: 1
          description: Pagina actual
        totalPages:
          type: number
          example: 11
          description: Total de paginas
      required:
        - items
        - total
        - page
        - totalPages
    AgentItemDto:
      type: object
      properties:
        id:
          type: string
          example: 6a0e1701ef0ddceeedc18084
          description: ID del agente
        name:
          type: string
          example: Agente Cobranza IA
          description: Nombre del agente
        status:
          type: string
          example: active
          enum:
            - active
            - inactive
          description: Estado del agente
        provider:
          type: string
          example: elevenlabs
          description: Proveedor de IA de voz
        call_type:
          type: string
          example: outbound
          enum:
            - inbound
            - outbound
          description: Tipo de llamada
        createdAt:
          type: string
          example: '2026-05-20T20:18:09.384Z'
        lastModifiedBy:
          $ref: '#/components/schemas/AgentLastModifiedByDto'
      required:
        - id
        - name
        - status
        - provider
        - call_type
        - createdAt
    AgentLastModifiedByDto:
      type: object
      properties:
        userId:
          type: string
          example: 83d52a59-e4e5-474a-a562-3d96cf663bad
        username:
          type: string
          example: oguerrero@wekall.co
        fullName:
          type: string
          example: Oscar Guerrero
        email:
          type: string
          example: oguerrero@wekall.co
        at:
          type: string
          example: '2026-05-20T20:18:09.381Z'
      required:
        - userId
        - username
        - fullName
        - email
        - at
  securitySchemes:
    bearer:
      scheme: bearer
      bearerFormat: JWT
      type: http
      description: Token obtenido desde POST /api/v1/auth/token

````