Criar e configurar um tenant

Um tenant é a unidade organizacional da Velix. Cada cliente tem um tenant próprio com isolamento completo de dados biométricos — os embeddings de um tenant nunca são acessíveis por outro.

---

Configurações disponíveis

Campo	Tipo	Padrão	Descrição
maxPersons	number	ilimitado	Limite de pessoas cadastradas
requireLiveness	boolean	true	Exige prova de vida no check-in
biometricQualityLevel	low / medium / high	medium	Nível mínimo de qualidade aceito
geofenceRadiusMeters	number	0	Raio do geofence em metros (0 = desativado)
allowOfflinePunch	boolean	false	Permite registro offline com sync posterior
timezone	string	America/Sao_Paulo	Fuso horário para cálculos de ponto
webhookUrl	string	—	URL para receber eventos via webhook

---

Atualizar configurações

TypeScript

await velix.http.patch(`/v1/tenants/${tenantId}/settings`, {
  requireLiveness: true,
  biometricQualityLevel: 'high',
  timezone: 'America/Sao_Paulo',
  geofenceRadiusMeters: 200,
});

Python

velix.http.patch(f"/v1/tenants/{tenant_id}/settings", json={
    "requireLiveness": True,
    "biometricQualityLevel": "high",
    "timezone": "America/Sao_Paulo",
    "geofenceRadiusMeters": 200,
})

cURL

curl -X PATCH https://api.velixbiometrics.com/v1/tenants/$TENANT_ID/settings \
  -H "Authorization: Bearer $VELIX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "requireLiveness": true,
    "biometricQualityLevel": "high",
    "timezone": "America/Sao_Paulo",
    "geofenceRadiusMeters": 200
  }'

---

Isolamento de dados

Cada tenant tem sua própria collection no Qdrant. Ao provisionar um tenant, a Velix cria automaticamente a collection tenant_{id} com vetores de 512 dimensões (distância coseno).

Isso garante que uma busca biométrica de um tenant nunca acessa embeddings de outro tenant, mesmo em caso de falha de autenticação.