@savvycal/appointments-core 1.7.0 → 1.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/dist/index.d.cts +127 -77
  2. package/dist/index.d.ts +127 -77
  3. package/package.json +1 -1
package/dist/index.d.cts CHANGED
@@ -1309,7 +1309,7 @@ interface paths {
1309
1309
  * List blocks
1310
1310
  * @description List all blocks account-wide or attached to a specific resource type.
1311
1311
  *
1312
- * Blocks are sorted by `start_date` in ascending order (oldest first).
1312
+ * Blocks are sorted by `date` in ascending order (oldest first).
1313
1313
  */
1314
1314
  get: operations["listBlocks"];
1315
1315
  put?: never;
@@ -1360,6 +1360,7 @@ interface components {
1360
1360
  * "public_bookings": {
1361
1361
  * "enabled": true
1362
1362
  * },
1363
+ * "time_zone": "America/New_York",
1363
1364
  * "weekly_rules": [
1364
1365
  * {
1365
1366
  * "day": "mo",
@@ -1393,6 +1394,8 @@ interface components {
1393
1394
  */
1394
1395
  enabled: boolean;
1395
1396
  };
1397
+ /** @description The IANA time zone the weekly rules are authored in. Defaults to the provider's location time zone when omitted. */
1398
+ time_zone?: string;
1396
1399
  /** @description Weekly rules for the schedule. */
1397
1400
  weekly_rules?: components["schemas"]["WeeklyRule"][];
1398
1401
  };
@@ -1606,7 +1609,7 @@ interface components {
1606
1609
  * "prov_d025a96ac0c6"
1607
1610
  * ],
1608
1611
  * "created_at": "2017-09-12T12:34:55Z",
1609
- * "end_date": "2025-10-27",
1612
+ * "date": "2025-10-27",
1610
1613
  * "end_time": "17:00",
1611
1614
  * "exception_dates": [
1612
1615
  * "2025-10-27T09:00:00"
@@ -1622,7 +1625,6 @@ interface components {
1622
1625
  * "freq": "weekly"
1623
1626
  * },
1624
1627
  * "service_id": null,
1625
- * "start_date": "2025-10-27",
1626
1628
  * "start_time": "09:00",
1627
1629
  * "time_zone": "America/New_York",
1628
1630
  * "title": "Team Meeting",
@@ -1656,6 +1658,7 @@ interface components {
1656
1658
  * "external_id": "123"
1657
1659
  * },
1658
1660
  * "object": "provider",
1661
+ * "time_zone": "America/New_York",
1659
1662
  * "updated_at": "2017-09-13T10:11:12Z"
1660
1663
  * },
1661
1664
  * "type": "provider.updated"
@@ -1779,6 +1782,7 @@ interface components {
1779
1782
  * "external_id": "123"
1780
1783
  * },
1781
1784
  * "object": "provider",
1785
+ * "time_zone": "America/New_York",
1782
1786
  * "updated_at": "2017-09-13T10:11:12Z"
1783
1787
  * },
1784
1788
  * "providers": [
@@ -1793,6 +1797,7 @@ interface components {
1793
1797
  * },
1794
1798
  * "object": "provider",
1795
1799
  * "role": "primary",
1800
+ * "time_zone": "America/New_York",
1796
1801
  * "updated_at": "2017-09-13T10:11:12Z"
1797
1802
  * }
1798
1803
  * ],
@@ -2103,6 +2108,7 @@ interface components {
2103
2108
  * "external_id": "123"
2104
2109
  * },
2105
2110
  * "object": "provider",
2111
+ * "time_zone": "America/New_York",
2106
2112
  * "updated_at": "2017-09-13T10:11:12Z"
2107
2113
  * },
2108
2114
  * "service_id": "srv_d025a96ac0c6",
@@ -2197,7 +2203,7 @@ interface components {
2197
2203
  * "attachments": [
2198
2204
  * "prov_d025a96ac0c6"
2199
2205
  * ],
2200
- * "end_date": "2025-10-27",
2206
+ * "date": "2025-10-27",
2201
2207
  * "end_time": "17:00",
2202
2208
  * "exception_dates": [
2203
2209
  * "2025-10-27T09:00:00"
@@ -2210,7 +2216,6 @@ interface components {
2210
2216
  * ],
2211
2217
  * "freq": "weekly"
2212
2218
  * },
2213
- * "start_date": "2025-10-27",
2214
2219
  * "start_time": "09:00",
2215
2220
  * "time_zone": "America/New_York",
2216
2221
  * "title": "Initial Consult"
@@ -2228,9 +2233,9 @@ interface components {
2228
2233
  attachments?: string[];
2229
2234
  /**
2230
2235
  * Format: date
2231
- * @description The end date of the block.
2236
+ * @description The date of the block.
2232
2237
  */
2233
- end_date?: string;
2238
+ date?: string;
2234
2239
  /** @description The end time of the block. */
2235
2240
  end_time?: string | null;
2236
2241
  /** @description The exception dates for the block. */
@@ -2239,11 +2244,6 @@ interface components {
2239
2244
  recurrence_rule?: components["schemas"]["RecurrenceRule"] | null;
2240
2245
  /** @description The ID of the service for the block. Required when `attachment_type` is `service_provider`. */
2241
2246
  service_id?: string | null;
2242
- /**
2243
- * Format: date
2244
- * @description The start date of the block.
2245
- */
2246
- start_date?: string;
2247
2247
  /** @description The start time of the block. */
2248
2248
  start_time?: string | null;
2249
2249
  /** @description The time zone of the block. */
@@ -2307,6 +2307,7 @@ interface components {
2307
2307
  * "external_id": "123"
2308
2308
  * },
2309
2309
  * "object": "provider",
2310
+ * "time_zone": "America/New_York",
2310
2311
  * "updated_at": "2017-09-13T10:11:12Z"
2311
2312
  * },
2312
2313
  * "requirements": {
@@ -2582,6 +2583,7 @@ interface components {
2582
2583
  * "external_id": "123"
2583
2584
  * },
2584
2585
  * "object": "provider",
2586
+ * "time_zone": "America/New_York",
2585
2587
  * "updated_at": "2017-09-13T10:11:12Z"
2586
2588
  * },
2587
2589
  * "providers": [
@@ -2596,6 +2598,7 @@ interface components {
2596
2598
  * },
2597
2599
  * "object": "provider",
2598
2600
  * "role": "primary",
2601
+ * "time_zone": "America/New_York",
2599
2602
  * "updated_at": "2017-09-13T10:11:12Z"
2600
2603
  * }
2601
2604
  * ],
@@ -2926,6 +2929,7 @@ interface components {
2926
2929
  * "external_id": "123"
2927
2930
  * },
2928
2931
  * "object": "provider",
2932
+ * "time_zone": "America/New_York",
2929
2933
  * "updated_at": "2017-09-13T10:11:12Z"
2930
2934
  * },
2931
2935
  * "requirements": {
@@ -3135,6 +3139,7 @@ interface components {
3135
3139
  * "external_id": "123"
3136
3140
  * },
3137
3141
  * "object": "provider",
3142
+ * "time_zone": "America/New_York",
3138
3143
  * "updated_at": "2017-09-13T10:11:12Z"
3139
3144
  * },
3140
3145
  * "service_id": "srv_d025a96ac0c6",
@@ -3282,6 +3287,7 @@ interface components {
3282
3287
  * "external_id": "123"
3283
3288
  * },
3284
3289
  * "object": "provider",
3290
+ * "time_zone": "America/New_York",
3285
3291
  * "updated_at": "2017-09-13T10:11:12Z"
3286
3292
  * },
3287
3293
  * "service_id": "srv_d025a96ac0c6",
@@ -3521,6 +3527,7 @@ interface components {
3521
3527
  * "external_id": "123"
3522
3528
  * },
3523
3529
  * "object": "provider",
3530
+ * "time_zone": "America/New_York",
3524
3531
  * "updated_at": "2017-09-13T10:11:12Z"
3525
3532
  * },
3526
3533
  * "requirements": {
@@ -3959,6 +3966,7 @@ interface components {
3959
3966
  * "external_id": "123"
3960
3967
  * },
3961
3968
  * "object": "provider",
3969
+ * "time_zone": "America/New_York",
3962
3970
  * "updated_at": "2017-09-13T10:11:12Z"
3963
3971
  * },
3964
3972
  * "requirements": {
@@ -4250,6 +4258,7 @@ interface components {
4250
4258
  * "public_bookings": {
4251
4259
  * "enabled": true
4252
4260
  * },
4261
+ * "time_zone": "America/New_York",
4253
4262
  * "updated_at": "2025-02-17T17:49:19Z",
4254
4263
  * "weekly_rules": [
4255
4264
  * {
@@ -4326,6 +4335,7 @@ interface components {
4326
4335
  * "external_id": "123"
4327
4336
  * },
4328
4337
  * "object": "provider",
4338
+ * "time_zone": "America/New_York",
4329
4339
  * "updated_at": "2017-09-13T10:11:12Z"
4330
4340
  * },
4331
4341
  * "requirements": {
@@ -4591,7 +4601,7 @@ interface components {
4591
4601
  * "prov_d025a96ac0c6"
4592
4602
  * ],
4593
4603
  * "created_at": "2017-09-12T12:34:55Z",
4594
- * "end_date": "2025-10-27",
4604
+ * "date": "2025-10-27",
4595
4605
  * "end_time": "17:00",
4596
4606
  * "exception_dates": [
4597
4607
  * "2025-10-27T09:00:00"
@@ -4607,7 +4617,6 @@ interface components {
4607
4617
  * "freq": "weekly"
4608
4618
  * },
4609
4619
  * "service_id": null,
4610
- * "start_date": "2025-10-27",
4611
4620
  * "start_time": "09:00",
4612
4621
  * "time_zone": "America/New_York",
4613
4622
  * "title": "Team Meeting",
@@ -5164,6 +5173,7 @@ interface components {
5164
5173
  * "external_id": "123"
5165
5174
  * },
5166
5175
  * "object": "provider",
5176
+ * "time_zone": "America/New_York",
5167
5177
  * "updated_at": "2017-09-13T10:11:12Z"
5168
5178
  * },
5169
5179
  * "providers": [
@@ -5178,6 +5188,7 @@ interface components {
5178
5188
  * },
5179
5189
  * "object": "provider",
5180
5190
  * "role": "primary",
5191
+ * "time_zone": "America/New_York",
5181
5192
  * "updated_at": "2017-09-13T10:11:12Z"
5182
5193
  * }
5183
5194
  * ],
@@ -5618,6 +5629,7 @@ interface components {
5618
5629
  * "external_id": "123"
5619
5630
  * },
5620
5631
  * "object": "provider",
5632
+ * "time_zone": "America/New_York",
5621
5633
  * "updated_at": "2017-09-13T10:11:12Z"
5622
5634
  * },
5623
5635
  * "providers": [
@@ -5632,6 +5644,7 @@ interface components {
5632
5644
  * },
5633
5645
  * "object": "provider",
5634
5646
  * "role": "primary",
5647
+ * "time_zone": "America/New_York",
5635
5648
  * "updated_at": "2017-09-13T10:11:12Z"
5636
5649
  * }
5637
5650
  * ],
@@ -5828,6 +5841,7 @@ interface components {
5828
5841
  * "external_id": "123"
5829
5842
  * },
5830
5843
  * "object": "provider",
5844
+ * "time_zone": "America/New_York",
5831
5845
  * "updated_at": "2017-09-13T10:11:12Z"
5832
5846
  * },
5833
5847
  * "type": "provider.created"
@@ -6051,6 +6065,7 @@ interface components {
6051
6065
  * "external_id": "123"
6052
6066
  * },
6053
6067
  * "object": "provider",
6068
+ * "time_zone": "America/New_York",
6054
6069
  * "updated_at": "2017-09-13T10:11:12Z"
6055
6070
  * },
6056
6071
  * "providers": [
@@ -6065,6 +6080,7 @@ interface components {
6065
6080
  * },
6066
6081
  * "object": "provider",
6067
6082
  * "role": "primary",
6083
+ * "time_zone": "America/New_York",
6068
6084
  * "updated_at": "2017-09-13T10:11:12Z"
6069
6085
  * }
6070
6086
  * ],
@@ -6443,7 +6459,7 @@ interface components {
6443
6459
  * "attachments": [
6444
6460
  * "prov_d025a96ac0c6"
6445
6461
  * ],
6446
- * "end_date": "2025-10-27",
6462
+ * "date": "2025-10-27",
6447
6463
  * "end_time": "17:00",
6448
6464
  * "exception_dates": [
6449
6465
  * "2025-10-27T09:00:00"
@@ -6456,7 +6472,6 @@ interface components {
6456
6472
  * ],
6457
6473
  * "freq": "weekly"
6458
6474
  * },
6459
- * "start_date": "2025-10-27",
6460
6475
  * "start_time": "09:00",
6461
6476
  * "time_zone": "America/New_York",
6462
6477
  * "title": "Initial Consult"
@@ -6474,9 +6489,9 @@ interface components {
6474
6489
  attachments?: string[];
6475
6490
  /**
6476
6491
  * Format: date
6477
- * @description The end date of the block.
6492
+ * @description The date of the block.
6478
6493
  */
6479
- end_date: string;
6494
+ date: string;
6480
6495
  /** @description The end time of the block. */
6481
6496
  end_time?: string | null;
6482
6497
  /** @description Exceptions for recurring block instances (in naive date time format). */
@@ -6485,11 +6500,6 @@ interface components {
6485
6500
  recurrence_rule?: components["schemas"]["RecurrenceRule"] | null;
6486
6501
  /** @description The ID of the service for the block. Required when `attachment_type` is `service_provider`. */
6487
6502
  service_id?: string | null;
6488
- /**
6489
- * Format: date
6490
- * @description The start date of the block.
6491
- */
6492
- start_date: string;
6493
6503
  /** @description The start time of the block. */
6494
6504
  start_time?: string | null;
6495
6505
  /** @description The time zone of the block. */
@@ -6607,6 +6617,7 @@ interface components {
6607
6617
  * "external_id": "123"
6608
6618
  * },
6609
6619
  * "object": "provider",
6620
+ * "time_zone": "America/New_York",
6610
6621
  * "updated_at": "2017-09-13T10:11:12Z"
6611
6622
  * },
6612
6623
  * "providers": [
@@ -6621,6 +6632,7 @@ interface components {
6621
6632
  * },
6622
6633
  * "object": "provider",
6623
6634
  * "role": "primary",
6635
+ * "time_zone": "America/New_York",
6624
6636
  * "updated_at": "2017-09-13T10:11:12Z"
6625
6637
  * }
6626
6638
  * ],
@@ -6826,6 +6838,7 @@ interface components {
6826
6838
  * "external_id": "123"
6827
6839
  * },
6828
6840
  * "object": "provider",
6841
+ * "time_zone": "America/New_York",
6829
6842
  * "updated_at": "2017-09-13T10:11:12Z"
6830
6843
  * },
6831
6844
  * "service_id": "srv_d025a96ac0c6",
@@ -6899,6 +6912,7 @@ interface components {
6899
6912
  * "external_id": "123"
6900
6913
  * },
6901
6914
  * "object": "provider",
6915
+ * "time_zone": "America/New_York",
6902
6916
  * "updated_at": "2017-09-13T10:11:12Z"
6903
6917
  * }
6904
6918
  * ],
@@ -6926,7 +6940,7 @@ interface components {
6926
6940
  * "prov_d025a96ac0c6"
6927
6941
  * ],
6928
6942
  * "created_at": "2017-09-12T12:34:55Z",
6929
- * "end_date": "2025-10-27",
6943
+ * "date": "2025-10-27",
6930
6944
  * "end_time": "17:00",
6931
6945
  * "exception_dates": [
6932
6946
  * "2025-10-27T09:00:00"
@@ -6942,7 +6956,6 @@ interface components {
6942
6956
  * "freq": "weekly"
6943
6957
  * },
6944
6958
  * "service_id": null,
6945
- * "start_date": "2025-10-27",
6946
6959
  * "start_time": "09:00",
6947
6960
  * "time_zone": "America/New_York",
6948
6961
  * "title": "Team Meeting",
@@ -7171,6 +7184,7 @@ interface components {
7171
7184
  * "external_id": "123"
7172
7185
  * },
7173
7186
  * "object": "provider",
7187
+ * "time_zone": "America/New_York",
7174
7188
  * "updated_at": "2017-09-13T10:11:12Z"
7175
7189
  * },
7176
7190
  * "type": "provider.reactivated"
@@ -7330,6 +7344,7 @@ interface components {
7330
7344
  * "external_id": "123"
7331
7345
  * },
7332
7346
  * "object": "provider",
7347
+ * "time_zone": "America/New_York",
7333
7348
  * "updated_at": "2017-09-13T10:11:12Z"
7334
7349
  * },
7335
7350
  * "providers": [
@@ -7344,6 +7359,7 @@ interface components {
7344
7359
  * },
7345
7360
  * "object": "provider",
7346
7361
  * "role": "primary",
7362
+ * "time_zone": "America/New_York",
7347
7363
  * "updated_at": "2017-09-13T10:11:12Z"
7348
7364
  * }
7349
7365
  * ],
@@ -7561,6 +7577,7 @@ interface components {
7561
7577
  * "external_id": "123"
7562
7578
  * },
7563
7579
  * "object": "provider",
7580
+ * "time_zone": "America/New_York",
7564
7581
  * "updated_at": "2017-09-13T10:11:12Z"
7565
7582
  * }
7566
7583
  * }
@@ -7582,6 +7599,7 @@ interface components {
7582
7599
  * "public_bookings": {
7583
7600
  * "enabled": true
7584
7601
  * },
7602
+ * "time_zone": "America/New_York",
7585
7603
  * "updated_at": "2025-02-17T17:49:19Z",
7586
7604
  * "weekly_rules": [
7587
7605
  * {
@@ -7796,6 +7814,7 @@ interface components {
7796
7814
  * "external_id": "123"
7797
7815
  * },
7798
7816
  * "object": "provider",
7817
+ * "time_zone": "America/New_York",
7799
7818
  * "updated_at": "2017-09-13T10:11:12Z"
7800
7819
  * },
7801
7820
  * "providers": [
@@ -7810,6 +7829,7 @@ interface components {
7810
7829
  * },
7811
7830
  * "object": "provider",
7812
7831
  * "role": "primary",
7832
+ * "time_zone": "America/New_York",
7813
7833
  * "updated_at": "2017-09-13T10:11:12Z"
7814
7834
  * }
7815
7835
  * ],
@@ -8229,6 +8249,7 @@ interface components {
8229
8249
  * "external_id": "123"
8230
8250
  * },
8231
8251
  * "object": "provider",
8252
+ * "time_zone": "America/New_York",
8232
8253
  * "updated_at": "2017-09-13T10:11:12Z"
8233
8254
  * },
8234
8255
  * "providers": [
@@ -8243,6 +8264,7 @@ interface components {
8243
8264
  * },
8244
8265
  * "object": "provider",
8245
8266
  * "role": "primary",
8267
+ * "time_zone": "America/New_York",
8246
8268
  * "updated_at": "2017-09-13T10:11:12Z"
8247
8269
  * }
8248
8270
  * ],
@@ -8634,6 +8656,7 @@ interface components {
8634
8656
  * "external_id": "123"
8635
8657
  * },
8636
8658
  * "object": "provider",
8659
+ * "time_zone": "America/New_York",
8637
8660
  * "updated_at": "2017-09-13T10:11:12Z"
8638
8661
  * },
8639
8662
  * "providers": [
@@ -8648,6 +8671,7 @@ interface components {
8648
8671
  * },
8649
8672
  * "object": "provider",
8650
8673
  * "role": "primary",
8674
+ * "time_zone": "America/New_York",
8651
8675
  * "updated_at": "2017-09-13T10:11:12Z"
8652
8676
  * }
8653
8677
  * ],
@@ -8829,6 +8853,7 @@ interface components {
8829
8853
  * "public_bookings": {
8830
8854
  * "enabled": true
8831
8855
  * },
8856
+ * "time_zone": "America/New_York",
8832
8857
  * "updated_at": "2025-02-17T17:49:19Z",
8833
8858
  * "weekly_rules": [
8834
8859
  * {
@@ -8878,7 +8903,7 @@ interface components {
8878
8903
  * "prov_d025a96ac0c6"
8879
8904
  * ],
8880
8905
  * "created_at": "2017-09-12T12:34:55Z",
8881
- * "end_date": "2025-10-27",
8906
+ * "date": "2025-10-27",
8882
8907
  * "end_time": "17:00",
8883
8908
  * "exception_dates": [
8884
8909
  * "2025-10-27T09:00:00"
@@ -8894,7 +8919,6 @@ interface components {
8894
8919
  * "freq": "weekly"
8895
8920
  * },
8896
8921
  * "service_id": null,
8897
- * "start_date": "2025-10-27",
8898
8922
  * "start_time": "09:00",
8899
8923
  * "time_zone": "America/New_York",
8900
8924
  * "title": "Team Meeting",
@@ -8918,17 +8942,25 @@ interface components {
8918
8942
  * `status` field reflects where the meeting is in its lifecycle. Meeting details
8919
8943
  * such as `join_url` are populated only once the status is `created`.
8920
8944
  *
8921
- * The `host_url` field is a stable proxy URL on the account's booking domain
8922
- * (the canonical SavvyCal host, or an active custom domain when one is
8945
+ * The `host_url` field is a proxy URL on the account's booking domain (the
8946
+ * canonical SavvyCal host, or an active custom domain when one is
8923
8947
  * configured) that the meeting host follows to start the meeting. **Treat
8924
8948
  * this URL as a credential — anyone with it can start the meeting as the
8925
8949
  * host.** It is valid through the appointment's end time + a 24h grace
8926
- * window, after which it returns 410 Gone. SavvyCal handles refresh of the
8927
- * underlying conferencing-provider URL transparently behind the proxy, so
8928
- * the proxy URL itself remains stable across `appointment.updated` webhook
8929
- * events. `host_url` is null when the meeting is not yet `created` or when
8930
- * the conferencing provider has no distinct host start URL (e.g., Google
8931
- * Meet uses a single shared URL).
8950
+ * window, after which it returns 410 Gone.
8951
+ *
8952
+ * SavvyCal refreshes the underlying conferencing-provider URL transparently
8953
+ * behind the proxy, so the proxy URL generally remains stable across
8954
+ * `appointment.meeting.updated` events. It may change if SavvyCal rotates
8955
+ * the underlying token (e.g., for security reasons) or when the meeting is
8956
+ * replaced — a brand-new meeting with a new `id`, which happens when a
8957
+ * reschedule routes the appointment to a different host on the account.
8958
+ * Listen for `appointment.meeting.updated` and `appointment.meeting.replaced`
8959
+ * to keep stored copies fresh.
8960
+ *
8961
+ * `host_url` is null when the meeting is not yet `created` or when the
8962
+ * conferencing provider has no distinct host start URL (e.g., Google Meet
8963
+ * uses a single shared URL).
8932
8964
  * @example {
8933
8965
  * "conferencing_provider": "zoom_admin",
8934
8966
  * "error_message": null,
@@ -8956,11 +8988,15 @@ interface components {
8956
8988
  external_meeting_id: string | null;
8957
8989
  /**
8958
8990
  * Format: uri
8959
- * @description Stable proxy URL the host follows to start the meeting. Treat as a
8991
+ * @description Proxy URL the host follows to start the meeting. Treat as a
8960
8992
  * credential — anyone with this URL can start the meeting as host.
8961
8993
  * Valid through the appointment's end time + 24h grace window, then
8962
- * returns 410 Gone. Null when the meeting is not `created` or when
8963
- * the conferencing provider has no distinct host start URL.
8994
+ * returns 410 Gone. Generally stable, but may change across
8995
+ * `appointment.meeting.updated` events (e.g., if SavvyCal rotates the
8996
+ * token) and always changes when the meeting is replaced
8997
+ * (`appointment.meeting.replaced`). Null when the meeting is not
8998
+ * `created` or when the conferencing provider has no distinct host
8999
+ * start URL.
8964
9000
  */
8965
9001
  host_url: string | null;
8966
9002
  /** @description Unique identifier for the object. */
@@ -9203,6 +9239,7 @@ interface components {
9203
9239
  * "external_id": "123"
9204
9240
  * },
9205
9241
  * "object": "provider",
9242
+ * "time_zone": "America/New_York",
9206
9243
  * "updated_at": "2017-09-13T10:11:12Z"
9207
9244
  * },
9208
9245
  * "providers": [
@@ -9217,6 +9254,7 @@ interface components {
9217
9254
  * },
9218
9255
  * "object": "provider",
9219
9256
  * "role": "primary",
9257
+ * "time_zone": "America/New_York",
9220
9258
  * "updated_at": "2017-09-13T10:11:12Z"
9221
9259
  * }
9222
9260
  * ],
@@ -9441,6 +9479,7 @@ interface components {
9441
9479
  * "public_bookings": {
9442
9480
  * "enabled": true
9443
9481
  * },
9482
+ * "time_zone": "America/New_York",
9444
9483
  * "updated_at": "2025-02-17T17:49:19Z",
9445
9484
  * "weekly_rules": [
9446
9485
  * {
@@ -9733,6 +9772,7 @@ interface components {
9733
9772
  * "external_id": "123"
9734
9773
  * },
9735
9774
  * "object": "provider",
9775
+ * "time_zone": "America/New_York",
9736
9776
  * "updated_at": "2017-09-13T10:11:12Z"
9737
9777
  * },
9738
9778
  * "providers": [
@@ -9747,6 +9787,7 @@ interface components {
9747
9787
  * },
9748
9788
  * "object": "provider",
9749
9789
  * "role": "primary",
9790
+ * "time_zone": "America/New_York",
9750
9791
  * "updated_at": "2017-09-13T10:11:12Z"
9751
9792
  * }
9752
9793
  * ],
@@ -10007,6 +10048,7 @@ interface components {
10007
10048
  * "public_bookings": {
10008
10049
  * "enabled": true
10009
10050
  * },
10051
+ * "time_zone": "America/New_York",
10010
10052
  * "updated_at": "2025-02-17T17:49:19Z",
10011
10053
  * "weekly_rules": [
10012
10054
  * {
@@ -10138,6 +10180,7 @@ interface components {
10138
10180
  * },
10139
10181
  * "object": "provider",
10140
10182
  * "role": "primary",
10183
+ * "time_zone": "America/New_York",
10141
10184
  * "updated_at": "2017-09-13T10:11:12Z"
10142
10185
  * }
10143
10186
  */
@@ -10169,6 +10212,8 @@ interface components {
10169
10212
  * @enum {string}
10170
10213
  */
10171
10214
  role: "primary" | "secondary";
10215
+ /** @description The provider's preferred IANA time zone, used as the default when authoring schedules. */
10216
+ time_zone: string;
10172
10217
  /**
10173
10218
  * Format: date-time
10174
10219
  * @description Time at which the object was last updated.
@@ -10188,6 +10233,7 @@ interface components {
10188
10233
  * "external_id": "123"
10189
10234
  * },
10190
10235
  * "object": "provider",
10236
+ * "time_zone": "America/New_York",
10191
10237
  * "updated_at": "2017-09-13T10:11:12Z"
10192
10238
  * }
10193
10239
  */
@@ -10214,6 +10260,8 @@ interface components {
10214
10260
  * @enum {string}
10215
10261
  */
10216
10262
  object: "provider";
10263
+ /** @description The provider's preferred IANA time zone, used as the default when authoring schedules. */
10264
+ time_zone: string;
10217
10265
  /**
10218
10266
  * Format: date-time
10219
10267
  * @description Time at which the object was last updated.
@@ -10229,6 +10277,7 @@ interface components {
10229
10277
  * "public_bookings": {
10230
10278
  * "enabled": true
10231
10279
  * },
10280
+ * "time_zone": "America/New_York",
10232
10281
  * "weekly_rules": [
10233
10282
  * {
10234
10283
  * "day": "mo",
@@ -10262,6 +10311,8 @@ interface components {
10262
10311
  */
10263
10312
  enabled: boolean;
10264
10313
  };
10314
+ /** @description The IANA time zone the weekly rules are authored in. Defaults to the provider's location time zone when omitted. */
10315
+ time_zone?: string;
10265
10316
  /** @description Weekly rules for the schedule. */
10266
10317
  weekly_rules?: components["schemas"]["WeeklyRule"][];
10267
10318
  };
@@ -10317,7 +10368,7 @@ interface components {
10317
10368
  * "prov_d025a96ac0c6"
10318
10369
  * ],
10319
10370
  * "created_at": "2017-09-12T12:34:55Z",
10320
- * "end_date": "2025-10-27",
10371
+ * "date": "2025-10-27",
10321
10372
  * "end_time": "17:00",
10322
10373
  * "exception_dates": [
10323
10374
  * "2025-10-27T09:00:00"
@@ -10333,7 +10384,6 @@ interface components {
10333
10384
  * "freq": "weekly"
10334
10385
  * },
10335
10386
  * "service_id": null,
10336
- * "start_date": "2025-10-27",
10337
10387
  * "start_time": "09:00",
10338
10388
  * "time_zone": "America/New_York",
10339
10389
  * "title": "Team Meeting",
@@ -10357,9 +10407,9 @@ interface components {
10357
10407
  created_at: string;
10358
10408
  /**
10359
10409
  * Format: date
10360
- * @description The end date of the block.
10410
+ * @description The date of the block.
10361
10411
  */
10362
- end_date: string;
10412
+ date: string;
10363
10413
  /** @description The end time of the block. */
10364
10414
  end_time: string | null;
10365
10415
  /** @description The exception dates for the block. */
@@ -10375,11 +10425,6 @@ interface components {
10375
10425
  recurrence_rule: components["schemas"]["RecurrenceRule"] | null;
10376
10426
  /** @description The ID of the service for the block. Required when `attachment_type` is `service_provider`. */
10377
10427
  service_id: string | null;
10378
- /**
10379
- * Format: date
10380
- * @description The start date of the block.
10381
- */
10382
- start_date: string;
10383
10428
  /** @description The start time of the block. */
10384
10429
  start_time: string | null;
10385
10430
  /** @description The time zone of the block. */
@@ -10410,6 +10455,7 @@ interface components {
10410
10455
  * "external_id": "123"
10411
10456
  * },
10412
10457
  * "object": "provider",
10458
+ * "time_zone": "America/New_York",
10413
10459
  * "updated_at": "2017-09-13T10:11:12Z"
10414
10460
  * },
10415
10461
  * "service_id": "srv_d025a96ac0c6",
@@ -10618,6 +10664,7 @@ interface components {
10618
10664
  * "public_bookings": {
10619
10665
  * "enabled": true
10620
10666
  * },
10667
+ * "time_zone": "America/New_York",
10621
10668
  * "updated_at": "2025-02-17T17:49:19Z",
10622
10669
  * "weekly_rules": [
10623
10670
  * {
@@ -10661,6 +10708,8 @@ interface components {
10661
10708
  /** @description Whether public bookings are enabled for the schedule. */
10662
10709
  enabled: boolean;
10663
10710
  };
10711
+ /** @description The IANA time zone the schedule's weekly rules are authored in. */
10712
+ time_zone: string;
10664
10713
  /**
10665
10714
  * Format: datetime
10666
10715
  * @description When the schedule was last updated.
@@ -10779,6 +10828,7 @@ interface components {
10779
10828
  * "external_id": "123"
10780
10829
  * },
10781
10830
  * "object": "provider",
10831
+ * "time_zone": "America/New_York",
10782
10832
  * "updated_at": "2017-09-13T10:11:12Z"
10783
10833
  * },
10784
10834
  * "providers": [
@@ -10793,6 +10843,7 @@ interface components {
10793
10843
  * },
10794
10844
  * "object": "provider",
10795
10845
  * "role": "primary",
10846
+ * "time_zone": "America/New_York",
10796
10847
  * "updated_at": "2017-09-13T10:11:12Z"
10797
10848
  * }
10798
10849
  * ],
@@ -11054,6 +11105,7 @@ interface components {
11054
11105
  * "external_id": "123"
11055
11106
  * },
11056
11107
  * "object": "provider",
11108
+ * "time_zone": "America/New_York",
11057
11109
  * "updated_at": "2017-09-13T10:11:12Z"
11058
11110
  * },
11059
11111
  * "requirements": {
@@ -11317,6 +11369,7 @@ interface components {
11317
11369
  * "external_id": "123"
11318
11370
  * },
11319
11371
  * "object": "provider",
11372
+ * "time_zone": "America/New_York",
11320
11373
  * "updated_at": "2017-09-13T10:11:12Z"
11321
11374
  * },
11322
11375
  * "providers": [
@@ -11331,6 +11384,7 @@ interface components {
11331
11384
  * },
11332
11385
  * "object": "provider",
11333
11386
  * "role": "primary",
11387
+ * "time_zone": "America/New_York",
11334
11388
  * "updated_at": "2017-09-13T10:11:12Z"
11335
11389
  * }
11336
11390
  * ],
@@ -11764,7 +11818,7 @@ interface components {
11764
11818
  * "prov_d025a96ac0c6"
11765
11819
  * ],
11766
11820
  * "created_at": "2017-09-12T12:34:55Z",
11767
- * "end_date": "2025-10-27",
11821
+ * "date": "2025-10-27",
11768
11822
  * "end_time": "17:00",
11769
11823
  * "exception_dates": [
11770
11824
  * "2025-10-27T09:00:00"
@@ -11780,7 +11834,6 @@ interface components {
11780
11834
  * "freq": "weekly"
11781
11835
  * },
11782
11836
  * "service_id": null,
11783
- * "start_date": "2025-10-27",
11784
11837
  * "start_time": "09:00",
11785
11838
  * "time_zone": "America/New_York",
11786
11839
  * "title": "Team Meeting",
@@ -11908,6 +11961,7 @@ interface components {
11908
11961
  * "external_id": "123"
11909
11962
  * },
11910
11963
  * "object": "provider",
11964
+ * "time_zone": "America/New_York",
11911
11965
  * "updated_at": "2017-09-13T10:11:12Z"
11912
11966
  * },
11913
11967
  * "providers": [
@@ -11922,6 +11976,7 @@ interface components {
11922
11976
  * },
11923
11977
  * "object": "provider",
11924
11978
  * "role": "primary",
11979
+ * "time_zone": "America/New_York",
11925
11980
  * "updated_at": "2017-09-13T10:11:12Z"
11926
11981
  * }
11927
11982
  * ],
@@ -12199,6 +12254,7 @@ interface components {
12199
12254
  * "external_id": "123"
12200
12255
  * },
12201
12256
  * "object": "provider",
12257
+ * "time_zone": "America/New_York",
12202
12258
  * "updated_at": "2017-09-13T10:11:12Z"
12203
12259
  * },
12204
12260
  * "providers": [
@@ -12213,6 +12269,7 @@ interface components {
12213
12269
  * },
12214
12270
  * "object": "provider",
12215
12271
  * "role": "primary",
12272
+ * "time_zone": "America/New_York",
12216
12273
  * "updated_at": "2017-09-13T10:11:12Z"
12217
12274
  * }
12218
12275
  * ],
@@ -12539,6 +12596,7 @@ interface components {
12539
12596
  * "external_id": "123"
12540
12597
  * },
12541
12598
  * "object": "provider",
12599
+ * "time_zone": "America/New_York",
12542
12600
  * "updated_at": "2017-09-13T10:11:12Z"
12543
12601
  * },
12544
12602
  * "type": "provider.deactivated"
@@ -12650,6 +12708,7 @@ interface components {
12650
12708
  * "external_id": "123"
12651
12709
  * },
12652
12710
  * "object": "provider",
12711
+ * "time_zone": "America/New_York",
12653
12712
  * "updated_at": "2017-09-13T10:11:12Z"
12654
12713
  * },
12655
12714
  * "service_id": "srv_d025a96ac0c6",
@@ -12968,6 +13027,7 @@ interface components {
12968
13027
  * "external_id": "123"
12969
13028
  * },
12970
13029
  * "object": "provider",
13030
+ * "time_zone": "America/New_York",
12971
13031
  * "updated_at": "2017-09-13T10:11:12Z"
12972
13032
  * },
12973
13033
  * "requirements": {
@@ -13390,6 +13450,7 @@ interface components {
13390
13450
  * "external_id": "123"
13391
13451
  * },
13392
13452
  * "object": "provider",
13453
+ * "time_zone": "America/New_York",
13393
13454
  * "updated_at": "2017-09-13T10:11:12Z"
13394
13455
  * },
13395
13456
  * "providers": [
@@ -13404,6 +13465,7 @@ interface components {
13404
13465
  * },
13405
13466
  * "object": "provider",
13406
13467
  * "role": "primary",
13468
+ * "time_zone": "America/New_York",
13407
13469
  * "updated_at": "2017-09-13T10:11:12Z"
13408
13470
  * }
13409
13471
  * ],
@@ -18203,18 +18265,12 @@ interface operations {
18203
18265
  service_provider_ids?: string;
18204
18266
  /** @description Filter by location ID(s). Accepts a single ID or comma-delimited list of IDs. */
18205
18267
  location_ids?: string;
18206
- /** @description Only return blocks that start on the specified date. */
18207
- start_date?: string;
18208
- /** @description Only return blocks that end on the specified date. */
18209
- end_date?: string;
18210
- /** @description Only return blocks that start on or after the specified date. */
18211
- start_date_min?: string;
18212
- /** @description Only return blocks that start on or before the specified date. */
18213
- start_date_max?: string;
18214
- /** @description Only return blocks that end on or after the specified date. */
18215
- end_date_min?: string;
18216
- /** @description Only return blocks that end on or before the specified date. */
18217
- end_date_max?: string;
18268
+ /** @description Only return blocks on the specified date. */
18269
+ date?: string;
18270
+ /** @description Only return blocks on or after the specified date. */
18271
+ date_min?: string;
18272
+ /** @description Only return blocks on or before the specified date. */
18273
+ date_max?: string;
18218
18274
  /** @description If true, only return blocks that are recurring. */
18219
18275
  recurring?: boolean;
18220
18276
  /** @description If true, only return blocks that are all day. */
@@ -19272,12 +19328,11 @@ declare function createBlock(client: FetchClient, body: RequestBody<"/v1/blocks"
19272
19328
  all_day?: boolean;
19273
19329
  attachment_type: "location" | "service" | "provider" | "service_provider";
19274
19330
  attachments?: string[];
19275
- end_date: string;
19331
+ date: string;
19276
19332
  end_time?: string | null;
19277
19333
  exception_dates?: string[];
19278
19334
  recurrence_rule?: components["schemas"]["RecurrenceRule"] | null;
19279
19335
  service_id?: string | null;
19280
- start_date: string;
19281
19336
  start_time?: string | null;
19282
19337
  time_zone?: string;
19283
19338
  title?: string;
@@ -19704,6 +19759,7 @@ declare function createProviderSchedule(client: FetchClient, path: PathParams<"/
19704
19759
  public_bookings?: {
19705
19760
  enabled: boolean;
19706
19761
  };
19762
+ time_zone?: string;
19707
19763
  weekly_rules?: components["schemas"]["WeeklyRule"][];
19708
19764
  } | undefined;
19709
19765
  params: {
@@ -21527,12 +21583,9 @@ declare function listBlocks(client: FetchClient, query?: QueryParams<"/v1/blocks
21527
21583
  service_ids?: string;
21528
21584
  service_provider_ids?: string;
21529
21585
  location_ids?: string;
21530
- start_date?: string;
21531
- end_date?: string;
21532
- start_date_min?: string;
21533
- start_date_max?: string;
21534
- end_date_min?: string;
21535
- end_date_max?: string;
21586
+ date?: string;
21587
+ date_min?: string;
21588
+ date_max?: string;
21536
21589
  recurring?: boolean;
21537
21590
  all_day?: boolean;
21538
21591
  };
@@ -21579,12 +21632,9 @@ declare function listBlocks(client: FetchClient, query?: QueryParams<"/v1/blocks
21579
21632
  service_ids?: string;
21580
21633
  service_provider_ids?: string;
21581
21634
  location_ids?: string;
21582
- start_date?: string;
21583
- end_date?: string;
21584
- start_date_min?: string;
21585
- start_date_max?: string;
21586
- end_date_min?: string;
21587
- end_date_max?: string;
21635
+ date?: string;
21636
+ date_min?: string;
21637
+ date_max?: string;
21588
21638
  recurring?: boolean;
21589
21639
  all_day?: boolean;
21590
21640
  } | undefined;
@@ -22910,12 +22960,11 @@ declare function updateBlock(client: FetchClient, path: PathParams<"/v1/blocks/{
22910
22960
  all_day?: boolean;
22911
22961
  attachment_type?: "location" | "service" | "provider" | "service_provider";
22912
22962
  attachments?: string[];
22913
- end_date?: string;
22963
+ date?: string;
22914
22964
  end_time?: string | null;
22915
22965
  exception_dates?: string[];
22916
22966
  recurrence_rule?: components["schemas"]["RecurrenceRule"] | null;
22917
22967
  service_id?: string | null;
22918
- start_date?: string;
22919
22968
  start_time?: string | null;
22920
22969
  time_zone?: string;
22921
22970
  title?: string;
@@ -23434,6 +23483,7 @@ declare function updateProviderSchedule(client: FetchClient, path: PathParams<"/
23434
23483
  public_bookings?: {
23435
23484
  enabled: boolean;
23436
23485
  };
23486
+ time_zone?: string;
23437
23487
  weekly_rules?: components["schemas"]["WeeklyRule"][];
23438
23488
  } | undefined;
23439
23489
  params: {