A Tenant (sometimes called an Organization) is the top-level container for one or more companies. Roles and access rights are managed here - every Payroll lives underneath a tenant.
Important: the API already allows creating multiple Payrolls under one Tenant, but Ason currently only supports one Payroll per Tenant in practice (e.g. Tenant "Acme" with Payroll "Acme Ltd."). As a platform customer, create one Tenant per company customer of yours.
FAQ
Can a tenant contain more than one company?
A Tenant is technically the top-level container for one or more Payrolls (companies), and the API already allows creating several Payrolls under one Tenant - but currently, only one Payroll per Tenant is actually supported in practice. As a platform customer, create one Tenant per company customer of yours.
Who manages access to a tenant?
Users with the appropriate role, invited by email.
Can I rename a tenant after creation?
No - the tenant identifier is immutable once set. There's no rename operation.
Can I delete a tenant? How, and who is allowed to?
Yes - DELETE /tenants/{orgId} (only for admins of that tenant). It's a hard delete of the tenant and all its data, not a soft delete - there's no recovery afterwards, so export first if you might need the data later.
Can I just set a tenant to inactive instead of deleting it, e.g. because payroll should stop being calculated?
No supported "pause" toggle exists - the only tenant-level lifecycle action is the permanent delete above. If you just want to stop new calculations, simply stop reporting case changes and don't close further periods.
API Endpoints
| What | Call |
|---|---|
| List organizations | GET /tenants |
| Create an organization | POST /tenants |
| Import an organization (from an export) | POST /tenants/import |
| Get an organization | GET /tenants/{orgId} |
| Delete an organization | DELETE /tenants/{orgId} |
| Export all organization data | GET /tenants/{orgId}/export |