For AI agents: paste our llms-full.txt into your context — the complete Riven docs index for coding assistants.

Search docs

Find a page across the Riven documentation

Organizations & Legal Entity Convergence

Manage any company workspace at rivenai.io/org — keeping your customer-facing brand display name distinct from your registered legal entity, FEIN, and Secretary of State filing while converging Auth, Riven Comms, Riven ERP, and Document Center.

Real businesses frequently operate under a trade or brand name while contracting, banking, and filing taxes under a distinct statutory LLC, PLLC, or corporation. Riven models both fields natively for every organization so you never have to choose between clean workspace branding and accurate legal accounting.

FieldWhere it appearsExample
Workspace Display NameApp switcher, Riven Chat context, Riven Comms team title, portal headerVilleRetreats TM or PES Supply
Registered Legal EntityRiven ERP res.company.name, POs/invoices, W-9 schedules, contractsVILLERETREATSTM LLC or Portlandia Electric Supply LLC
Federal Tax ID (FEIN)Riven ERP res.company.vat, 1099/W-9 schedules, tax-exemption packets87-4340012
State / SOS RegistrationRiven ERP l10n_us_state_identifier, corporate entity schedulesKY #1179078

Four-surface live convergence#

Whenever an organization owner or admin creates a workspace at /org, completes a Business Suite wizard, or clicks Save & Sync Surfaces inside /org/{id}, Riven converges four operational surfaces in a single transaction:

  1. Riven Auth & OIDC SSO — updates the canonical organization profile, custom data (legalEntity, taxId, jurisdiction), and optional Entra ID / SAML / SCIM directory bindings.
  2. Riven Comms & 5 Department Desks — provisions or updates the dedicated team (t-{slug}) and refreshes channel headers across all 5 standard Department Desks (Operations, Sales & Intake, Finance & Billing, Support & Fulfillment, and Executive).
  3. Company-Isolated Riven ERP 0.0.06+e — binds and updates the tenant’s isolated res.company record (name, vat, and l10n_us_state_identifier) with strict multi-company ACLs (company_id + company_ids).
  4. Document Center & Compliance Vault — links /org/{id}/documents so corporate formation filings and FEIN / W-9 schedules verify against the active legal identity and sync to Riven ERP.

Step-by-step: updating or disambiguating an entity#

  1. Open rivenai.io/org and select your organization (or create a new organization with Legal Entity & FEIN expanded).
  2. In Organization & Legal Entity Identity, enter the Workspace display name, Registered legal entity name, Tax ID / FEIN, and State / SOS registration.
  3. Click Save (or Sync all surfaces) and verify all four status badges under Connected Surfaces & Live Convergence show green (Active, 5/5 Desks, Company #{id}, and Docs · ERP Synced).
  4. Open Document Center in the left rail (or /org/{id}/documents) and click Generate Entity & W-9 Packet to mint updated schedules into Riven ERP.

All Riven ERP identity and document sync operations execute with mail_notrack and tracking_disable, ensuring zero unsolicited notification emails are ever sent to external partners or customers during admin updates.