Tenants

Lists tenants the current user is a member of; create tenants, invite users, assign roles. Tenant context is not required for tenants; use setTenant for work orders, assets, and other tenant-scoped resources.

List tenants

List all tenants the authenticated user is a member of (from v_tenants).

const tenants = await client.tenants.list()
// Returns TenantRow[]

Get by ID

Fetch a single tenant by ID.

const tenant = await client.tenants.getById('uuid-of-tenant')
// Returns TenantRow | null

Create tenant

Create a new tenant. The authenticated user becomes a member and is assigned the admin role. Returns the new tenant UUID.

const tenantId = await client.tenants.create({
  name: 'Acme Corp',
  slug: 'acme-corp',
})
// Returns string (UUID)

Invite user

Invite a user to a tenant with a role (e.g. admin, member). The invitee receives an invite; they must accept to join.

await client.tenants.inviteUser({
  tenantId: 'uuid-of-tenant',
  inviteeEmail: 'newuser@example.com',
  roleKey: 'member',
})

Assign role

Assign a role to an existing user in a tenant.

await client.tenants.assignRole({
  tenantId: 'uuid-of-tenant',
  userId: 'uuid-of-user',
  roleKey: 'member',
})