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

# Listar Agents

> Retorna todos os agents do workspace, incluindo os desativados.



## OpenAPI

````yaml GET /v1/agents
openapi: 3.0.1
info:
  title: Integrabot API
  version: 1.0.0
  description: >-
    A API do Integrabot permite gerenciar leads, agents e integrações de forma
    programática. Use esta API para criar leads a partir de formulários web,
    sincronizar contatos com seu CRM ou automatizar fluxos de trabalho com os
    agents de IA do Integrabot.
  contact:
    name: Suporte Integrabot
    email: hello@integrabot.ai
    url: https://docs.integrabot.ai
servers:
  - url: https://api.integrabot.ai
    description: Produção
security:
  - bearerAuth: []
paths:
  /v1/agents:
    get:
      tags:
        - Agents
      summary: Listar Agents
      description: Retorna todos os agents do workspace, incluindo os desativados.
      operationId: listAgents
      responses:
        '200':
          description: Lista de agents.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Agent'
              example:
                - uuid: a1b2c3d4-e5f6-7890-abcd-ef1234567890
                  name: Agente de Vendas
                  is_active: true
                  model: gpt-4o
                  communication_style: professional
                  tools_count: 5
                  created_at: '2025-01-10T08:00:00Z'
                - uuid: f0e1d2c3-b4a5-6789-0abc-def123456789
                  name: Agente de Suporte
                  is_active: true
                  model: gpt-4o-mini
                  communication_style: friendly
                  tools_count: 3
                  created_at: '2025-01-12T14:00:00Z'
        '401':
          description: Token de API inválido ou ausente.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorUnauthorized'
components:
  schemas:
    Agent:
      type: object
      properties:
        uuid:
          type: string
          format: uuid
          example: a1b2c3d4-e5f6-7890-abcd-ef1234567890
        name:
          type: string
          example: Agente de Vendas
        is_active:
          type: boolean
          example: true
        model:
          type: string
          example: gpt-4o
        communication_style:
          type: string
          nullable: true
          example: professional
        tools_count:
          type: integer
          example: 5
        created_at:
          type: string
          format: date-time
          example: '2025-01-10T08:00:00Z'
    ErrorUnauthorized:
      type: object
      properties:
        error:
          type: string
          example: Unauthorized
        message:
          type: string
          example: Token de API inválido ou ausente.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key starting with sk_

````