Entity Settings

The following Entities have configurable settings via API:

  • accounts
  • regions
  • zones
  • clients
  • departments

These settings are read and write capable via the following methods.

[GET|PATCH] /rest/v1/{accounts|regions|zones|clients|departments}/{id}/settings/{setting_key}

image (34).png

Every Setting has its own key format that you’ll have to inspect (especially the Value property).

Patching Settings (e.g. Region Locale Date Format)

image (36).png

Settings Examples (not exhaustive)

Regions

[ { "tag": "TimeZone", "value": "America/New_York", "description": "The Timezone of the account", "category": "SYSTEM-LOCALE" }, { "tag": "DateFormat", "value": "m/d/Y", "description": "The locale date format.", "category": "SYSTEM-LOCALE" }, { "tag": "TimeFormat", "value": "h:ia", "description": "The locale time format.", "category": "SYSTEM-LOCALE" }, { "tag": "CurrencyFormat", "value": "$", "description": "The locale currency format.", "category": "SYSTEM-LOCALE" }, { "tag": "DistanceFormat", "value": "km", "description": "The locale distance format.", "category": "SYSTEM-LOCALE" }, { "tag": "AddressFormat", "value": "CA", "description": "The locale address format.", "category": "SYSTEM-LOCALE" }, { "tag": "AllowMultiCount", "value": true, "description": "Allow one patrol counting as more.", "category": "RUNSHEET" }, { "tag": "RunsheetAutoApproval", "value": "AUTO_APPROVE_ALL", "description": "Runsheet Job Auto Approval Strategy.", "category": "RUNSHEET" }, { "tag": "RunsheetGracePeriod", "value": "ALLOW_TASK_GRACE_PERIOD_YES", "description": "Allow runsheet task grace periods.", "category": "RUNSHEET" }, { "tag": "DispatchJobAutoApproval", "value": "AUTO_ALL", "description": "Dispatch Job Auto Approval Strategy.", "category": "DISPATCH" }, { "tag": "DispatchDisplayBillingNote", "value": false, "description": "Dispatch Job Billing Note Mandatory.", "category": "DISPATCH" }, { "tag": "DispatchSlaLogic", "value": "COUNT_AFTER_JOB_TIME", "description": "Dispatch SLA Logic.", "category": "DISPATCH" }, { "tag": "DispatchRefreshRate", "value": 30000, "description": "Active Dispatch Refresh Rate (in milliseconds).", "category": "DISPATCH" }, { "tag": "LateClockOutReminderAfter", "value": 0, "description": "Late Clock-Out Reminder after (in minutes)", "category": "SCHEDULING" }, { "tag": "EmergencyNumber", "value": 911, "description": "Emergency Number (911)", "category": "PATROL-AND-SECURITY" } ]

Clients

[ { "tag": "TimeZone", "value": "America/New_York", "description": "The Timezone of the account", "category": "SYSTEM-LOCALE" }, { "tag": "PatrolTourReportDetails", "value": true, "description": "Include Patrol Tour Report Details?", "category": "REPORT" }, { "tag": "DisplayGpsCoordinates", "value": false, "description": "Display GPS Coordinates on Patrol Tour Report Details?", "category": "REPORT" }, { "tag": "DualBranding", "value": false, "description": "If the account has dual branding enabled", "category": "REPORT" }, { "tag": "CheckpointActionRequired", "value": false, "description": "Checkpoint Actions required to be consider scanned?", "category": "REPORT" } ]

2024-02-21 Full List

These are lifted from a code sources directory tree and don’t reflect the “category” names:

Dispatch\DispatchSetting
Dispatch\DisplayBillingNoteSetting
Dispatch\JobAutoApprovalSetting
Dispatch\RefreshRateSetting
Dispatch\SlaSettingLogicSetting

Locale\AddressFormatSetting
Locale\CurrencyFormatSetting
Locale\DateFormatSetting
Locale\DistanceFormatSetting
Locale\LocaleSetting
Locale\TimeFormatSetting
Locale\TimeZoneSetting

LoneWorker\LateAfterSetting
LoneWorker\LateBeforeSetting
LoneWorker\LoneWorkerSetting

PatrolAndSecurity\EmergencyNumber
PatrolAndSecurity\PatrolAndSecuritySetting

Report\CheckpointActionRequired
Report\ClientReportSettings
Report\DisplayGpsCoordinates
Report\DualBrandingSetting
Report\PatrolTourReportDetails

Runsheet\AllowMultiCountSetting
Runsheet\DisplaySiteInfoOnPaperSetting
Runsheet\RunsheetAutoApprovalSetting
Runsheet\RunsheetGracePeriodSetting
Runsheet\RunsheetSetting

Scheduling\LateClockOutReminderAfter
Scheduling\SchedulingSetting

 

 

 

Was this article helpful?
0 out of 0 found this helpful

Articles in this section