@savvycal/appointments-core 1.1.1 → 1.3.0

package/dist/index.d.ts

@@ -2156,6 +2156,12 @@ interface components {
          *       "object": {
          *         "abandoned_at": null,
          *         "appointment": null,
+         *         "booking_policy": {
+         *           "hold": {
+         *             "duration": "PT10M",
+         *             "enabled": true
+         *           }
+         *         },
          *         "client": null,
          *         "client_data": {
          *           "email": "jane@example.com",
@@ -2176,8 +2182,6 @@ interface components {
          *           "utc": "2026-02-23T15:30:00Z"
          *         },
          *         "errors": null,
-         *         "hold_duration": "PT10M",
-         *         "hold_enabled": true,
          *         "hold_until": "2026-02-22T10:10:00Z",
          *         "id": "bi_abc123def456abc123def456",
          *         "locked_fields": [
@@ -2202,6 +2206,20 @@ interface components {
          *           "object": "provider",
          *           "updated_at": "2017-09-13T10:11:12Z"
          *         },
+         *         "requirements": {
+         *           "booking": {
+         *             "complete": true
+         *           },
+         *           "info": {
+         *             "complete": false
+         *           },
+         *           "submissions": [
+         *             {
+         *               "complete": false,
+         *               "form_id": "frm_abc123def456"
+         *             }
+         *           ]
+         *         },
          *         "service": {
          *           "appointment_type": "in_person",
          *           "booking_policy": {
@@ -2294,7 +2312,19 @@ interface components {
          *         },
          *         "status": "slot_selected",
          *         "submissions": [],
-         *         "updated_at": "2026-02-22T10:00:00Z"
+         *         "updated_at": "2026-02-22T10:00:00Z",
+         *         "workflow": {
+         *           "available_steps": [
+         *             "booking",
+         *             "info",
+         *             "form:frm_abc123def456"
+         *           ],
+         *           "can_change_slot": true,
+         *           "can_complete": false,
+         *           "defunct_reason": null,
+         *           "is_defunct": false,
+         *           "resume_step": "info"
+         *         }
          *       },
          *       "type": "booking_intent.completed"
          *     }
@@ -2381,8 +2411,12 @@ interface components {
          * CreateBookingIntentRequest
          * @description Request schema for creating a booking intent
          * @example {
-         *       "hold_duration": "PT10M",
-         *       "hold_enabled": true,
+         *       "booking_policy": {
+         *         "hold": {
+         *           "duration": "PT10M",
+         *           "enabled": true
+         *         }
+         *       },
          *       "metadata": {
          *         "source": "web"
          *       },
@@ -2392,6 +2426,16 @@ interface components {
         CreateBookingIntentRequest: {
             /** @description When true, automatically assigns an available provider for the selected time slot if no provider_id is specified. */
             auto_assign_provider?: boolean | null;
+            /** @description Policy overrides for this booking intent. When omitted, falls back to the service's policies. */
+            booking_policy?: {
+                /** @description Hold policy overrides. */
+                hold?: {
+                    /** @description The duration of the hold as an ISO 8601 duration string. */
+                    duration?: string | null;
+                    /** @description Whether slot holds are enabled. */
+                    enabled?: boolean;
+                } | null;
+            } | null;
             /** @description Progressive client data to collect during the booking flow. */
             client_data?: {
                 email?: string | null;
@@ -2413,12 +2457,8 @@ interface components {
              * @description The end time of the slot as an ISO-8601 datetime string with a timezone offset.
              */
             end_at?: string | null;
-            /** @description The hold duration as an ISO 8601 duration string (e.g., PT10M). When omitted, falls back to the service's hold policy duration. */
-            hold_duration?: string | null;
-            /** @description Whether to enable slot holding. When omitted, falls back to the service's hold policy. */
-            hold_enabled?: boolean | null;
-            /** @description Fields to lock from public API updates. Possible values: service_id, provider_id, start_at, end_at, time_zone, client_data, submissions. */
-            locked_fields?: string[] | null;
+            /** @description Fields to lock from public API updates. */
+            locked_fields?: ("service_id" | "provider_id" | "start_at" | "end_at" | "time_zone" | "client_data" | "submissions")[] | null;
             /** @description Custom metadata key-value pairs. */
             metadata?: {
                 [key: string]: unknown;
@@ -2449,6 +2489,12 @@ interface components {
          *       "object": {
          *         "abandoned_at": null,
          *         "appointment": null,
+         *         "booking_policy": {
+         *           "hold": {
+         *             "duration": "PT10M",
+         *             "enabled": true
+         *           }
+         *         },
          *         "client": null,
          *         "client_data": {
          *           "email": "jane@example.com",
@@ -2469,8 +2515,6 @@ interface components {
          *           "utc": "2026-02-23T15:30:00Z"
          *         },
          *         "errors": null,
-         *         "hold_duration": "PT10M",
-         *         "hold_enabled": true,
          *         "hold_until": "2026-02-22T10:10:00Z",
          *         "id": "bi_abc123def456abc123def456",
          *         "locked_fields": [
@@ -2495,6 +2539,20 @@ interface components {
          *           "object": "provider",
          *           "updated_at": "2017-09-13T10:11:12Z"
          *         },
+         *         "requirements": {
+         *           "booking": {
+         *             "complete": true
+         *           },
+         *           "info": {
+         *             "complete": false
+         *           },
+         *           "submissions": [
+         *             {
+         *               "complete": false,
+         *               "form_id": "frm_abc123def456"
+         *             }
+         *           ]
+         *         },
          *         "service": {
          *           "appointment_type": "in_person",
          *           "booking_policy": {
@@ -2587,7 +2645,19 @@ interface components {
          *         },
          *         "status": "slot_selected",
          *         "submissions": [],
-         *         "updated_at": "2026-02-22T10:00:00Z"
+         *         "updated_at": "2026-02-22T10:00:00Z",
+         *         "workflow": {
+         *           "available_steps": [
+         *             "booking",
+         *             "info",
+         *             "form:frm_abc123def456"
+         *           ],
+         *           "can_change_slot": true,
+         *           "can_complete": false,
+         *           "defunct_reason": null,
+         *           "is_defunct": false,
+         *           "resume_step": "info"
+         *         }
          *       },
          *       "type": "booking_intent.abandoned"
          *     }
@@ -2770,6 +2840,41 @@ interface components {
              */
             type: "short_text" | "long_text" | "email" | "phone" | "boolean" | "radio" | "select" | "checkbox";
         };
+        /**
+         * BookingIntentRequirements
+         * @description Per-section completeness status for a booking intent. Provides boolean
+         *     signals for whether each section of the booking flow has enough data
+         *     to proceed, enabling the frontend to make navigation decisions without
+         *     parsing error pointers.
+         * @example {
+         *       "booking": {
+         *         "complete": true
+         *       },
+         *       "info": {
+         *         "complete": false
+         *       },
+         *       "submissions": [
+         *         {
+         *           "complete": false,
+         *           "form_id": "frm_abc123def456"
+         *         }
+         *       ]
+         *     }
+         */
+        BookingIntentRequirements: {
+            /** @description Booking step completeness status. */
+            booking: {
+                /** @description Whether the booking step is complete (provider and slot fields are present). */
+                complete: boolean;
+            };
+            /** @description Info step completeness status. */
+            info: {
+                /** @description Whether the info step is complete (required client fields are present). */
+                complete: boolean;
+            };
+            /** @description Per-form completeness status, in the same order as the service's forms. */
+            submissions: components["schemas"]["SubmissionRequirement"][];
+        };
         /**
          * ServiceProvider
          * @description A service provider
@@ -2958,6 +3063,12 @@ interface components {
          *       "object": {
          *         "abandoned_at": null,
          *         "appointment": null,
+         *         "booking_policy": {
+         *           "hold": {
+         *             "duration": "PT10M",
+         *             "enabled": true
+         *           }
+         *         },
          *         "client": null,
          *         "client_data": {
          *           "email": "jane@example.com",
@@ -2978,8 +3089,6 @@ interface components {
          *           "utc": "2026-02-23T15:30:00Z"
          *         },
          *         "errors": null,
-         *         "hold_duration": "PT10M",
-         *         "hold_enabled": true,
          *         "hold_until": "2026-02-22T10:10:00Z",
          *         "id": "bi_abc123def456abc123def456",
          *         "locked_fields": [
@@ -3004,6 +3113,20 @@ interface components {
          *           "object": "provider",
          *           "updated_at": "2017-09-13T10:11:12Z"
          *         },
+         *         "requirements": {
+         *           "booking": {
+         *             "complete": true
+         *           },
+         *           "info": {
+         *             "complete": false
+         *           },
+         *           "submissions": [
+         *             {
+         *               "complete": false,
+         *               "form_id": "frm_abc123def456"
+         *             }
+         *           ]
+         *         },
          *         "service": {
          *           "appointment_type": "in_person",
          *           "booking_policy": {
@@ -3096,7 +3219,19 @@ interface components {
          *         },
          *         "status": "slot_selected",
          *         "submissions": [],
-         *         "updated_at": "2026-02-22T10:00:00Z"
+         *         "updated_at": "2026-02-22T10:00:00Z",
+         *         "workflow": {
+         *           "available_steps": [
+         *             "booking",
+         *             "info",
+         *             "form:frm_abc123def456"
+         *           ],
+         *           "can_change_slot": true,
+         *           "can_complete": false,
+         *           "defunct_reason": null,
+         *           "is_defunct": false,
+         *           "resume_step": "info"
+         *         }
          *       },
          *       "type": "booking_intent.updated"
          *     }
@@ -3377,6 +3512,12 @@ interface components {
          *         {
          *           "abandoned_at": null,
          *           "appointment": null,
+         *           "booking_policy": {
+         *             "hold": {
+         *               "duration": "PT10M",
+         *               "enabled": true
+         *             }
+         *           },
          *           "client": null,
          *           "client_data": {
          *             "email": "jane@example.com",
@@ -3397,8 +3538,6 @@ interface components {
          *             "utc": "2026-02-23T15:30:00Z"
          *           },
          *           "errors": null,
-         *           "hold_duration": "PT10M",
-         *           "hold_enabled": true,
          *           "hold_until": "2026-02-22T10:10:00Z",
          *           "id": "bi_abc123def456abc123def456",
          *           "locked_fields": [
@@ -3423,6 +3562,20 @@ interface components {
          *             "object": "provider",
          *             "updated_at": "2017-09-13T10:11:12Z"
          *           },
+         *           "requirements": {
+         *             "booking": {
+         *               "complete": true
+         *             },
+         *             "info": {
+         *               "complete": false
+         *             },
+         *             "submissions": [
+         *               {
+         *                 "complete": false,
+         *                 "form_id": "frm_abc123def456"
+         *               }
+         *             ]
+         *           },
          *           "service": {
          *             "appointment_type": "in_person",
          *             "booking_policy": {
@@ -3515,7 +3668,19 @@ interface components {
          *           },
          *           "status": "slot_selected",
          *           "submissions": [],
-         *           "updated_at": "2026-02-22T10:00:00Z"
+         *           "updated_at": "2026-02-22T10:00:00Z",
+         *           "workflow": {
+         *             "available_steps": [
+         *               "booking",
+         *               "info",
+         *               "form:frm_abc123def456"
+         *             ],
+         *             "can_change_slot": true,
+         *             "can_complete": false,
+         *             "defunct_reason": null,
+         *             "is_defunct": false,
+         *             "resume_step": "info"
+         *           }
          *         }
          *       ],
          *       "meta": {
@@ -3713,6 +3878,12 @@ interface components {
          *       "object": {
          *         "abandoned_at": null,
          *         "appointment": null,
+         *         "booking_policy": {
+         *           "hold": {
+         *             "duration": "PT10M",
+         *             "enabled": true
+         *           }
+         *         },
          *         "client": null,
          *         "client_data": {
          *           "email": "jane@example.com",
@@ -3733,8 +3904,6 @@ interface components {
          *           "utc": "2026-02-23T15:30:00Z"
          *         },
          *         "errors": null,
-         *         "hold_duration": "PT10M",
-         *         "hold_enabled": true,
          *         "hold_until": "2026-02-22T10:10:00Z",
          *         "id": "bi_abc123def456abc123def456",
          *         "locked_fields": [
@@ -3759,6 +3928,20 @@ interface components {
          *           "object": "provider",
          *           "updated_at": "2017-09-13T10:11:12Z"
          *         },
+         *         "requirements": {
+         *           "booking": {
+         *             "complete": true
+         *           },
+         *           "info": {
+         *             "complete": false
+         *           },
+         *           "submissions": [
+         *             {
+         *               "complete": false,
+         *               "form_id": "frm_abc123def456"
+         *             }
+         *           ]
+         *         },
          *         "service": {
          *           "appointment_type": "in_person",
          *           "booking_policy": {
@@ -3851,7 +4034,19 @@ interface components {
          *         },
          *         "status": "slot_selected",
          *         "submissions": [],
-         *         "updated_at": "2026-02-22T10:00:00Z"
+         *         "updated_at": "2026-02-22T10:00:00Z",
+         *         "workflow": {
+         *           "available_steps": [
+         *             "booking",
+         *             "info",
+         *             "form:frm_abc123def456"
+         *           ],
+         *           "can_change_slot": true,
+         *           "can_complete": false,
+         *           "defunct_reason": null,
+         *           "is_defunct": false,
+         *           "resume_step": "info"
+         *         }
          *       },
          *       "type": "booking_intent.created"
          *     }
@@ -3900,7 +4095,7 @@ interface components {
          * IntentSubmissionInput
          * @description A form submission entry containing a form ID and response data.
          * @example {
-         *       "form_id": "frm_abc123def456abc123def456",
+         *       "form_id": "frm_abc123def456",
          *       "responses": {
          *         "color": [
          *           "opt_abc"
@@ -4136,6 +4331,19 @@ interface components {
              */
             type: "connected_account.reconnected";
         };
+        /**
+         * BookingIntentBookingPolicy
+         * @description Policy overrides applied to this booking intent.
+         * @example {
+         *       "hold": {
+         *         "duration": "PT10M",
+         *         "enabled": true
+         *       }
+         *     }
+         */
+        BookingIntentBookingPolicy: {
+            hold: components["schemas"]["HoldPolicy"];
+        };
         /**
          * Client
          * @description This is an object representing a client.
@@ -5201,6 +5409,16 @@ interface components {
         UpdateBookingIntentRequest: {
             /** @description When true, automatically assigns an available provider for the selected time slot if no provider_id is specified. */
             auto_assign_provider?: boolean | null;
+            /** @description Policy overrides for this booking intent. When omitted, falls back to the service's policies if service is changing. */
+            booking_policy?: {
+                /** @description Hold policy overrides. */
+                hold?: {
+                    /** @description The duration of the hold as an ISO 8601 duration string. */
+                    duration?: string | null;
+                    /** @description Whether slot holds are enabled. */
+                    enabled?: boolean;
+                } | null;
+            } | null;
             /** @description Progressive client data. Provided fields are merged with existing values. */
             client_data?: {
                 email?: string | null;
@@ -5222,12 +5440,8 @@ interface components {
              * @description The end time of the slot as an ISO-8601 datetime string with a timezone offset.
              */
             end_at?: string | null;
-            /** @description The hold duration as an ISO 8601 duration string (e.g., PT10M). When omitted, falls back to the service's hold policy duration. */
-            hold_duration?: string | null;
-            /** @description Whether to enable slot holding. When omitted, falls back to the service's hold policy if service is changing. */
-            hold_enabled?: boolean | null;
-            /** @description Fields to lock from public API updates. Possible values: service_id, provider_id, start_at, end_at, time_zone, client_data, submissions. Replaces existing locked_fields entirely. */
-            locked_fields?: string[] | null;
+            /** @description Fields to lock from public API updates. Replaces existing locked_fields entirely. */
+            locked_fields?: ("service_id" | "provider_id" | "start_at" | "end_at" | "time_zone" | "client_data" | "submissions")[] | null;
             /** @description Custom metadata key-value pairs. Replaces existing metadata entirely. */
             metadata?: {
                 [key: string]: unknown;
@@ -7155,6 +7369,20 @@ interface components {
          *       "id": "bi_abc123def456abc123def456",
          *       "locked_fields": [],
          *       "object": "public_booking_intent",
+         *       "requirements": {
+         *         "booking": {
+         *           "complete": true
+         *         },
+         *         "info": {
+         *           "complete": false
+         *         },
+         *         "submissions": [
+         *           {
+         *             "complete": false,
+         *             "form_id": "frm_abc123def456"
+         *           }
+         *         ]
+         *       },
          *       "start_at": {
          *         "local": "2026-02-23T10:00:00-05:00",
          *         "object": "zoned_date_time",
@@ -7162,7 +7390,19 @@ interface components {
          *         "unix_ts": 1771945200,
          *         "utc": "2026-02-23T15:00:00Z"
          *       },
-         *       "status": "slot_selected"
+         *       "status": "slot_selected",
+         *       "workflow": {
+         *         "available_steps": [
+         *           "booking",
+         *           "info",
+         *           "form:frm_abc123def456"
+         *         ],
+         *         "can_change_slot": true,
+         *         "can_complete": false,
+         *         "defunct_reason": null,
+         *         "is_defunct": false,
+         *         "resume_step": "info"
+         *       }
          *     }
          */
         PublicBookingIntent: {
@@ -7179,20 +7419,22 @@ interface components {
             hold_until?: string | null;
             /** @description The booking intent ID */
             id: string;
-            /** @description Fields that are locked and cannot be updated via the public API. Possible values: service_id, provider_id, start_at, end_at, time_zone, client_data, submissions. */
-            locked_fields?: string[];
+            /** @description Fields that are locked and cannot be updated via the public API. */
+            locked_fields?: ("service_id" | "provider_id" | "start_at" | "end_at" | "time_zone" | "client_data" | "submissions")[];
             /**
              * @description The object type
              * @enum {string}
              */
             object: "public_booking_intent";
+            requirements?: components["schemas"]["BookingIntentRequirements"];
             /** @description The start time of the selected slot */
             start_at?: components["schemas"]["ZonedDateTime"] | null;
             /**
-             * @description The current status of the booking intent
+             * @description The current status of the booking intent. Automatically transitions from pending to slot_selected when provider_id, start_at, end_at, and time_zone are all present (on create or update).
              * @enum {string}
              */
             status: "pending" | "slot_selected" | "completed" | "abandoned";
+            workflow?: components["schemas"]["BookingIntentWorkflow"];
         };
         /**
          * ServiceForm
@@ -7674,6 +7916,20 @@ interface components {
              */
             type: "short_text" | "long_text" | "email" | "phone" | "boolean" | "radio" | "select" | "checkbox";
         };
+        /**
+         * SubmissionRequirement
+         * @description Completeness status for a single form submission.
+         * @example {
+         *       "complete": false,
+         *       "form_id": "frm_abc123def456"
+         *     }
+         */
+        SubmissionRequirement: {
+            /** @description Whether the submission exists and all required fields have been answered. */
+            complete: boolean;
+            /** @description The form's object ID. */
+            form_id: string;
+        };
         /**
          * PublicBookingIntentResponse
          * @description Response schema for a single booking intent via a public interface.
@@ -7692,6 +7948,20 @@ interface components {
          *         "id": "bi_abc123def456abc123def456",
          *         "locked_fields": [],
          *         "object": "public_booking_intent",
+         *         "requirements": {
+         *           "booking": {
+         *             "complete": true
+         *           },
+         *           "info": {
+         *             "complete": false
+         *           },
+         *           "submissions": [
+         *             {
+         *               "complete": false,
+         *               "form_id": "frm_abc123def456"
+         *             }
+         *           ]
+         *         },
          *         "start_at": {
          *           "local": "2026-02-23T10:00:00-05:00",
          *           "object": "zoned_date_time",
@@ -7699,7 +7969,19 @@ interface components {
          *           "unix_ts": 1771945200,
          *           "utc": "2026-02-23T15:00:00Z"
          *         },
-         *         "status": "slot_selected"
+         *         "status": "slot_selected",
+         *         "workflow": {
+         *           "available_steps": [
+         *             "booking",
+         *             "info",
+         *             "form:frm_abc123def456"
+         *           ],
+         *           "can_change_slot": true,
+         *           "can_complete": false,
+         *           "defunct_reason": null,
+         *           "is_defunct": false,
+         *           "resume_step": "info"
+         *         }
          *       }
          *     }
          */
@@ -8297,6 +8579,12 @@ interface components {
          *       "data": {
          *         "abandoned_at": null,
          *         "appointment": null,
+         *         "booking_policy": {
+         *           "hold": {
+         *             "duration": "PT10M",
+         *             "enabled": true
+         *           }
+         *         },
          *         "client": null,
          *         "client_data": {
          *           "email": "jane@example.com",
@@ -8317,8 +8605,6 @@ interface components {
          *           "utc": "2026-02-23T15:30:00Z"
          *         },
          *         "errors": null,
-         *         "hold_duration": "PT10M",
-         *         "hold_enabled": true,
          *         "hold_until": "2026-02-22T10:10:00Z",
          *         "id": "bi_abc123def456abc123def456",
          *         "locked_fields": [
@@ -8343,6 +8629,20 @@ interface components {
          *           "object": "provider",
          *           "updated_at": "2017-09-13T10:11:12Z"
          *         },
+         *         "requirements": {
+         *           "booking": {
+         *             "complete": true
+         *           },
+         *           "info": {
+         *             "complete": false
+         *           },
+         *           "submissions": [
+         *             {
+         *               "complete": false,
+         *               "form_id": "frm_abc123def456"
+         *             }
+         *           ]
+         *         },
          *         "service": {
          *           "appointment_type": "in_person",
          *           "booking_policy": {
@@ -8435,7 +8735,19 @@ interface components {
          *         },
          *         "status": "slot_selected",
          *         "submissions": [],
-         *         "updated_at": "2026-02-22T10:00:00Z"
+         *         "updated_at": "2026-02-22T10:00:00Z",
+         *         "workflow": {
+         *           "available_steps": [
+         *             "booking",
+         *             "info",
+         *             "form:frm_abc123def456"
+         *           ],
+         *           "can_change_slot": true,
+         *           "can_complete": false,
+         *           "defunct_reason": null,
+         *           "is_defunct": false,
+         *           "resume_step": "info"
+         *         }
          *       }
          *     }
          */
@@ -9335,6 +9647,41 @@ interface components {
                 reschedule: string[];
             };
         };
+        /**
+         * BookingIntentWorkflow
+         * @description Server-computed workflow state for a booking intent. Provides step routing,
+         *     completability, and defunct state so the frontend can render the correct
+         *     booking flow without inferring these from raw fields.
+         * @example {
+         *       "available_steps": [
+         *         "booking",
+         *         "info",
+         *         "form:frm_abc123def456"
+         *       ],
+         *       "can_change_slot": true,
+         *       "can_complete": false,
+         *       "defunct_reason": null,
+         *       "is_defunct": false,
+         *       "resume_step": "info"
+         *     }
+         */
+        BookingIntentWorkflow: {
+            /** @description Ordered list of steps the user can visit. Computed from service forms and locked_fields. */
+            available_steps: string[];
+            /** @description Whether slot fields (start_at, end_at, time_zone) are unlocked and can be modified. */
+            can_change_slot: boolean;
+            /** @description Whether the intent has enough valid data to submit right now. When true, calling the complete endpoint will succeed regardless of whether the current status is pending or slot_selected. */
+            can_complete: boolean;
+            /**
+             * @description Why the intent is defunct. Null when not defunct.
+             * @enum {string|null}
+             */
+            defunct_reason?: "abandoned" | "no_available_steps" | "status_invalid" | null;
+            /** @description Whether the intent is in an unrecoverable state and should render a terminal UI. */
+            is_defunct: boolean;
+            /** @description The step the UI should show on load or resume. One of: booking, info, form:<form_id>, confirmed, defunct. */
+            resume_step: string;
+        };
         /**
          * ProviderDeactivatedEventData
          * @description This is an object representing data for the provider deactivated event.
@@ -9725,6 +10072,12 @@ interface components {
          * @example {
          *       "abandoned_at": null,
          *       "appointment": null,
+         *       "booking_policy": {
+         *         "hold": {
+         *           "duration": "PT10M",
+         *           "enabled": true
+         *         }
+         *       },
          *       "client": null,
          *       "client_data": {
          *         "email": "jane@example.com",
@@ -9745,8 +10098,6 @@ interface components {
          *         "utc": "2026-02-23T15:30:00Z"
          *       },
          *       "errors": null,
-         *       "hold_duration": "PT10M",
-         *       "hold_enabled": true,
          *       "hold_until": "2026-02-22T10:10:00Z",
          *       "id": "bi_abc123def456abc123def456",
          *       "locked_fields": [
@@ -9771,6 +10122,20 @@ interface components {
          *         "object": "provider",
          *         "updated_at": "2017-09-13T10:11:12Z"
          *       },
+         *       "requirements": {
+         *         "booking": {
+         *           "complete": true
+         *         },
+         *         "info": {
+         *           "complete": false
+         *         },
+         *         "submissions": [
+         *           {
+         *             "complete": false,
+         *             "form_id": "frm_abc123def456"
+         *           }
+         *         ]
+         *       },
          *       "service": {
          *         "appointment_type": "in_person",
          *         "booking_policy": {
@@ -9863,7 +10228,19 @@ interface components {
          *       },
          *       "status": "slot_selected",
          *       "submissions": [],
-         *       "updated_at": "2026-02-22T10:00:00Z"
+         *       "updated_at": "2026-02-22T10:00:00Z",
+         *       "workflow": {
+         *         "available_steps": [
+         *           "booking",
+         *           "info",
+         *           "form:frm_abc123def456"
+         *         ],
+         *         "can_change_slot": true,
+         *         "can_complete": false,
+         *         "defunct_reason": null,
+         *         "is_defunct": false,
+         *         "resume_step": "info"
+         *       }
          *     }
          */
         BookingIntent: {
@@ -9874,6 +10251,7 @@ interface components {
             abandoned_at?: string | null;
             /** @description The created appointment. Present when status is completed. */
             appointment?: components["schemas"]["Appointment"] | null;
+            booking_policy: components["schemas"]["BookingIntentBookingPolicy"];
             /** @description The linked client */
             client?: components["schemas"]["Client"] | null;
             /** @description Client data accumulated during the booking flow. Sensitive fields (first_name, last_name, email, phone) are redacted unless include_sensitive is true. */
@@ -9900,10 +10278,6 @@ interface components {
             end_at?: components["schemas"]["ZonedDateTime"] | null;
             /** @description Validation errors for data provided so far. Fields not yet submitted are not flagged. Null when not computed. */
             errors?: components["schemas"]["JsonError"][] | null;
-            /** @description The hold duration as an ISO 8601 duration string (e.g., PT10M) */
-            hold_duration?: string | null;
-            /** @description Whether slot holding is enabled */
-            hold_enabled: boolean;
             /**
              * Format: date-time
              * @description When the hold expires (UTC)
@@ -9911,8 +10285,8 @@ interface components {
             hold_until?: string | null;
             /** @description The booking intent ID */
             id: string;
-            /** @description Fields that are locked and cannot be updated via the public API. Possible values: service_id, provider_id, start_at, end_at, time_zone, client_data, submissions. */
-            locked_fields?: string[];
+            /** @description Fields that are locked and cannot be updated via the public API. */
+            locked_fields?: ("service_id" | "provider_id" | "start_at" | "end_at" | "time_zone" | "client_data" | "submissions")[];
             /** @description Custom metadata key-value pairs */
             metadata?: {
                 [key: string]: unknown;
@@ -9924,6 +10298,8 @@ interface components {
             object: "booking_intent";
             /** @description The assigned provider */
             provider?: components["schemas"]["Provider"] | null;
+            /** @description Per-section completeness status. Present on single-intent responses, null on list responses. */
+            requirements?: components["schemas"]["BookingIntentRequirements"] | null;
             /** @description The selected service */
             service?: components["schemas"]["Service"] | null;
             /** @description Whether the slot has been prevalidated. When true, public completion skips slot validation. */
@@ -9931,7 +10307,7 @@ interface components {
             /** @description The start time of the selected slot */
             start_at?: components["schemas"]["ZonedDateTime"] | null;
             /**
-             * @description The current status of the booking intent
+             * @description The current status of the booking intent. Automatically transitions from pending to slot_selected when provider_id, start_at, end_at, and time_zone are all present (on create or update).
              * @enum {string}
              */
             status: "pending" | "slot_selected" | "completed" | "abandoned";
@@ -9942,6 +10318,8 @@ interface components {
              * @description When the intent was last updated
              */
             updated_at: string;
+            /** @description Server-computed workflow state. Present on single-intent responses, null on list responses. */
+            workflow?: components["schemas"]["BookingIntentWorkflow"] | null;
         };
         /**
          * CreateServiceRequest
@@ -15014,11 +15392,14 @@ type BlocksResponse = Schemas["BlocksResponse"];
 type BlockUpdatedEventData = Schemas["BlockUpdatedEventData"];
 type BookingIntent = Schemas["BookingIntent"];
 type BookingIntentAbandonedEventData = Schemas["BookingIntentAbandonedEventData"];
+type BookingIntentBookingPolicy = Schemas["BookingIntentBookingPolicy"];
 type BookingIntentCompletedEventData = Schemas["BookingIntentCompletedEventData"];
 type BookingIntentCreatedEventData = Schemas["BookingIntentCreatedEventData"];
+type BookingIntentRequirements = Schemas["BookingIntentRequirements"];
 type BookingIntentResponse = Schemas["BookingIntentResponse"];
 type BookingIntentsResponse = Schemas["BookingIntentsResponse"];
 type BookingIntentUpdatedEventData = Schemas["BookingIntentUpdatedEventData"];
+type BookingIntentWorkflow = Schemas["BookingIntentWorkflow"];
 type BookingPolicy = Schemas["BookingPolicy"];
 type CancelAppointmentRequest = Schemas["CancelAppointmentRequest"];
 type CancellationEvent = Schemas["CancellationEvent"];
@@ -15136,6 +15517,7 @@ type ServiceUpdatedEventData = Schemas["ServiceUpdatedEventData"];
 type Slot = Schemas["Slot"];
 type SlotRule = Schemas["SlotRule"];
 type SortServiceFormsRequest = Schemas["SortServiceFormsRequest"];
+type SubmissionRequirement = Schemas["SubmissionRequirement"];
 type UnauthorizedResponse = Schemas["UnauthorizedResponse"];
 type UpdateAccountRequest = Schemas["UpdateAccountRequest"];
 type UpdateAccountUserRequest = Schemas["UpdateAccountUserRequest"];
@@ -15967,6 +16349,12 @@ declare function createBookingIntent(client: FetchClient, body: RequestBody<"/v1
 }, {
     body: {
         auto_assign_provider?: boolean | null;
+        booking_policy?: {
+            hold?: {
+                duration?: string | null;
+                enabled?: boolean;
+            } | null;
+        } | null;
         client_data?: {
             email?: string | null;
             fields?: {
@@ -15981,9 +16369,7 @@ declare function createBookingIntent(client: FetchClient, body: RequestBody<"/v1
         } | null;
         client_id?: string | null;
         end_at?: string | null;
-        hold_duration?: string | null;
-        hold_enabled?: boolean | null;
-        locked_fields?: string[] | null;
+        locked_fields?: ("service_id" | "provider_id" | "start_at" | "end_at" | "time_zone" | "client_data" | "submissions")[] | null;
         metadata?: {
             [key: string]: unknown;
         } | null;
@@ -19515,6 +19901,12 @@ declare function updateBookingIntent(client: FetchClient, path: PathParams<"/v1/
 }, {
     body: {
         auto_assign_provider?: boolean | null;
+        booking_policy?: {
+            hold?: {
+                duration?: string | null;
+                enabled?: boolean;
+            } | null;
+        } | null;
         client_data?: {
             email?: string | null;
             fields?: {
@@ -19529,9 +19921,7 @@ declare function updateBookingIntent(client: FetchClient, path: PathParams<"/v1/
         } | null;
         client_id?: string | null;
         end_at?: string | null;
-        hold_duration?: string | null;
-        hold_enabled?: boolean | null;
-        locked_fields?: string[] | null;
+        locked_fields?: ("service_id" | "provider_id" | "start_at" | "end_at" | "time_zone" | "client_data" | "submissions")[] | null;
         metadata?: {
             [key: string]: unknown;
         } | null;
@@ -20123,4 +20513,4 @@ declare function updateService(client: FetchClient, path: PathParams<"/v1/servic
     };
 }, `${string}/${string}`>>;
 
-export { type Account, type AccountEvent, type AccountResponse, type AccountUser, type AccountUserCreatedEventData, type AccountUserDeletedEventData, type AccountUserResponse, type AccountUserUpdatedEventData, type AccountUsersResponse, type AccountsResponse, type AdvanceNoticePolicy, type AggregatedSlot, type Appointment, type AppointmentCanceledEventData, type AppointmentConfirmedEventData, type AppointmentCreatedEventData, type AppointmentDeletedEventData, type AppointmentRescheduledEventData, type AppointmentResponse, type AppointmentsResponse, type AttachServiceFormRequest, type Block, type BlockCreatedEventData, type BlockDeletedEventData, type BlockResponse, type BlockUpdatedEventData, type BlocksResponse, type BookingIntent, type BookingIntentAbandonedEventData, type BookingIntentCompletedEventData, type BookingIntentCreatedEventData, type BookingIntentResponse, type BookingIntentUpdatedEventData, type BookingIntentsResponse, type BookingPolicy, type CancelAppointmentRequest, type CancelPublicAppointmentRequest, type CancellationEvent, type CancellationPolicy, type CancellationReason, type CancellationReasonResponse, type CancellationReasonsResponse, type Client, type ClientCreatedEventData, type ClientDeletedEventData, type ClientField, type ClientFieldChoice, type ClientFieldOptions, type ClientFieldResponse, type ClientFieldsResponse, type ClientResponse, type ClientUpdatedEventData, type ClientsResponse, type CompleteBookingIntentRequest, type CompletePublicBookingIntentRequest, type ConfirmAppointmentRequest, type ConfirmationEvent, type ConnectedAccount, type ConnectedAccountCreatedEventData, type ConnectedAccountDeletedEventData, type ConnectedAccountReconnectedEventData, type ConnectedAccountRefreshFailedEventData, type ConnectedAccountResponse, type ConnectedAccountsResponse, type CreateAccountRequest, type CreateAccountUserRequest, type CreateAppointmentRequest, type CreateBlockRequest, type CreateBookingIntentRequest, type CreateCancellationReasonRequest, type CreateClientFieldRequest, type CreateClientRequest, type CreateDashboardSessionRequest, type CreateFormRequest, type CreateProviderRequest, type CreateProviderScheduleRequest, type CreatePublicAppointmentRequest, type CreatePublicBookingIntentRequest, type CreateServiceProviderRequest, type CreateServiceRequest, type DashboardSession, type DashboardSessionResponse, type FetchClient, type FetchClientOptions, type FieldChoice, type FieldChoiceInput, type FieldOptions, type FieldOptionsInput, type ForbiddenResponse, type Form, type FormDetail, type FormField, type FormFieldInput, type FormResponse, type FormsResponse, type GenericErrorResponse, type HoldPolicy, type IntentSubmissionInput, type JsonError, type JsonErrorResponse, type MaximizeUtilizationPolicy, type NotFoundResponse, type PaginationMeta, type PathParams, type Platform, type PlatformResponse, type Provider, type ProviderCreatedEventData, type ProviderDeactivatedEventData, type ProviderNotificationConfig, type ProviderNotificationType, type ProviderReactivatedEventData, type ProviderResponse, type ProviderSchedule, type ProviderScheduleCreatedEventData, type ProviderScheduleDeletedEventData, type ProviderScheduleResponse, type ProviderScheduleUpdatedEventData, type ProviderSchedulesResponse, type ProviderUpdatedEventData, type ProvidersResponse, type PublicAppointment, type PublicAppointmentResponse, type PublicBookingIntent, type PublicBookingIntentResponse, type PublicCancellationReason, type PublicCancellationReasonsResponse, type PublicServiceEarliestSlotResponse, type PublicServiceSlotsResponse, type QueryParams, type RecurrenceRule, type RequestBody, type RescheduleAppointmentRequest, type RescheduleEvent, type ReschedulePublicAppointmentRequest, type ReschedulingPolicy, type Role, type RolesResponse, type Service, type ServiceCreatedEventData, type ServiceDeletedEventData, type ServiceForm, type ServiceFormResponse, type ServiceFormsResponse, type ServiceProvider, type ServiceProviderCreatedEventData, type ServiceProviderDeletedEventData, type ServiceProviderResponse, type ServiceProvidersResponse, type ServiceResponse, type ServiceSlotResponse, type ServiceUpdatedEventData, type ServicesResponse, type Slot, type SlotRule, type SortServiceFormsRequest, type UnauthorizedResponse, type UpdateAccountRequest, type UpdateAccountUserRequest, type UpdateBlockRequest, type UpdateBookingIntentRequest, type UpdateCancellationReasonRequest, type UpdateClientFieldRequest, type UpdateClientRequest, type UpdateConnectedAccountRequest, type UpdateFormRequest, type UpdateProviderRequest, type UpdateProviderScheduleRequest, type UpdatePublicBookingIntentRequest, type UpdateServiceRequest, type User, type WeeklyRule, type ZonedDateTime, abandonBookingIntent, abandonPublicBookingIntent, attachServiceForm, cancelAppointment, cancelPublicAppointment, completeBookingIntent, completePublicBookingIntent, confirmAppointment, createAccount, createAccountUser, createAppointment, createBlock, createBookingIntent, createCancellationReason, createClient, createClientField, createDashboardSession, createFetchClient, createForm, createProvider, createProviderSchedule, createPublicAppointment, createPublicBookingIntent, createService, createServiceProvider, deactivateProvider, deleteBlock, deleteCancellationReason, deleteClient, deleteClientField, deleteConnectedAccount, deleteForm, deleteProviderSchedule, deleteService, deleteServiceProvider, detachServiceForm, getAccountById, getAppointment, getBlock, getBookingIntent, getCancellationReason, getClient, getClientField, getConnectedAccount, getCurrentAccount, getCurrentAccountUser, getCurrentPlatform, getEarliestPublicServiceSlot, getForm, getProvider, getProviderSchedule, getPublicAppointment, getPublicBookingIntent, getService, listAccountUsers, listAccounts, listAppointments, listBlocks, listBookingIntents, listCancellationReasons, listClientFields, listClients, listConnectedAccounts, listForms, listProviderSchedules, listProviders, listPublicCancellationReasons, listPublicServiceSlots, listRoles, listServiceForms, listServiceProviders, listServiceSlots, listServices, type paths, rescheduleAppointment, reschedulePublicAppointment, sortServiceForms, updateAccount, updateAccountUser, updateBlock, updateBookingIntent, updateCancellationReason, updateClient, updateClientField, updateConnectedAccount, updateForm, updateProvider, updateProviderSchedule, updatePublicBookingIntent, updateService };
+export { type Account, type AccountEvent, type AccountResponse, type AccountUser, type AccountUserCreatedEventData, type AccountUserDeletedEventData, type AccountUserResponse, type AccountUserUpdatedEventData, type AccountUsersResponse, type AccountsResponse, type AdvanceNoticePolicy, type AggregatedSlot, type Appointment, type AppointmentCanceledEventData, type AppointmentConfirmedEventData, type AppointmentCreatedEventData, type AppointmentDeletedEventData, type AppointmentRescheduledEventData, type AppointmentResponse, type AppointmentsResponse, type AttachServiceFormRequest, type Block, type BlockCreatedEventData, type BlockDeletedEventData, type BlockResponse, type BlockUpdatedEventData, type BlocksResponse, type BookingIntent, type BookingIntentAbandonedEventData, type BookingIntentBookingPolicy, type BookingIntentCompletedEventData, type BookingIntentCreatedEventData, type BookingIntentRequirements, type BookingIntentResponse, type BookingIntentUpdatedEventData, type BookingIntentWorkflow, type BookingIntentsResponse, type BookingPolicy, type CancelAppointmentRequest, type CancelPublicAppointmentRequest, type CancellationEvent, type CancellationPolicy, type CancellationReason, type CancellationReasonResponse, type CancellationReasonsResponse, type Client, type ClientCreatedEventData, type ClientDeletedEventData, type ClientField, type ClientFieldChoice, type ClientFieldOptions, type ClientFieldResponse, type ClientFieldsResponse, type ClientResponse, type ClientUpdatedEventData, type ClientsResponse, type CompleteBookingIntentRequest, type CompletePublicBookingIntentRequest, type ConfirmAppointmentRequest, type ConfirmationEvent, type ConnectedAccount, type ConnectedAccountCreatedEventData, type ConnectedAccountDeletedEventData, type ConnectedAccountReconnectedEventData, type ConnectedAccountRefreshFailedEventData, type ConnectedAccountResponse, type ConnectedAccountsResponse, type CreateAccountRequest, type CreateAccountUserRequest, type CreateAppointmentRequest, type CreateBlockRequest, type CreateBookingIntentRequest, type CreateCancellationReasonRequest, type CreateClientFieldRequest, type CreateClientRequest, type CreateDashboardSessionRequest, type CreateFormRequest, type CreateProviderRequest, type CreateProviderScheduleRequest, type CreatePublicAppointmentRequest, type CreatePublicBookingIntentRequest, type CreateServiceProviderRequest, type CreateServiceRequest, type DashboardSession, type DashboardSessionResponse, type FetchClient, type FetchClientOptions, type FieldChoice, type FieldChoiceInput, type FieldOptions, type FieldOptionsInput, type ForbiddenResponse, type Form, type FormDetail, type FormField, type FormFieldInput, type FormResponse, type FormsResponse, type GenericErrorResponse, type HoldPolicy, type IntentSubmissionInput, type JsonError, type JsonErrorResponse, type MaximizeUtilizationPolicy, type NotFoundResponse, type PaginationMeta, type PathParams, type Platform, type PlatformResponse, type Provider, type ProviderCreatedEventData, type ProviderDeactivatedEventData, type ProviderNotificationConfig, type ProviderNotificationType, type ProviderReactivatedEventData, type ProviderResponse, type ProviderSchedule, type ProviderScheduleCreatedEventData, type ProviderScheduleDeletedEventData, type ProviderScheduleResponse, type ProviderScheduleUpdatedEventData, type ProviderSchedulesResponse, type ProviderUpdatedEventData, type ProvidersResponse, type PublicAppointment, type PublicAppointmentResponse, type PublicBookingIntent, type PublicBookingIntentResponse, type PublicCancellationReason, type PublicCancellationReasonsResponse, type PublicServiceEarliestSlotResponse, type PublicServiceSlotsResponse, type QueryParams, type RecurrenceRule, type RequestBody, type RescheduleAppointmentRequest, type RescheduleEvent, type ReschedulePublicAppointmentRequest, type ReschedulingPolicy, type Role, type RolesResponse, type Service, type ServiceCreatedEventData, type ServiceDeletedEventData, type ServiceForm, type ServiceFormResponse, type ServiceFormsResponse, type ServiceProvider, type ServiceProviderCreatedEventData, type ServiceProviderDeletedEventData, type ServiceProviderResponse, type ServiceProvidersResponse, type ServiceResponse, type ServiceSlotResponse, type ServiceUpdatedEventData, type ServicesResponse, type Slot, type SlotRule, type SortServiceFormsRequest, type SubmissionRequirement, type UnauthorizedResponse, type UpdateAccountRequest, type UpdateAccountUserRequest, type UpdateBlockRequest, type UpdateBookingIntentRequest, type UpdateCancellationReasonRequest, type UpdateClientFieldRequest, type UpdateClientRequest, type UpdateConnectedAccountRequest, type UpdateFormRequest, type UpdateProviderRequest, type UpdateProviderScheduleRequest, type UpdatePublicBookingIntentRequest, type UpdateServiceRequest, type User, type WeeklyRule, type ZonedDateTime, abandonBookingIntent, abandonPublicBookingIntent, attachServiceForm, cancelAppointment, cancelPublicAppointment, completeBookingIntent, completePublicBookingIntent, confirmAppointment, createAccount, createAccountUser, createAppointment, createBlock, createBookingIntent, createCancellationReason, createClient, createClientField, createDashboardSession, createFetchClient, createForm, createProvider, createProviderSchedule, createPublicAppointment, createPublicBookingIntent, createService, createServiceProvider, deactivateProvider, deleteBlock, deleteCancellationReason, deleteClient, deleteClientField, deleteConnectedAccount, deleteForm, deleteProviderSchedule, deleteService, deleteServiceProvider, detachServiceForm, getAccountById, getAppointment, getBlock, getBookingIntent, getCancellationReason, getClient, getClientField, getConnectedAccount, getCurrentAccount, getCurrentAccountUser, getCurrentPlatform, getEarliestPublicServiceSlot, getForm, getProvider, getProviderSchedule, getPublicAppointment, getPublicBookingIntent, getService, listAccountUsers, listAccounts, listAppointments, listBlocks, listBookingIntents, listCancellationReasons, listClientFields, listClients, listConnectedAccounts, listForms, listProviderSchedules, listProviders, listPublicCancellationReasons, listPublicServiceSlots, listRoles, listServiceForms, listServiceProviders, listServiceSlots, listServices, type paths, rescheduleAppointment, reschedulePublicAppointment, sortServiceForms, updateAccount, updateAccountUser, updateBlock, updateBookingIntent, updateCancellationReason, updateClient, updateClientField, updateConnectedAccount, updateForm, updateProvider, updateProviderSchedule, updatePublicBookingIntent, updateService };