--- title: schedule.settings | Doing Work API description: The shop's scheduling setup: time zone, booking hours (or the default when none are set), arrival window, travel buffer, reminder lead time, whether on the. url: https://doingwork.work/docs/reference/schedule-settings/ --- # schedule.settings The shop's scheduling setup: time zone, booking hours (or the default when none are set), arrival window, travel buffer, reminder lead time, whether on the way notices go out, and whether arrival times are shown. on_my_way_notices covers both the on the way and the arrived notice. arrival_notices is off unless the shop turns it on. When on, an on the way message includes an arrival time when one is known (a stored route estimate, or the time the worker entered; no drive time is looked up). On the way and arrived each go by text and by email. Any worker in the shop can read it. | | | |---|---| | Who | Agents can call this | | REST | `GET /v1/schedule/settings` | | MCP tool | `schedule_settings` | | Writes | no | | Area | [Scheduling and visits](https://doingwork.work/docs/reference/#scheduling-and-visits) | ## When to use it The shop's scheduling setup: time zone, booking hours (or the default when none are set), arrival window, travel buffer, reminder lead time, whether on the way notices go out, and whether arrival times are shown. on_my_way_notices covers both the on the way and the arrived notice. ## What to tell the owner Tell them what you found in plain words. Don't read back raw fields. ## Input | Field | Type | Required | |---|---|---| | `shop_id` | string (uuid) | yes | ## Example ```http GET https://doingwork.work/v1/schedule/settings?shop_id=00000000-0000-4000-8000-000000000000 ``` ## Output | Field | Type | Always there | |---|---|---| | `shop_id` | string (uuid) | yes | | `time_zone` | string | yes | | `time_zone_set` | boolean | no | | `hours` | array | yes | | `hours[].weekday` | integer | yes | | `hours[].start` | string | yes | | `hours[].end` | string | yes | | `hours_source` | string (one of shop, default) | yes | | `arrival_window_minutes` | integer | yes | | `buffer_minutes` | integer | yes | | `reminder_hours` | integer | yes | | `on_my_way_notices` | boolean | yes | | `arrival_notices` | boolean | yes | ```json { "shop_id": "00000000-0000-4000-8000-000000000000", "time_zone": "...", "hours": [ { "weekday": 1, "start": "...", "end": "..." } ], "hours_source": "shop", "arrival_window_minutes": 1, "buffer_minutes": 1, "reminder_hours": 1, "on_my_way_notices": true, "arrival_notices": true } ``` ## Errors | Code | Status | What to do | |---|---|---| | `invalid_input`, `invalid_token`, `rate_limited` | | Can happen on any call. See [errors](https://doingwork.work/docs/errors/). |