Operadores
Listar Operadores
Obter uma lista paginada de operadores com filtros.
GET /api/operators
Retorna uma lista paginada de operadores com filtros opcionais.
Auth: Obrigatória — permissão operator:manage
Parâmetros de Consulta
| Parâmetro | Tipo | Padrão | Descrição |
|---|---|---|---|
page | number | 1 | Número da página |
per_page | number | 25 | Itens por página (máx. 100) |
search | string | - | Buscar por nome, e-mail ou ID externo (correspondência de substring, sem diferenciar maiúsculas de minúsculas) |
types | OperatorTypeEnum (CSV) | - | Filtrar por tipo(s) de operador. Lista separada por vírgulas de valores OperatorTypeEnum (ex. SALESMAN,ACTIVATOR). |
is_active | boolean | - | Filtrar por status ativo |
Exemplo
curl "https://api.reten.ai/api/operators?types=SALESMAN&page=1&limit=10" \
-H "Authorization: Bearer <token>" \
-H "x-tenant-id: <tenant-id>"const params = new URLSearchParams({ types: "SALESMAN", page: "1", limit: "10" });
const response = await fetch(`https://api.reten.ai/api/operators?${params}`, {
headers: {
"Authorization": "Bearer <token>",
"x-tenant-id": "<tenant-id>",
},
});
const data = await response.json();import requests
response = requests.get(
"https://api.reten.ai/api/operators",
headers={
"Authorization": "Bearer <token>",
"x-tenant-id": "<tenant-id>",
},
params={"types": "SALESMAN", "page": 1, "limit": 10},
)
data = response.json()Resposta 200 OK
{
"data": [
{
"id": "cc0e8400-e29b-41d4-a716-446655440000",
"name": "John Doe",
"externalId": "EXT-12345",
"email": "john.doe@example.com",
"type": "SALESMAN",
"isActive": true
}
],
"meta": {
"page": 1,
"limit": 10,
"total": 1,
"totalPages": 1
}
}