Empresa

Recurso singular: la API key apunta a exactamente una empresa, así que estos endpoints son uno por API key y no hay :id en la URL.

El objeto Company

{
  "id":               "65a1b2c3d4e5f6789012abcd",
  "name":             "DSM",
  "slug":             "dsm",
  "website":          "https://dsm.com",
  "legal_name":       "DSM S.A. de C.V.",
  "logo_url":         "https://cdn.finova.com/v1/logo/dsm/logo-...",
  "business_type":    "Servicios",
  "business_context": "Consultoría de marketing y growth para PyMEs.",
  "business_goals":   ["Aumentar leads calificados", "Reducir CAC"],
  "team": {
    "max_team_size":     5,
    "current_team_size": 3,
    "seats_available":   2
  },
  "enabled_modules":  ["calendar", "leads", "automation"],
  "created_at": "2025-11-12T11:00:00Z",
  "updated_at": "2026-05-17T14:30:21Z"
}

Campos editables

Campo	Tipo	Descripción
name	string	Nombre comercial.
website	string	URL del sitio.
legal_name	string	Razón social.
business_type	string	Tipo de negocio (free text).
business_context	string	Contexto del negocio (texto largo). Usado por la IA.
business_goals	array<string>	Lista de objetivos.

Campos no mutables vía API:

• slug, plan, contadores de quota (max_storage_bytes, max_ai_tokens, etc.), max_team_size, enabled_module_slugs. Estos viven detrás del flujo de facturación y configuración del dashboard.

Scopes requeridos

Acción	Scope
GET /company	read-company
PUT /company, POST /company/logo	update-company

Obtener la empresa

GET /api/v1/company

Actualizar info de la empresa

PUT /api/v1/company
Content-Type: application/json

{
  "data": {
    "name":             "DSM Growth",
    "website":          "https://dsm.com",
    "business_type":    "Servicios",
    "business_context": "Consultoría de marketing para retail.",
    "business_goals":   ["Triplicar leads del Q3", "Onboarding 24h"]
  }
}

Subir logo

POST /api/v1/company/logo
Content-Type: multipart/form-data

logo: <archivo JPG/PNG/SVG>

El logo de la empresa se usa como branding principal en la landing pública de las ligas de agenda (book.fi-nova.com/<user_slug>/<link_slug>). Si la empresa no tiene logo, la landing cae al avatar del host (User#avatar).