Equipes

CRUD completo para equipes (filas de atendimento), que agrupam contatos.

Endpoints

Método	Rota	Descrição
GET	/api/v1/teams	Lista equipes
POST	/api/v1/teams	Cria uma equipe
GET	/api/v1/teams/{team}	Exibe uma equipe
PUT/PATCH	/api/v1/teams/{team}	Atualiza uma equipe
DELETE	/api/v1/teams/{team}	Remove uma equipe

Filtros de listagem

search, is_active.

Campos

Campo	Tipo	Obrigatório	Descrição
name	string, max 255	Sim	Nome da equipe.
is_active	boolean	Não	Padrão: conforme cadastro.
contact_ids	array de integers	Não	IDs de contatos da mesma conta que fazem parte da equipe. Substitui a lista atual de membros (sincronização completa, não incremental).

Exemplo de resposta

{
  "id": 4,
  "name": "Suporte N2",
  "is_active": true,
  "contact_ids": [21, 22, 23],
  "created_at": "2026-08-01T12:00:00Z",
  "updated_at": "2026-08-01T12:00:00Z"
}

Exemplos com curl

Listar equipes

curl "$ROUXINOL_URL/api/v1/teams?is_active=true" \
  -H "Authorization: Bearer $ROUXINOL_TOKEN"

Criar uma equipe

curl -X POST "$ROUXINOL_URL/api/v1/teams" \
  -H "Authorization: Bearer $ROUXINOL_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Suporte N2", "contact_ids": [21, 22, 23] }'

Exibir uma equipe

curl "$ROUXINOL_URL/api/v1/teams/4" \
  -H "Authorization: Bearer $ROUXINOL_TOKEN"

Atualizar uma equipe (substitui os membros)

curl -X PATCH "$ROUXINOL_URL/api/v1/teams/4" \
  -H "Authorization: Bearer $ROUXINOL_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "contact_ids": [21, 24] }'

Remover uma equipe

curl -X DELETE "$ROUXINOL_URL/api/v1/teams/4" \
  -H "Authorization: Bearer $ROUXINOL_TOKEN"