Locations & facilities
PlatformRepresent facilities, branches, departments and operational locations within an organization or tenant.
Isolation
Tenant-scoped by design
Hierarchy
Organizations + sub-organizations
Access
Membership + role context
Configuration
Policies, modules & branding
Overview
Locations model physical or operational places. They can map to facilities, branches, rooms or service locations without creating unnecessary tenant boundaries.
Location model
| Field | Description |
|---|---|
| id | Location identifier |
| tenant_id | Owning tenant |
| parent_location_id | Optional parent location |
| type | facility, branch, department, room, virtual |
| status | active, inactive |
| address | Structured postal address when applicable |
List locations
GET /v1/locationsCopy
GET /v1/locations?tenant_id=tnt_hospital_01&type=departmentCreate location
POST /v1/locationsCopy
{
"tenant_id":"tnt_hospital_01",
"name":"Cardiology — Floor 2",
"type":"department",
"parent_location_id":"loc_main_hospital"
}Hierarchy
Use location hierarchy for operational spaces. Use organization hierarchy for governance/legal ownership, and tenants for security/data-isolation boundaries.