Organizations

Every app runs inside an organization (your tenant). The SDK is automatically scoped to your organization via the JWT — you never pass an org ID to any API call.

sdk.organizations gives you read access to your org’s metadata and lets admins update settings.

Multi-tenancy is automatic. All SDK calls — sdk.people.list(), sdk.storage.db.collection('x').get('y'), etc. — are automatically isolated to your organization. You never need to filter by tenant or org ID.

Get current organization

const org = await sdk.organizations.getCurrent()
console.log(org.id, org.name, org.plan)
// Use org.id if you need to display or store your tenant context

Update organization settings

Requires admin scope.

const updated = await sdk.organizations.update({
  name: 'Acme Corp',
  settings: { defaultLocale: 'en-US' },
})