Empresa

Gerenciamento das configurações da empresa (tenant). Requer papel de manager ou superior.

Endpoints

Método	Endpoint	Descrição	Role Mínimo
GET	/api/v1/company	Dados da empresa	manager
PUT	/api/v1/company	Atualizar empresa	manager

---

Consultar Empresa

Retorna as configurações da empresa do tenant atual.

GET /api/v1/company

Exemplo de Request

curl -X GET https://voki.avanter.com.br/api/v1/company \
  -H "Authorization: Bearer eyJhbGci..." \
  -H "X-Tenant: avanter"

Resposta de Sucesso (200)

{
  "data": {
    "id": "d4e5f6a7-b8c9-0123-defg-456789012345",
    "name": "Avanter Aliado Tecnológico Ltda",
    "slug": "avanter",
    "document": "12.345.678/0001-90",
    "document_type": "cnpj",
    "email": "contato@avanter.com.br",
    "phone": "+5511999999999",
    "logo_url": null,
    "primary_color": "#6366f1",
    "max_concurrent_calls": 10,
    "recording_enabled": true,
    "transcription_enabled": true,
    "mfa_required": false,
    "plan": "professional",
    "stripe_customer_id": "cus_xxx",
    "stripe_subscription_id": "sub_xxx",
    "inserted_at": "2026-01-01T00:00:00Z",
    "updated_at": "2026-02-15T10:00:00Z"
  }
}

---

Atualizar Empresa

Atualiza as configurações da empresa.

PUT /api/v1/company

Request Body

Campo	Tipo	Obrigatório	Descrição
name	string	Não	Nome da empresa
email	string	Não	Email de contato
phone	string	Não	Telefone
logo_url	string	Não	URL do logotipo
primary_color	string	Não	Cor primária (hex)
recording_enabled	boolean	Não	Habilitar gravação de chamadas
transcription_enabled	boolean	Não	Habilitar transcrição IA
mfa_required	boolean	Não	Exigir MFA para todos os usuários

Exemplo de Request

curl -X PUT https://voki.avanter.com.br/api/v1/company \
  -H "Authorization: Bearer eyJhbGci..." \
  -H "X-Tenant: avanter" \
  -H "Content-Type: application/json" \
  -d '{
    "company": {
      "name": "Avanter Aliado Tecnológico Ltda",
      "recording_enabled": true,
      "mfa_required": true
    }
  }'

Resposta de Sucesso (200)

{
  "data": {
    "id": "d4e5f6a7-b8c9-0123-defg-456789012345",
    "name": "Avanter Aliado Tecnológico Ltda",
    "slug": "avanter",
    "document": "12.345.678/0001-90",
    "document_type": "cnpj",
    "email": "contato@avanter.com.br",
    "phone": "+5511999999999",
    "logo_url": null,
    "primary_color": "#6366f1",
    "max_concurrent_calls": 10,
    "recording_enabled": true,
    "transcription_enabled": true,
    "mfa_required": true,
    "plan": "professional",
    "stripe_customer_id": "cus_xxx",
    "stripe_subscription_id": "sub_xxx",
    "inserted_at": "2026-01-01T00:00:00Z",
    "updated_at": "2026-02-18T11:30:00Z"
  }
}

Erros

Código	Descrição
422	Dados inválidos
403	Sem permissão