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

# Listar equipes

> Lista as equipes, para escolher o destino de uma transferência. Scope: `teams:read`.



## OpenAPI

````yaml GET /channel-api/teams
openapi: 3.1.0
info:
  title: Zazz Chat — Channel API
  description: >-
    Channel API do Zazz Chat: envio de mensagens, roteamento de conversas e
    webhook de eventos. Há duas credenciais: a chave de API do canal (header
    `x-channel-api-key`) e a API key de conta (header `Authorization: ApiKey
    <token>`), com scopes e canais permitidos.
  version: 1.0.0
servers:
  - url: https://{host}
    description: Back-end do Zazz Chat
    variables:
      host:
        default: chat.zazzinternet.com
        description: Host do back-end da sua instalação do Zazz Chat
security:
  - channelApiKey: []
paths:
  /channel-api/teams:
    get:
      summary: Listar equipes
      description: >-
        Lista as equipes, para escolher o destino de uma transferência. Scope:
        `teams:read`.
      responses:
        '200':
          description: Equipes.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Team'
        '401':
          description: >-
            Nenhuma credencial válida (API key revogada, inexistente ou header
            ausente).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                statusCode: 401
                message: Credencial ausente ou inválida
                error: Unauthorized
        '404':
          description: >-
            Credencial ausente/inválida para esta rota, key sem o scope exigido,
            chat inexistente ou fora dos canais permitidos da key. A API não
            diferencia os casos para não revelar a existência do recurso.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                statusCode: 404
                message: Not Found
                error: Not Found
        '429':
          description: Limite de 120 requisições por minuto por API key excedido.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                statusCode: 429
                message: Rate limit exceeded. Maximum 120 requests per 60s per API key.
      security:
        - accountApiKey: []
components:
  schemas:
    Team:
      type: object
      properties:
        id:
          type: string
          example: 66f1f0c2e4b0a1b2c3d4e100
        name:
          type: string
          example: Suporte
        description:
          type:
            - string
            - 'null'
          example: null
        status:
          type: string
          example: active
        members:
          type: array
          items:
            type: string
          description: IDs dos usuários da equipe.
    Error:
      type: object
      properties:
        statusCode:
          type: integer
        message:
          type: string
        error:
          type: string
  securitySchemes:
    channelApiKey:
      type: apiKey
      in: header
      name: x-channel-api-key
      description: >-
        Chave de API do canal, gerada na aba **API** das configurações do canal
        (Dashboard → Suporte → Canais). A chave é exibida uma única vez ao ser
        gerada; gerar uma nova invalida a anterior.
    accountApiKey:
      type: apiKey
      in: header
      name: Authorization
      description: >-
        API key de conta, no formato `ApiKey <token>` (ex.: `ApiKey
        zk_live_...`). Criada em **Configurações → API Keys** por um usuário com
        a permissão `api_keys:manage`. O token é exibido uma única vez. Cada
        rota exige um scope; key sem o scope, ou recurso fora dos canais
        permitidos da key, responde `404`.

````