Tenants
Tenant-level feature switches.
| Operation | Endpoint |
|---|---|
| Get the caller's tenant | GET /api/tenant |
| Update tenant settings | PATCH /api/tenant |
GET /api/tenant
/api/tenantGet the caller's tenant
The tenant is resolved from the credential; there is no id to pass. orgSettings is its tenant-wide rule settings, {} when none were written.
Requires Basic authentication.
Responses
| Status | Meaning |
|---|---|
200 | The tenant, its feature switches and its rule settings. |
401 | Missing, malformed or unrecognised Basic credentials. |
403 | Authenticated, but the client's role does not permit this, or it is not attached to the patient. |
Response body
| Field | Type | Required | Description |
|---|---|---|---|
id | string | yes | |
name | string | yes | |
settings | object | yes | Feature switches. episodicAlerts gates episode recording and the notification feed; synchronousMode returns before evaluating; informationalCodes, historyCategories and feedCodes are the codes and categories the tenant declares (PATCH /api/tenant); ruleSet, when present, is deprecated and ignored. |
orgSettings | object | null | yes | The tenant's rule settings, {} when none were written: what the triggers judge by, the triggers themselves included. Written through PATCH /api/tenant. Null for a SUBMITTER or SUBSCRIBER credential. Example: {"bands":{"8867-4":{"low":50,"high":110}}}. |
createdAt | date-time | yes | Example: "2026-08-27T09:15:00.000Z". |
updatedAt | date-time | yes | Example: "2026-08-27T09:15:00.000Z". |
PATCH /api/tenant
/api/tenantUpdate tenant settings
settings is merged, so a switch left out is left alone. Takes effect on the next request — except throttleLimit, which each replica caches for up to a minute.
episodicAlerts gates episode recording and the notification feed. synchronousMode makes ingest return before evaluating. throttleLimit overrides THROTTLE_LIMIT for this tenant; 0 exempts it.
informationalCodes, historyCategories and feedCodes (lists of strings, none by default): the codes the tenant's triggers consume and never judge (no no-verdict, and the * trigger skips them), the reading categories stored and never judged, and the codes the notification feed lists by default (none: every code). A new tenant is given the default pack's lists, and a tenant that states no historyCategories keeps the default pack's.
ruleSet is deprecated and ignored: readings are judged by the triggers in the rule settings, the tenant's (orgSettings) and each patient's own (/api/patient/{id}/settings).
orgSettings is the tenant's rule settings, which replace /api/settings/org: what the triggers judge by, the triggers themselves included. It is merged key by key: a key sent replaces the stored one whole, null removes it, and a key left out is kept. Its first write is given the default pack when it sends no triggers. Audited as UPDATE_ORG_SETTINGS. A band it changes ends the episodes judged under the old one, and a code it switches off (its band "NO_THRESHOLD", or out of bed enabled: false) has its active alerts resolved and its open episodes closed THRESHOLD_CHANGED at the save, for every patient judged by the tenant's settings (an acknowledged out-of-bed absence, whose episode the ack closed, has its still-active alert resolved); a band deleted closes nothing. A tenant whose only org settings are one project's, with no patient stamped with another project, has them made the tenant's first, so the write reaches the patients they served.
resolvedAt (ISO 8601) is when the caller resolved orgSettings: it lands only over a write resolved earlier, or stored without one, and is otherwise refused 409 STALE_SETTINGS with nothing written. With ifAbsent=true each key of orgSettings is written only where the stored settings lack it, so a default seeded at enrolment cannot overwrite a concurrent save.
Requires Basic authentication.
Parameters
| Name | In | Required | Description |
|---|---|---|---|
ifAbsent | query | no | Write each key of orgSettings only where the stored settings lack it. |
Request body
| Field | Type | Required | Description |
|---|---|---|---|
name | string | no | |
settings | TenantSettingsDto | no | |
orgSettings | object | no | The tenant's rule settings, merged key by key: a key sent replaces the stored one, null removes it. |
resolvedAt | string | no | When the caller resolved orgSettings: it lands only over a write resolved earlier. |
Responses
| Status | Meaning |
|---|---|
200 | The tenant as it now stands. |
401 | Missing, malformed or unrecognised Basic credentials. |
403 | Authenticated, but the client's role does not permit this, or it is not attached to the patient. |
409 | A newer write of orgSettings is already stored (STALE_SETTINGS); nothing was written. |
422 | The payload failed validation. |
Response body
| Field | Type | Required | Description |
|---|---|---|---|
id | string | yes | |
name | string | yes | |
settings | object | yes | Feature switches. episodicAlerts gates episode recording and the notification feed; synchronousMode returns before evaluating; informationalCodes, historyCategories and feedCodes are the codes and categories the tenant declares (PATCH /api/tenant); ruleSet, when present, is deprecated and ignored. |
orgSettings | object | null | yes | The tenant's rule settings, {} when none were written: what the triggers judge by, the triggers themselves included. Written through PATCH /api/tenant. Null for a SUBMITTER or SUBSCRIBER credential. Example: {"bands":{"8867-4":{"low":50,"high":110}}}. |
createdAt | date-time | yes | Example: "2026-08-27T09:15:00.000Z". |
updatedAt | date-time | yes | Example: "2026-08-27T09:15:00.000Z". |
Updated 20 days ago