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

# Obtener los agentes de tu empresa

> Devuelve los agentes de tu cuenta que pueden recibir conversaciones. Úsalo para conocer el `email` y el `id` de cada agente, que son los valores que debes devolver desde tu endpoint cuando usas el destino **API** del bloque de Métodos de transferencia.

Solo se devuelven los agentes **activos**, por lo que cualquier agente de la respuesta puede recibir una conversación.

Este endpoint vive en el host de la plataforma de agentes, `agent-api.treble.ai`, y no en `main.treble.ai`.



## OpenAPI

````yaml open-api-files/treble-api-es.json GET /agent/company/agents
openapi: 3.0.1
info:
  title: API de Treble Poll
  description: Documentación para el endpoint de despliegue de polls en Treble
  version: 1.0.0
servers:
  - url: https://main.treble.ai
    description: Servidor principal de Treble
  - url: https://tudominio.com
    description: >-
      Servidor de ejemplo para implementar los webhooks. Esto representa TU
      servidor donde debes implementar los endpoints que Treble llamará.
security: []
tags:
  - name: Webhooks
    description: >-
      Endpoints que Treble llamará en tu servidor. Estos no son endpoints reales
      que puedas llamar, sino una representación de los webhooks que Treble
      invocará en tu sistema.
paths:
  /agent/company/agents:
    get:
      summary: Obtener los agentes de tu empresa
      description: >-
        Devuelve los agentes de tu cuenta que pueden recibir conversaciones.
        Úsalo para conocer el `email` y el `id` de cada agente, que son los
        valores que debes devolver desde tu endpoint cuando usas el destino
        **API** del bloque de Métodos de transferencia.


        Solo se devuelven los agentes **activos**, por lo que cualquier agente
        de la respuesta puede recibir una conversación.


        Este endpoint vive en el host de la plataforma de agentes,
        `agent-api.treble.ai`, y no en `main.treble.ai`.
      parameters:
        - name: Authorization
          in: header
          required: true
          description: >-
            API Key de autorización. Se puede obtener en
            https://app.treble.ai/es/dashboard/settings/developers
          schema:
            type: string
          example: API_KEY
      responses:
        '200':
          description: Lista de agentes obtenida correctamente
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Agent'
              example:
                - id: 4567
                  first_name: Andrea
                  last_name: Soto
                  email: andrea.soto@tuempresa.com
                  tags:
                    - id: 12
                      name: Default
                    - id: 18
                      name: Comercial
      servers:
        - url: https://agent-api.treble.ai
          description: Host de la plataforma de agentes de Treble
components:
  schemas:
    Agent:
      type: object
      description: Agente de tu cuenta que puede recibir conversaciones.
      properties:
        id:
          type: integer
          description: Identificador del agente en Treble.
          example: 4567
        first_name:
          type: string
          description: Nombre del agente.
          example: Andrea
        last_name:
          type: string
          description: Apellido del agente.
          example: Soto
        email:
          type: string
          description: >-
            Email del agente. Es el valor recomendado para devolver desde tu
            endpoint de asignación.
          example: andrea.soto@tuempresa.com
        tags:
          type: array
          description: Equipos a los que pertenece el agente.
          items:
            $ref: '#/components/schemas/AgentTag'
    AgentTag:
      type: object
      description: Equipo (tag) al que pertenece el agente.
      properties:
        id:
          type: integer
          description: Identificador del equipo.
          example: 12
        name:
          type: string
          description: Nombre del equipo.
          example: Default

````