Skip to content

Org Settings API

All endpoints require authentication and admin privileges. Routes are mounted under /api/admin/settings.

GET /api/admin/settings

Returns all organisation settings as a key-value map.

Response: { settings }

The settings object is a Record<string, string> where each key is a setting name and the value is its current value.


PUT /api/admin/settings

Updates one or more organisation settings. Only allowed keys are persisted; unknown keys are silently ignored. Uses upsert semantics (insert or update on conflict).

Body: Record<string, string> — key-value pairs to update.

Allowed keys:

KeyDescription
timezoneOrganisation timezone
holiday_statePublic holiday state/region

Response: { settings } — the full settings map after the update.