Skip to content

create_cancelation_policies

Create one or more catalog cancelation policies in parallel. Each policy carries its own workspaceId, so a single call can create policies across multiple workspaces. Each policy needs a name (unique within its workspace) and takes an optional cancelationFeePercentage (0-100, 0 when omitted), which is not currently used: it is stored with the policy and on each booking, but no charge or refund is calculated from it. Optionally provide coolOff ({ length, lengthUnit: HOURS|DAYS, type: BOOKING_CREATION|BOOKING_CONFIRMATION }) — all three fields must be set together. Each creation is executed independently and reported per-policy; partial failures do not abort the rest.

Parameter Type Required Description
cancelationPolicies CancelationPolicyInput[] Yes Array of cancelation policies to create. Each item carries its own workspaceId. - CancelationPolicyInput
Field Type Required Description
workspaceId string Yes The ID of the workspace that owns this cancelation policy
name string Yes Human-readable name for the cancelation policy. Must be unique within the workspace (max 255 characters).
cancelationFeePercentage number No The cancelation fee percentage (0-100), 0 when omitted. Not currently used: it is stored with the policy and on each booking, but no charge or refund is calculated from it.
coolOff CoolOff No CoolOff
Field Type Required Description
length number Yes Cool-off period length, must be greater than 0
lengthUnit CoolOffLengthUnit Yes CoolOffLengthUnit
type CoolOffFrom Yes CoolOffFrom
Value Description
HOURS Cool-off length is measured in hours
DAYS Cool-off length is measured in days
Value Description
BOOKING_CREATION Cool-off period starts when the booking is created
BOOKING_CONFIRMATION Cool-off period starts when the booking is confirmed
Field Type Description
content ContentItem[] Array of content items returned by the tool - ContentItem
isError boolean Whether the tool execution resulted in an error
Field Type Description
type 'text' Content type (currently only ‘text’ is supported)
text string The text content to display