Tenant Settings
Per-environment configuration for tenants. Matching, locale, jobs, LedgerMatch, cache.
What are tenant settings
Tenant settings are stored per tenant and environment. They control matching behavior, locale (for number/date parsing), job schedules, LedgerMatch preferences, and cache toggles. Update via PATCH /tenants/:id/settings with X-Tenant-Id and X-Environment set.
When you first update settings for an environment, default values are applied for any omitted fields. See Tenants > Settings for a conceptual overview.
Nested configuration
Each nested object has its own reference page with full attribute definitions:
- localePreferences — Locale Preferences
- jobSchedulingPreferences — Job Scheduling
- ledgerMatchPreferences — LedgerMatch Preferences
- cachePreferences — Cache Preferences
Attributes
| Attribute | Purpose |
|---|---|
| matchingConfidenceThreshold | Min confidence to auto-accept (0–1). Default: 0.80 |
| matchingMode | realtime, batch, or hybrid |
| autoMatchEnabled | Auto-trigger matching on new incoming transactions |
| autoAcceptTopRanked | Auto-accept top match when above threshold |
| autoAcceptOnlyWhenSingleMatch | Only auto-accept when exactly one match |
| jobSchedulingPreferences | Cron schedules, retention, batch size. See Job Scheduling |
| localePreferences | Locale, timezone, currency, date format. See Locale Preferences |
| ledgerMatchPreferences | matchStrategy, retry, timeout. See LedgerMatch Preferences |
| cachePreferences | matchCacheEnabled, expectedCacheEnabled. See Cache Preferences |