{"openapi":"3.1.0","info":{"title":"DayTidy public guest API","version":"1.1.0","description":"Use the advertised x-daytidy-site.routes URLs. Guest operations are scoped to a single request and use HTTPS without OAuth, client registration or a callback."},"paths":{"\/guest\/openapi":{"get":{"operationId":"describeGuestBooking","security":[],"responses":{"200":{"description":"Current outcome","headers":{"Cache-Control":{"schema":{"const":"no-store"}},"X-Request-Id":{"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}}},"content":{"application\/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request","headers":{"Cache-Control":{"schema":{"const":"no-store"}},"X-Request-Id":{"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}}},"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Error"}}}},"403":{"description":"Guest bookings are unavailable","headers":{"Cache-Control":{"schema":{"const":"no-store"}},"X-Request-Id":{"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}}},"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Error"}}}},"405":{"description":"Method unavailable","headers":{"Cache-Control":{"schema":{"const":"no-store"}},"X-Request-Id":{"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}}},"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Error"}}}},"429":{"description":"Request limit exceeded","headers":{"Cache-Control":{"schema":{"const":"no-store"}},"X-Request-Id":{"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Error"}}}},"503":{"description":"Temporarily unavailable","headers":{"Cache-Control":{"schema":{"const":"no-store"}},"X-Request-Id":{"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}}},"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Error"}}}}}}},"\/guest\/quotes":{"post":{"operationId":"createGuestQuote","security":[],"responses":{"200":{"description":"Current outcome","headers":{"Cache-Control":{"schema":{"const":"no-store"}},"X-Request-Id":{"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}}},"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/GuestQuote"}}}},"400":{"description":"Invalid request","headers":{"Cache-Control":{"schema":{"const":"no-store"}},"X-Request-Id":{"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}}},"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Error"}}}},"403":{"description":"Guest bookings are unavailable","headers":{"Cache-Control":{"schema":{"const":"no-store"}},"X-Request-Id":{"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}}},"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Error"}}}},"405":{"description":"Method unavailable","headers":{"Cache-Control":{"schema":{"const":"no-store"}},"X-Request-Id":{"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}}},"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Error"}}}},"429":{"description":"Request limit exceeded","headers":{"Cache-Control":{"schema":{"const":"no-store"}},"X-Request-Id":{"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Error"}}}},"503":{"description":"Temporarily unavailable","headers":{"Cache-Control":{"schema":{"const":"no-store"}},"X-Request-Id":{"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}}},"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Error"}}}},"413":{"description":"Request exceeds the byte limit","headers":{"Cache-Control":{"schema":{"const":"no-store"}},"X-Request-Id":{"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}}},"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Error"}}}},"415":{"description":"Expected an application\/json body","headers":{"Cache-Control":{"schema":{"const":"no-store"}},"X-Request-Id":{"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}}},"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Error"}}}},"404":{"description":"Unknown operation or capability","headers":{"Cache-Control":{"schema":{"const":"no-store"}},"X-Request-Id":{"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}}},"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Error"}}}},"409":{"description":"Booking conflict","headers":{"Cache-Control":{"schema":{"const":"no-store"}},"X-Request-Id":{"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}}},"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Error"}}}}},"requestBody":{"required":true,"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/QuoteSelection"}}}}}},"\/guest\/bookings":{"post":{"operationId":"createGuestBooking","security":[{"GuestCapability":[]}],"responses":{"200":{"description":"Current outcome","headers":{"Cache-Control":{"schema":{"const":"no-store"}},"X-Request-Id":{"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}}},"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Operation"}}}},"202":{"description":"Additional input or processing required","headers":{"Cache-Control":{"schema":{"const":"no-store"}},"X-Request-Id":{"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Operation"}}}},"400":{"description":"Invalid request","headers":{"Cache-Control":{"schema":{"const":"no-store"}},"X-Request-Id":{"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}}},"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Error"}}}},"403":{"description":"Guest bookings are unavailable","headers":{"Cache-Control":{"schema":{"const":"no-store"}},"X-Request-Id":{"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}}},"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Error"}}}},"405":{"description":"Method unavailable","headers":{"Cache-Control":{"schema":{"const":"no-store"}},"X-Request-Id":{"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}}},"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Error"}}}},"429":{"description":"Request limit exceeded","headers":{"Cache-Control":{"schema":{"const":"no-store"}},"X-Request-Id":{"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Error"}}}},"503":{"description":"Temporarily unavailable","headers":{"Cache-Control":{"schema":{"const":"no-store"}},"X-Request-Id":{"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}}},"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Error"}}}},"413":{"description":"Request exceeds the byte limit","headers":{"Cache-Control":{"schema":{"const":"no-store"}},"X-Request-Id":{"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}}},"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Error"}}}},"415":{"description":"Expected an application\/json body","headers":{"Cache-Control":{"schema":{"const":"no-store"}},"X-Request-Id":{"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}}},"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Error"}}}},"404":{"description":"Unknown operation or capability","headers":{"Cache-Control":{"schema":{"const":"no-store"}},"X-Request-Id":{"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}}},"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Error"}}}},"409":{"description":"Booking conflict","headers":{"Cache-Control":{"schema":{"const":"no-store"}},"X-Request-Id":{"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}}},"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Error"}}}},"410":{"description":"Quote or capability expired","headers":{"Cache-Control":{"schema":{"const":"no-store"}},"X-Request-Id":{"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}}},"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Error"}}}},"422":{"description":"Verification or booking requirements could not be satisfied","headers":{"Cache-Control":{"schema":{"const":"no-store"}},"X-Request-Id":{"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}}},"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Error"}}}}},"parameters":[{"$ref":"#\/components\/parameters\/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/CreateGuestBooking"}}}}}},"\/guest\/operations\/{operation_id}":{"get":{"operationId":"getGuestOperation","security":[{"GuestCapability":[]}],"responses":{"200":{"description":"Current outcome","headers":{"Cache-Control":{"schema":{"const":"no-store"}},"X-Request-Id":{"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Operation"}}}},"400":{"description":"Invalid request","headers":{"Cache-Control":{"schema":{"const":"no-store"}},"X-Request-Id":{"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}}},"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Error"}}}},"403":{"description":"Guest bookings are unavailable","headers":{"Cache-Control":{"schema":{"const":"no-store"}},"X-Request-Id":{"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}}},"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Error"}}}},"405":{"description":"Method unavailable","headers":{"Cache-Control":{"schema":{"const":"no-store"}},"X-Request-Id":{"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}}},"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Error"}}}},"429":{"description":"Request limit exceeded","headers":{"Cache-Control":{"schema":{"const":"no-store"}},"X-Request-Id":{"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Error"}}}},"503":{"description":"Temporarily unavailable","headers":{"Cache-Control":{"schema":{"const":"no-store"}},"X-Request-Id":{"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}}},"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Error"}}}},"404":{"description":"Unknown operation or capability","headers":{"Cache-Control":{"schema":{"const":"no-store"}},"X-Request-Id":{"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}}},"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Error"}}}},"410":{"description":"Quote or capability expired","headers":{"Cache-Control":{"schema":{"const":"no-store"}},"X-Request-Id":{"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}}},"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Error"}}}}},"parameters":[{"$ref":"#\/components\/parameters\/OperationId"}]}},"\/guest\/operations\/{operation_id}\/continue":{"post":{"operationId":"continueGuestBooking","description":"Submit the booking-specific verification code, request a resend, or send an empty object to resume a ready or provisioning operation. New-account provisioning can hold capacity for up to five minutes after verification and returns processing until ownership is finalized. For Stripe, submit a quote-bound payment credential after email verification. Empty JSON requests obtain an HTTP Payment challenge before authorization and reconcile the original attempt after submission.","security":[{"GuestCapability":[]}],"responses":{"200":{"description":"Current outcome","headers":{"Cache-Control":{"schema":{"const":"no-store"}},"X-Request-Id":{"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"Retry-After":{"schema":{"type":"integer","minimum":1}},"Payment-Receipt":{"schema":{"type":"string"},"description":"MPP receipt after authoritative Stripe settlement."}},"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Operation"}}}},"202":{"description":"Additional input or processing required","headers":{"Cache-Control":{"schema":{"const":"no-store"}},"X-Request-Id":{"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Operation"}}}},"400":{"description":"Invalid request","headers":{"Cache-Control":{"schema":{"const":"no-store"}},"X-Request-Id":{"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}}},"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Error"}}}},"403":{"description":"Guest bookings are unavailable","headers":{"Cache-Control":{"schema":{"const":"no-store"}},"X-Request-Id":{"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}}},"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Error"}}}},"405":{"description":"Method unavailable","headers":{"Cache-Control":{"schema":{"const":"no-store"}},"X-Request-Id":{"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}}},"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Error"}}}},"429":{"description":"Request limit exceeded","headers":{"Cache-Control":{"schema":{"const":"no-store"}},"X-Request-Id":{"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Error"}}}},"503":{"description":"Temporarily unavailable","headers":{"Cache-Control":{"schema":{"const":"no-store"}},"X-Request-Id":{"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}}},"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Error"}}}},"413":{"description":"Request exceeds the byte limit","headers":{"Cache-Control":{"schema":{"const":"no-store"}},"X-Request-Id":{"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}}},"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Error"}}}},"415":{"description":"Expected an application\/json body","headers":{"Cache-Control":{"schema":{"const":"no-store"}},"X-Request-Id":{"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}}},"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Error"}}}},"404":{"description":"Unknown operation or capability","headers":{"Cache-Control":{"schema":{"const":"no-store"}},"X-Request-Id":{"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}}},"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Error"}}}},"409":{"description":"Booking conflict","headers":{"Cache-Control":{"schema":{"const":"no-store"}},"X-Request-Id":{"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}}},"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Error"}}}},"410":{"description":"Quote or capability expired","headers":{"Cache-Control":{"schema":{"const":"no-store"}},"X-Request-Id":{"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}}},"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Error"}}}},"422":{"description":"Verification or booking requirements could not be satisfied","headers":{"Cache-Control":{"schema":{"const":"no-store"}},"X-Request-Id":{"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}}},"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Error"}}}},"402":{"description":"Stripe authorization required. The body is the same operation available over A2A.","headers":{"Cache-Control":{"schema":{"const":"no-store"}},"X-Request-Id":{"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"Retry-After":{"schema":{"type":"integer","minimum":1}},"WWW-Authenticate":{"schema":{"type":"string"},"description":"MPP Stripe charge challenge bound to this operation and the verified quote."}},"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Operation"}}}}},"parameters":[{"$ref":"#\/components\/parameters\/OperationId"},{"in":"header","name":"Authorization","description":"MPP Payment credential matching the current challenge. Send an empty JSON object and the guest capability.","schema":{"type":"string","pattern":"^Payment [a-zA-Z0-9_-]+$"}}],"requestBody":{"required":true,"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/ContinueGuestBooking"},"examples":{"completeVerification":{"value":{"verification_code":"123456"}},"probeOrReconcile":{"value":{}},"delegatedStripePayment":{"value":{"payment_credential":"spt_example"}}}}}}}},"\/guest\/cancellations":{"post":{"operationId":"requestGuestCancellation","summary":"Request a fresh booking-bound cancellation code","security":[],"requestBody":{"required":true,"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/GuestCancellationRequest"}}}},"responses":{"202":{"description":"Generic pending challenge. The response never indicates a match or mail delivery.","headers":{"Cache-Control":{"schema":{"const":"no-store"}},"X-Request-Id":{"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"DayTidy-Cancellation-Token":{"required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"},"description":"Keep private. Provide this value as a header for confirmation and status."}},"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/GuestCancellationResult"}}}},"400":{"$ref":"#\/components\/responses\/GuestCancellationError","description":"Invalid request"},"403":{"$ref":"#\/components\/responses\/GuestCancellationError","description":"Public cancellation unavailable"},"405":{"$ref":"#\/components\/responses\/GuestCancellationError","description":"Method unavailable"},"413":{"$ref":"#\/components\/responses\/GuestCancellationError","description":"Request too large"},"415":{"$ref":"#\/components\/responses\/GuestCancellationError","description":"JSON content type required"},"429":{"$ref":"#\/components\/responses\/GuestCancellationError","description":"Rate limited"},"503":{"$ref":"#\/components\/responses\/GuestCancellationError","description":"Temporarily unavailable"}}}},"\/guest\/cancellations\/{operation_id}\/confirm":{"post":{"operationId":"confirmGuestCancellation","summary":"Confirm the exact cancellation with fresh email proof","security":[{"CancellationCapability":[]}],"parameters":[{"$ref":"#\/components\/parameters\/OperationId"},{"$ref":"#\/components\/parameters\/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/GuestCancellationConfirmation"}}}},"responses":{"200":{"description":"Committed outcome or verified policy decision","headers":{"Cache-Control":{"schema":{"const":"no-store"}},"X-Request-Id":{"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}}},"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/GuestCancellationResult"}}}},"202":{"description":"Processing or recovery required","headers":{"Cache-Control":{"schema":{"const":"no-store"}},"X-Request-Id":{"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/GuestCancellationResult"}}}},"400":{"$ref":"#\/components\/responses\/GuestCancellationError","description":"Invalid request"},"403":{"$ref":"#\/components\/responses\/GuestCancellationError","description":"Public cancellation unavailable"},"404":{"$ref":"#\/components\/responses\/GuestCancellationError","description":"Operation or credential unknown"},"405":{"$ref":"#\/components\/responses\/GuestCancellationError","description":"Method unavailable"},"409":{"$ref":"#\/components\/responses\/GuestCancellationError","description":"Idempotency key or command conflict"},"410":{"$ref":"#\/components\/responses\/GuestCancellationError","description":"Operation access expired"},"413":{"$ref":"#\/components\/responses\/GuestCancellationError","description":"Request too large"},"415":{"$ref":"#\/components\/responses\/GuestCancellationError","description":"JSON content type required"},"422":{"$ref":"#\/components\/responses\/GuestCancellationError","description":"Verification failed"},"429":{"$ref":"#\/components\/responses\/GuestCancellationError","description":"Rate limited"},"503":{"$ref":"#\/components\/responses\/GuestCancellationError","description":"Temporarily unavailable"}}}},"\/guest\/cancellations\/{operation_id}":{"get":{"operationId":"getGuestCancellation","summary":"Read the scoped cancellation operation outcome","security":[{"CancellationCapability":[]}],"parameters":[{"$ref":"#\/components\/parameters\/OperationId"}],"responses":{"200":{"description":"Current operation outcome. A success reports the durable commit snapshot.","headers":{"Cache-Control":{"schema":{"const":"no-store"}},"X-Request-Id":{"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/GuestCancellationResult"}}}},"400":{"$ref":"#\/components\/responses\/GuestCancellationError","description":"Invalid request"},"403":{"$ref":"#\/components\/responses\/GuestCancellationError","description":"Public cancellation unavailable"},"404":{"$ref":"#\/components\/responses\/GuestCancellationError","description":"Operation or credential unknown"},"405":{"$ref":"#\/components\/responses\/GuestCancellationError","description":"Method unavailable"},"410":{"$ref":"#\/components\/responses\/GuestCancellationError","description":"Operation access expired"},"429":{"$ref":"#\/components\/responses\/GuestCancellationError","description":"Rate limited"},"503":{"$ref":"#\/components\/responses\/GuestCancellationError","description":"Temporarily unavailable"}}}}},"components":{"securitySchemes":{"GuestCapability":{"type":"apiKey","in":"header","name":"DayTidy-Guest-Token"},"CancellationCapability":{"type":"apiKey","in":"header","name":"DayTidy-Cancellation-Token","description":"Operation-scoped credential issued only as a response header at initiation."}},"parameters":{"IdempotencyKey":{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{16,128}$"},"description":"High-entropy per-command value kept unchanged across transports and retries."},"OperationId":{"name":"operation_id","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}}},"schemas":{"CommonAmount":{"type":"string","pattern":"^(0|[1-9][0-9]*)(\\.[0-9]{1,8})?$","description":"Decimal string, using configured currency precision and existing rounding. No client-authoritative price."},"CommonAppointmentMode":{"type":"string","enum":["separate","same_time","back_to_back"],"description":"Existing independent-appointment matching mode. Normalize through the shared Draft\/Appointments rules before quoting and approval binding."},"CommonBookingQuantity":{"type":"integer","minimum":1,"description":"Validate against current offering\/option min\/max, capacity and Appointments::quantityLimit where applicable. No fixed transport ceiling; reject values not representable by the supported runtime before expansion."},"CommonCurrency":{"type":"string","pattern":"^[A-Z]{3}$"},"CommonFirstPartyUrl":{"type":"string","format":"uri","maxLength":2048,"pattern":"^https:\/\/[^\/?#@\\s]+(?:[\/?#]|$)","x-url-origin":"canonical site origin","description":"Server-generated HTTPS URL without userinfo; additionally require the canonical site origin using trusted site context. Never trust an agent-provided origin or include credentials in its query."},"CommonNextAction":{"type":"object","properties":{"type":{"type":"string","enum":["none","browser_required"]},"url":{"$ref":"#\/components\/schemas\/CommonFirstPartyUrl"}},"required":["type"],"additionalProperties":false,"allOf":[{"if":{"properties":{"type":{"enum":["browser_required"]}},"required":["type"]},"then":{"required":["url"]}}]},"CommonOpaqueId":{"type":"string","minLength":16,"maxLength":128,"pattern":"^[A-Za-z0-9_-]+$"},"CommonParticipantRowId":{"type":"string","pattern":"^(option|appointment)-[1-9][0-9]*-[1-9][0-9]*$","maxLength":64,"not":{"pattern":"[^a-z0-9-]"},"description":"Server-issued, quote-scoped identifier for one option unit or independent appointment. The prefix distinguishes the two modes."},"CommonPositiveId":{"type":"integer","minimum":1},"CommonSeatCount":{"type":"integer","minimum":1,"description":"Must match the engine-derived seat count for the configured option and requested quantity. No fixed transport ceiling."},"CommonTimestamp":{"type":"string","format":"date-time","description":"Offset required on input; normalize responses to UTC. Booking selection and query bounds use whole-second precision. Cross-field range validation is mandatory."},"ContinueGuestBooking":{"oneOf":[{"type":"object","properties":{"verification_code":{"type":"string","pattern":"^[0-9]{6}$"}},"required":["verification_code"],"additionalProperties":false},{"type":"object","properties":{"resend_code":{"const":true}},"required":["resend_code"],"additionalProperties":false},{"type":"object","properties":{"payment_credential":{"type":"string","pattern":"^spt_[a-zA-Z0-9]{1,128}$","writeOnly":true,"description":"Provider-issued, quote-bound Stripe Shared Payment Token. Keep out of logs and conversation."}},"required":["payment_credential"],"additionalProperties":false},{"type":"object","properties":{},"required":[],"additionalProperties":false}]},"CreateGuestBooking":{"type":"object","properties":{"quote_id":{"type":"string","pattern":"^[a-f0-9]{32}$"},"email":{"type":"string","format":"email","maxLength":127},"customer_fields":{"$ref":"#\/components\/schemas\/FieldValues"},"participants":{"type":"array","items":{"$ref":"#\/components\/schemas\/ParticipantInput"},"maxItems":100},"cancellation_policy_version":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"required":["quote_id","email","customer_fields","participants","cancellation_policy_version"],"additionalProperties":false},"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"request_id":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"required":["code","request_id"],"additionalProperties":false}},"required":["error"],"additionalProperties":false},"FieldDescriptor":{"type":"object","properties":{"field_id":{"type":"integer"},"label":{"type":"string"},"type":{"type":"string"},"required":{"type":"boolean"},"agent_supported":{"type":"boolean"},"conditional":{"type":"boolean"},"choices":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"},"label":{"type":"string"}},"required":["value","label"],"additionalProperties":false},"maxItems":100}},"required":["field_id","label","type","required","agent_supported","conditional"],"additionalProperties":false},"FieldValues":{"type":"object","maxProperties":100,"patternProperties":{"^[0-9]+$":{"oneOf":[{"type":"string","maxLength":4000},{"type":"integer"},{"type":"boolean"},{"type":"array","items":{"type":"string","maxLength":1000},"maxItems":100}]}},"additionalProperties":false},"GuestQuote":{"type":"object","properties":{"quote_id":{"type":"string","pattern":"^[a-f0-9]{32}$"},"expires_at":{"$ref":"#\/components\/schemas\/CommonTimestamp"},"selection":{"$ref":"#\/components\/schemas\/QuoteSelection"},"pricing":{"$ref":"#\/components\/schemas\/QuotePricing"},"cancellation_policy":{"$ref":"#\/components\/schemas\/QuoteCancellationPolicy"},"reserves_capacity":{"type":"boolean","const":false},"next_action":{"type":"object","properties":{"type":{"type":"string","enum":["create_guest_booking","form_unsupported","payment_method_unsupported"]},"url":{"$ref":"#\/components\/schemas\/CommonFirstPartyUrl"}},"required":["type"],"allOf":[{"if":{"properties":{"type":{"enum":["form_unsupported","payment_method_unsupported"]}}},"then":{"required":["url"]}}],"additionalProperties":false},"participant_rows":{"type":"array","maxItems":100,"items":{"oneOf":[{"$ref":"#\/components\/schemas\/QuoteOptionParticipantRow"},{"$ref":"#\/components\/schemas\/QuoteAppointmentParticipantRow"}]},"description":"Server-defined descriptors for participant input. They contain no personal data. Empty for browser handoff or when no agent-supported participant fields apply."},"timezone":{"type":"string","description":"Business IANA timezone."},"headless":{"type":"boolean"},"guest_token":{"type":"string","pattern":"^[a-f0-9]{64}$"},"registration":{"type":"string","enum":["none","automatic"],"description":"With automatic registration, the verified email determines the booking owner. The site creates a WordPress account if needed, including when website registration is manual. The client supplies no username or password and receives no account access."},"verification":{"type":"string","enum":["email","optional"],"description":"Email verification is mandatory when registration is automatic. Optional verification is limited to eligible free bookings when registration is off."},"payment_mode":{"type":"string","enum":["free","pay_on_site","online","offline"]},"customer_fields":{"type":"array","items":{"$ref":"#\/components\/schemas\/FieldDescriptor"},"maxItems":100},"participant_fields":{"type":"array","items":{"$ref":"#\/components\/schemas\/FieldDescriptor"},"maxItems":100},"delegated_payment":{"$ref":"#\/components\/schemas\/StripePaymentCapability"}},"required":["quote_id","expires_at","selection","pricing","cancellation_policy","reserves_capacity","next_action","participant_rows","timezone","headless","guest_token","registration","verification","payment_mode","customer_fields","participant_fields"],"additionalProperties":false},"Operation":{"type":"object","properties":{"operation_id":{"type":"string","pattern":"^[a-f0-9]{64}$"},"reference":{"type":"string","pattern":"^[A-Za-z0-9_-]{1,128}$","description":"Daytidy booking reference for the customer. Use operation_id for guest status lookup."},"state":{"type":"string","enum":["pending_verification","ready","processing","recovery_required","succeeded","failed"]},"booking_status":{"type":["string","null"]},"payment_status":{"type":["string","null"]},"next_action":{"type":"object","properties":{"type":{"type":"string","enum":["none","verify_email","retry","poll","authorize_payment","submit_payment_credential"]}},"required":["type"],"additionalProperties":false},"code":{"type":"string","description":"Safe operation error. After email verification, network_account_unavailable indicates a suspended Multisite account, registration_expired indicates the provisional hold ended, and registration_uncertain indicates an interrupted attempt whose account could not be recovered."},"retry_after":{"type":"integer","minimum":1},"payment_execution":{"type":"string","enum":["authorization_required","authorized","processing","uncertain","paid","failed"]},"payment_request":{"$ref":"#\/components\/schemas\/StripePaymentRequest"},"customer_approval":{"type":"string","enum":["awaiting_customer_approval","verified"]}},"required":["operation_id","state","booking_status","payment_status","next_action"],"additionalProperties":false},"ParticipantInput":{"type":"object","properties":{"participant_row_id":{"type":"string","maxLength":64,"pattern":"^(option|appointment)-[1-9][0-9]*-[1-9][0-9]*$"},"fields":{"$ref":"#\/components\/schemas\/FieldValues"}},"required":["participant_row_id","fields"],"additionalProperties":false},"QuoteAppointmentParticipantRow":{"type":"object","properties":{"participant_row_id":{"pattern":"^appointment-","$ref":"#\/components\/schemas\/CommonParticipantRowId"},"option_id":{"$ref":"#\/components\/schemas\/CommonPositiveId"},"appointment_id":{"type":"string","pattern":"^[1-9][0-9]*_[1-9][0-9]*$","maxLength":61,"not":{"pattern":"[^0-9_]"}},"selection_index":{"type":"integer","minimum":0,"maximum":49,"description":"Index in the normalized quote selection items, in appointment order."}},"required":["participant_row_id","option_id","appointment_id","selection_index"],"additionalProperties":false},"QuoteCancellationPolicy":{"type":"object","properties":{"version_hash":{"type":"string","pattern":"^[a-f0-9]{64}$"},"summary":{"type":"string","maxLength":4000},"customer_cancellation_enabled":{"type":"boolean"},"cutoff_hours":{"type":"integer","minimum":0}},"required":["version_hash","summary","customer_cancellation_enabled","cutoff_hours"],"additionalProperties":false},"QuoteOptionParticipantRow":{"type":"object","properties":{"participant_row_id":{"pattern":"^option-","$ref":"#\/components\/schemas\/CommonParticipantRowId"},"option_id":{"$ref":"#\/components\/schemas\/CommonPositiveId"}},"required":["participant_row_id","option_id"],"additionalProperties":false},"QuotePricing":{"type":"object","properties":{"currency":{"$ref":"#\/components\/schemas\/CommonCurrency"},"subtotal":{"$ref":"#\/components\/schemas\/CommonAmount"},"discount":{"$ref":"#\/components\/schemas\/CommonAmount"},"tax":{"$ref":"#\/components\/schemas\/CommonAmount"},"fees":{"$ref":"#\/components\/schemas\/CommonAmount"},"total":{"description":"The amount payable after discounts, fees and taxes. DayTidy stores the pre-discount total separately in its transaction.","$ref":"#\/components\/schemas\/CommonAmount"}},"required":["currency","subtotal","discount","tax","fees","total"],"additionalProperties":false},"QuoteSelection":{"type":"object","properties":{"offering_id":{"$ref":"#\/components\/schemas\/CommonPositiveId"},"gateway":{"type":"string","minLength":1,"maxLength":100},"items":{"maxItems":50,"$ref":"#\/components\/schemas\/QuoteSelectionItems"},"coupon":{"type":"string","minLength":1,"maxLength":100},"appointment_mode":{"description":"Independent appointments only: omitted means separate; a single expanded appointment normalizes to separate. The normalized quote always includes the effective mode for independent appointments, and the guest capability binds it. Non-independent selections must omit this field.","$ref":"#\/components\/schemas\/CommonAppointmentMode"}},"required":["offering_id","gateway","items"],"additionalProperties":false},"QuoteSelectionItem":{"type":"object","properties":{"option_id":{"$ref":"#\/components\/schemas\/CommonPositiveId"},"quantity":{"$ref":"#\/components\/schemas\/CommonBookingQuantity"},"seats":{"$ref":"#\/components\/schemas\/CommonSeatCount"},"session_starts_at":{"$ref":"#\/components\/schemas\/CommonTimestamp"},"session_ends_at":{"$ref":"#\/components\/schemas\/CommonTimestamp"},"resource_id":{"$ref":"#\/components\/schemas\/CommonPositiveId"}},"required":["option_id","quantity","session_starts_at"],"additionalProperties":false},"QuoteSelectionItems":{"type":"array","minItems":1,"items":{"$ref":"#\/components\/schemas\/QuoteSelectionItem"}},"StripePaymentCapability":{"type":"object","properties":{"provider":{"const":"stripe"},"merchant":{"type":"string","pattern":"^acct_[a-zA-Z0-9]+$"},"seller_profile":{"type":"string","pattern":"^profile_[a-zA-Z0-9_]+$"},"environment":{"type":"string","enum":["test","live"]},"payment_method":{"const":"shared_payment_token"},"currency":{"const":"usd"},"amount_minor":{"type":"integer","minimum":50,"maximum":99999999}},"required":["provider","merchant","seller_profile","environment","payment_method","currency","amount_minor"],"additionalProperties":false},"StripePaymentRequest":{"type":"object","properties":{"provider":{"const":"stripe"},"merchant":{"type":"string","pattern":"^acct_[a-zA-Z0-9]+$"},"seller_profile":{"type":"string","pattern":"^profile_[a-zA-Z0-9_]+$"},"environment":{"type":"string","enum":["test","live"]},"payment_method":{"const":"shared_payment_token"},"currency":{"const":"usd"},"amount_minor":{"type":"integer","minimum":50,"maximum":99999999},"expires_at":{"$ref":"#\/components\/schemas\/CommonTimestamp"},"shared_metadata":{"type":"object","properties":{"daytidy_site":{"type":"string","pattern":"^[a-f0-9]{64}$"},"daytidy_quote":{"type":"string","pattern":"^[a-f0-9]{32}$"},"daytidy_binding":{"type":"string","pattern":"^[a-f0-9]{64}$"},"daytidy_seller_profile":{"type":"string","pattern":"^profile_[a-zA-Z0-9_]+$"}},"required":["daytidy_site","daytidy_quote","daytidy_binding","daytidy_seller_profile"],"additionalProperties":false}},"required":["provider","merchant","seller_profile","environment","payment_method","currency","amount_minor","expires_at","shared_metadata"],"additionalProperties":false},"GuestCancellationRequest":{"type":"object","properties":{"reference":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[^\\x00-\\x1F\\x7F]+$","description":"Exact customer-facing booking reference, up to 128 UTF-8 bytes."},"email":{"type":"string","format":"email","maxLength":127}},"required":["reference","email"],"additionalProperties":false},"GuestCancellationConfirmation":{"type":"object","properties":{"reference":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[^\\x00-\\x1F\\x7F]+$","description":"Exact customer-facing booking reference, up to 128 UTF-8 bytes."},"intent":{"const":"cancel_booking"},"verification_code":{"type":"string","pattern":"^[0-9]{6}$"}},"required":["reference","intent","verification_code"],"additionalProperties":false},"GuestCancellationResult":{"type":"object","properties":{"operation_id":{"type":"string","pattern":"^[a-f0-9]{64}$"},"state":{"enum":["pending_verification","processing","recovery_required","succeeded","failed"]},"next_action":{"type":"object","properties":{"type":{"enum":["none","verify_email","retry","poll"]}},"required":["type"],"additionalProperties":false},"reference":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[^\\x00-\\x1F\\x7F]+$","description":"Exact customer-facing booking reference, up to 128 UTF-8 bytes."},"booking_status":{"const":"cancelled"},"payment_status":{"enum":["paid","unpaid","pending","failed","not_required","partially_refunded","refunded"]},"code":{"enum":["verification_failed","feature_unavailable","not_found","invalid_state","disabled","terminal","started","cutoff","policy_denied","checkout_in_progress","temporarily_unavailable"]},"retry_after":{"type":"integer","minimum":1}},"required":["operation_id","state","next_action"],"additionalProperties":false,"oneOf":[{"properties":{"state":{"const":"pending_verification"},"next_action":{"properties":{"type":{"const":"verify_email"}}},"reference":false,"booking_status":false,"payment_status":false,"code":false,"retry_after":false}},{"properties":{"state":{"const":"processing"},"next_action":{"properties":{"type":{"const":"retry"}}},"reference":false,"booking_status":false,"payment_status":false,"code":false},"required":["retry_after"]},{"properties":{"state":{"const":"recovery_required"},"next_action":{"properties":{"type":{"const":"poll"}}},"reference":false,"booking_status":false,"payment_status":false,"code":false},"required":["retry_after"]},{"properties":{"state":{"const":"succeeded"},"next_action":{"properties":{"type":{"const":"none"}}},"code":false,"retry_after":false},"required":["reference","booking_status","payment_status"]},{"properties":{"state":{"const":"failed"},"next_action":{"properties":{"type":{"const":"none"}}},"reference":false,"booking_status":false,"payment_status":false,"retry_after":false},"required":["code"]}]}},"responses":{"GuestCancellationError":{"description":"Guest cancellation request error.","headers":{"Cache-Control":{"schema":{"const":"no-store"}},"X-Request-Id":{"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Error"}}}}}},"x-daytidy-a2a":{"protocolVersion":"1.0","protocolBinding":"JSONRPC","commands":{"guest.quote.create":"createGuestQuote","guest.booking.create":"createGuestBooking","guest.booking.continue":"continueGuestBooking","GetTask":"getGuestOperation","guest.booking.cancel.request":"requestGuestCancellation","guest.booking.cancel.confirm":"confirmGuestCancellation"},"cancellationStatus":{"method":"GetTask","operationId":"getGuestCancellation","capabilityHeader":"DayTidy-Cancellation-Token"}},"servers":[{"url":"https:\/\/demo.daytidy.com\/barbershop\/wp-json\/daytidy-agent\/v1"}],"x-daytidy-site":{"site_id":"79b997016d8a9d0a096b0c9c46c96a5519cd9275115c61496a43387454720c04","website":"https:\/\/demo.daytidy.com\/barbershop\/","routes":{"listOfferings":"https:\/\/demo.daytidy.com\/barbershop\/wp-json\/daytidy-agent\/v1\/offerings","getOffering":"https:\/\/demo.daytidy.com\/barbershop\/wp-json\/daytidy-agent\/v1\/offerings\/{offering_id}","getAvailability":"https:\/\/demo.daytidy.com\/barbershop\/wp-json\/daytidy-agent\/v1\/offerings\/{offering_id}\/availability","findAvailableSlots":"https:\/\/demo.daytidy.com\/barbershop\/wp-json\/daytidy-agent\/v1\/offerings\/{offering_id}\/availability\/search","describeGuestBooking":"https:\/\/demo.daytidy.com\/barbershop\/wp-json\/daytidy-agent\/v1\/guest\/openapi","createGuestQuote":"https:\/\/demo.daytidy.com\/barbershop\/wp-json\/daytidy-agent\/v1\/guest\/quotes","createGuestBooking":"https:\/\/demo.daytidy.com\/barbershop\/wp-json\/daytidy-agent\/v1\/guest\/bookings","getGuestOperation":"https:\/\/demo.daytidy.com\/barbershop\/wp-json\/daytidy-agent\/v1\/guest\/operations\/{operation_id}","continueGuestBooking":"https:\/\/demo.daytidy.com\/barbershop\/wp-json\/daytidy-agent\/v1\/guest\/operations\/{operation_id}\/continue","requestGuestCancellation":"https:\/\/demo.daytidy.com\/barbershop\/wp-json\/daytidy-agent\/v1\/guest\/cancellations","confirmGuestCancellation":"https:\/\/demo.daytidy.com\/barbershop\/wp-json\/daytidy-agent\/v1\/guest\/cancellations\/{operation_id}\/confirm","getGuestCancellation":"https:\/\/demo.daytidy.com\/barbershop\/wp-json\/daytidy-agent\/v1\/guest\/cancellations\/{operation_id}"},"payment_providers":[{"provider":"stripe","merchant":"acct_1S20g9LVZvNddjP1","seller_profile":"profile_test_61VlXpvWyOkumc7xnA6VlXpu7fA8RwqSnZT34j4YqSSe","environment":"test","payment_method":"shared_payment_token","currency":"usd"}]}}