FoyerDevelopers

Generated · Live registry

voice-hold tools

1 tool in this domain, generated from the running registry.

All tool domains

voice-hold.create

writes

Place a 125-minute soft-hold on a room and send the caller an SMS with the confirmation link. Designed for the VAPI voice-agent — call after the guest verbally accepts a rate from voice-availability.check. Returns stayId + payLinkUrl + holdExpiresAt; the agent reads the expiry back to the guest.

Input parameters

FieldTypeRequiredNotes
roomTypeIdstringyesRoom type key, exactly the roomTypeId value returned by voice-availability.check (case-sensitive, e.g. 'Double' is not 'double').
checkInstringyesFirst night, YYYY-MM-DD.
checkOutstringyesDeparture (exclusive), YYYY-MM-DD.
guestsintegeryesHeadcount.
guestNamestringyesCaller's name (for guest record).
guestPhonestringyesE.164 phone number (used as SMS recipient + guest alias).

Output fields

FieldTypeRequiredNotes
stayIdstringyes
payLinkUrlstringyes
holdExpiresAtstringyesISO-8601 timestamp, 125 minutes from now.
stripePaymentLinkIdstring · nullableyesStripe Checkout Session ID (cs_...) when minted — the link expires 5 minutes before the hold; null when we fell back to a synthetic URL (Stripe disabled / tenant not onboarded / API error).