Listar Equipes

Listar as equipes para as quais as conversas podem ser roteadas em um workspace, ordenadas por nome. O workspace inteiro é retornado: não existe um filtro de "equipes às quais eu pertenço", porque uma API key não carrega identidade de agente para resolvê-lo. A configuração do próprio motor de atribuição — o intervalo de varredura e a estratégia de atribuição automática — é interna e não é publicada; allowAutoAssign é o dado estável sobre se o trabalho chega a uma equipe automaticamente. Toda operação é delimitada pelo workspaceId obrigatório. Uma API key com escopo de workspace que nomeie qualquer outro workspace é recusada com 403 antes de qualquer consulta rodar, então uma API key de workspace só consegue alcançar o próprio workspace.

GET/api/v1/chat/teams

Authorization

apiKey
X-API-Key<token>

Sua API key do Studio, pessoal ou com escopo de workspace. Gere uma em Settings e depois API Keys. As operações que rejeitam API keys de workspace dizem isso na própria descrição.

Em: header

Parâmetros de query

page?integer

Número da página, começando em 1. O padrão é 1.

Padrão1
Intervalo1 <= value <= 9007199254740991
perPage?integer

Itens por página, entre 1 e 100. O padrão é 25.

Padrão25
Intervalo1 <= value <= 100
workspaceId*string

Workspace cujas equipes são listadas.

Tamanho1 <= length

Corpo da resposta

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://agent-studio.seeyu.ai/api/v1/chat/teams?workspaceId=string" \  -H "X-API-Key: YOUR_API_KEY"
{
  "teams": [
    {
      "id": "tem_01J8F2K3N5PC",
      "workspaceId": "ws_01J8F2K3N5P7",
      "name": "Support",
      "description": "Suporte de primeiro nível",
      "allowAutoAssign": true,
      "workingHoursEnabled": true,
      "outOfOfficeMessage": "We are closed. We will reply on the next working day.",
      "timezone": "America/Sao_Paulo",
      "createdAt": "2026-07-24T11:02:19.000Z",
      "updatedAt": "2026-08-28T09:41:02.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "perPage": 25,
    "total": 1,
    "totalPages": 1
  }
}
{
  "error": "Invalid input: expected string, received undefined",
  "details": [
    {
      "code": "invalid_type",
      "expected": "string",
      "path": [
        "phone"
      ],
      "message": "Invalid input: expected string, received undefined"
    }
  ]
}
{
  "error": "Unauthorized"
}
{
  "error": "API key is not authorized for this workspace"
}
{
  "error": "Rate limit exceeded",
  "message": "API rate limit exceeded. Please retry after 2026-09-13T12:00:00.000Z",
  "retryAfter": 1789286400000
}
{
  "error": "Internal server error",
  "requestId": "req_01J9Z2K3M4N5P6Q7R8S9T0"
}
GETListar Membros da Equipe