MCP tool reference
The current Blawby MCP tools, their inputs, access requirements and effects, generated from the deployed server contract.
Chris Luke
579 min read
Blawby’s MCP connects an AI assistant to your business website and operations. This reference describes the tools exposed by the running server. Access still depends on your business membership, role and enabled features. Your assistant may need a tool refresh before it can use recently added tools.
For setup, see Connect Blawby to ChatGPT. For practical tasks, start with updating your menu, managing bookings, adding photos and video, publishing a post, or handling inquiries.
See what AI assistants can and cannot do for the overview and refreshing your tools if your connected assistant has an older list.
This reference is generated from the tool definitions running on this server. It updates when those definitions are deployed.
Reference fingerprint: sha256:445dc05d64a99085532b391da557ffd6c5b7c6177d225a0c38b0b1fd8c68a6b4
Tools: 168.
Connect with the setup guide, then read what AI assistants can do. Select the intended business and use its internal IDs returned by the tools. Permissions and entitlements are checked when each operation runs.
For step-by-step tasks, see menu updates, bookings, photos and video, publishing a post, and guest messages and requests.
Before asking an assistant to change data, review the business, records and intended result. Tool descriptions specify any operation-specific approval steps. Client confirmation controls depend on your AI assistant. Read-only, destructive, open-world and idempotent hints describe the tool; they do not grant permission or approve an operation.
Input and output tables list each field, its required state and schema constraints. Nested objects, array items and schema alternatives link to shared shapes below. These shapes are generated from the same definitions, including local JSON Schema references.
Tool groups
- analytics:
get_organization_analytics,query_google_analytics,query_search_console - blog:
create_article_category,create_blog_post,delete_article_category,delete_blog_post,get_blog_post,list_article_categories,list_blog_posts,publish_blog_post,reorder_article_categories,reorder_blog_posts,update_article_category,update_blog_post - bookings:
cancel_product_booking,confirm_product_booking,create_product_booking,create_product_session,get_product_booking,list_product_booking_sessions,list_product_bookings,no_show_product_booking,reject_product_booking,request_product_booking_change,update_product_booking,update_product_session - content:
append_content_block,create_site_page,delete_content_block,delete_site_page,get_site_page,list_site_pages,replace_content_block,update_site_page - context:
get_workspace_context,set_workspace_context - conversations:
get_conversation,list_conversation_recipients,list_conversations,mark_conversation_read,mark_conversation_unread,send_message,set_conversation_archived,start_conversation,update_conversation_group - google ads:
create_google_ads_search_campaign,get_google_ads_campaign,list_google_ads_campaigns,query_google_ads_report,update_google_ads_campaign - guest messaging:
cancel_scheduled_guest_message,create_message_template,delete_message_template,get_guest_messaging_context,list_message_templates,list_scheduled_guest_messages,schedule_guest_reply,update_message_template,update_stay_arrival_guide - locales:
add_organization_language,delete_organization_language,delete_resource_localization,disable_organization_language,get_product_catalog_localization,get_resource_localization,list_organization_locales,publish_organization_language,put_resource_localization,replace_resource_localizations - locations:
block_dates,create_location,get_calendar,get_location,list_locations,open_dates,update_location - media:
attach_media,delete_media_asset,list_media_assets,remove_media,reorder_media,save_media_attachment,set_media,update_media_asset - meta ads:
create_meta_ads_campaign,list_meta_ads_campaigns,query_meta_ads_report,update_meta_ads_campaign - organizations:
cancel_organization_invitation,get_organization,get_organization_settings,get_website_draft,invite_organization_member,list_organization_members,list_organizations,publish_website,remove_organization_member,save_website_draft,set_consultation_mode,update_organization_member_role,update_organization_settings - payments:
get_payment,get_payment_payouts,get_payment_summary,get_payments_dashboard_link,list_payments - posts:
create_post,delete_channel_post,delete_post,get_channel_post,get_post,get_social_connections,list_channel_posts,list_posts,publish_post,reconcile_post_publication,update_post - products:
batch_create_products,create_collection,create_product,delete_collection,delete_product,delete_product_booking_config,get_product,list_collections,list_location_products,list_products,reconcile_products,remove_product_location,reorder_collections,replace_product_weekly_schedule,set_collection_products,set_product_booking_config,set_product_location,set_product_publication,update_collection,update_menu,update_product - providers:
get_member_public_profile,get_member_scheduling,set_member_busy_calendars,set_member_scheduling,update_member_public_profile - qa:
create_qa,delete_qa,list_location_qa,list_organization_qa,reorder_qa,update_qa - reviews:
list_location_reviews,list_organization_reviews - stays:
assign_home_photos_to_room,create_home_room,delete_home_room,delete_stay_payment,get_stay_calendar,record_stay_payment,set_stay_nights,update_home_accessibility,update_home_room - submissions:
create_inquiry - tasks:
complete_task,create_task,list_opportunities,list_tasks,skip_task,update_task
Analytics
Get organization analytics — get_organization_analytics
Read one Insights page, as the dashboard shows it: its headline numbers, each one by day, and its list, every number written as the page shows it. Pages: rating and reviews, occupancy or bookings, cancellations, length of stay, party size, nightly rate or average value, income by channel, booking conversion (with website clicks to book, call or order), lead time, returning guests, page views, top pages and sources.
Minimum role: admin. Required entitlement: None.
Annotations: title: Get organization analytics, readOnlyHint: true, idempotentHint: true, openWorldHint: false, destructiveHint: false.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
end_date |
string | No | Inclusive local end date in YYYY-MM-DD format. Defaults to today. |
kind |
string | No | What is booked: stay, experience, service (consultations) or table. Default all. Not read by page views, top pages and sources. enum: ["all","stay","experience","service","table"] |
location_id |
string | No | One location. Read by rating, Bookings & rates, lead time and returning pages only. |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
page |
string | Yes | The page, as section/page. enum: ["quality/overall-rating","rates/occupancy-rate","rates/bookings","rates/cancellation-rate","rates/length-of-stay","rates/party-size","rates/nightly-rate","rates/average-value","rates/income-by-channel","conversion/booking-conversion","conversion/lead-time","conversion/returning","conversion/page-views","conversion/top-pages","conversion/sources"] |
start_date |
string | No | Inclusive local start date in YYYY-MM-DD format. Defaults to 29 days before end_date. |
additionalProperties: false; required: ["page"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
action |
object or null (fields) | Yes | |
filters |
object (fields) | Yes | additionalProperties: false; required: ["offering","range"] |
list |
object or null (fields) | Yes | |
metrics |
array of object (fields) | Yes | |
note |
string or null | Yes | |
series |
object (fields) | Yes | additionalProperties: false; required: ["dates","charts"] |
subtitle |
string or null | Yes | |
title |
string | Yes |
$schema: "https://json-schema.org/draft/2020-12/schema"; additionalProperties: false; required: ["title","subtitle","note","action","filters","metrics","series","list"]
Query Google analytics — query_google_analytics
Run a report on the connected Google Analytics 4 property: GA4 dimensions and metrics (such as date, landingPage, sessionSource, sessionMedium; activeUsers, sessions, screenPageViews, keyEvents) over one to four date ranges, with filters, ordering and paging. GA4 keeps history from before Blawby; use it for periods the business's own analytics do not cover.
Minimum role: admin. Required entitlement: None.
Annotations: title: Query Google analytics, readOnlyHint: true, idempotentHint: true, openWorldHint: false, destructiveHint: false.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
date_ranges |
array of object (fields) | Yes | Days in the property time zone. Two ranges compare periods, such as this October and last October. maxItems: 4; minItems: 1 |
dimensions |
array of string (fields) | No | GA4 API dimension names. maxItems: 9 |
filters |
array of object (fields) | No | Every filter must match. maxItems: 10 |
limit |
integer | No | Rows per page (default 100). maximum: 10000; minimum: 1 |
metrics |
array of string (fields) | Yes | GA4 API metric names. maxItems: 10; minItems: 1 |
offset |
integer | No | Rows to skip, for the next page. minimum: 0 |
order_by |
object (fields) | No | additionalProperties: false; required: ["field","kind"] |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
additionalProperties: false; required: ["date_ranges","metrics"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
currency |
string | Yes | |
property_id |
string | Yes | |
property_quota |
object or null | Yes | GA4 tokens consumed and remaining for the property after this report. |
row_count |
integer | Yes | All rows the report has; page with offset. |
rows |
array of object (fields) | Yes | |
time_zone |
string | Yes |
required: ["property_id","time_zone","currency","row_count","property_quota","rows"]
Query search console — query_search_console
Read organic Google Search performance for the connected Search Console property: clicks, impressions, CTR and average position by query, page, country, device, date or search appearance, with filters and paging. final reads finished days only; all includes days Google is still finalizing.
Minimum role: admin. Required entitlement: None.
Annotations: title: Query search console, readOnlyHint: true, idempotentHint: true, openWorldHint: false, destructiveHint: false.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
aggregation_type |
string | No | How results are counted: byPage counts each page; byProperty counts the site once per result. Default auto. enum: ["auto","byPage","byProperty"] |
data_state |
string | No | Default final. enum: ["final","all"] |
dimensions |
array of string (fields) | No | maxItems: 4 |
end_date |
string | Yes | Last day, inclusive. pattern: "^\d{4}-\d{2}-\d{2}$" |
filters |
array of object (fields) | No | Every filter must match. maxItems: 10 |
limit |
integer | No | Rows per page (default 1000). maximum: 25000; minimum: 1 |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
search_type |
string | No | Default web. enum: ["web","image","video","news","discover","googleNews"] |
start_date |
string | Yes | First day (Pacific Time, as Search Console counts). pattern: "^\d{4}-\d{2}-\d{2}$" |
start_row |
integer | No | Rows to skip, for the next page. minimum: 0 |
additionalProperties: false; required: ["start_date","end_date"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
aggregation |
string or null | Yes | |
data_state |
string | Yes | |
end_date |
string | Yes | |
next_start_row |
integer or null | Yes | Set when this page is full: pass it as start_row for more. Google also omits rare queries, so a last page is not every query. |
rows |
array of object (fields) | Yes | |
site_url |
string | Yes | |
start_date |
string | Yes | |
time_zone |
string | Yes | Search Console counts days in Pacific Time. |
required: ["site_url","start_date","end_date","data_state","aggregation","time_zone","next_start_row","rows"]
Blog
Create article category — create_article_category
Create a category in the blog or the documentation, at the top level or under another category (parent_id). It goes last among its siblings; place it with reorder_article_categories. Its slug comes from the name and does not change later. Returns the category and ID; articles are assigned separately.
Minimum role: admin. Required entitlement: None.
Annotations: title: Create article category, readOnlyHint: false, openWorldHint: false, destructiveHint: false.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
collection |
string | Yes | enum: ["blog","docs"] |
description |
string or null | No | What the category covers, shown on its page and used as the page description. maxLength: 500 |
name |
string | Yes | maxLength: 100; minLength: 1 |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
parent_id |
string or null | No | The category this one sits under, in the same collection; null or omitted for the top level. Categories nest at most 3 levels deep. |
additionalProperties: false; required: ["collection","name"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
category |
object (fields) | Yes | additionalProperties: false; required: ["id","collection","name","slug","description","parent_id","sort_order","article_count","child_count"] |
additionalProperties: false; required: ["category"]
Create blog post — create_blog_post
Create a draft blog or documentation article with ordered content_blocks. It stays private until published. Creating a draft completes any accepted task to create an article. A category in the selected collection is required for publication. Use a new idempotency_key for each article; retrying the same key returns the same article. The preview_url allows draft review. When linking to dashboard settings in markdown copy, use /dashboard/app/
Minimum role: admin. Required entitlement: None.
Annotations: title: Create blog post, readOnlyHint: false, openWorldHint: false, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
category_id |
string | No | The article's category: the id of one of its collection's categories (list_article_categories). Required before publish_blog_post. To use a category that does not exist yet, create it with create_article_category first. |
collection |
string | No | Which of the site's collections the article belongs to: its blog, or its documentation. Defaults to the blog. enum: ["blog","docs"] |
content_blocks |
array of object (fields) | Yes | The article, in order. Any number of blocks of any type, images wherever they belong. The first block, when it is an image, is the cover. minItems: 1 |
excerpt |
string | No | |
idempotency_key |
string | Yes | A value you make up once for this article, such as a UUID, and reuse only to retry this same request. maxLength: 200; minLength: 1 |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
title |
string | Yes | |
visibility |
string | No | Unlisted posts work by direct URL but are excluded from indexes, search, feeds, and sitemap. enum: ["listed","unlisted"] |
additionalProperties: false; required: ["idempotency_key","title","content_blocks"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
post |
object (fields) | Yes | additionalProperties: false; required: ["id","title","slug","excerpt","collection","category","sort_order","seo_keywords","published","published_at","status","visibility","created_at","updated_at","cover","admin_edit_url","edit_url","public_path","public_url","preview_url","view_url","content_blocks"] |
additionalProperties: false; required: ["post"]
Delete article category — delete_article_category
Delete an empty category. A category that still has articles or subcategories is refused with how many it holds: ask the user where they should go, move each article with update_blog_post (category_id) and each subcategory with update_article_category (parent_id), then delete it.
Minimum role: admin. Required entitlement: None.
Annotations: title: Delete article category, readOnlyHint: false, openWorldHint: false, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
category_id |
string | Yes | |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
additionalProperties: false; required: ["category_id"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
category_id |
string | Yes | |
deleted |
boolean | Yes |
additionalProperties: false; required: ["category_id","deleted"]
Delete blog post — delete_blog_post
Permanently delete the selected blog or documentation article and its owned content. Use only when the user requests removing that article; a published article is removed from the website.
Minimum role: admin. Required entitlement: None.
Annotations: title: Delete blog post, readOnlyHint: false, openWorldHint: true, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
post_id |
string | Yes | Post id or slug. |
additionalProperties: false; required: ["post_id"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
deleted |
boolean | Yes | |
post_id |
string | Yes |
additionalProperties: false; required: ["post_id","deleted"]
Get blog post — get_blog_post
Read one blog or documentation article by ID or slug, including its ordered content_blocks and updated_at token. Use that token when editing or publishing the article.
Minimum role: admin. Required entitlement: None.
Annotations: title: Get blog post, readOnlyHint: true, idempotentHint: true, openWorldHint: false, destructiveHint: false.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
post_id |
string | Yes | Post id or slug. |
additionalProperties: false; required: ["post_id"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
post |
object (fields) | Yes | additionalProperties: false; required: ["id","title","slug","excerpt","collection","category","sort_order","seo_keywords","published","published_at","status","visibility","created_at","updated_at","cover","admin_edit_url","edit_url","public_path","public_url","preview_url","view_url","content_blocks"] |
additionalProperties: false; required: ["post"]
List article categories — list_article_categories
List categories and subcategories in one site blog or documentation collection, in public display order, with article and child-category counts. Published articles require a category in their collection.
Minimum role: admin. Required entitlement: None.
Annotations: title: List article categories, readOnlyHint: true, idempotentHint: true, openWorldHint: false, destructiveHint: false.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
collection |
string | Yes | enum: ["blog","docs"] |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
additionalProperties: false; required: ["collection"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
categories |
array of object (fields) | Yes |
additionalProperties: false; required: ["categories"]
List blog posts — list_blog_posts
List draft and published long-form articles in the selected site’s blog or documentation collection. Results are paginated in public display order. Short website posts are listed separately by list_posts.
Minimum role: admin. Required entitlement: None.
Annotations: title: List blog posts, readOnlyHint: true, idempotentHint: true, openWorldHint: false, destructiveHint: false.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
collection |
string | No | enum: ["blog","docs"] |
cursor |
string | No | Opaque next_cursor from the previous page. |
limit |
number | No | Page size. Defaults to 50; maximum 100. maximum: 100; minimum: 1 |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
status |
string | No | enum: ["draft","published"] |
additionalProperties: false; required: []
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
page_info |
object (fields) | Yes | required: ["has_more","next_cursor"] |
posts |
array of object (fields) | Yes |
additionalProperties: false; required: ["posts","page_info"]
Publish blog post — publish_blog_post
Publish the selected draft blog or documentation article when publication is requested. Requires updated_at from the latest read. An already published article is unchanged, including its date and announcement. Returns its publication state, revision and website URL; this does not publish to Facebook or Instagram.
Minimum role: admin. Required entitlement: None.
Annotations: title: Publish blog post, readOnlyHint: false, openWorldHint: true, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
post_id |
string | Yes | Post id or slug. |
updated_at |
string | Yes | Exact post.updated_at concurrency token from the latest get_blog_post or successful blog mutation. |
additionalProperties: false; required: ["post_id","updated_at"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
changed |
boolean | Yes | |
post |
object (fields) | Yes | additionalProperties: false; required: ["id","title","collection","visibility","status","published","published_at","updated_at","public_url"] |
additionalProperties: false; required: ["post","changed"]
Reorder article categories — reorder_article_categories
Set the order of one set of sibling categories on the public site — the index, its sidebar and the menu: the collection's top level (parent_id null or omitted), or one category's subcategories. Send every sibling id exactly once; a partial order is rejected.
Minimum role: admin. Required entitlement: None.
Annotations: title: Reorder article categories, readOnlyHint: false, openWorldHint: true, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
category_ids |
array of string (fields) | Yes | minItems: 1 |
collection |
string | Yes | enum: ["blog","docs"] |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
parent_id |
string or null | No | Whose subcategories are being ordered; null or omitted for the top level. |
additionalProperties: false; required: ["collection","category_ids"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
categories |
array of object (fields) | Yes |
additionalProperties: false; required: ["categories"]
Reorder blog posts — reorder_blog_posts
Replace the public display order of articles in one blog or documentation collection. Supply every article ID in that collection exactly once, including drafts. New articles with sort_order 0 appear first until ordered; category ordering is separate.
Minimum role: admin. Required entitlement: None.
Annotations: title: Reorder blog posts, readOnlyHint: false, openWorldHint: true, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
collection |
string | Yes | enum: ["blog","docs"] |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
post_ids |
array of string (fields) | Yes | minItems: 1 |
additionalProperties: false; required: ["collection","post_ids"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
posts |
array of object (fields) | Yes |
required: ["posts"]
Update article category — update_article_category
Rename a category, change its description, or move it under another category (parent_id; null moves it to the top level, where it goes last). Its page's address (slug) stays the same. Omitted fields stay unchanged; returns the updated category without moving its articles.
Minimum role: admin. Required entitlement: None.
Annotations: title: Update article category, readOnlyHint: false, openWorldHint: true, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
category_id |
string | Yes | |
description |
string or null | No | maxLength: 500 |
name |
string | No | maxLength: 100; minLength: 1 |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
parent_id |
string or null | No | Omit to retain the current parent; null moves the category to the top level. A supplied parent must be in the same collection. Categories nest at most 3 levels deep. |
additionalProperties: false; required: ["category_id"]
anyOf: shape 1, shape 2, shape 3.
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
category |
object (fields) | Yes | additionalProperties: false; required: ["id","collection","name","slug","description","parent_id","sort_order","article_count","child_count"] |
additionalProperties: false; required: ["category"]
Update blog post — update_blog_post
Edit the selected blog or documentation article. Only supplied metadata changes; content_blocks replaces the entire body and requires updated_at from the latest read. Stale tokens conflict. Changes to a published article are public immediately. When linking to dashboard settings in markdown copy, use /dashboard/app/
Minimum role: admin. Required entitlement: None.
Annotations: title: Update blog post, readOnlyHint: false, openWorldHint: true, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
category_id |
string | No | The article's category: the id of one of its collection's categories (list_article_categories). Required before publish_blog_post. To use a category that does not exist yet, create it with create_article_category first. |
collection |
string | No | Move the article to the site's blog or its documentation. Omit to leave it where it is. enum: ["blog","docs"] |
content_blocks |
array of object (fields) | No | The whole article, in order, replacing every block. Blocks read back keep their id. The first block, when it is an image, is the cover. minItems: 1 |
excerpt |
string | No | |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
post_id |
string | Yes | Post id or slug. |
title |
string | No | |
updated_at |
string | No | Required with content_blocks. Use updated_at returned by get_blog_post; stale tokens are rejected with a conflict. |
visibility |
string | No | enum: ["listed","unlisted"] |
additionalProperties: false; required: ["post_id"]
anyOf: shape 1, shape 2, shape 3, shape 4, shape 5, shape 6.
allOf: shape 1.
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
changed |
boolean | Yes | Whether this request changed the stored article. An equivalent save leaves its revision unchanged. |
post |
object (fields) | Yes | additionalProperties: false; required: ["id","title","slug","excerpt","collection","category","sort_order","seo_keywords","published","published_at","status","visibility","created_at","updated_at","cover","admin_edit_url","edit_url","public_path","public_url","preview_url","view_url","content_blocks"] |
additionalProperties: false; required: ["post","changed"]
Bookings
Cancel product booking — cancel_product_booking
Cancel a pending or confirmed booking before it ends and tell the guest: a product booking or consultation releases its places; a stay the host entered frees its nights, cancels its pending automatic messages and updates the home's connected Airbnb availability through Channex (a channel's stay is cancelled on its channel). A required refund returns financial_action_required and a dashboard URL before status changes.
Minimum role: member. Required entitlement: None.
Annotations: title: Cancel product booking, readOnlyHint: false, openWorldHint: true, destructiveHint: true, idempotentHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
booking_id |
string | Yes | Booking ID returned by list_product_bookings or create_product_booking. Distinct from conversation_id, which identifies the inbox conversation. |
idempotency_key |
string | Yes | Caller-supplied durable idempotency key. Reuse only for the identical operation. maxLength: 200; minLength: 1 |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
reason |
string | No | For a stay: why it was cancelled, kept with it. maxLength: 500 |
version |
integer | Yes | The booking version from get_product_booking. A stale version is refused. minimum: 1 |
additionalProperties: false; required: ["booking_id","version","idempotency_key"]
Output
Output: object.
Confirm product booking — confirm_product_booking
Confirm a pending product booking or consultation after staff review and email the guest, keeping its session and places. No payment is collected.
Minimum role: member. Required entitlement: None.
Annotations: title: Confirm product booking, readOnlyHint: false, openWorldHint: true, destructiveHint: true, idempotentHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
booking_id |
string | Yes | Booking ID returned by list_product_bookings or create_product_booking. Distinct from conversation_id, which identifies the inbox conversation. |
idempotency_key |
string | Yes | Caller-supplied durable idempotency key. Reuse only for the identical operation. maxLength: 200; minLength: 1 |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
version |
integer | Yes | The booking version from get_product_booking. A stale version is refused. minimum: 1 |
additionalProperties: false; required: ["booking_id","version","idempotency_key"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
available_actions |
array of string (fields) | Yes | |
conversation_id |
string | Yes | minLength: 1 |
ok |
boolean | Yes | const: true |
record |
object (fields) | Yes | required: ["id","kind","status","party_size","starts_at","ends_at","timezone","assigned_member_id","location_id","product_id","product_kind","product_name"] |
status |
number | Yes | const: 200 |
thread |
object (fields) | Yes | required: ["id","kind"] |
required: ["ok","status","conversation_id","record","available_actions","thread"]
Create product booking — create_product_booking
Book a guest in a timed offering or record a direct stay. Use an available session ID for a table, experience or legal consultation; for a stay give the arrival and departure dates, guests and amount due to the host. Reuse the same key for the same request. Timed bookings that require online payment need an approved dashboard checkout.
Minimum role: admin. Required entitlement: None.
Annotations: title: Create product booking, readOnlyHint: false, openWorldHint: true, destructiveHint: true, idempotentHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
adults |
integer | No | maximum: 99; minimum: 1 |
answers |
array of object (fields) | No | Answers to the configured questions by question ID: text for short_text/long_text, a choice ID for single_choice, choice IDs for multiple_choice, true or false for yes_no. Required questions must be answered. maxItems: 20 |
arrival_time |
string or null | No | The local time the guest said they arrive; the stay starts then instead of at the home's check-in time. Null or omitted is the check-in time. pattern: "^([01]\d|2[0-3]):[0-5]\d$" |
check_in_date |
string | No | pattern: "^\d{4}-\d{2}-\d{2}$" |
check_out_date |
string | No | The morning the guest leaves; the stay holds the nights before it. pattern: "^\d{4}-\d{2}-\d{2}$" |
children |
integer | No | maximum: 99; minimum: 0 |
external_reference |
string | No | maxLength: 200 |
guest_acknowledgement |
boolean | No | Explicit choice to send the timed booking confirmation. |
guest_email |
string or null | No | |
guest_name |
string | Yes | The guest's full name. maxLength: 200; minLength: 1 |
guest_phone |
string or null | No | International number with its country calling code, e.g. +66812345678. |
idempotency_key |
string | Yes | Caller-supplied durable idempotency key. Reuse only for the identical operation. maxLength: 200; minLength: 1 |
infants |
integer | No | maximum: 99; minimum: 0 |
locale |
string | No | Guest confirmation language code; defaults to the website language. |
notes |
string | No | maxLength: 1000 |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
party_size |
integer | No | maximum: 99; minimum: 1 |
private_notes |
string or null | No | The host's own note, never shown to the guest. maxLength: 2000 |
product_session_id |
string | No | Available time from list_product_booking_sessions. |
product_slug |
string | Yes | Offering slug from list_products or get_product. |
product_variant_id |
string | No | minLength: 1 |
questions_revision |
string | No | The questions_revision the answers were collected against. Required with answers; a changed revision returns questions_changed with the current questions. |
source |
string | No | Provenance for timed bookings, such as operator or external scheduler. maxLength: 100; minLength: 1 |
total_minor |
integer | No | Whole minor units of the organization currency, e.g. cents. minimum: 0 |
additionalProperties: false; required: ["product_slug","guest_name","idempotency_key"]
Output
Output: object.
Create product session — create_product_session
Add a dated time at a location for an existing bookable offering using its actual start and end. Online offerings take no dated sessions: they are booked in their provider's working hours. A restaurant's tables take none either: they are seated through their location's opening hours.
Minimum role: member. Required entitlement: None.
Annotations: title: Create product session, readOnlyHint: false, openWorldHint: true, destructiveHint: false, idempotentHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
capacity |
integer or null | No | minimum: 0 |
ends_at |
string | Yes | format: "date-time" |
idempotency_key |
string | Yes | Caller-supplied durable idempotency key. Reuse only for the identical operation. maxLength: 200; minLength: 1 |
location_id |
string | Yes | Session location. minLength: 1 |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
product_id |
string | Yes | minLength: 1 |
starts_at |
string | Yes | format: "date-time" |
additionalProperties: false; required: ["product_id","location_id","starts_at","ends_at","idempotency_key"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
sessions |
array of object (fields) | Yes | minItems: 1 |
required: ["sessions"]
Get product booking — get_product_booking
Read one booking — an experience, consultation, table or stay at a home — when the user wants its guest details, answers to the offering's questions, status or current session. Use the booking version when making a change.
Minimum role: member. Required entitlement: None.
Annotations: title: Get product booking, readOnlyHint: true, idempotentHint: true, openWorldHint: false, destructiveHint: false.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
booking_id |
string | Yes | Booking ID returned by list_product_bookings or create_product_booking. Distinct from conversation_id, which identifies the inbox conversation. |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
additionalProperties: false; required: ["booking_id"]
Output
Output: object.
List product booking sessions — list_product_booking_sessions
Read scheduled times and remaining places for a product, including shared calendar conflicts. Choose a returned session ID to create or change a booking.
Minimum role: member. Required entitlement: None.
Annotations: title: List product booking sessions, readOnlyHint: true, idempotentHint: true, openWorldHint: false, destructiveHint: false.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
cursor |
string | No | Opaque next_cursor from the previous page. |
from |
string | Yes | Inclusive ISO UTC instant. |
limit |
number | No | Page size. Defaults to 50; maximum 100. maximum: 100; minimum: 1 |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
product_id |
string | Yes | |
to |
string | Yes | Exclusive ISO UTC instant, at most 93 days after from. |
additionalProperties: false; required: ["product_id","from","to"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
page_info |
object (fields) | Yes | required: ["has_more","next_cursor"] |
sessions |
array of object (fields) | Yes |
required: ["sessions","page_info"]
List product bookings — list_product_bookings
Read bookings for tables, experiences, legal consultations and stays. Use get_product_booking for guest contact details and booking_id plus version to make changes.
Minimum role: member. Required entitlement: None.
Annotations: title: List product bookings, readOnlyHint: true, idempotentHint: true, openWorldHint: false, destructiveHint: false.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
assigned_member_id |
string | No | |
cursor |
string | No | Opaque next_cursor from the previous page. |
from |
string | No | Inclusive session start instant. |
limit |
number | No | Page size. Defaults to 50; maximum 100. maximum: 100; minimum: 1 |
location_id |
string or null | No | |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
product_id |
string | No | |
status |
string | No | enum: ["pending","confirmed","completed","cancelled"] |
to |
string | No | Exclusive session start instant. |
unit |
string | No | enum: ["slot","nights"] |
additionalProperties: false; required: []
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
bookings |
array of object (fields) | Yes | |
page_info |
object (fields) | Yes | required: ["has_more","next_cursor"] |
required: ["bookings","page_info"]
No show product booking — no_show_product_booking
Record that a guest did not attend a booking that has begun and does not have a guest review.
Minimum role: member. Required entitlement: None.
Annotations: title: No show product booking, readOnlyHint: false, openWorldHint: false, destructiveHint: true, idempotentHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
booking_id |
string | Yes | Booking ID returned by list_product_bookings or create_product_booking. Distinct from conversation_id, which identifies the inbox conversation. |
idempotency_key |
string | Yes | Caller-supplied durable idempotency key. Reuse only for the identical operation. maxLength: 200; minLength: 1 |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
version |
integer | Yes | The booking version from get_product_booking. A stale version is refused. minimum: 1 |
additionalProperties: false; required: ["booking_id","version","idempotency_key"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
available_actions |
array of string (fields) | Yes | |
conversation_id |
string | Yes | minLength: 1 |
ok |
boolean | Yes | const: true |
record |
object (fields) | Yes | required: ["id","kind","status","party_size","starts_at","ends_at","timezone","assigned_member_id","location_id","product_id","product_kind","product_name"] |
status |
number | Yes | const: 200 |
thread |
object (fields) | Yes | required: ["id","kind"] |
required: ["ok","status","conversation_id","record","available_actions","thread"]
Reject product booking — reject_product_booking
Decline a pending product booking or consultation, release its places and email the guest. A required refund returns financial_action_required and a dashboard URL before status changes.
Minimum role: member. Required entitlement: None.
Annotations: title: Reject product booking, readOnlyHint: false, openWorldHint: true, destructiveHint: true, idempotentHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
booking_id |
string | Yes | Booking ID returned by list_product_bookings or create_product_booking. Distinct from conversation_id, which identifies the inbox conversation. |
idempotency_key |
string | Yes | Caller-supplied durable idempotency key. Reuse only for the identical operation. maxLength: 200; minLength: 1 |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
version |
integer | Yes | The booking version from get_product_booking. A stale version is refused. minimum: 1 |
additionalProperties: false; required: ["booking_id","version","idempotency_key"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
available_actions |
array of string (fields) | Yes | |
conversation_id |
string | Yes | minLength: 1 |
ok |
boolean | Yes | const: true |
record |
object (fields) | Yes | required: ["id","kind","status","party_size","starts_at","ends_at","timezone","assigned_member_id","location_id","product_id","product_kind","product_name"] |
status |
number | Yes | const: 200 |
thread |
object (fields) | Yes | required: ["id","kind"] |
required: ["ok","status","conversation_id","record","available_actions","thread"]
Request product booking change — request_product_booking_change
Propose a different session or party size to the guest, or apply the move now when allowed. A proposal emails the guest a link to accept or decline and the booking stays as it is until they accept; send no separate message about it. Legal consultation time changes require client acceptance. Give product_id for a table move to a different offering, or to move a stay to another home. For a stay, apply must be true; the guest receives the new arrival instructions.
Minimum role: member. Required entitlement: None.
Annotations: title: Request product booking change, readOnlyHint: false, openWorldHint: true, destructiveHint: true, idempotentHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
apply |
boolean | No | |
booking_id |
string | Yes | Booking ID returned by list_product_bookings or create_product_booking. Distinct from conversation_id, which identifies the inbox conversation. |
idempotency_key |
string | Yes | Caller-supplied durable idempotency key. Reuse only for the identical operation. maxLength: 200; minLength: 1 |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
party_size |
integer | No | maximum: 99; minimum: 1 |
product_id |
string | No | minLength: 1 |
product_session_id |
string | No | minLength: 1 |
version |
integer | Yes | The booking version from get_product_booking. A stale version is refused. minimum: 1 |
additionalProperties: false; required: ["booking_id","version","idempotency_key"]
Output
Output: object.
Update product booking — update_product_booking
Edit the team’s private notes, or update the dates, party and guest details of a host-entered stay. Use the latest booking version. Use request_product_booking_change for timed inventory changes.
Minimum role: member. Required entitlement: None.
Annotations: title: Update product booking, readOnlyHint: false, openWorldHint: true, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
adults |
integer | No | maximum: 99; minimum: 1 |
arrival_time |
string or null | No | The local time the guest said they arrive; the stay starts then instead of at the home's check-in time. Null or omitted is the check-in time. pattern: "^([01]\d|2[0-3]):[0-5]\d$" |
booking_id |
string | Yes | Booking ID returned by list_product_bookings or create_product_booking. Distinct from conversation_id, which identifies the inbox conversation. |
check_in_date |
string | No | pattern: "^\d{4}-\d{2}-\d{2}$" |
check_out_date |
string | No | The morning the guest leaves; the stay holds the nights before it. pattern: "^\d{4}-\d{2}-\d{2}$" |
children |
integer | No | maximum: 99; minimum: 0 |
guest_email |
string or null | No | |
guest_name |
string | No | The guest's full name. maxLength: 200; minLength: 1 |
guest_phone |
string or null | No | International number with its country calling code, e.g. +66812345678. |
infants |
integer | No | maximum: 99; minimum: 0 |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
private_notes |
string or null | No | The host's own note, never shown to the guest. maxLength: 2000 |
total_minor |
integer | No | Whole minor units of the organization currency, e.g. cents. minimum: 0 |
version |
integer | Yes | The booking version from get_product_booking. A stale version is refused. minimum: 1 |
additionalProperties: false; required: ["booking_id","version"]
anyOf: shape 1, shape 2, shape 3, shape 4, shape 5, shape 6, shape 7, shape 8, shape 9, shape 10, shape 11.
Output
Output: object.
Update product session — update_product_session
Edit one session’s time, capacity or state using its current timestamp. Committed bookings or checkout holds prevent time or state changes; use the guest booking-change workflow. A restaurant table's seatings are not edited one by one: change its location's hours, special hours or closures.
Minimum role: member. Required entitlement: None.
Annotations: title: Update product session, readOnlyHint: false, openWorldHint: true, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
capacity |
integer or null | No | minimum: 0 |
ends_at |
string | No | format: "date-time" |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
product_id |
string | Yes | minLength: 1 |
product_session_id |
string | Yes | minLength: 1 |
starts_at |
string | No | format: "date-time" |
status |
string | No | enum: ["scheduled","cancelled"] |
updated_at |
string or null | Yes | Session updated_at from list_product_booking_sessions, or null for a recurring time with no saved change or booking. |
additionalProperties: false; required: ["product_id","product_session_id","updated_at"]
anyOf: shape 1, shape 2, shape 3, shape 4.
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
session |
object (fields) | Yes | required: ["id","organization_id","product_id","location_id","starts_at","ends_at","timezone","capacity","status","claimed","remaining","is_full","updated_at"] |
required: ["session"]
Content
Append content block — append_content_block
Add a block to an existing article or site page, returning the changed block and document timestamp. An image in the first article block becomes its cover.
Minimum role: admin. Required entitlement: None.
Annotations: title: Append content block, readOnlyHint: false, openWorldHint: true, destructiveHint: false.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
after_block_id |
string or null | No | The block this one follows. Omit to append at the end. |
data |
#/$defs/content_heading or #/$defs/content_markdown or #/$defs/content_image or #/$defs/content_gallery or #/$defs/content_video or #/$defs/content_faq or #/$defs/content_how_to or #/$defs/content_divider or #/$defs/content_cta or #/$defs/content_contact_cta or #/$defs/content_booking_cta or #/$defs/content_callout or #/$defs/content_hero or #/$defs/content_button_group or #/$defs/content_feature_grid or #/$defs/content_comparison or #/$defs/content_stat_grid or #/$defs/content_workflow_grid or #/$defs/content_showcase or #/$defs/content_language_reach or #/$defs/content_steps or #/$defs/content_video_feature or #/$defs/content_media_text or #/$defs/content_contact_form or #/$defs/content_team_grid or #/$defs/content_testimonial_grid or #/$defs/content_donation_choices or #/$defs/content_page_grid or #/$defs/content_product_grid or #/$defs/content_location_grid or #/$defs/content_social_posts or #/$defs/content_ai_assistance (fields) | Yes | |
document_id |
string | Yes | The blog post id or site page variant id. |
level |
integer or null | No | Heading blocks only. maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | No | Required on image blocks: one item, the picture. Send a block's media as a read returned it. |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
type |
string | Yes | enum: ["heading","markdown","image","gallery","video","faq","how_to","divider","cta","contact_cta","booking_cta","callout","hero","button_group","feature_grid","comparison","stat_grid","workflow_grid","showcase","language_reach","steps","video_feature","media_text","contact_form","team_grid","testimonial_grid","donation_choices","page_grid","product_grid","location_grid","social_posts","ai_assistance"] |
additionalProperties: false; required: ["document_id","type","data"]
anyOf: shape 1, shape 2, shape 3, shape 4, shape 5, shape 6, shape 7, shape 8, shape 9, shape 10, shape 11, shape 12, shape 13, shape 14, shape 15, shape 16, shape 17, shape 18, shape 19, shape 20, shape 21, shape 22, shape 23, shape 24, shape 25, shape 26, shape 27, shape 28, shape 29, shape 30, shape 31, shape 32.
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
blocks |
array of object (fields) | Yes | Changed blocks with IDs and timestamps; empty after deletion. |
document_id |
string | Yes | |
updated_at |
string | Yes | The document's new concurrency token. |
additionalProperties: false; required: ["document_id","updated_at","blocks"]
Create site page — create_site_page
Add a new authored site page or a new language version of an existing source page. Existing document IDs and occupied language paths are refused; existing pages and their content are retained. Supply the actual content for the named language; no translation is generated. Pages on a live site can become public immediately. Returns the new document, blocks and editor information.
Minimum role: admin. Required entitlement: None.
Annotations: title: Create site page, readOnlyHint: false, openWorldHint: true, destructiveHint: false.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
blocks |
array of object (fields) | Yes | Ordered blocks for the new page. Existing pages and their blocks are not replaced. Block data contains no asset IDs or delivery URLs; use each block’s media field for its saved media placements. |
locale |
string or null | No | Authored language of the new page version. Omit or use null for the site’s source language. |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
page_id |
string or null | No | Existing source page ID only when adding a new secondary-language version. Omit or use null for a new source page. |
page_type |
string | No | Type of a new source page. A language version inherits its source page’s type; omit this field or supply the same type. enum: ["custom","recipe","legal","system"] |
path |
string | Yes | New unused path in this language. An occupied path or redirect is refused; creation does not move an existing page. |
recipe |
string or null | No | Template section a new source page fills, or null for none. A language version inherits its source page’s recipe when omitted; an explicit value, including null, must match the source. |
sort_order |
number | No | Position of a new source page in the site’s page list. Language versions inherit the source page’s position and must omit this field. |
summary |
string or null | No | Summary of the new page; null means no summary. |
title |
string | Yes | The page's name, e.g. About. The site name is appended to the browser title. Always sent in full — an omitted title is not kept. |
variant_id |
string or null | No | Optional new document ID. An existing document ID is refused. |
additionalProperties: false; required: ["path","title","blocks"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
page |
object (fields) | Yes | required: ["id","page_id","organization_id","product_id","locale","path","title","summary","page_type","recipe","sort_order","updated_at","blocks","document","admin_edit_url"] |
required: ["page"]
Delete content block — delete_content_block
Permanently delete one block and its descendants from an article or site page; published content changes immediately. Returns the document timestamp and no blocks.
Minimum role: admin. Required entitlement: None.
Annotations: title: Delete content block, readOnlyHint: false, openWorldHint: true, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
block_id |
string | Yes | |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
updated_at |
string | Yes | The block's updated_at from the last read. |
additionalProperties: false; required: ["block_id","updated_at"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
blocks |
array of object (fields) | Yes | Changed blocks with IDs and timestamps; empty after deletion. |
document_id |
string | Yes | |
updated_at |
string | Yes | The document's new concurrency token. |
additionalProperties: false; required: ["document_id","updated_at","blocks"]
Delete site page — delete_site_page
Delete the selected site page or translation. Deleting a translation removes that translation; deleting the source locale removes the page and every translation with it, and the response names the locales that went. A required site page cannot be deleted, because its route would then have nothing to show.
Minimum role: admin. Required entitlement: None.
Annotations: title: Delete site page, readOnlyHint: false, openWorldHint: true, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
updated_at |
string | Yes | The document timestamp from the last read, so a page edited since is refused rather than silently removed. |
variant_id |
string | Yes |
additionalProperties: false; required: ["variant_id","updated_at"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
deleted |
object (fields) | Yes | required: ["id","path","locale","removed_locales"] |
required: ["deleted"]
Get site page — get_site_page
Read one site-page language variant, including its path, title, ordered blocks and current timestamp. Use its returned IDs and concurrency information for edits.
Minimum role: admin. Required entitlement: None.
Annotations: title: Get site page, readOnlyHint: true, idempotentHint: true, openWorldHint: false, destructiveHint: false.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
variant_id |
string | Yes |
additionalProperties: false; required: ["variant_id"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
page |
object (fields) | Yes | required: ["id","page_id","organization_id","product_id","locale","path","title","summary","page_type","recipe","sort_order","updated_at","blocks","document","admin_edit_url"] |
required: ["page"]
List site pages — list_site_pages
List authored pages and built-in public routes. Catalog routes display published products; they do not require custom page creation.
Minimum role: admin. Required entitlement: None.
Annotations: title: List site pages, readOnlyHint: true, idempotentHint: true, openWorldHint: false, destructiveHint: false.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
cursor |
string | No | Opaque next_cursor from the previous page. |
limit |
number | No | Page size. Defaults to 50; maximum 100. maximum: 100; minimum: 1 |
locale |
string or null | No | |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
additionalProperties: false; required: []
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
built_in_pages |
array of object (fields) | Yes | |
page_info |
object (fields) | Yes | required: ["has_more","next_cursor"] |
pages |
array of object (fields) | Yes |
required: ["pages","built_in_pages","page_info"]
Replace content block — replace_content_block
Replace one block’s complete data, keeping its ID and position; published content changes immediately. Read it first and preserve content outside the requested change; returns the changed block and document timestamp.
Minimum role: admin. Required entitlement: None.
Annotations: title: Replace content block, readOnlyHint: false, openWorldHint: true, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
block_id |
string | Yes | |
data |
#/$defs/content_heading or #/$defs/content_markdown or #/$defs/content_image or #/$defs/content_gallery or #/$defs/content_video or #/$defs/content_faq or #/$defs/content_how_to or #/$defs/content_divider or #/$defs/content_cta or #/$defs/content_contact_cta or #/$defs/content_booking_cta or #/$defs/content_callout or #/$defs/content_hero or #/$defs/content_button_group or #/$defs/content_feature_grid or #/$defs/content_comparison or #/$defs/content_stat_grid or #/$defs/content_workflow_grid or #/$defs/content_showcase or #/$defs/content_language_reach or #/$defs/content_steps or #/$defs/content_video_feature or #/$defs/content_media_text or #/$defs/content_contact_form or #/$defs/content_team_grid or #/$defs/content_testimonial_grid or #/$defs/content_donation_choices or #/$defs/content_page_grid or #/$defs/content_product_grid or #/$defs/content_location_grid or #/$defs/content_social_posts or #/$defs/content_ai_assistance (fields) | Yes | Complete replacement data; omitted fields are removed. |
media |
array of #/$defs/content_block_media (fields) | No | Omit to retain existing placements; supply the complete array to replace them. |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
updated_at |
string | Yes | The block's updated_at from the last read. |
additionalProperties: false; required: ["block_id","updated_at","data"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
blocks |
array of object (fields) | Yes | Changed blocks with IDs and timestamps; empty after deletion. |
document_id |
string | Yes | |
updated_at |
string | Yes | The document's new concurrency token. |
additionalProperties: false; required: ["document_id","updated_at","blocks"]
Update site page — update_site_page
Replace a page’s metadata and complete ordered blocks using its current timestamp. Omitted summary and product binding retain their values; removing blocks requires their exact IDs.
Minimum role: admin. Required entitlement: None.
Annotations: title: Update site page, readOnlyHint: false, openWorldHint: true, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
blocks |
array of object (fields) | Yes | Complete canonical block array. Each existing block must retain its id unless its removal is explicitly confirmed. Block data never contains asset IDs or delivery URLs. Omit media to preserve that block's current placements; provide media explicitly to replace them, or call set_media with owner_type "content_block", the block id, and the intended slot. |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
page_type |
string | Yes | The page's type. Send the page_type from the last read unless you are changing it. enum: ["custom","recipe","legal","system"] |
path |
string | Yes | The saved page path. A page keeps this address when its content or title changes. |
product_id |
string or null | No | Explicit canonical Product binding on the source page only. Omit to retain; null unbinds. Translations inherit the source binding; slugs never imply a relationship. |
recipe |
string or null | Yes | The site section this page fills, or null for a page that fills none. Send the recipe from the last read unless you are changing it; an omitted recipe is not kept. |
removed_block_ids |
array of string (fields) | No | Exact existing block IDs omitted from the replacement; omit when none are removed. |
sort_order |
number | Yes | The page's position in the site's page list. Send the sort_order from the last read unless you are reordering. |
summary |
string or null | No | Omit to preserve on update; null clears it. |
title |
string | Yes | The page's name, e.g. About. The site name is appended to the browser title. Always sent in full — an omitted title is not kept. |
updated_at |
string | Yes | |
variant_id |
string | Yes |
additionalProperties: false; required: ["variant_id","updated_at","path","title","page_type","recipe","sort_order","blocks"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
page |
object (fields) | Yes | required: ["id","page_id","organization_id","product_id","locale","path","title","summary","page_type","recipe","sort_order","updated_at","blocks","document","admin_edit_url"] |
required: ["page"]
Context
Get workspace context — get_workspace_context
Read the selected business and location and the businesses available to the signed-in user. Selection uses the saved MCP workspace; without an accessible saved business, the only accessible business is selected, or no business is selected when several are available. Use the returned internal organization and location IDs in later tools.
Minimum role: member. Required entitlement: None.
Annotations: title: Get workspace context, readOnlyHint: true, idempotentHint: true, openWorldHint: false, destructiveHint: false.
Authentication: oauth2, scopes tenant.
Input
Input: object.
additionalProperties: false
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
context |
object (fields) | Yes | The business this call acted on, its public website origin, and the location the call named, or null location fields when it named none. additionalProperties: false; required: ["organization_id","organization_name","organization_slug","organization_subdomain","organization_public_url","location_id","location_slug","location_title"] |
locations |
array of object (fields) | Yes | |
organizations |
array of object (fields) | Yes |
required: ["context","organizations","locations"]
Set workspace context — set_workspace_context
Save the selected business or location for the signed-in user, shared across their MCP connections. Read get_workspace_context or list_organizations for organization IDs and list_locations for location IDs. Supply at least one ID. Omitted organization uses the current selection; omitted location keeps the saved location within the same business and is unset when changing businesses. Explicit IDs on later tools override this saved selection.
Minimum role: member. Required entitlement: None.
Annotations: title: Set workspace context, readOnlyHint: false, openWorldHint: false, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
location_id |
string | No | Internal location ID from list_locations or get_workspace_context, within the selected business. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
organization_id |
string | No | minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
additionalProperties: false
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
context |
object (fields) | Yes | The business this call acted on, its public website origin, and the location the call named, or null location fields when it named none. additionalProperties: false; required: ["organization_id","organization_name","organization_slug","organization_subdomain","organization_public_url","location_id","location_slug","location_title"] |
locations |
array of object (fields) | Yes | |
organizations |
array of object (fields) | Yes | |
success |
boolean | Yes |
required: ["success","context","organizations","locations"]
Conversations
Get conversation — get_conversation
Read the latest page of a conversation you participate in. Entries are in sequence order. Pass page.before to read older messages. Reading does not acknowledge messages.
Minimum role: member. Required entitlement: None.
Annotations: title: Get conversation, readOnlyHint: true, idempotentHint: true, openWorldHint: false, destructiveHint: false.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
before |
integer | No | minimum: 1 |
conversation_id |
string | Yes | A conversation_id from list_conversations, start_conversation or a booking read. minLength: 1 |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
additionalProperties: false; required: ["conversation_id"]
Output
Output: object.
List conversation recipients — list_conversation_recipients
Read the current organization members you can start a team conversation with. Select actual user IDs from these results; current_user_id identifies you. It does not include guests.
Minimum role: member. Required entitlement: None.
Annotations: title: List conversation recipients, readOnlyHint: true, idempotentHint: true, openWorldHint: false, destructiveHint: false.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
additionalProperties: false; required: []
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
current_user_id |
string | Yes | |
members |
array of object (fields) | Yes |
required: ["current_user_id","members"]
List conversations — list_conversations
Read Messages: every conversation you can see, newest first — guests (contacts and bookings: classes, consultations, tables and stays), Airbnb Support and your team conversations — with unread counts per kind as the filter menu shows them. Filter by kind, current/past/blocked, unread, type and words. Follow page_info. Read one with get_conversation.
Minimum role: member. Required entitlement: None.
Annotations: title: List conversations, readOnlyHint: true, idempotentHint: true, openWorldHint: false, destructiveHint: false.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
cursor |
string | No | Opaque next_cursor from the previous page. |
kind |
string | No | enum: ["all","guests","support","team"] |
limit |
number | No | Page size. Defaults to 50; maximum 100. maximum: 100; minimum: 1 |
location_id |
string | No | minLength: 1 |
mailbox |
string | No | enum: ["current","past","blocked"] |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
q |
string | No | Words in the guest’s name, the home or the messages. maxLength: 200; minLength: 1 |
type |
string | No | Guest conversations of this kind only. enum: ["contact","booking","stay"] |
unread |
boolean | No | Only conversations with a message from someone else you have not read. |
additionalProperties: false; required: []
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
conversations |
array of object (fields) | Yes | |
has_unread |
boolean | Yes | Your Current mailbox holds an unread conversation, whatever this page's filters. |
page_info |
object (fields) | Yes | required: ["has_more","next_cursor"] |
required: ["conversations","has_unread","page_info"]
Mark conversation read — mark_conversation_read
Mark a conversation read for you, through its newest message or through message_id (the newest one you were shown). Needs a message from someone else (409 NOTHING_TO_MARK). Changes only your own read position; sends nothing and changes nobody else’s unread state.
Minimum role: member. Required entitlement: None.
Annotations: title: Mark conversation read, readOnlyHint: false, openWorldHint: false, destructiveHint: true, idempotentHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
conversation_id |
string | Yes | A conversation_id from list_conversations, start_conversation or a booking read. minLength: 1 |
message_id |
string | No | minLength: 1 |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
additionalProperties: false; required: ["conversation_id"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
conversation_id |
string | Yes | |
last_read_message_id |
string or null | Yes | |
unread |
boolean | Yes |
additionalProperties: false; required: ["conversation_id","unread","last_read_message_id"]
Mark conversation unread — mark_conversation_unread
Mark a conversation unread for you: its newest message from someone else is unread again. Needs a message from someone else (409 NOTHING_TO_MARK). Changes only your own read position.
Minimum role: member. Required entitlement: None.
Annotations: title: Mark conversation unread, readOnlyHint: false, openWorldHint: false, destructiveHint: true, idempotentHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
conversation_id |
string | Yes | A conversation_id from list_conversations, start_conversation or a booking read. minLength: 1 |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
additionalProperties: false; required: ["conversation_id"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
conversation_id |
string | Yes | |
last_read_message_id |
string or null | Yes | |
unread |
boolean | Yes |
additionalProperties: false; required: ["conversation_id","unread","last_read_message_id"]
Send message — send_message
Send text and/or one photo in a conversation, as you. Check conversation.composer.channel from get_conversation. Airbnb replies accept text or one photo, sent separately. Email replies accept text, a photo or both. A guest with neither email nor account is refused with GUEST_UNREACHABLE. Team replies reach participants according to their notification choices. Reuse the same idempotency_key for an identical retry. A failed Airbnb attempt may retry only when retry_with_same_idempotency_key is true; a realtime failure may report committed:true and must retry that same request. A saved message does not prove delivery.
Minimum role: member. Required entitlement: None.
Annotations: title: Send message, readOnlyHint: false, openWorldHint: true, destructiveHint: true, idempotentHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
conversation_id |
string | Yes | A conversation_id from list_conversations, start_conversation or a booking read. minLength: 1 |
file |
object (fields) | No | Optional photo supplied as a ChatGPT file attachment. required: ["download_url","file_id"] |
idempotency_key |
string | Yes | maxLength: 128; minLength: 8; pattern: "^[a-zA-Z0-9_-]{8,128}$" |
message |
string | No | maxLength: 5000; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
additionalProperties: false; required: ["conversation_id","idempotency_key"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
conversation_id |
string | Yes | |
message |
object (fields) | Yes | required: ["id","sequence"] |
required: ["conversation_id","message"]
File parameters: file.
Set conversation archived — set_conversation_archived
Archive a conversation for yourself (it moves to Past until someone else writes in it) or restore it. It cancels no booking, sends nothing and leaves everyone else’s Messages unchanged. A conversation quiet for 30 days stays in Past; a blocked one is in Blocked.
Minimum role: member. Required entitlement: None.
Annotations: title: Set conversation archived, readOnlyHint: false, openWorldHint: false, destructiveHint: true, idempotentHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
archived |
boolean | Yes | |
conversation_id |
string | Yes | A conversation_id from list_conversations, start_conversation or a booking read. minLength: 1 |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
additionalProperties: false; required: ["conversation_id","archived"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
archived |
boolean | Yes | |
conversation_id |
string | Yes |
additionalProperties: false; required: ["conversation_id","archived"]
Start conversation — start_conversation
Start a team conversation with explicitly selected workspace members. Direct and booking/location conversations reuse the same participants and context. A manual conversation with at least three people is a distinct group, can have a name, and requires a stable idempotency_key; reuse that key only for an identical retry. Maximum 50 people including you. This sends no message and invites nobody. Choose actual users from list_conversation_recipients. Guests are never added; a guest conversation starts when the guest writes or books.
Minimum role: member. Required entitlement: None.
Annotations: title: Start conversation, readOnlyHint: false, openWorldHint: false, destructiveHint: false, idempotentHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
booking_id |
string | No | Optional booking ID you may read, a stay’s included. minLength: 1 |
idempotency_key |
string | No | Required for a manually created group. Keep the same key for an identical retry. maxLength: 200; minLength: 1 |
location_id |
string | No | Optional explicit location context you may read. minLength: 1 |
member_user_ids |
array of string (fields) | Yes | maxItems: 49; minItems: 1; uniqueItems: true |
name |
string | No | Optional name for a manually created group of at least three people; unavailable for direct or booking/location conversations. maxLength: 100; minLength: 1 |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
additionalProperties: false; required: ["member_user_ids"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
conversation_id |
string | Yes | |
created |
boolean | Yes |
required: ["conversation_id","created"]
Update conversation group — update_conversation_group
Rename, add people to, remove someone from, or leave a manually created team group. The creator and participating workspace owners/admins can manage it; any participant can leave. Read capabilities.can_manage_participants and capabilities.can_leave from get_conversation. Direct chats, guest conversations and booking/location conversations are protected. No action deletes the conversation or its messages. New members can read its history; removed members lose access. Use a stable idempotency_key and retry exactly the same action if committed:true is returned.
Minimum role: member. Required entitlement: None.
Annotations: title: Update conversation group, readOnlyHint: false, openWorldHint: false, destructiveHint: true, idempotentHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
action |
string | Yes | enum: ["rename","add","remove","leave"] |
conversation_id |
string | Yes | A conversation_id from list_conversations, start_conversation or a booking read. minLength: 1 |
idempotency_key |
string | Yes | maxLength: 200; minLength: 1 |
member_user_ids |
array of string (fields) | No | Add only: current workspace users to add. maxItems: 49; minItems: 1; uniqueItems: true |
name |
string or null | No | Rename only: a name, or null to clear it. maxLength: 100; minLength: 1 |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
user_id |
string | No | Remove only: the participant to remove. Use leave to remove yourself. minLength: 1 |
additionalProperties: false; required: ["conversation_id","action","idempotency_key"]
oneOf: shape 1, shape 2, shape 3, shape 4.
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
conversation_id |
string | Yes | |
status |
string | Yes | enum: ["updated","left"] |
required: ["status","conversation_id"]
Google ads
Create Google Ads search campaign — create_google_ads_search_campaign
Create a paused Google Ads Search campaign with one ad group and responsive search ad from the supplied keywords, copy, destination and daily budget. The campaign cannot serve ads until separately enabled. Each call creates a new campaign; inspect the account before retrying an uncertain result.
Minimum role: admin. Required entitlement: google_ads_management.
Annotations: title: Create Google Ads search campaign, readOnlyHint: false, openWorldHint: true, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
contains_eu_political_advertising |
boolean | Yes | Whether the campaign contains EU political advertising. Google requires this self-declaration on every new campaign; ask the user rather than assuming. |
daily_budget_micros |
integer | Yes | Daily budget in micros (e.g. 10000000 for 10 units in account currency). minimum: 1000000 |
descriptions |
array of string (fields) | Yes | Descriptions for Responsive Search Ad (2 to 4, max 90 chars each). maxItems: 4; minItems: 2; uniqueItems: true |
headlines |
array of string (fields) | Yes | Headlines for Responsive Search Ad (3 to 15, max 30 chars each). maxItems: 15; minItems: 3; uniqueItems: true |
keywords |
array of object (fields) | Yes | Keywords to target with optional match type (default PHRASE). |
name |
string | Yes | Campaign name. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
target_url |
string | Yes | Destination landing page or blog post URL (must start with http:// or https://). |
additionalProperties: false; required: ["name","daily_budget_micros","target_url","keywords","headlines","descriptions","contains_eu_political_advertising"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
campaign_id |
string | Yes | |
status |
string | Yes | const: "PAUSED" |
required: ["campaign_id","status"]
Get Google Ads campaign — get_google_ads_campaign
Read a campaign in the connected Google Ads account when inspecting its status, budget, ad groups, keywords, responsive search ad copy or destination URLs.
Minimum role: admin. Required entitlement: None.
Annotations: title: Get Google Ads campaign, readOnlyHint: true, idempotentHint: true, openWorldHint: false, destructiveHint: false.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
campaign_id |
string | Yes | Numeric Google Ads campaign ID. pattern: "^[0-9]+$" |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
additionalProperties: false; required: ["campaign_id"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
adGroups |
array of object (fields) | Yes | |
budgetAmountMicros |
number | Yes | |
budgetId |
string or null | No | |
channelType |
string | Yes | |
clicks |
number | Yes | |
conversions |
number | Yes | |
costMicros |
number | Yes | |
currency |
string | Yes | Connected account currency; budget and spend micros are millionths of this currency. |
descriptions |
array of string (fields) | Yes | |
finalUrls |
array of string (fields) | Yes | |
headlines |
array of string (fields) | Yes | |
id |
string | Yes | |
impressions |
number | Yes | |
keywords |
array of object (fields) | Yes | |
name |
string | Yes | |
status |
string | Yes |
required: ["id","currency","name","status","channelType","budgetAmountMicros","clicks","impressions","costMicros","conversions","adGroups","keywords","headlines","descriptions","finalUrls"]
List Google Ads campaigns — list_google_ads_campaigns
List up to 100 campaigns in the connected Google Ads account, most spend first, with status, daily budget, spend, impressions, clicks and conversions. With start_date and end_date the metrics cover those days in the account time zone and include campaigns removed since; without them they are all-time for campaigns not removed. Reading is free with the connection.
Minimum role: admin. Required entitlement: None.
Annotations: title: List Google Ads campaigns, readOnlyHint: true, idempotentHint: true, openWorldHint: false, destructiveHint: false.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
end_date |
string | No | Last day of the metrics, inclusive. Requires start_date. pattern: "^\d{4}-\d{2}-\d{2}$" |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
start_date |
string | No | First day of the metrics, YYYY-MM-DD in the account time zone. Requires end_date. pattern: "^\d{4}-\d{2}-\d{2}$" |
status |
string | No | Filter campaigns by status: ENABLED, PAUSED, or ALL non-removed campaigns (default: ALL). enum: ["ENABLED","PAUSED","ALL"] |
additionalProperties: false; required: []
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
campaigns |
array of object (fields) | Yes | |
currency |
string | Yes | Connected account currency; budget and spend micros are millionths of this currency. |
customer_id |
string | Yes | |
end_date |
string or null | Yes | |
start_date |
string or null | Yes | |
time_zone |
string | Yes | The account time zone the dates are in. |
required: ["customer_id","currency","time_zone","start_date","end_date","campaigns"]
Query Google Ads report — query_google_ads_report
Read a Google Ads report for chosen days from the connected account: campaign_daily (each campaign per day), search_terms, keywords, landing_pages or geography (countries), with impressions, clicks, spend, conversions and conversion value. Dates are in the account time zone; spend is micros of the account currency. Google omits low-volume search terms for privacy, so a missing term is not zero demand. Reading is free with the connection.
Minimum role: admin. Required entitlement: None.
Annotations: title: Query Google Ads report, readOnlyHint: true, idempotentHint: true, openWorldHint: false, destructiveHint: false.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
campaign_id |
string | No | Only this campaign. pattern: "^[0-9]+$" |
end_date |
string | Yes | Last day, inclusive. pattern: "^\d{4}-\d{2}-\d{2}$" |
limit |
integer | No | Rows to return, most clicks first; campaign_daily is by day (default 100). maximum: 10000; minimum: 1 |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
report |
string | Yes | campaign_daily: each campaign per day; search_terms: what people searched; keywords: the keywords that matched; landing_pages: the final URLs ads sent people to; geography: the countries clicks came from. enum: ["campaign_daily","search_terms","keywords","landing_pages","geography"] |
start_date |
string | Yes | First day, YYYY-MM-DD in the account time zone. pattern: "^\d{4}-\d{2}-\d{2}$" |
additionalProperties: false; required: ["report","start_date","end_date"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
currency |
string | Yes | Connected account currency; costMicros are millionths of it. |
customer_id |
string | Yes | |
end_date |
string | Yes | |
report |
string | Yes | |
rows |
array of object (fields) | Yes | |
start_date |
string | Yes | |
time_zone |
string | Yes |
required: ["customer_id","currency","time_zone","report","start_date","end_date","rows"]
Update Google Ads campaign — update_google_ads_campaign
Pause, enable or change the daily budget of a selected campaign in the connected Google Ads account. Supply status, the budget_id/daily_budget_micros pair, or both. Read get_google_ads_campaign or list_google_ads_campaigns for the current budget ID and account currency first. Enabling or raising a budget can increase advertising spend; changing a shared budget affects every campaign using it.
Minimum role: admin. Required entitlement: google_ads_management.
Annotations: title: Update Google Ads campaign, readOnlyHint: false, openWorldHint: true, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
budget_id |
string | No | Budget ID returned for this campaign by get_google_ads_campaign or list_google_ads_campaigns. Required with daily_budget_micros; shared budget changes affect every campaign using it. pattern: "^[0-9]+$" |
campaign_id |
string | Yes | Google Ads campaign ID to update. pattern: "^[0-9]+$" |
daily_budget_micros |
integer | No | New daily budget in micros. Required with budget_id. minimum: 1000000 |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
status |
string | No | New campaign status (ENABLED or PAUSED). enum: ["ENABLED","PAUSED"] |
additionalProperties: false; required: ["campaign_id"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
budget_id |
string or null | No | |
campaign_id |
string | Yes | |
daily_budget_micros |
integer or null | No | |
status |
string or null | No |
required: ["campaign_id"]
Guest messaging
Cancel scheduled guest message — cancel_scheduled_guest_message
Cancel one pending outbox message: one of your own send-later replies, or, for a workspace manager, an automatic guest message. A message already sending, sent or requiring review cannot be cancelled or resent by this operation.
Minimum role: member. Required entitlement: None.
Annotations: title: Cancel scheduled guest message, readOnlyHint: false, openWorldHint: false, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
scheduled_message_id |
string | Yes | minLength: 1 |
additionalProperties: false; required: ["scheduled_message_id"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
message |
object (fields) | Yes | additionalProperties: false; required: ["id","status"] |
required: ["message"]
Create message template — create_message_template
Create an automatic guest message, sent into the conversation of every stay, product booking (experience, consultation or restaurant table) on the named offerings, at the scheduled time in each booking’s own timezone. A cancelled booking’s pending messages are cancelled and a moved one’s follow it. It plans only eligible future events; ambiguous or nonexistent local times fail visibly. Every confirmed stay is already sent its home’s check-in instructions at 10:00 the day before arrival, so the name “Check-in instructions” is reserved.
Minimum role: admin. Required entitlement: None.
Annotations: title: Create message template, readOnlyHint: false, openWorldHint: true, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
body |
string | Yes | maxLength: 5000; minLength: 1 |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
schedule |
object (fields) | Yes | |
title |
string | Yes | maxLength: 100; minLength: 1 |
additionalProperties: false; required: ["title","body","schedule"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
template |
object (fields) | Yes | required: ["id","organization_id","title","body","schedule","version","created_at","updated_at"] |
required: ["template"]
Delete message template — delete_message_template
Delete an automatic message using its current version and cancel its pending messages. Earlier delivery snapshots remain recorded; an in-flight send cannot be recalled.
Minimum role: admin. Required entitlement: None.
Annotations: title: Delete message template, readOnlyHint: false, openWorldHint: false, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
template_id |
string | Yes | minLength: 1 |
version |
integer | Yes | minimum: 1 |
additionalProperties: false; required: ["template_id","version"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
status |
string | Yes | const: "deleted" |
template_id |
string | Yes | minLength: 1 |
required: ["template_id","status"]
Get guest messaging context — get_guest_messaging_context
Read what a canonical guest conversation is about: its booked record (a stay or booking: what, where, for how many and when, in its own timezone), and for a home its listing and stay, including private check-in instructions the host may choose to share. An inquiry has no record; a channel inquiry can have a home without a booked stay.
Minimum role: member. Required entitlement: None.
Annotations: title: Get guest messaging context, readOnlyHint: true, idempotentHint: true, openWorldHint: false, destructiveHint: false.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
conversation_id |
string | Yes | minLength: 1 |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
additionalProperties: false; required: ["conversation_id"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
conversation_id |
string | Yes | minLength: 1 |
home |
object or null (fields) | Yes | additionalProperties: false; required: ["product_id","name","timezone","check_in_method","check_in_instructions","wifi_network","wifi_password","directions","house_manual","checkout_instructions"] |
record |
object or null (fields) | Yes | The stay or booking (a class, consultation or table) the conversation is about, as its guest reads it; null for an inquiry. starts and ends are local to timezone: a date, or a date and time. required: ["unit","status","name","location","address","phone","party_size","timezone","starts","ends","no_show_at"] |
stay |
object or null (fields) | Yes | additionalProperties: false; required: ["id","product_id","status","check_in_date","check_out_date","guest_name","adults","children","infants"] |
required: ["conversation_id","home","stay","record"]
List message templates — list_message_templates
Read the workspace’s automatic guest messages: text the server sends every guest or client booked on the named homes, experiences, consultations or restaurant table products, on its own schedule. Follow page_info for every page.
Minimum role: member. Required entitlement: None.
Annotations: title: List message templates, readOnlyHint: true, idempotentHint: true, openWorldHint: false, destructiveHint: false.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
cursor |
string | No | Opaque next_cursor from the previous page. |
limit |
number | No | Page size. Defaults to 50; maximum 100. maximum: 100; minimum: 1 |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
additionalProperties: false; required: []
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
page_info |
object (fields) | Yes | required: ["has_more","next_cursor"] |
templates |
array of object (fields) | Yes |
required: ["templates","page_info"]
List scheduled guest messages — list_scheduled_guest_messages
Read the outbox, newest first, optionally for one canonical guest conversation: your own send-later replies (author_user_id is you), and for workspace managers every automatic guest-message snapshot with its visible failure reason for every booking (booking_id names it, a stay’s included), including each stay’s built-in check-in message (template_id null, template_title “Check-in instructions”). Teammates’ send-later replies are not visible. Read provider delivery receipts through get_conversation; no provider result is inferred from a scheduled time.
Minimum role: member. Required entitlement: None.
Annotations: title: List scheduled guest messages, readOnlyHint: true, idempotentHint: true, openWorldHint: false, destructiveHint: false.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
conversation_id |
string | No | minLength: 1 |
cursor |
string | No | Opaque next_cursor from the previous page. |
limit |
number | No | Page size. Defaults to 50; maximum 100. maximum: 100; minimum: 1 |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
additionalProperties: false; required: []
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
messages |
array of object (fields) | Yes | |
page_info |
object (fields) | Yes | required: ["has_more","next_cursor"] |
required: ["messages","page_info"]
Schedule guest reply — schedule_guest_reply
Send your own text reply in a guest conversation later, at due_at (an ISO 8601 instant within the next year). It is sent through the conversation’s reply_channel as your reply, if you can still reach the conversation then. Only you see it pending, in list_scheduled_guest_messages; cancel it with cancel_scheduled_guest_message. Text only: send photos now with send_message.
Minimum role: member. Required entitlement: None.
Annotations: title: Schedule guest reply, readOnlyHint: false, openWorldHint: true, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
body |
string | Yes | maxLength: 5000; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
conversation_id |
string | Yes | minLength: 1 |
due_at |
string | Yes | format: "date-time" |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
additionalProperties: false; required: ["conversation_id","body","due_at"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
message |
object (fields) | Yes | required: ["id","organization_id","product_id","booking_id","conversation_id","author_user_id","template_id","template_title","template_version","body","due_at","timezone","status","reason","error_code","error_field","message_id","started_at","sent_at","created_at","updated_at"] |
required: ["message"]
Update message template — update_message_template
Replace an automatic message and its schedule using the current version. Completed, failed, skipped, cancelled and uncertain deliveries are never recreated by an edit.
Minimum role: admin. Required entitlement: None.
Annotations: title: Update message template, readOnlyHint: false, openWorldHint: true, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
body |
string | Yes | maxLength: 5000; minLength: 1 |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
schedule |
object (fields) | Yes | |
template_id |
string | Yes | minLength: 1 |
title |
string | Yes | maxLength: 100; minLength: 1 |
version |
integer | Yes | minimum: 1 |
additionalProperties: false; required: ["template_id","version","title","body","schedule"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
template |
object (fields) | Yes | required: ["id","organization_id","title","body","schedule","version","created_at","updated_at"] |
required: ["template"]
Update stay arrival guide — update_stay_arrival_guide
Save one home's private arrival guide: check-in method and instructions, wifi, directions, house manual and checkout instructions. Fields left out keep their values; null removes one. Saving does not send anything to a guest or publish it on the site. For a connected Airbnb home, supplied check-in, wifi, directions and house-manual fields return editor links in airbnb_unsynced for the host to check and edit in Airbnb. Checkout instructions are saved only in Blawby.
Minimum role: admin. Required entitlement: None.
Annotations: title: Update stay arrival guide, readOnlyHint: false, openWorldHint: false, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
check_in_instructions |
string or null | No | maxLength: 5000; minLength: 1 |
check_in_method |
string or null | No | How guests get in. enum: ["smart_lock","keypad","lockbox","building_staff","in_person","other",null] |
checkout_instructions |
array of object (fields) | No | What guests do before leaving, in order, each task once; replaces the whole list. |
directions |
string or null | No | maxLength: 5000; minLength: 1 |
house_manual |
string or null | No | maxLength: 5000; minLength: 1 |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
product_id |
string | Yes | minLength: 1 |
wifi_network |
string or null | No | maxLength: 100; minLength: 1 |
wifi_password |
string or null | No | maxLength: 100; minLength: 1 |
additionalProperties: false; required: ["product_id"]
anyOf: shape 1, shape 2, shape 3, shape 4, shape 5, shape 6, shape 7.
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
airbnb_unsynced |
array of object (fields) | Yes | Airbnb editor links for supplied fields that have a mapped editor page. Each entry identifies a field saved in Blawby for the host to check and edit in Airbnb. Empty when no mapped fields were supplied or the home is not connected. |
channel_push |
object or null (fields) | Yes | |
guide |
object (fields) | Yes | additionalProperties: false |
product_id |
string | Yes | minLength: 1 |
additionalProperties: false; required: ["product_id","guide","channel_push","airbnb_unsynced"]
Locales
Add organization language — add_organization_language
Add a supported website language for private authoring. A new language starts disabled; an existing language keeps its publication status and translations while its stored label is refreshed from the platform catalog.
Minimum role: admin. Required entitlement: None.
Annotations: title: Add organization language, readOnlyHint: false, openWorldHint: false, destructiveHint: true, idempotentHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
locale |
string | Yes | enum: ["en","ja","th","vi"] |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
additionalProperties: false; required: ["locale"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
locales |
array of object (fields) | Yes |
additionalProperties: false; required: ["locales"]
Delete organization language — delete_organization_language
Permanently delete a disabled website language and all of its translations. Disable it before deletion. Source content is preserved.
Minimum role: admin. Required entitlement: None.
Annotations: title: Delete organization language, readOnlyHint: false, openWorldHint: false, destructiveHint: true, idempotentHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
locale |
string | Yes | |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
additionalProperties: false; required: ["locale"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
deleted |
boolean | Yes | const: true |
locale |
string | Yes |
additionalProperties: false; required: ["deleted","locale"]
Delete resource localization — delete_resource_localization
Permanently remove one translation and its owned document and redirects. Source content is preserved; imported Q&A remains read-only.
Minimum role: admin. Required entitlement: None.
Annotations: title: Delete resource localization, readOnlyHint: false, openWorldHint: true, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
locale |
string | Yes | |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
resource_id |
string | Yes | |
resource_type |
string | Yes | enum: ["organization","business_location","product","collection","article_category","media_asset","content_document"] |
additionalProperties: false; required: ["resource_type","resource_id","locale"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
context |
object (fields) | Yes | The business this call acted on, its public website origin, and the location the call named, or null location fields when it named none. additionalProperties: false; required: ["organization_id","organization_name","organization_slug","organization_subdomain","organization_public_url","location_id","location_slug","location_title"] |
deleted |
boolean | Yes | |
locale |
string | Yes | |
resource_id |
string | Yes | |
resource_type |
string | Yes | enum: ["organization","business_location","product","collection","article_category","media_asset","content_document"] |
additionalProperties: false; required: ["deleted","resource_type","resource_id","locale","context"]
Disable organization language — disable_organization_language
Disable an existing website language’s public routes while preserving its translations for private authoring. The source language cannot be disabled.
Minimum role: admin. Required entitlement: None.
Annotations: title: Disable organization language, readOnlyHint: false, openWorldHint: true, destructiveHint: true, idempotentHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
locale |
string | Yes | enum: ["en","ja","th","vi"] |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
additionalProperties: false; required: ["locale"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
locales |
array of object (fields) | Yes |
additionalProperties: false; required: ["locales"]
Get product catalog localization — get_product_catalog_localization
Read catalog text and existing translations for an authored secondary language, including its menu sections.
Minimum role: admin. Required entitlement: None.
Annotations: title: Get product catalog localization, readOnlyHint: true, idempotentHint: true, openWorldHint: false, destructiveHint: false.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
locale |
string | Yes | |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
additionalProperties: false; required: ["locale"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
collections |
array of object (fields) | Yes | |
locale |
string | Yes | |
products |
array of object (fields) | Yes |
additionalProperties: false; required: ["locale","products","collections"]
Get resource localization — get_resource_localization
Read the requested resource or document in exactly the named language. A missing translation returns not found rather than source-language content.
Minimum role: admin. Required entitlement: None.
Annotations: title: Get resource localization, readOnlyHint: true, idempotentHint: true, openWorldHint: false, destructiveHint: false.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
locale |
string | Yes | |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
resource_id |
string | Yes | |
resource_type |
string | Yes | enum: ["organization","business_location","product","collection","article_category","media_asset","content_document"] |
additionalProperties: false; required: ["resource_type","resource_id","locale"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
localization |
object (fields) | Yes |
additionalProperties: false; required: ["localization"]
List organization locales — list_organization_locales
Read the website’s source language and authored translations.
Minimum role: admin. Required entitlement: None.
Annotations: title: List organization locales, readOnlyHint: true, idempotentHint: true, openWorldHint: false, destructiveHint: false.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
additionalProperties: false; required: []
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
locales |
array of object (fields) | Yes |
additionalProperties: false; required: ["locales"]
Publish organization language — publish_organization_language
Publish an added website language’s authored translations after translating its homepage. Legal Services sites also require a translated organization name and consultation call-to-action label. Missing translations remain unavailable; the source language is unchanged.
Minimum role: admin. Required entitlement: None.
Annotations: title: Publish organization language, readOnlyHint: false, openWorldHint: true, destructiveHint: true, idempotentHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
locale |
string | Yes | enum: ["en","ja","th","vi"] |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
additionalProperties: false; required: ["locale"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
locales |
array of object (fields) | Yes |
additionalProperties: false; required: ["locales"]
Put resource localization — put_resource_localization
Replace an exact translation with fields allowed for its resource_type. For content_document, an existing translation requires its current updated_at from get_resource_localization; a new article or page translation requires content_blocks. Omit blocks to retain an existing body. Document addresses come from the source and remain stable. Authored Q&A translations use title and summary without blocks; imported Q&A remains read-only.
Minimum role: admin. Required entitlement: None.
Annotations: title: Put resource localization, readOnlyHint: false, openWorldHint: true, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
content_blocks |
array of object (fields) | No | Complete canonical block array. Each existing block must retain its id unless its removal is explicitly confirmed. Block data never contains asset IDs or delivery URLs. Omit media to preserve that block's current placements; provide media explicitly to replace them, or call set_media with owner_type "content_block", the block id, and the intended slot. |
locale |
string | Yes | |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
resource_id |
string | Yes | |
resource_type |
string | Yes | enum: ["organization","business_location","product","collection","article_category","media_asset","content_document"] |
updated_at |
string or null | No | content_document only: required current translation updated_at when replacing an existing document. Omit or use null when creating a translation. |
values |
object (fields) | Yes | additionalProperties: false |
additionalProperties: false; required: ["resource_type","resource_id","locale","values"]
oneOf: shape 1, shape 2, shape 3, shape 4, shape 5, shape 6, shape 7.
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
context |
object (fields) | Yes | The business this call acted on, its public website origin, and the location the call named, or null location fields when it named none. additionalProperties: false; required: ["organization_id","organization_name","organization_slug","organization_subdomain","organization_public_url","location_id","location_slug","location_title"] |
localization |
object (fields) | Yes |
additionalProperties: false; required: ["localization","context"]
Replace resource localizations — replace_resource_localizations
Atomically replace 1–250 exact resource translations for one language. Omitted resources retain their translations; any invalid item rejects the batch. Uses supplied translations without generating them.
Minimum role: admin. Required entitlement: None.
Annotations: title: Replace resource localizations, readOnlyHint: false, openWorldHint: true, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
items |
array of object (fields) | Yes | maxItems: 250; minItems: 1 |
locale |
string | Yes | |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
resource_type |
string | Yes | enum: ["organization","business_location","product","collection","article_category","media_asset"] |
additionalProperties: false; required: ["resource_type","locale","items"]
oneOf: shape 1, shape 2, shape 3, shape 4, shape 5, shape 6.
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
context |
object (fields) | Yes | The business this call acted on, its public website origin, and the location the call named, or null location fields when it named none. additionalProperties: false; required: ["organization_id","organization_name","organization_slug","organization_subdomain","organization_public_url","location_id","location_slug","location_title"] |
locale |
string | Yes | |
resource_type |
string | Yes | enum: ["organization","business_location","product","collection","article_category","media_asset"] |
updated_resource_ids |
array of string (fields) | Yes |
additionalProperties: false; required: ["locale","resource_type","updated_resource_ids","context"]
Locations
Block dates — block_dates
Close a location for a whole-day date range when the user wants to prevent bookings on those dates. Both endpoints are inclusive. Adds a closure to special hours while retaining existing closures and dated hours, and cancels the location’s unbooked table seatings on those dates. Returns the saved hours; existing bookings are not cancelled or messaged.
Minimum role: admin. Required entitlement: None.
Annotations: title: Block dates, readOnlyHint: false, openWorldHint: true, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
from |
string | Yes | First closed day, YYYY-MM-DD. format: "date"; pattern: "^\d{4}-\d{2}-\d{2}$" |
location_id |
string | Yes | Internal location ID returned by list_locations or get_workspace_context. |
note |
string or null | No | Why, for the team; guests never see it. |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
to |
string | Yes | Last closed day, YYYY-MM-DD, inclusive. Same as from for one day. format: "date"; pattern: "^\d{4}-\d{2}-\d{2}$" |
additionalProperties: false; required: ["location_id","from","to"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
affected_commitments |
array of object (fields) | Yes | |
changed_fields |
array of string (fields) | Yes | |
context |
object (fields) | Yes | The business this call acted on, its public website origin, and the location the call named, or null location fields when it named none. additionalProperties: false; required: ["organization_id","organization_name","organization_slug","organization_subdomain","organization_public_url","location_id","location_slug","location_title"] |
entity |
string | Yes | enum: ["location"] |
id |
string | Yes | |
ok |
boolean | Yes | const: true |
saved_fields |
object (fields) | Yes | Persisted values of the fields named in changed_fields. required: [] |
slug |
string | Yes | |
updated_at |
string | Yes |
required: ["ok","entity","id","slug","changed_fields","updated_at","context","saved_fields","affected_commitments"]
Create location — create_location
Add an active business branch or office. Locations are not billed. Lodging publishes homes at /stays and has no public location pages. Create homes with create_product; their address records stay part of the home. Set branch hours with update_location.
Minimum role: admin. Required entitlement: None.
Annotations: title: Create location, readOnlyHint: false, openWorldHint: true, destructiveHint: false, idempotentHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
address |
object or null (fields) | No | additionalProperties: false; required: ["regionCode","addressLines"] |
description |
string | No | |
email |
string | No | format: "email" |
idempotency_key |
string | Yes | One key per new location, kept by this business and never expired. Retrying with the same key and details returns the location it created. The same key with different details fails with IDEMPOTENCY_CONFLICT; if that location has been deleted it fails with LOCATION_DELETED and nothing is created. maxLength: 200; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
phone |
string | No | International number with its country calling code, e.g. +66812345678. |
timezone |
string | Yes | Explicit IANA timezone identifier, such as Asia/Bangkok. Missing timezone is an error, never the browser timezone. minLength: 1 |
title |
string | Yes | maxLength: 200; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
website_url |
string | No | format: "uri" |
additionalProperties: false; required: ["title","idempotency_key","timezone"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
location |
object (fields) | Yes | additionalProperties: false; required: ["id","title","status"] |
organization_id |
string | Yes |
additionalProperties: false; required: ["organization_id","location"]
Get calendar — get_calendar
Read the business’s bookings (table reservations, classes and consultations), guest arrivals and departures, published posts and unavailable dates when the user wants to review its calendar. Dates are inclusive local calendar days, with at most 62 days per call. Use kinds to filter the agenda.
Minimum role: admin. Required entitlement: None.
Annotations: title: Get calendar, readOnlyHint: true, idempotentHint: true, openWorldHint: false, destructiveHint: false.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
assigned_member_id |
string | No | |
from |
string | Yes | First day, YYYY-MM-DD. format: "date"; pattern: "^\d{4}-\d{2}-\d{2}$" |
kinds |
array of string (fields) | No | Limit to these kinds. Defaults to every kind the location offers. A stay appears on its arrival and its departure day. |
location_id |
string or null | No | Limit to this location, or null for the whole business including online bookings. |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
to |
string | Yes | Last day, YYYY-MM-DD, inclusive. format: "date"; pattern: "^\d{4}-\d{2}-\d{2}$" |
additionalProperties: false; required: ["from","to"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
available_kinds |
array of string (fields) | Yes | |
context |
object (fields) | No | The business this call acted on, its public website origin, and the location the call named, or null location fields when it named none. additionalProperties: false; required: ["organization_id","organization_name","organization_slug","organization_subdomain","organization_public_url","location_id","location_slug","location_title"] |
items |
array of object (fields) | Yes | |
unavailable_dates |
array of object (fields) | Yes |
required: ["items","available_kinds","unavailable_dates"]
Get location — get_location
Read one selected site location, including its contact details, opening hours, timezone and media. Use its returned ID for location-specific changes.
Minimum role: admin. Required entitlement: None.
Annotations: title: Get location, readOnlyHint: true, idempotentHint: true, openWorldHint: false, destructiveHint: false.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
location_id |
string | Yes | Internal location ID returned by list_locations or get_workspace_context. |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
additionalProperties: false; required: ["location_id"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
current_local_date |
string | Yes | Current date in the location timezone. format: "date" |
location |
object (fields) | Yes | required: ["id","slug","title","stay_map_sharing","latitude","longitude","status","timezone","created_at","updated_at","media"] |
required: ["location","current_local_date"]
List locations — list_locations
List the selected site’s locations with their IDs, slugs, titles and active state. Location-scoped tools take these IDs.
Minimum role: admin. Required entitlement: None.
Annotations: title: List locations, readOnlyHint: true, idempotentHint: true, openWorldHint: false, destructiveHint: false.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
cursor |
string | No | Opaque next_cursor from the previous page. |
limit |
number | No | Page size. Defaults to 50; maximum 100. maximum: 100; minimum: 1 |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
additionalProperties: false; required: []
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
locations |
array of object (fields) | Yes | |
page_info |
object (fields) | Yes | required: ["has_more","next_cursor"] |
required: ["locations","page_info"]
Open dates — open_dates
Remove temporary closures for an inclusive date range when the user wants to reopen a location. Closure dates outside the range and their notes are preserved. Regularly closed weekdays stay closed; change opening_hours with update_location to open those weekdays. The location’s table seatings return on the reopened dates. Returns the saved hours without creating or changing existing bookings.
Minimum role: admin. Required entitlement: None.
Annotations: title: Open dates, readOnlyHint: false, openWorldHint: true, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
from |
string | Yes | First reopened day, YYYY-MM-DD. format: "date"; pattern: "^\d{4}-\d{2}-\d{2}$" |
location_id |
string | Yes | Internal location ID returned by list_locations or get_workspace_context. |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
to |
string | Yes | Last reopened day, YYYY-MM-DD, inclusive. Same as from for one day. format: "date"; pattern: "^\d{4}-\d{2}-\d{2}$" |
additionalProperties: false; required: ["location_id","from","to"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
affected_commitments |
array of object (fields) | Yes | |
changed_fields |
array of string (fields) | Yes | |
context |
object (fields) | Yes | The business this call acted on, its public website origin, and the location the call named, or null location fields when it named none. additionalProperties: false; required: ["organization_id","organization_name","organization_slug","organization_subdomain","organization_public_url","location_id","location_slug","location_title"] |
entity |
string | Yes | enum: ["location"] |
id |
string | Yes | |
ok |
boolean | Yes | const: true |
saved_fields |
object (fields) | Yes | Persisted values of the fields named in changed_fields. required: [] |
slug |
string | Yes | |
updated_at |
string | Yes |
required: ["ok","entity","id","slug","changed_fields","updated_at","context","saved_fields","affected_commitments"]
Update location — update_location
Update a location's own details: its name and descriptions, regular opening hours, temporary closures/special hours, contact info, saved map coordinates, and map sharing for its places to stay. Renaming keeps the saved public address. To change its hero media, call set_media with { owner_type: "business_location", owner_id: <location.id>, slot: "hero" }. Only provided fields are changed. Returns the updated location; website details can change immediately. A restaurant’s table seatings follow these hours: new open time adds seatings, and closed time cancels the unbooked ones; booked seatings stay. Other offerings keep their own weekly schedules.
Minimum role: admin. Required entitlement: None.
Annotations: title: Update location, readOnlyHint: false, openWorldHint: true, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
address |
object or null (fields) | No | additionalProperties: false; required: ["regionCode","addressLines"] |
description |
string or null | No | Long description shown on the location page. Pass null to clear it. |
email |
string or null | No | Public email shown to guests on the website and in booking confirmation emails. Pass null to clear it. |
latitude |
number or null | No | Saved map latitude. Supply longitude in the same call; both null clears the coordinates. Omit both to keep the saved coordinates. maximum: 90; minimum: -90 |
location_id |
string | Yes | Internal location ID returned by list_locations or get_workspace_context. |
longitude |
number or null | No | Saved map longitude. Supply latitude in the same call; both null clears the coordinates. Omit both to keep the saved coordinates. maximum: 180; minimum: -180 |
opening_hours |
null or object (fields) | No | Canonical weekly endpoint periods. Days use Sunday=0. Null means unknown; periods [] means closed. Sunday 00:00 without a close means always open. |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
phone |
string | No | Public phone number shown to guests on the website and in booking confirmation emails. International number with its country calling code, e.g. +66812345678. |
short_description |
string or null | No | One-line summary shown on location cards. Pass null to clear it. |
special_hours |
null or array of object (fields) | No | Explicit dated hours or closures. Closure starts_on is required; ends_on is inclusive and null means indefinite. Dated hours replace regular hours; periods [] closes the date. A closure or dated hours on a date replace that whole date, including the previous day’s hours that run past midnight into it: those end at midnight. A closure wins over dated hours on the same date. Closures may overlap; a second dated-hours entry for the same date is rejected. |
status |
string | No | Set active to enable the location, or inactive to hide it. Increasing the number of live homes requires the dashboard. enum: ["active","inactive"] |
stay_map_sharing |
string | No | Public map precision for every place to stay at this location. General shows the area; specific shows its precise pin. Both keep the street address private until a confirmed booking. Omit to keep the saved choice. enum: ["general","specific"] |
timezone |
string | No | IANA time zone identifier for this location, e.g. Asia/Bangkok. Used to interpret opening hours and booking slots. |
title |
string | No | Location name shown to guests. Renaming keeps its saved public address. maxLength: 200; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
additionalProperties: false; required: ["location_id"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
changed_fields |
array of string (fields) | Yes | |
context |
object (fields) | Yes | The business this call acted on, its public website origin, and the location the call named, or null location fields when it named none. additionalProperties: false; required: ["organization_id","organization_name","organization_slug","organization_subdomain","organization_public_url","location_id","location_slug","location_title"] |
entity |
string | Yes | enum: ["location"] |
id |
string | Yes | |
ok |
boolean | Yes | const: true |
saved_fields |
object (fields) | Yes | Persisted values of the fields named in changed_fields. required: [] |
slug |
string | Yes | |
updated_at |
string | Yes |
required: ["ok","entity","id","slug","changed_fields","updated_at","context","saved_fields"]
Media
Attach media — attach_media
Attach one existing media asset to an ordered collection placement (a gallery or a compliance document list), appending it after the current last item. An existing attachment stays in place; a full collection rejects a new attachment. For a single-valued placement (a cover, hero, or logo) use set_media instead. Product galleries are saved in Blawby; a connected listing’s Airbnb photo tour is edited in Airbnb.
Minimum role: admin. Required entitlement: None.
Annotations: title: Attach media, readOnlyHint: false, openWorldHint: true, destructiveHint: false, idempotentHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
asset_id |
string | Yes | The single media asset id to attach. |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
placement |
object (fields) | Yes |
additionalProperties: false; required: ["placement","asset_id"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
asset_ids |
array of string (fields) | Yes | |
cleared |
boolean | Yes | |
context |
object (fields) | No | The business this call acted on, its public website origin, and the location the call named, or null location fields when it named none. additionalProperties: false; required: ["organization_id","organization_name","organization_slug","organization_subdomain","organization_public_url","location_id","location_slug","location_title"] |
entity |
string | Yes | |
id |
string | Yes | |
media |
array of object (fields) | Yes | |
ok |
boolean | Yes | |
placement |
object (fields) | Yes |
required: ["ok","entity","id","placement","asset_ids","media","cleared"]
Delete media asset — delete_media_asset
Delete the selected site media asset and remove its website placements. Deletes stored media when no other asset references it. Refused while a social publication pins the asset; published provider posts are not deleted.
Minimum role: admin. Required entitlement: None.
Annotations: title: Delete media asset, readOnlyHint: false, openWorldHint: true, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
asset_id |
string | Yes | |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
additionalProperties: false; required: ["asset_id"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
deleted |
boolean | Yes |
required: ["deleted"]
List media assets — list_media_assets
List the images, videos and Markdown files in the selected site’s media library, with the asset IDs set_media and attach_media take. A file still in the conversation is saved with save_media_attachment.
Minimum role: admin. Required entitlement: None.
Annotations: title: List media assets, readOnlyHint: true, idempotentHint: true, openWorldHint: false, destructiveHint: false.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
cursor |
string | No | Opaque next_cursor from the previous page. |
kind |
string | No | Filter by asset type. enum: ["image","video","file"] |
limit |
number | No | Page size. Defaults to 50; maximum 100. maximum: 100; minimum: 1 |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
additionalProperties: false; required: []
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
assets |
array of object (fields) | Yes | |
page_info |
object (fields) | Yes | required: ["has_more","next_cursor"] |
required: ["assets","page_info"]
Remove media — remove_media
Detach one media asset from an ordered collection placement (a gallery or a compliance document list). Removing an asset that is not attached changes nothing; other attached assets keep their order. Product galleries are saved in Blawby; a connected listing’s Airbnb photo tour is edited in Airbnb.
Minimum role: admin. Required entitlement: None.
Annotations: title: Remove media, readOnlyHint: false, openWorldHint: true, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
asset_id |
string | Yes | The single media asset id to detach. |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
placement |
object (fields) | Yes |
additionalProperties: false; required: ["placement","asset_id"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
asset_ids |
array of string (fields) | Yes | |
cleared |
boolean | Yes | |
context |
object (fields) | No | The business this call acted on, its public website origin, and the location the call named, or null location fields when it named none. additionalProperties: false; required: ["organization_id","organization_name","organization_slug","organization_subdomain","organization_public_url","location_id","location_slug","location_title"] |
entity |
string | Yes | |
id |
string | Yes | |
media |
array of object (fields) | Yes | |
ok |
boolean | Yes | |
placement |
object (fields) | Yes |
required: ["ok","entity","id","placement","asset_ids","media","cleared"]
Reorder media — reorder_media
Move attached gallery or compliance assets before or after an attached neighbor. Omitted anchors move the asset to the end; invalid assets or anchors reject the call. Product galleries are saved in Blawby; a connected listing’s Airbnb photo tour is edited in Airbnb.
Minimum role: admin. Required entitlement: None.
Annotations: title: Reorder media, readOnlyHint: false, openWorldHint: true, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
moves |
array of object (fields) | Yes | Ordered list of moves to apply sequentially. |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
placement |
object (fields) | Yes |
additionalProperties: false; required: ["placement","moves"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
asset_ids |
array of string (fields) | Yes | |
cleared |
boolean | Yes | |
context |
object (fields) | No | The business this call acted on, its public website origin, and the location the call named, or null location fields when it named none. additionalProperties: false; required: ["organization_id","organization_name","organization_slug","organization_subdomain","organization_public_url","location_id","location_slug","location_title"] |
entity |
string | Yes | |
id |
string | Yes | |
media |
array of object (fields) | Yes | |
ok |
boolean | Yes | |
placement |
object (fields) | Yes |
required: ["ok","entity","id","placement","asset_ids","media","cleared"]
Save media attachment — save_media_attachment
Save an attached image, video with poster, or Markdown file. Uses the host’s file reference. An optional placement puts it on the requested website owner in this operation. Repeat the same idempotency key for a retry.
Minimum role: admin. Required entitlement: None.
Annotations: title: Save media attachment, readOnlyHint: false, openWorldHint: true, destructiveHint: true, idempotentHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
category |
string | No | Optional visual subject used to organize the media library. It never assigns the asset to content. enum: ["exterior","interior","food","menu","team","other"] |
description |
string | No | Description of the media (stored as alt text). |
file |
object (fields) | Yes | Authorized file reference supplied by ChatGPT after rewriting the declared top-level file argument, including a temporary download_url and file_id. required: ["download_url","file_id"] |
idempotency_key |
string | Yes | maxLength: 200; minLength: 1 |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
placement |
object (fields) | No | |
poster_file |
object (fields) | No | Required poster/thumbnail image for video uploads. Invalid for non-video uploads. required: ["download_url","file_id"] |
additionalProperties: false; required: ["file","idempotency_key"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
asset_id |
string | Yes | |
kind |
string | Yes | enum: ["image","video","file"] |
placement |
object or null (fields) | No | |
public_url |
string | Yes | |
status |
string | Yes | enum: ["active"] |
thumbnail_url |
string or null | No |
required: ["asset_id","status","public_url","kind"]
File parameters: file, poster_file.
Set media — set_media
Assign an asset to one cover, hero, logo or menu section photo; null clears it. Use attach_media for galleries and presentation for logo cropping. Product photos are saved in Blawby; a connected listing’s Airbnb photo tour is edited in Airbnb.
Minimum role: admin. Required entitlement: None.
Annotations: title: Set media, readOnlyHint: false, openWorldHint: true, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
asset_id |
string or null | Yes | One asset id, or null to clear this single-valued placement. |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
placement |
object (fields) | Yes | |
presentation |
object (fields) | No | Organization logo and logo_dark only. Omitted means original. additionalProperties: false; required: ["shape","focus"] |
additionalProperties: false; required: ["placement","asset_id"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
asset_ids |
array of string (fields) | Yes | |
cleared |
boolean | Yes | |
context |
object (fields) | No | The business this call acted on, its public website origin, and the location the call named, or null location fields when it named none. additionalProperties: false; required: ["organization_id","organization_name","organization_slug","organization_subdomain","organization_public_url","location_id","location_slug","location_title"] |
entity |
string | Yes | |
id |
string | Yes | |
media |
array of object (fields) | Yes | |
ok |
boolean | Yes | |
placement |
object (fields) | Yes |
required: ["ok","entity","id","placement","asset_ids","media","cleared"]
Update media asset — update_media_asset
Change the selected asset’s alt text or library category. At least one field is required. Category organizes the library and does not assign media to a page. Airbnb photo captions are edited in Airbnb.
Minimum role: admin. Required entitlement: None.
Annotations: title: Update media asset, readOnlyHint: false, openWorldHint: true, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
alt_text |
string or null | No | Omit to retain; null clears the alt text. |
asset_id |
string | Yes | |
category |
string | No | enum: ["exterior","interior","food","menu","team","other"] |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
additionalProperties: false; required: ["asset_id"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
updated |
boolean | Yes |
required: ["updated"]
Meta ads
Create Meta Ads campaign — create_meta_ads_campaign
Create a new campaign in PAUSED status in the connected Meta Ad Account.
Minimum role: admin. Required entitlement: google_ads_management.
Annotations: title: Create Meta Ads campaign, readOnlyHint: false, openWorldHint: true, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
daily_budget_cents |
integer | No | Daily budget in cents (e.g. 1000 for $10.00) minimum: 1 |
name |
string | No | Campaign name |
objective |
string | No | Campaign objective (default: OUTCOME_TRAFFIC) enum: ["OUTCOME_TRAFFIC","OUTCOME_LEADS","OUTCOME_AWARENESS"] |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
additionalProperties: false; required: []
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
campaign_id |
string | Yes | |
status |
string | Yes |
required: ["campaign_id","status"]
List Meta Ads campaigns — list_meta_ads_campaigns
List up to 100 campaigns in the connected Meta Ad Account, with status, objective, and daily budget.
Minimum role: admin. Required entitlement: None.
Annotations: title: List Meta Ads campaigns, readOnlyHint: true, idempotentHint: true, openWorldHint: false, destructiveHint: false.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
additionalProperties: false; required: []
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
ad_account_id |
string | Yes | |
campaigns |
array of object (fields) | Yes |
required: ["ad_account_id","campaigns"]
Query Meta Ads report — query_meta_ads_report
Query Meta Ads performance summary (spend, impressions, reach, clicks, conversions) for a given date range.
Minimum role: admin. Required entitlement: None.
Annotations: title: Query Meta Ads report, readOnlyHint: true, idempotentHint: true, openWorldHint: false, destructiveHint: false.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
end_date |
string | No | End date YYYY-MM-DD. pattern: "^\d{4}-\d{2}-\d{2}$" |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
start_date |
string | No | Start date YYYY-MM-DD. pattern: "^\d{4}-\d{2}-\d{2}$" |
additionalProperties: false; required: []
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
ad_account_id |
string | Yes | |
clicks |
number | Yes | |
conversions |
number | Yes | |
cost_cents |
number | Yes | |
currency |
string | No | |
end_date |
string | Yes | |
impressions |
number | Yes | |
reach |
number | Yes | |
start_date |
string | Yes |
required: ["ad_account_id","start_date","end_date","cost_cents","impressions","reach","clicks","conversions"]
Update Meta Ads campaign — update_meta_ads_campaign
Update the status or daily budget of an existing Meta Ads campaign.
Minimum role: admin. Required entitlement: google_ads_management.
Annotations: title: Update Meta Ads campaign, readOnlyHint: false, openWorldHint: true, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
campaign_id |
string | No | Meta campaign ID pattern: "^\d+$" |
daily_budget_cents |
integer | No | New daily budget in cents minimum: 1 |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
status |
string | No | Campaign status enum: ["ACTIVE","PAUSED"] |
additionalProperties: false; required: []
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
campaign_id |
string | Yes | |
success |
boolean | Yes |
required: ["campaign_id","success"]
Organizations
Cancel organization invitation — cancel_organization_invitation
Cancel a pending invitation to this business.
Minimum role: admin. Required entitlement: None.
Annotations: title: Cancel organization invitation, readOnlyHint: false, openWorldHint: false, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
invitation_id |
string | Yes | |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
additionalProperties: false; required: ["invitation_id"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
invitation |
object (fields) | Yes | additionalProperties: false; required: ["id","email","role","status","expiresAt","delivery"] |
additionalProperties: false; required: ["invitation"]
Get organization — get_organization
Read the selected Blawby site’s identity, public address and settings. organization_id is the internal ID returned by get_workspace_context or list_organizations, not a URL, domain or business name.
Minimum role: admin. Required entitlement: None.
Annotations: title: Get organization, readOnlyHint: true, idempotentHint: true, openWorldHint: false, destructiveHint: false.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
additionalProperties: false; required: []
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
organization |
object (fields) | Yes | required: ["id","subdomain","status"] |
required: ["organization"]
Get organization settings — get_organization_settings
Read editable settings for the selected Blawby site. Use its internal organization_id from get_workspace_context or list_organizations, not its public URL, domain or name.
Minimum role: admin. Required entitlement: None.
Annotations: title: Get organization settings, readOnlyHint: true, idempotentHint: true, openWorldHint: false, destructiveHint: false.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
additionalProperties: false; required: []
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
settings |
object (fields) | Yes | required: ["id","subdomain","default_currency","timezone"] |
required: ["settings"]
Get website draft — get_website_draft
Read your saved website setup. Omit draft_id to resume your unfinished website.
Minimum role: admin. Required entitlement: None.
Annotations: title: Get website draft, readOnlyHint: true, idempotentHint: true, openWorldHint: false, destructiveHint: false.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
draft_id |
string | No | minLength: 1 |
additionalProperties: false
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
currency |
string | No | |
draft_id |
string | Yes | |
hero_headline |
string | No | |
hero_subtitle |
string | No | |
idempotency_key |
string | No | |
location |
object (fields) | Yes | additionalProperties: false |
missing_fields |
array of string (fields) | Yes | |
name |
string | Yes | |
organization_id |
string | No | |
products |
array of object (fields) | Yes | |
source_locale |
string or null | Yes | |
status |
string | Yes | enum: ["active","committed"] |
subdomain |
string or null | Yes | |
timezone |
string | No | |
updated_at |
string | Yes | format: "date-time" |
vertical |
string | Yes | enum: ["restaurant","experience","service","lodging"] |
additionalProperties: false; required: ["draft_id","updated_at","status","subdomain","name","vertical","source_locale","location","products","missing_fields"]
Invite organization member — invite_organization_member
Invite a teammate by email using Better Auth. The invitation remains pending until they accept. Set resend only when the user wants an existing invitation sent again.
Minimum role: admin. Required entitlement: None.
Annotations: title: Invite organization member, readOnlyHint: false, openWorldHint: true, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
email |
string | Yes | format: "email" |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
resend |
boolean | No | |
role |
string | Yes | enum: ["member","owner","admin"] |
additionalProperties: false; required: ["email","role"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
invitation |
object (fields) | Yes | additionalProperties: false; required: ["id","email","role","status","expiresAt","delivery"] |
additionalProperties: false; required: ["invitation"]
List organization members — list_organization_members
Read the business’s teammates and invitations. Member IDs identify organization memberships; user IDs identify people.
Minimum role: admin. Required entitlement: None.
Annotations: title: List organization members, readOnlyHint: true, idempotentHint: true, openWorldHint: false, destructiveHint: false.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
limit |
integer | No | maximum: 100; minimum: 1 |
offset |
integer | No | minimum: 0 |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
additionalProperties: false; required: []
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
invitations |
array of object (fields) | Yes | |
members |
array of object (fields) | Yes | |
total |
integer | Yes | minimum: 0 |
additionalProperties: false; required: ["members","total","invitations"]
List organizations — list_organizations
List sites available to the signed-in user and the current account identity. Match the requested site against these results and use its internal ID; a public URL, domain or business name is not an organization_id.
Minimum role: admin. Required entitlement: None.
Annotations: title: List organizations, readOnlyHint: true, idempotentHint: true, openWorldHint: false, destructiveHint: false.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
cursor |
string | No | Opaque next_cursor from the previous page. |
limit |
number | No | Page size. Defaults to 50; maximum 100. maximum: 100; minimum: 1 |
additionalProperties: false
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
current_user |
object (fields) | Yes | required: ["id","is_platform_admin"] |
organizations |
array of object (fields) | Yes | |
page_info |
object (fields) | Yes | required: ["has_more","next_cursor"] |
required: ["organizations","current_user","page_info"]
Publish website — publish_website
Publish a saved website draft, select it as your workspace and notify Blawby operators by email. Finish any returned missing fields before retrying. Repeating a completed publication can resend the operator email.
Minimum role: admin. Required entitlement: None.
Annotations: title: Publish website, readOnlyHint: false, openWorldHint: true, destructiveHint: true, idempotentHint: false.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
draft_id |
string | Yes | minLength: 1 |
updated_at |
string | Yes | format: "date-time" |
additionalProperties: false; required: ["draft_id","updated_at"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
context |
object (fields) | Yes | The business this call acted on, its public website origin, and the location the call named, or null location fields when it named none. additionalProperties: false; required: ["organization_id","organization_name","organization_slug","organization_subdomain","organization_public_url","location_id","location_slug","location_title"] |
draft_id |
string | Yes | |
location_id |
string | Yes | |
organization_id |
string | Yes | |
public_url |
string | Yes | format: "uri" |
ready |
boolean | Yes | const: true |
additionalProperties: false; required: ["organization_id","location_id","draft_id","public_url","ready","context"]
Remove organization member — remove_organization_member
Remove a teammate’s membership in this business. Better Auth enforces removal permissions and protects the last owner.
Minimum role: admin. Required entitlement: None.
Annotations: title: Remove organization member, readOnlyHint: false, openWorldHint: false, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
member_id |
string | Yes | |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
additionalProperties: false; required: ["member_id"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
member |
object (fields) | Yes | required: ["id","organizationId","userId","role","createdAt"] |
additionalProperties: false; required: ["member"]
Save website draft — save_website_draft
Save website answers without publishing. Use the returned draft_id and updated_at for changes; reuse the creation key on retry.
Minimum role: admin. Required entitlement: None.
Annotations: title: Save website draft, readOnlyHint: false, openWorldHint: false, destructiveHint: true, idempotentHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
currency |
string | No | ISO 4217 currency code. pattern: "^[A-Z]{3}$" |
draft_id |
string | No | Existing draft to edit; omit when creating. minLength: 1 |
hero_headline |
string | No | maxLength: 500 |
hero_subtitle |
string | No | maxLength: 2000 |
idempotency_key |
string | Yes | maxLength: 200; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
location |
object (fields) | No | additionalProperties: false |
name |
string | No | Required when creating; omitted on an edit to retain it. maxLength: 200; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
products |
array of object (fields) | No | |
source_locale |
string | No | Required when creating; a saved draft cannot be relabelled into another language. enum: ["en","ja","th","vi"] |
subdomain |
string | No | maxLength: 63; minLength: 1; pattern: "^a-z0-9?$" |
timezone |
string | No | Explicit IANA timezone identifier, such as Asia/Bangkok. Missing timezone is an error, never the browser timezone. minLength: 1 |
updated_at |
string | No | Required when editing: the revision returned by get_website_draft. format: "date-time" |
vertical |
string | No | Required when creating; omitted on an edit to retain it. enum: ["restaurant","experience","service","lodging"] |
additionalProperties: false; required: ["idempotency_key"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
currency |
string | No | |
draft_id |
string | Yes | |
hero_headline |
string | No | |
hero_subtitle |
string | No | |
idempotency_key |
string | No | |
location |
object (fields) | Yes | additionalProperties: false |
missing_fields |
array of string (fields) | Yes | |
name |
string | Yes | |
organization_id |
string | No | |
products |
array of object (fields) | Yes | |
source_locale |
string or null | Yes | |
status |
string | Yes | enum: ["active","committed"] |
subdomain |
string or null | Yes | |
timezone |
string | No | |
updated_at |
string | Yes | format: "date-time" |
vertical |
string | Yes | enum: ["restaurant","experience","service","lodging"] |
additionalProperties: false; required: ["draft_id","updated_at","status","subdomain","name","vertical","source_locale","location","products","missing_fields"]
Set consultation mode — set_consultation_mode
Choose native legal consultation bookings, an external scheduler, or Contact on the Schedule page. Supply external_url to connect a scheduler; omission retains the saved URL. Null clears the URL only when not using the external scheduler.
Minimum role: admin. Required entitlement: None.
Annotations: title: Set consultation mode, readOnlyHint: false, openWorldHint: true, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
external_url |
string or null | No | |
mode |
string | Yes | enum: ["native","external_url","native_disabled"] |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
additionalProperties: false; required: ["mode"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
settings |
object (fields) | Yes | required: ["mode","external_url"] |
required: ["settings"]
Update organization member role — update_organization_member_role
Change a teammate’s business role. Better Auth enforces owner privileges and protects the last owner.
Minimum role: admin. Required entitlement: None.
Annotations: title: Update organization member role, readOnlyHint: false, openWorldHint: false, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
member_id |
string | Yes | |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
role |
string | Yes | enum: ["member","owner","admin"] |
additionalProperties: false; required: ["member_id","role"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
member |
object (fields) | Yes | required: ["id","organizationId","userId","role","createdAt"] |
additionalProperties: false; required: ["member"]
Update organization settings — update_organization_settings
Change the selected site’s brand, description, website font, colors, button and heading styling, contact email, default currency, visitor announcement banner/popup, inquiry form questions or Live/Draft status. Only supplied settings change. An announcement replaces all its fields, and null removes it. Logos and announcement images are separate media placements; this tool does not change them. Returns the updated settings. Published website settings change immediately; this does not create a short post, blog article or social publication.
Minimum role: admin. Required entitlement: None.
Annotations: title: Update organization settings, readOnlyHint: false, openWorldHint: true, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
address_visibility |
string | No | Show or hide office addresses on service websites. enum: ["visible","hidden"] |
announcement |
object or null (fields) | No | The universal announcement banner or modal shown to visitors on the public website, available to every theme. An image, when set, is a separate organization media placement (slot "announcement"), not a field here. required: ["headline"] |
brand_description |
string | No | |
button_casing |
string | No | Button text casing: uppercase or none (natural case). enum: ["uppercase","none"] |
button_color |
string | No | Button fill: action (the palette's action color) or accent (the palette's accent color). enum: ["action","accent"] |
button_shape |
string | No | Button corner styling: pill (fully rounded), rounded (subtle radius), or sharp (square corners). enum: ["pill","rounded","sharp"] |
careers_email |
string | No | |
catering_email |
string | No | |
contact_email |
string or null | No | Public contact email shown to guests. Pass null to clear it. |
default_currency |
string | No | ISO 4217 code. Existing prices keep their stored currency and amount; nothing is converted. pattern: "^[A-Z]{3}$" |
expected_inquiry_questions_revision |
string | No | inquiry_questions_revision from get_organization_settings; required with inquiry_questions. |
font_preset |
string | No | Website heading and body fonts, on every template: default (Default), mali (Mali), sarabun (Sarabun), prompt (Prompt), kanit (Kanit with Sarabun), ibm-plex-sans-thai (IBM Plex Sans Thai), noto-serif-thai (Noto Serif Thai with Noto Sans Thai), inter (Inter), dm-sans (DM Sans), montserrat (Montserrat), lora (Lora), playfair-display (Playfair Display with Inter), cormorant-garamond (Cormorant Garamond with Inter), marcellus (Marcellus with Inter). Thai, Vietnamese and Japanese text renders in every choice. enum: ["default","mali","sarabun","prompt","kanit","ibm-plex-sans-thai","noto-serif-thai","inter","dm-sans","montserrat","lora","playfair-display","cormorant-garamond","marcellus"] |
heading_casing |
string | No | Display heading casing: uppercase or none (natural case). enum: ["uppercase","none"] |
inquiry_questions |
array of object (fields) | No | The inquiry (quote or lead) form's own questions, asked beside the shared contact fields wherever the site places its contact form. Replaces the saved list; read get_organization_settings first and keep existing IDs. maxItems: 20 |
name |
string | No | |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
palette |
object or null (fields) | No | Website colors, each with a light and a dark value. Roles: ground (The page background.) surface (Cards, the header and footer, dialogs and fields.) text (Body copy and headings.) muted (Captions, details and supporting copy.) action (Buttons, links and selected states.) accent (Emphasis, decoration and highlighted buttons.) Start from a starter (coastal, forest, terracotta, ink, blossom, saffron, slate, midnight) and/or name only the roles to change; colors are #RRGGBB or a plain description such as "forest green". Borders and tints are derived. null returns to the default colors. The result reports any text or button pair below WCAG AA contrast. additionalProperties: false |
partnerships_email |
string | No | |
press_email |
string | No | |
status |
string | No | Website status: published/active is Live (public and indexable), draft/inactive is Draft (preview only). A suspended website cannot be changed. enum: ["published","draft","active","inactive"] |
timezone |
string | No | The business's reporting timezone: the day boundaries of its analytics. Bookings keep their location's or provider's timezone. minLength: 1 |
additionalProperties: false; required: []
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
address_visibility |
string | No | enum: ["visible","hidden"] |
changed_fields |
array of string (fields) | Yes | |
context |
object (fields) | No | The business this call acted on, its public website origin, and the location the call named, or null location fields when it named none. additionalProperties: false; required: ["organization_id","organization_name","organization_slug","organization_subdomain","organization_public_url","location_id","location_slug","location_title"] |
contrast_warnings |
array of object (fields) | No | |
entity |
string | Yes | enum: ["organization_settings"] |
id |
string | Yes | |
ok |
boolean | Yes | |
saved_fields |
object (fields) | Yes | Persisted values of only the supplied settings, keyed by changed_fields. additionalProperties: false |
social_card_refresh |
object or null (fields) | No | The latest brand-name change’s social-card refresh. Read with get_organization_settings until complete. Failed refreshes can be retried under Website → Brand → Name. additionalProperties: false; required: ["id","status","cursor","error"] |
updated_at |
string | No |
required: ["ok","entity","id","changed_fields","saved_fields"]
Payments
Get payment — get_payment
Read one customer payment belonging to the selected business, including its original purchase details, current refund records, disputes and authenticated dashboard URL. Requires payment_id from list_payments. Does not issue a refund, prepare an approval or change payment state; use the authenticated dashboard for financial actions.
Minimum role: admin. Required entitlement: None.
Annotations: title: Get payment, readOnlyHint: true, idempotentHint: true, openWorldHint: false, destructiveHint: false.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
payment_id |
string | Yes |
additionalProperties: false; required: ["payment_id"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
dashboard_url |
string | Yes | |
disputes |
array of object (fields) | Yes | |
organization_id |
string | Yes | |
payment |
object (fields) | Yes | additionalProperties: false; required: ["id","currency","amount","captured_amount","refunded_amount","title","to"] |
purchase |
object (fields) | Yes | required: ["title","quantity"] |
refunds |
array of object (fields) | Yes |
additionalProperties: false; required: ["organization_id","payment","purchase","refunds","disputes","dashboard_url"]
Get payment payouts — get_payment_payouts
Read the selected business’s connected Stripe balance and payout history, with source and retrieval time. Continue with next_cursor as after for another page. Use get_payment_summary for customer payment totals. This is a read of the business’s own connected account; it does not create a payout or transfer funds.
Minimum role: admin. Required entitlement: None.
Annotations: title: Get payment payouts, readOnlyHint: true, idempotentHint: true, openWorldHint: false, destructiveHint: false.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
after |
string | No | next_cursor from the previous payout page. |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
additionalProperties: false; required: []
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
balance |
object or null (fields) | No | required: ["available","pending"] |
configured |
boolean | Yes | |
dashboard_url |
string | Yes | |
next_cursor |
string or null | Yes | |
organization_id |
string | Yes | |
payouts |
array of object (fields) | Yes | |
refreshed_at |
string or null | No | |
source |
string | Yes |
additionalProperties: false; required: ["organization_id","configured","source","next_cursor","payouts","dashboard_url"]
Get payment summary — get_payment_summary
Read totals for the selected business’s customer payments in a UTC period: captured volume, refunds and disputes, separately by currency. Use list_payments for individual transactions. Trust receipts are distinct from earned revenue. Does not change payments or move money.
Minimum role: admin. Required entitlement: None.
Annotations: title: Get payment summary, readOnlyHint: true, idempotentHint: true, openWorldHint: false, destructiveHint: false.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
from |
string | Yes | Inclusive UTC ISO instant. |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
to |
string | Yes | Exclusive UTC ISO instant. |
additionalProperties: false; required: ["from","to"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
amounts |
array of object (fields) | Yes | |
dashboard_url |
string | Yes | |
from |
string | Yes | |
organization_id |
string | Yes | |
refreshed_at |
string or null | Yes | |
source |
string | Yes | |
timezone |
string | Yes | const: "UTC" |
to |
string | Yes | |
usage |
array of object (fields) | Yes | |
usage_status |
string | No |
additionalProperties: false; required: ["organization_id","timezone","from","to","amounts","usage","source","refreshed_at","dashboard_url"]
Get payments dashboard link — get_payments_dashboard_link
Get the selected business’s authenticated Payments setup and dashboard URL when the owner wants to manage its Stripe integration. Returns a link for the person to open; it does not open a page, create an account, start onboarding, prepare a refund or change the integration. Identity and bank details are entered only in the dashboard’s Stripe-hosted flow.
Minimum role: owner. Required entitlement: None.
Annotations: title: Get payments dashboard link, readOnlyHint: true, idempotentHint: true, openWorldHint: false, destructiveHint: false.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
additionalProperties: false; required: []
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
dashboard_url |
string | Yes | |
organization_id |
string | Yes | |
source |
string | Yes |
required: ["organization_id","dashboard_url","source"]
List payments — list_payments
List the selected business’s customer payment records in a UTC period, with purchase links and amounts in each currency’s minor units. Use the returned cursor as after for another page and get_payment for one transaction’s details. These are customer payments, separate from the business’s platform subscription bill. Does not change payments.
Minimum role: admin. Required entitlement: None.
Annotations: title: List payments, readOnlyHint: true, idempotentHint: true, openWorldHint: false, destructiveHint: false.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
after |
string | No | The cursor returned by the previous payment page. |
earnings_type |
string | No | Only payments still paid, or only payments with a refund. enum: ["paid","refunded"] |
from |
string | Yes | Inclusive UTC ISO instant. |
location_id |
string | No | |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
to |
string | Yes | Exclusive UTC ISO instant. |
additionalProperties: false; required: ["from","to"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
dashboard_url |
string | Yes | |
from |
string | No | |
next_cursor |
string or null | Yes | |
organization_id |
string | Yes | |
payments |
array of object (fields) | Yes | |
timezone |
string | No | const: "UTC" |
to |
string | No |
additionalProperties: false; required: ["organization_id","payments","next_cursor","dashboard_url"]
Posts
Create post — create_post
Create a draft short post when the user wants an announcement, event notice or offer. Supports a plain-text caption, ordered media, optional title, location and call to action. It stays private until publish_post. Creating a draft completes any accepted task to create a post. Use a new idempotency_key for each post and reuse it only for retries of that request. Long-form articles use create_blog_post.
Minimum role: admin. Required entitlement: None.
Annotations: title: Create post, readOnlyHint: false, openWorldHint: false, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
body |
string or null (fields) | No | The caption, plain text; newlines are kept. |
call_to_action |
object or null (fields) | No | |
idempotency_key |
string | Yes | A value you make up once for this post, such as a UUID, and reuse only to retry this same request. maxLength: 200; minLength: 1 |
location_id |
string or null (fields) | No | Scope the post to one of this organization's locations; omit for organization-wide. |
media |
array of object (fields) | No | Ordered media: at most one cover, then gallery items in order. Each asset appears once. |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
slug |
string or null (fields) | No | Optional route segment for /posts/ |
title |
string or null (fields) | No | Optional headline. Never invented when absent. |
visibility |
string | No | New drafts default to listed. Listed posts appear in feeds after publication; unlisted posts are reachable only by their URL. This setting does not publish the draft. default: "listed"; enum: ["listed","unlisted"] |
additionalProperties: false; required: ["idempotency_key"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
context |
object (fields) | No | The business this call acted on, its public website origin, and the location the call named, or null location fields when it named none. additionalProperties: false; required: ["organization_id","organization_name","organization_slug","organization_subdomain","organization_public_url","location_id","location_slug","location_title"] |
ok |
boolean | Yes | |
post |
object (fields) | Yes | required: ["id","slug","status","visibility","media","publications","updated_at"] |
replayed |
boolean | No | True when this idempotency_key had already created the post. |
required: ["ok","post"]
Delete channel post — delete_channel_post
Permanently delete exactly the provider_post_id on the explicitly selected connected Facebook Page, or the Blawby bot's message in the connected Discord channel. Keeps the website post and marks its publication receipt removed. Read get_social_connections and list_channel_posts first. Instagram deletion is unavailable with this app's Instagram Login connection; delete Instagram posts in Instagram. Use delete_post to remove website content separately.
Minimum role: admin. Required entitlement: None.
Annotations: title: Delete channel post, readOnlyHint: false, openWorldHint: true, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
channel |
string | Yes | enum: ["facebook","discord"] |
connection_revision |
string | Yes | The connection_revision returned with that target. |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
provider_post_id |
string | Yes | |
target_id |
string | Yes | The exact target_id returned by get_social_connections. |
additionalProperties: false; required: ["channel","target_id","connection_revision","provider_post_id"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
channel |
string | Yes | enum: ["facebook","discord"] |
deleted |
boolean | Yes | |
provider_post_id |
string | Yes | |
publication |
object or null (fields) | Yes | required: ["id","state"] |
target_id |
string | Yes |
required: ["channel","target_id","provider_post_id","deleted","publication"]
Delete post — delete_post
Delete a post from the website. Its Facebook, Instagram and Discord posts are not deleted; use delete_channel_post for an explicit supported channel deletion.
Minimum role: admin. Required entitlement: None.
Annotations: title: Delete post, readOnlyHint: false, openWorldHint: true, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
post_id |
string | Yes |
additionalProperties: false; required: ["post_id"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
deleted |
boolean | Yes | |
post_id |
string | Yes |
required: ["post_id","deleted"]
Get channel post — get_channel_post
Read one post from the selected connected Facebook Page, Instagram professional account or Discord channel when the user wants its current caption, media or link. Use provider_post_id from list_channel_posts with the exact target from get_social_connections. Website content is unchanged.
Minimum role: admin. Required entitlement: None.
Annotations: title: Get channel post, readOnlyHint: true, idempotentHint: true, openWorldHint: false, destructiveHint: false.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
channel |
string | Yes | enum: ["facebook","instagram","discord"] |
connection_revision |
string | Yes | The connection_revision returned with that target. |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
provider_post_id |
string | Yes | |
target_id |
string | Yes | The exact target_id returned by get_social_connections. |
additionalProperties: false; required: ["channel","target_id","connection_revision","provider_post_id"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
post |
object (fields) | Yes | additionalProperties: false; required: ["channel","target_id","provider_post_id","body","public_url","published_at","media"] |
required: ["post"]
Get post — get_post
Read a short website post before editing or publishing it. Returns its caption, call to action, ordered media, website status, draft preview link and stored Facebook, Instagram or Discord publication receipts. Use get_channel_post for current provider content.
Minimum role: admin. Required entitlement: None.
Annotations: title: Get post, readOnlyHint: true, idempotentHint: true, openWorldHint: false, destructiveHint: false.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
post_id |
string | Yes |
additionalProperties: false; required: ["post_id"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
post |
object (fields) | Yes | required: ["id","slug","status","visibility","media","publications","updated_at"] |
required: ["post"]
Get social connections — get_social_connections
Read the site’s website, Facebook Page, Instagram and Discord channel publishing connections before selecting a publication target. Returns target_id, connection_revision, supported formats and operations, setup links, and problems, including whether Meta currently accepts each connection and whether the Blawby bot can still post to the connected Discord channel. Credentials are not returned.
Minimum role: admin. Required entitlement: None.
Annotations: title: Get social connections, readOnlyHint: true, idempotentHint: true, openWorldHint: false, destructiveHint: false.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
additionalProperties: false; required: []
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
channels |
array of object (fields) | Yes | |
website |
object (fields) | Yes | required: ["channel","target_id","label"] |
required: ["website","channels"]
List channel posts — list_channel_posts
Read live posts directly from the explicitly selected connected Facebook Page, Instagram professional account or Discord channel; for Discord, the Blawby bot's messages there. Does not import website posts or media. Read get_social_connections first and supply the exact channel, target_id and connection_revision. next_after is the provider's cursor; pass it as after for the next page.
Minimum role: admin. Required entitlement: None.
Annotations: title: List channel posts, readOnlyHint: true, idempotentHint: true, openWorldHint: false, destructiveHint: false.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
after |
string | No | |
channel |
string | Yes | enum: ["facebook","instagram","discord"] |
connection_revision |
string | Yes | The connection_revision returned with that target. |
limit |
integer | No | default: 25; maximum: 100; minimum: 1 |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
target_id |
string | Yes | The exact target_id returned by get_social_connections. |
additionalProperties: false; required: ["channel","target_id","connection_revision"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
next_after |
string or null | Yes | |
posts |
array of object (fields) | Yes |
required: ["posts","next_after"]
List posts — list_posts
List draft or published short website posts when the user wants to find announcements to review or edit. Results are paginated, newest change first. Filter by location_id for one location. Use list_channel_posts for live Facebook or Instagram posts.
Minimum role: admin. Required entitlement: None.
Annotations: title: List posts, readOnlyHint: true, idempotentHint: true, openWorldHint: false, destructiveHint: false.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
cursor |
string | No | Opaque next_cursor from the previous page. |
limit |
number | No | Page size. Defaults to 50; maximum 100. maximum: 100; minimum: 1 |
location_id |
string | No | Only posts scoped to this location. |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
status |
string | No | enum: ["draft","published"] |
additionalProperties: false; required: []
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
page_info |
object (fields) | Yes | required: ["has_more","next_cursor"] |
posts |
array of object (fields) | Yes |
required: ["posts","page_info"]
Publish post — publish_post
Publish the post to the selected website or social destinations, returning one result per target with its status: published, already_published, failed with the provider error, or skipped. Publish again after a failure once its cause is fixed. A provider_unreachable failure may still have reached the destination: find its post there and pass that provider_post_id to reconcile_post_publication before publishing again.
Minimum role: admin. Required entitlement: None.
Annotations: title: Publish post, readOnlyHint: false, openWorldHint: true, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
post_id |
string | Yes | |
targets |
array of object (fields) | Yes | One entry per destination, each channel at most once. maxItems: 4; minItems: 1 |
updated_at |
string | Yes | The post's updated_at as you last read it. |
additionalProperties: false; required: ["post_id","updated_at","targets"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
ok |
boolean | Yes | True only when every requested target is published or already published. |
outcomes |
array of object (fields) | Yes | |
post_id |
string | Yes | |
updated_at |
string | Yes |
additionalProperties: false; required: ["ok","post_id","updated_at","outcomes"]
Reconcile post publication — reconcile_post_publication
Read an existing social publication on its destination and refresh its receipt without publishing. Supply provider_post_id only for the exact post on the connected destination.
Minimum role: admin. Required entitlement: None.
Annotations: title: Reconcile post publication, readOnlyHint: false, openWorldHint: false, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
provider_post_id |
string | No | Optional: the Facebook post id, Instagram media id or Discord message id it became. |
publication_id |
string | Yes | The publication id from get_post or a publish_post outcome. |
additionalProperties: false; required: ["publication_id"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
publication |
object (fields) | Yes | additionalProperties: false; required: ["channel","target_id","status"] |
state |
string | Yes | const: "published" |
additionalProperties: false; required: ["state","publication"]
Update post — update_post
Change at least one supplied website post field. Use the current updated_at from get_post. Omitted fields retain their values; null clears a nullable field. Published social posts are unchanged.
Minimum role: admin. Required entitlement: None.
Annotations: title: Update post, readOnlyHint: false, openWorldHint: true, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
body |
string or null (fields) | No | The caption, plain text; newlines are kept. |
call_to_action |
object or null (fields) | No | |
location_id |
string or null (fields) | No | Omit to retain the current scope. A location ID scopes the post there; null makes it organization-wide. |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
post_id |
string | Yes | |
title |
string or null (fields) | No | Optional headline. Never invented when absent. |
updated_at |
string | Yes | Current post.updated_at from get_post. A stale revision refuses the change. |
visibility |
string | No | listed shows the post in feeds; unlisted keeps it reachable by its URL only. Neither makes a draft public. enum: ["listed","unlisted"] |
additionalProperties: false; required: ["post_id","updated_at"]
anyOf: shape 1, shape 2, shape 3, shape 4, shape 5.
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
context |
object (fields) | No | The business this call acted on, its public website origin, and the location the call named, or null location fields when it named none. additionalProperties: false; required: ["organization_id","organization_name","organization_slug","organization_subdomain","organization_public_url","location_id","location_slug","location_title"] |
ok |
boolean | Yes | |
post |
object (fields) | Yes | required: ["id","slug","status","visibility","media","publications","updated_at"] |
replayed |
boolean | No | True when this idempotency_key had already created the post. |
required: ["ok","post"]
Products
Batch create products — batch_create_products
Create several products in the selected site’s catalog when the user supplies a new catalog batch. Validates every entry before writing; any invalid entry rejects the complete request. Creating a place to stay reports the business's current live-home count to its Stripe subscription; an unpublished home adds nothing to it. Publication and location offerings are assigned separately.
Minimum role: admin. Required entitlement: None.
Annotations: title: Batch create products, readOnlyHint: false, openWorldHint: true, destructiveHint: false, idempotentHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
idempotency_key |
string | Yes | maxLength: 200; minLength: 1 |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
products |
array of object (fields) | Yes | maxItems: 400; minItems: 1 |
additionalProperties: false; required: ["products","idempotency_key"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
products |
array of object (fields) | Yes |
required: ["products"]
Create collection — create_collection
Create an empty product collection, such as a menu section, site-wide or at the named location. Returns the saved collection and its ID. Add products separately with set_collection_products; existing products and collections stay unchanged.
Minimum role: admin. Required entitlement: None.
Annotations: title: Create collection, readOnlyHint: false, openWorldHint: true, destructiveHint: false.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
description |
string or null | No | |
location_id |
string or null | No | Narrow this collection to one location, or omit for site-wide. |
name |
string | Yes | |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
sort_order |
integer | No |
additionalProperties: false; required: ["name"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
collection |
object (fields) | Yes | additionalProperties: false; required: ["id","organization_id","location_id","name","slug","description","image","sort_order"] |
required: ["collection"]
Create product — create_product
Add food or drink, an experience or class, a practice area or consultation, a restaurant location's tables (kind table, one per location, booked like any offering), or a place to stay. An experience can start as a private draft without booking setup. To make it public, configure its booking flow or supply an external booking URL. Supplying booking creates its configuration, offering, schedule and public page together, using instant confirmation and no online collection by default. A place to stay needs stay (its location and stay settings), keeps its public house rules in details, and is priced per night by its variant price; guests book it on the site and pay in full, so it takes no order_url and publishes only once it has a nightly price and online payments are set up. Repeat the same idempotency key on retry.
Minimum role: admin. Required entitlement: None.
Annotations: title: Create product, readOnlyHint: false, openWorldHint: true, destructiveHint: false, idempotentHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
active |
boolean | No | Enable or disable this product. Increasing the number of live homes requires the dashboard. |
booking |
object (fields) | No | Complete booking setup for a published offering. Legal consultations require provider scheduling and an explicitly selected attorney. A restaurant's tables are one table product per location, seated through that location's opening and special hours every seating_interval_minutes: they take no weekly_slots or sessions, the location needs opening hours, default_capacity is the guests seatable per seating, and a deposit is the variant's price with payment_basis per_booking (price zero for no deposit). Any other offering at a location takes weekly_slots or dated sessions; an update can retain its saved weekly times. location_id null holds it online: it needs scheduling_mode provider with an assigned member, takes no weekly_slots or sessions, and is booked in that provider's working hours. Runtime validation requires actual future availability before publication. additionalProperties: false; required: ["location_id","duration_minutes","default_capacity"] |
description |
string | No | |
details |
object (fields) | No | Named customer-facing facts for the product kind. This is a complete replacement map; preserve fields to retain. pricing_note contains explicitly stated price wording and requires empty numeric prices. additionalProperties: false |
idempotency_key |
string | Yes | Repeat the same key with the same request to get the product it created instead of a second one. maxLength: 200; minLength: 1 |
kind |
string | Yes | The customer-facing kind: dish (food or drink), experience (experience or class), service (practice area or consultation), stay (place to stay), or table (a restaurant location’s tables, booked as a reservation). Determines the allowed descriptive fields; booking and stock remain separate capabilities. enum: ["dish","experience","service","stay","table"] |
marketing_features |
array of string (fields) | No | Generic selling bullets. Inclusions, preparation instructions and policies are separate details. maxItems: 15 |
metadata |
object | No | Opaque string annotations for integrations. No pricing, scheduling, stock or filtering behavior may read these. additionalProperties: {"type":"string"} |
name |
string | Yes | |
order_url |
string or null | No | External ordering or booking destination, such as Uber Eats, an experience checkout, or Clio Grow. When set, public actions use this URL instead of native booking. Null restores the configured native flow. |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
page |
object (fields) | No | A source page created with this product and bound to it, in the same write. Omit for a product without a page of its own. additionalProperties: false; required: ["title","blocks"] |
stay |
object (fields) | No | Required for kind stay and refused for every other kind: the location the home is at (fixed once created) and its stay settings. Guest-facing house rules go in details.house_rules. Base nightly rate is the variant price. additionalProperties: false; required: ["location_id","check_in_time","check_out_time","max_guests","min_nights","assigned_member_id"] |
tax_code |
string or null | No | |
unit_label |
string or null | No | A unit noun such as "person" or "night". Never pricing prose. |
variants |
array of object (fields) | No | Omit to create a single default variant. maxItems: 250; minItems: 1 |
additionalProperties: false; required: ["name","kind","idempotency_key"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
product |
object (fields) | Yes | additionalProperties: false; required: ["id","kind","name","slug","description","active","variants","details","publications","locations","collections","source","created_at","updated_at"] |
required: ["product"]
Delete collection — delete_collection
Permanently delete the selected product collection and its memberships when the user asks to remove that group. Returns deleted status; its products remain in the catalog and other collections.
Minimum role: admin. Required entitlement: None.
Annotations: title: Delete collection, readOnlyHint: false, openWorldHint: true, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
collection_id |
string | Yes | |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
additionalProperties: false; required: ["collection_id"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
deleted |
boolean | Yes |
required: ["deleted"]
Delete product — delete_product
Delete a product and its public page. Booking history prevents deletion; pause bookings or withhold publication to retain it.
Minimum role: admin. Required entitlement: None.
Annotations: title: Delete product, readOnlyHint: false, openWorldHint: true, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
product_id |
string | Yes |
additionalProperties: false; required: ["product_id"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
deleted |
boolean | Yes |
required: ["deleted"]
Delete product booking config — delete_product_booking_config
Delete the selected product’s booking configuration to disable its session booking. Returns deleted status. Refused if any booking history exists, including cancelled bookings; the catalog product itself remains.
Minimum role: admin. Required entitlement: None.
Annotations: title: Delete product booking config, readOnlyHint: false, openWorldHint: true, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
product_id |
string | Yes |
additionalProperties: false; required: ["product_id"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
deleted |
boolean | Yes |
required: ["deleted"]
Get product — get_product
Read one site product before reviewing or editing its variants, prices, media, publication, locations, collections, named product facts or booking defaults. Prices belong to variants; booking defaults apply to new sessions.
Minimum role: member. Required entitlement: None.
Annotations: title: Get product, readOnlyHint: true, idempotentHint: true, openWorldHint: false, destructiveHint: false.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
product_id |
string | Yes |
additionalProperties: false; required: ["product_id"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
product |
object (fields) | Yes | additionalProperties: false; required: ["id","kind","name","slug","description","active","variants","details","publications","locations","collections","source","created_at","updated_at"] |
required: ["product"]
List collections — list_collections
List the selected site’s product collections when the user wants to find menu sections or other product groups. Returns their public display order. Supply location_id to narrow the list to one location.
Minimum role: admin. Required entitlement: None.
Annotations: title: List collections, readOnlyHint: true, idempotentHint: true, openWorldHint: false, destructiveHint: false.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
location_id |
string or null | No | |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
additionalProperties: false; required: []
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
collections |
array of object (fields) | Yes |
required: ["collections"]
List location products — list_location_products
List product identities offered at one selected location. Results are paginated; published_only narrows to published offerings. Use list_products for the whole site.
Minimum role: admin. Required entitlement: None.
Annotations: title: List location products, readOnlyHint: true, idempotentHint: true, openWorldHint: false, destructiveHint: false.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
cursor |
string | No | Opaque next_cursor from the previous page. |
featured |
boolean | No | |
kind |
string | No | enum: ["dish","experience","service","stay","table"] |
limit |
number | No | Page size. Defaults to 50; maximum 100. maximum: 100; minimum: 1 |
location_id |
string | Yes | |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
published_only |
boolean | No |
additionalProperties: false; required: ["location_id"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
counts |
object (fields) | Yes | additionalProperties: false; required: ["total","by_kind"] |
page_info |
object (fields) | Yes | required: ["has_more","next_cursor"] |
products |
array of object (fields) | Yes | |
scope |
object (fields) | Yes | additionalProperties: false; required: ["view","organization_id","kind","published_only"] |
additionalProperties: false; required: ["scope","counts","products","page_info"]
List products — list_products
List products carried by the selected site, published or withheld. Results include products across the site; list_location_products narrows to one location.
Minimum role: member. Required entitlement: None.
Annotations: title: List products, readOnlyHint: true, idempotentHint: true, openWorldHint: false, destructiveHint: false.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
cursor |
string | No | Opaque next_cursor from the previous page. |
featured |
boolean | No | |
kind |
string | No | enum: ["dish","experience","service","stay","table"] |
limit |
number | No | Page size. Defaults to 50; maximum 100. maximum: 100; minimum: 1 |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
published_only |
boolean | No |
additionalProperties: false; required: []
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
counts |
object (fields) | Yes | additionalProperties: false; required: ["total","by_kind"] |
page_info |
object (fields) | Yes | required: ["has_more","next_cursor"] |
products |
array of object (fields) | Yes | |
scope |
object (fields) | Yes | additionalProperties: false; required: ["view","organization_id","kind","published_only"] |
additionalProperties: false; required: ["scope","counts","products","page_info"]
Reconcile products — reconcile_products
Synchronize complete catalog entries in one atomic local write. Existing product IDs preserve identity; supplied variants and prices replace their lists. Omitted products stay unchanged unless deactivate_missing disables them. A new home requires stay settings. Changed connected-home settings and nightly prices are pushed to Airbnb through Channex after saving. Unsupported connected-listing settings are refused before any local writes; a failed channel completion reports committed changes with CHANNEL_PUSH_FAILED. Repeat the same idempotency key for an identical retry. Use update_menu for a restaurant menu and update_product for a partial edit. Increasing the number of live homes requires the dashboard.
Minimum role: admin. Required entitlement: None.
Annotations: title: Reconcile products, readOnlyHint: false, openWorldHint: true, destructiveHint: true, idempotentHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
deactivate_missing |
boolean | No | |
idempotency_key |
string | Yes | maxLength: 200; minLength: 1 |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
products |
array of object (fields) | Yes | maxItems: 200 |
additionalProperties: false; required: ["products","idempotency_key"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
products |
array of object (fields) | Yes |
required: ["products"]
Remove product location — remove_product_location
Remove the selected product’s offering at one explicit location and return its product and location IDs with removed true. The catalog product, prices and other location offerings remain. Read get_product to review them.
Minimum role: admin. Required entitlement: None.
Annotations: title: Remove product location, readOnlyHint: false, openWorldHint: true, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
location_id |
string | Yes | |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
product_id |
string | Yes |
additionalProperties: false; required: ["product_id","location_id"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
location_id |
string | Yes | |
product_id |
string | Yes | |
removed |
boolean | Yes | const: true |
additionalProperties: false; required: ["product_id","location_id","removed"]
Reorder collections — reorder_collections
Set the display order of product collections for the whole site or one explicit location. Supply every collection ID in that scope exactly once; a partial list is rejected. When supplied, expected_collection_ids must match the full current order or the complete reorder is refused. Returns the ordered collections without changing their products.
Minimum role: admin. Required entitlement: None.
Annotations: title: Reorder collections, readOnlyHint: false, openWorldHint: true, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
collection_ids |
array of string (fields) | Yes | minItems: 1; uniqueItems: true |
expected_collection_ids |
array of string (fields) | No | Optional full ordered snapshot from list_collections; when supplied, a stale snapshot rejects the entire reorder. uniqueItems: true |
location_id |
string or null | No | |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
additionalProperties: false; required: ["collection_ids"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
collections |
array of object (fields) | Yes |
required: ["collections"]
Replace product weekly schedule — replace_product_weekly_schedule
Replace a product’s weekly time slots at one location when the user wants to change its recurring schedule. Times are in that location’s timezone and use the product duration/capacity. A restaurant table product has no weekly slots: it is seated through its location’s opening hours. An online offering has no weekly slots: it is booked in its provider’s working hours (set_member_scheduling). An empty slots array clears that schedule. Future times are calculated from the saved rules. Sessions with booking history keep their recorded times and capacity. Returns the saved rules and the count of recorded future sessions cancelled by the change.
Minimum role: member. Required entitlement: None.
Annotations: title: Replace product weekly schedule, readOnlyHint: false, openWorldHint: true, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
location_id |
string | Yes | A saved location ID. |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
product_id |
string | Yes | |
slots |
array of object (fields) | Yes |
additionalProperties: false; required: ["product_id","location_id","slots"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
cancelled |
integer | Yes | minimum: 0 |
rules |
array of object (fields) | Yes |
additionalProperties: false; required: ["rules","cancelled"]
Set collection products — set_collection_products
Set a collection’s complete product membership and order. Supply every product ID to retain. When supplied, expected_product_ids is the full ordered snapshot being edited; a stale snapshot refuses every change. To move removed products into another explicitly named same-organization collection, supply move_to and both collections’ complete expected_product_ids. A move keeps the destination’s current order and appends source removals in source order without duplicates. Returns the source products; read the catalog to verify both sections.
Minimum role: admin. Required entitlement: None.
Annotations: title: Set collection products, readOnlyHint: false, openWorldHint: true, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
collection_id |
string | Yes | |
expected_product_ids |
array of string (fields) | No | When supplied, reject changes unless this exactly matches the collection’s current product order. Required with move_to. maxItems: 2000; uniqueItems: true |
move_to |
object (fields) | No | additionalProperties: false; required: ["collection_id","expected_product_ids"] |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
product_ids |
array of string (fields) | Yes | maxItems: 2000; uniqueItems: true |
additionalProperties: false; required: ["collection_id","product_ids"]
allOf: shape 1.
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
products |
array of object (fields) | Yes |
required: ["products"]
Set product booking config — set_product_booking_config
Configure booking duration, capacity, scheduling, minimum notice, party limits, guest terms, what an online payment is charged for, and the questions asked with each booking (for example an assessment visit's property questions or a restaurant table's occasion). New settings default to instant confirmation and no online collection. Omitted fields retain saved settings; existing sessions keep their times and capacity, except a table's unbooked seatings, which follow its new length, interval and seats. Read settings with get_product.
Minimum role: member. Required entitlement: None.
Annotations: title: Set product booking config, readOnlyHint: false, openWorldHint: true, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
accessibility_contact_required |
boolean | No | Ask guests needing accessibility support to contact the business before booking. |
advance_notice_minutes |
integer or null | No | Minimum notice in minutes (1440 is 1 day, 2880 is 2 days): clients cannot book or cancel online a session that starts sooner, and no booking is moved into one. Free cancellation closes at least 24 hours before the start either way. Null means no notice. minimum: 0 |
assigned_member_id |
string | No | Host membership ID from list_organization_members → members[].id or get_member_scheduling → members[].id, not userId. Every bookable offering has one: it handles all its bookings. Guests see this member’s approved public profile. Read get_member_public_profile; publication requires an approved profile with a nonblank public_name. |
confirmation_mode |
string | No | instant confirms immediately (default); review waits for staff approval. default: "instant"; enum: ["instant","review"] |
default_capacity |
integer or null | No | Places per session; null means unlimited, zero closes seats. minimum: 0 |
duration_minutes |
integer or null | No | Minutes each visit occupies its booking slot or seats, independent of the interval between start times. Null clears an existing duration. minimum: 1 |
expected_questions_revision |
string | No | booking.questions_revision (or stay.questions_revision) from get_product; required with questions. |
held_online |
boolean | No | True holds the offering online: its times are its provider's working hours, in the provider's timezone. Requires scheduling_mode provider with an assigned member. |
minimum_guest_age |
integer or null | No | Youngest guest admitted, stated to guests before booking; null states none. minimum: 0 |
online_payment_required |
boolean | No | True requires online payment when booking; false is the default and does not collect online. default: false |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
party_size_max |
integer or null | No | Largest party one booking takes; null is limited only by the session's places. A larger party contacts the business. minimum: 1 |
party_size_min |
integer or null | No | Smallest party one booking takes; null has no minimum. minimum: 1 |
payment_basis |
string | No | What the online price is charged for: per_guest (each place, a class seat) or per_booking (the booking as a whole, a table's deposit). enum: ["per_guest","per_booking"] |
payment_min_party_size |
integer or null | No | Smallest party that pays online, for example a deposit for parties of 6 or more; smaller parties book without paying. Null means every party pays when online_payment_required is true. minimum: 1 |
product_id |
string | Yes | |
questions |
array of object (fields) | No | Replace the questions asked with each booking. Read get_product first and keep existing question IDs. A question-only change never moves or regenerates sessions. maxItems: 20 |
scheduling_mode |
string | No | Legal consultations require provider scheduling with an explicitly assigned attorney. business: the business publishes its own sessions; the assigned member hosts them, but their working hours do not set the times. Experiences may use it. provider: times come from the assigned member’s working hours. Physical provider times also respect the selected member’s availability; online times come from their working hours. enum: ["business","provider"] |
seating_interval_minutes |
integer or null | No | Tables only, and required for them: minutes between seatings. A table is seated from each opening of its location's opening hours (or that date's special hours) and every interval after, while duration_minutes still ends by closing. Change when tables are bookable with update_location hours, block_dates and open_dates. maximum: 1440; minimum: 5 |
additionalProperties: false; required: ["product_id"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
config |
object or null (fields) | Yes | required: ["duration_minutes","seating_interval_minutes","default_capacity","confirmation_mode","online_payment_required","held_online","advance_notice_minutes","party_size_min","party_size_max","minimum_guest_age","accessibility_contact_required","payment_basis","payment_min_party_size","questions","questions_revision"] |
required: ["config"]
Set product location — set_product_location
Set whether the selected location offers a product and shows it on that location’s website. A new location relationship defaults active and published to true; on an existing relationship, omitted flags retain their values. Returns the saved location flags. Existing prices do not establish a location offering; read get_product for the complete product.
Minimum role: admin. Required entitlement: None.
Annotations: title: Set product location, readOnlyHint: false, openWorldHint: true, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
active |
boolean | No | |
location_id |
string | Yes | |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
product_id |
string | Yes | |
published |
boolean | No |
additionalProperties: false; required: ["product_id","location_id"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
active |
boolean | Yes | |
location_id |
string | Yes | |
product_id |
string | Yes | |
published |
boolean | Yes |
additionalProperties: false; required: ["product_id","location_id","active","published"]
Set product publication — set_product_publication
Publish or withhold a product on the selected site and return its saved publication flag. Read get_product first. A home or offering booked on this site needs an assigned host with an approved public profile and nonblank public_name: find membership IDs in list_organization_members, read get_member_public_profile, and author or approve the profile through update_member_public_profile. Assignment alone does not publish a profile. Other publication prerequisites, including pricing and availability, still apply. This setting is independent of whether the product is available for sale and of visibility at individual locations. Increasing the number of live homes requires the dashboard.
Minimum role: admin. Required entitlement: None.
Annotations: title: Set product publication, readOnlyHint: false, openWorldHint: true, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
product_id |
string | Yes | |
published |
boolean | Yes |
additionalProperties: false; required: ["product_id","published"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
organization_id |
string | Yes | |
product_id |
string | Yes | |
published |
boolean | Yes |
additionalProperties: false; required: ["product_id","organization_id","published"]
Update collection — update_collection
Change the selected product collection’s name, description or display position and return the saved collection. Only supplied fields change; membership uses set_collection_products and ordering several collections uses reorder_collections.
Minimum role: admin. Required entitlement: None.
Annotations: title: Update collection, readOnlyHint: false, openWorldHint: true, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
collection_id |
string | Yes | |
description |
string or null | No | |
name |
string | No | |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
sort_order |
integer | No |
additionalProperties: false; required: ["collection_id"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
collection |
object (fields) | Yes | additionalProperties: false; required: ["id","organization_id","location_id","name","slug","description","image","sort_order"] |
required: ["collection"]
Update menu — update_menu
Update and publish supplied menu dishes, prices and sections at the selected location. Omitted items, variants, prices and order remain; new items and sections append in supplied order. Returns the location’s menu sections and dishes.
Minimum role: admin. Required entitlement: None.
Annotations: title: Update menu, readOnlyHint: false, openWorldHint: true, destructiveHint: true, idempotentHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
idempotency_key |
string | Yes | maxLength: 200; minLength: 1 |
location_id |
string | Yes | |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
sections |
array of object (fields) | Yes | maxItems: 30; minItems: 1 |
additionalProperties: false; required: ["location_id","idempotency_key","sections"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
public_url |
string or null | Yes | |
replayed |
boolean | Yes | |
sections |
array of object (fields) | Yes |
additionalProperties: false; required: ["sections","replayed","public_url"]
Update product — update_product
Edit a product and return its updated record. For a price change, supply the variant ID, price ID and unit_amount. Variants and prices merge by ID; omitted entries stay. Supplied details replace their current values by default. Use details_mode merge for focused fact edits, preserving unmentioned facts and clearing named facts with null. Booking setup also creates sessions and publishes the offering. For a connected Airbnb home, changed arrival/departure windows, cancellation, pet/smoking/event rules and minimum stays update supported listing settings through Channex. Unsupported connected-listing settings are refused before saving. A failed channel completion reports the committed edit with CHANNEL_PUSH_FAILED; reload before retrying. Increasing the number of live homes requires the dashboard.
Minimum role: member. Required entitlement: None.
Annotations: title: Update product, readOnlyHint: false, openWorldHint: true, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
active |
boolean | No | Enable or disable this product. Increasing the number of live homes requires the dashboard. |
booking |
object (fields) | No | Complete booking setup for a published offering. Legal consultations require provider scheduling and an explicitly selected attorney. A restaurant's tables are one table product per location, seated through that location's opening and special hours every seating_interval_minutes: they take no weekly_slots or sessions, the location needs opening hours, default_capacity is the guests seatable per seating, and a deposit is the variant's price with payment_basis per_booking (price zero for no deposit). Any other offering at a location takes weekly_slots or dated sessions; an update can retain its saved weekly times. location_id null holds it online: it needs scheduling_mode provider with an assigned member, takes no weekly_slots or sessions, and is booked in that provider's working hours. Runtime validation requires actual future availability before publication. additionalProperties: false; required: ["location_id","duration_minutes","default_capacity"] |
description |
string | No | |
details |
object (fields) | No | Named customer-facing facts for the product kind. Omitted details stay unchanged. Supplied details replace their map by default, retaining featured unless supplied. With details_mode merge, only supplied facts change and null removes a named fact. pricing_note requires empty numeric prices. additionalProperties: false |
details_mode |
string | No | Requires details. replace is the default complete replacement map, retaining featured unless supplied; null is refused. merge preserves unmentioned facts and null explicitly removes a named fact. Unknown keys are refused in either mode. default: "replace"; enum: ["merge","replace"] |
idempotency_key |
string | No | Required with booking setup. Repeat the same key with the same request for an identical retry. maxLength: 200; minLength: 1 |
kind |
string | No | The customer-facing kind: dish (food or drink), experience (experience or class), service (practice area or consultation), stay (place to stay), or table (a restaurant location’s tables, booked as a reservation). Determines the allowed descriptive fields; booking and stock remain separate capabilities. enum: ["dish","experience","service","stay","table"] |
marketing_features |
array of string (fields) | No | Generic selling bullets. Inclusions, preparation instructions and policies are separate details. maxItems: 15 |
metadata |
object | No | Opaque string annotations for integrations. No pricing, scheduling, stock or filtering behavior may read these. additionalProperties: {"type":"string"} |
name |
string | No | |
order_url |
string or null | No | External ordering or booking destination, such as Uber Eats, an experience checkout, or Clio Grow. When set, public actions use this URL instead of native booking. Null restores the configured native flow. |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
product_id |
string | Yes | |
stay |
object (fields) | No | Stay settings to change on a place to stay. Its location is fixed. additionalProperties: false |
tax_code |
string or null | No | |
unit_label |
string or null | No | A unit noun such as "person" or "night". Never pricing prose. |
updated_at |
string | No | The Product updated_at from the read being edited. A stale value refuses the entire update, including variants and prices. Omit only for a deliberate update based on current state. minLength: 1 |
variants |
array of object (fields) | No | Partial existing variants by id or new variants. Omitted variants and their prices remain unless variants_mode is replace. Existing variant and price IDs retain their identities. maxItems: 250; minItems: 1 |
variants_mode |
string | No | merge preserves variants omitted from the supplied list. replace explicitly removes omitted variants and their owned records; removal is refused once a variant has booking history. Applies only with variants. default: "merge"; enum: ["merge","replace"] |
additionalProperties: false; required: ["product_id"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
product |
object (fields) | Yes | additionalProperties: false; required: ["id","kind","name","slug","description","active","variants","details","publications","locations","collections","source","created_at","updated_at","channel_push"] |
required: ["product"]
Providers
Get member public profile — get_member_public_profile
Read one organization membership’s authored public host name, photo, biography, approval and shared revision, including unpublished drafts. A valid membership without saved settings returns profile null. This is separate from the person’s Better Auth account profile and does not return working hours or Calendar data. Ordinary members can read only themselves; owners/admins can inspect their team.
Minimum role: member. Required entitlement: None.
Annotations: title: Get member public profile, readOnlyHint: true, idempotentHint: true, openWorldHint: false, destructiveHint: false.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
member_id |
string | Yes | Organization membership ID from get_member_scheduling.members[].id or list_organization_members.members[].id, not the person’s userId. Ordinary members may name only their own membership. minLength: 1 |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
additionalProperties: false; required: ["member_id"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
profile |
object or null (fields) | Yes | additionalProperties: false; required: ["member_id","updated_at","public_name","public_photo_url","public_bio","public_approved"] |
additionalProperties: false; required: ["profile"]
Get member scheduling — get_member_scheduling
List accessible organization memberships and their hours, time off and Calendar status when member_id is omitted, or read one membership’s scheduling. A valid membership without saved settings returns scheduling null. A profile-only record has null timezone, weekly and time_off. Use get_member_public_profile for authored host profiles and approval. Ordinary members can read only themselves; owners/admins can inspect their team. No Google event content or credentials are returned.
Minimum role: member. Required entitlement: None.
Annotations: title: Get member scheduling, readOnlyHint: true, idempotentHint: true, openWorldHint: false, destructiveHint: false.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
member_id |
string | No | Organization membership ID from get_member_scheduling.members[].id or list_organization_members.members[].id, not the person’s userId. Ordinary members may name only their own membership. minLength: 1 |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
additionalProperties: false; required: []
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
members |
array of object (fields) | No | |
scheduling |
object or null (fields) | No | additionalProperties: false; required: ["member_id","timezone","updated_at","weekly","time_off","calendar_account_id","calendar_ids","calendar_status","calendar_conflict_count","calendar_conflicts"] |
additionalProperties: false
Set member busy calendars — set_member_busy_calendars
Google Calendar sync. Selecting calendars needs the Business plan; disconnecting never does. After working hours are authored, select busy-input calendars using the member’s already-linked Google account and known calendar IDs. Only that member may select their linked account; an administrator can disconnect it. This tool does not connect Google or discover calendars. Returns the saved selection and check status. Stale or disconnected selected calendars block availability; no selected calendars uses internal scheduling.
Minimum role: member. Required entitlement: None.
Annotations: title: Set member busy calendars, readOnlyHint: false, openWorldHint: false, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
account_id |
string or null | Yes | Existing member Google account with free/busy scopes; null with no calendars disconnects. Does not grant OAuth access. |
calendar_ids |
array of string (fields) | Yes | Busy-input calendars, separate from organization booking output. Empty pauses checking; existing bookings and Google events are unchanged. maxItems: 10; uniqueItems: true |
member_id |
string | Yes | Organization membership ID from get_member_scheduling.members[].id or list_organization_members.members[].id, not the person’s userId. Ordinary members may name only their own membership. minLength: 1 |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
additionalProperties: false; required: ["member_id","account_id","calendar_ids"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
scheduling |
object (fields) | Yes | additionalProperties: false; required: ["member_id","updated_at","calendar_account_id","calendar_ids","calendar_status","calendar_conflict_count"] |
additionalProperties: false; required: ["scheduling"]
Set member scheduling — set_member_scheduling
Change a member’s working hours or time off using the latest shared revision from get_member_scheduling. Omitted fields retain their values. When saved timezone is null, provide timezone, weekly and time_off together; explicit empty arrays mean no working hours or time off. Later edits can supply only changed fields. Returns the saved hours and revision. Changes affect future bookable availability; existing booking assignments and times stay fixed and no guest messages are sent. Public host profile edits use update_member_public_profile.
Minimum role: member. Required entitlement: None.
Annotations: title: Set member scheduling, readOnlyHint: false, openWorldHint: true, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
member_id |
string | Yes | Organization membership ID from get_member_scheduling.members[].id or list_organization_members.members[].id, not the person’s userId. Ordinary members may name only their own membership. minLength: 1 |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
time_off |
array of object (fields) | No | maxItems: 100 |
timezone |
string | No | IANA timezone for these working hours. |
updated_at |
string or null | Yes | Latest updated_at from get_member_scheduling or get_member_public_profile; null only when that read returns null. Both concerns share this revision, so either kind of edit can make an earlier read stale. format: "date-time" |
weekly |
array of object (fields) | No | maxItems: 28 |
additionalProperties: false; required: ["member_id","updated_at"]
anyOf: shape 1, shape 2, shape 3.
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
scheduling |
object (fields) | Yes | additionalProperties: false; required: ["member_id","updated_at","timezone","weekly","time_off"] |
additionalProperties: false; required: ["scheduling"]
Update member public profile — update_member_public_profile
Edit only the supplied public host profile fields using the latest shared revision from get_member_public_profile. Omitted fields retain their values; null clears a field. Profile content edits revoke prior approval unless an owner/admin explicitly approves that edit. Only owners/admins may supply public_approved. True publishes the authored profile as a host on public offerings. False withholds it. Approval requires a nonblank public_name. A profile can be saved before any working hours exist; this operation leaves hours, time off and Calendar settings unchanged. Returns the saved profile and shared revision.
Minimum role: member. Required entitlement: None.
Annotations: title: Update member public profile, readOnlyHint: false, openWorldHint: true, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
member_id |
string | Yes | Organization membership ID from get_member_scheduling.members[].id or list_organization_members.members[].id, not the person’s userId. Ordinary members may name only their own membership. minLength: 1 |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
public_approved |
boolean | No | Owner/admin only. True approves this authored profile for public host display; false withholds it. |
public_bio |
string or null | No | maxLength: 2000 |
public_name |
string or null | No | maxLength: 100 |
public_photo_url |
string or null | No | format: "uri"; maxLength: 2048 |
updated_at |
string or null | Yes | Latest updated_at from get_member_scheduling or get_member_public_profile; null only when that read returns null. Both concerns share this revision, so either kind of edit can make an earlier read stale. format: "date-time" |
additionalProperties: false; required: ["member_id","updated_at"]
anyOf: shape 1, shape 2, shape 3, shape 4.
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
profile |
object (fields) | Yes | additionalProperties: false; required: ["member_id","updated_at","public_name","public_photo_url","public_bio","public_approved"] |
additionalProperties: false; required: ["profile"]
Qa
Create Q&A — create_qa
Create authored Q&A in the explicit site, page or location scope. Omitted sort_order appends. This creates a new record on every call and is not idempotent: do not automatically retry an uncertain response. Imported Google content remains managed in Google.
Minimum role: admin. Required entitlement: None.
Annotations: title: Create Q&A, readOnlyHint: false, openWorldHint: true, destructiveHint: false.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
answer |
string or null | No | |
is_owner_answer |
boolean | No | |
location_id |
string or null | No | Location scope; omit or use null for site or page Q&A. A location ID cannot be combined with a non-null page_path. |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
page_path |
string or null | No | Page scope such as /about; omit or use null for general site or location Q&A. |
question |
string | Yes | Required non-empty question; at most 500 characters after trimming. |
question_author |
string or null | No | |
sort_order |
integer | No | |
status |
string | No | enum: ["published","hidden"] |
additionalProperties: false; required: ["question"]
allOf: shape 1.
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
created |
boolean | Yes | |
id |
string | Yes |
required: ["id","created"]
Delete Q&A — delete_qa
Delete authored Q&A and its content document tree in its explicit scope. Imported Google records are protected.
Minimum role: admin. Required entitlement: None.
Annotations: title: Delete Q&A, readOnlyHint: false, openWorldHint: true, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
location_id |
string or null | No | Location scope; omit or use null for site or page Q&A. A location ID cannot be combined with a non-null page_path. |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
page_path |
string or null | No | Page scope such as /about; omit or use null for general site or location Q&A. |
qa_id |
string | Yes |
additionalProperties: false; required: ["qa_id"]
allOf: shape 1.
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
deleted |
boolean | Yes | |
qa_id |
string | Yes |
required: ["qa_id","deleted"]
List location Q&A — list_location_qa
Read Q&A for an explicit location. This tool lists authored and imported Q&A. Authored Q&A can be managed through the CMS and authored Q&A tools; imported Google question and answer content is managed in Google.
Minimum role: admin. Required entitlement: None.
Annotations: title: List location Q&A, readOnlyHint: true, idempotentHint: true, openWorldHint: false, destructiveHint: false.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
cursor |
string | No | Opaque next_cursor from the previous page. |
limit |
number | No | Page size. Defaults to 50; maximum 100. maximum: 100; minimum: 1 |
location_id |
string | Yes | |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
additionalProperties: false; required: ["location_id"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
items |
array of object (fields) | Yes | |
page_info |
object (fields) | Yes | required: ["has_more","next_cursor"] |
required: ["items","page_info"]
List organization Q&A — list_organization_qa
Read the site’s general Q&A, or the Q&A of one page when page_path is provided. This tool lists authored and imported Q&A. Authored Q&A can be managed through the CMS and authored Q&A tools; imported Google question and answer content is managed in Google.
Minimum role: admin. Required entitlement: None.
Annotations: title: List organization Q&A, readOnlyHint: true, idempotentHint: true, openWorldHint: false, destructiveHint: false.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
cursor |
string | No | Opaque next_cursor from the previous page. |
limit |
number | No | Page size. Defaults to 50; maximum 100. maximum: 100; minimum: 1 |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
page_path |
string or null | No | Public route path such as /about, /pricing, or /blog. Omit for general site Q&A. |
additionalProperties: false; required: []
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
items |
array of object (fields) | Yes | |
page_info |
object (fields) | Yes | required: ["has_more","next_cursor"] |
required: ["items","page_info"]
Reorder Q&A — reorder_qa
Set sort positions of authored Q&A records in one explicit scope. Every id must be distinct, manual and in scope; otherwise no record is reordered. Imported Google records are protected.
Minimum role: admin. Required entitlement: None.
Annotations: title: Reorder Q&A, readOnlyHint: false, openWorldHint: true, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
location_id |
string or null | No | Location scope; omit or use null for site or page Q&A. A location ID cannot be combined with a non-null page_path. |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
page_path |
string or null | No | Page scope such as /about; omit or use null for general site or location Q&A. |
updates |
array of object (fields) | Yes | minItems: 1 |
additionalProperties: false; required: ["updates"]
allOf: shape 1.
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
updated |
integer | Yes |
required: ["updated"]
Update Q&A — update_qa
Update at least one authored Q&A field in its explicit scope. Omitted fields retain their values. Imported Google records and translations cannot be edited through this tool.
Minimum role: admin. Required entitlement: None.
Annotations: title: Update Q&A, readOnlyHint: false, openWorldHint: true, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
answer |
string or null | No | |
is_owner_answer |
boolean | No | |
location_id |
string or null | No | Location scope; omit or use null for site or page Q&A. A location ID cannot be combined with a non-null page_path. |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
page_path |
string or null | No | Page scope such as /about; omit or use null for general site or location Q&A. |
qa_id |
string | Yes | |
question |
string | No | Required non-empty question; at most 500 characters after trimming. |
question_author |
string or null | No | |
sort_order |
integer | No | |
status |
string | No | enum: ["published","hidden"] |
additionalProperties: false; required: ["qa_id"]
anyOf: shape 1, shape 2, shape 3, shape 4, shape 5, shape 6.
allOf: shape 1.
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
qa_id |
string | Yes | |
updated |
boolean | Yes |
required: ["qa_id","updated"]
Reviews
List location reviews — list_location_reviews
Read reviews and existing replies for the selected location. Includes review provenance and verification status. Replies to imported Google reviews are managed in Google; this tool makes no changes.
Minimum role: admin. Required entitlement: None.
Annotations: title: List location reviews, readOnlyHint: true, idempotentHint: true, openWorldHint: false, destructiveHint: false.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
cursor |
string | No | Opaque next_cursor from the previous page. |
limit |
number | No | Page size. Defaults to 50; maximum 100. maximum: 100; minimum: 1 |
location_id |
string | Yes | |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
additionalProperties: false; required: ["location_id"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
page_info |
object (fields) | Yes | required: ["has_more","next_cursor"] |
reviews |
array of object (fields) | Yes |
required: ["reviews","page_info"]
List organization reviews — list_organization_reviews
Read site-wide reviews that have no location, including existing replies, provenance and verification status. This tool makes no changes.
Minimum role: admin. Required entitlement: None.
Annotations: title: List organization reviews, readOnlyHint: true, idempotentHint: true, openWorldHint: false, destructiveHint: false.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
cursor |
string | No | Opaque next_cursor from the previous page. |
limit |
number | No | Page size. Defaults to 50; maximum 100. maximum: 100; minimum: 1 |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
additionalProperties: false; required: []
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
page_info |
object (fields) | Yes | required: ["has_more","next_cursor"] |
reviews |
array of object (fields) | Yes |
required: ["reviews","page_info"]
Stays
Assign home photos to room — assign_home_photos_to_room
Assign existing home photos to one room group, to Additional photos, or to a newly created room. First call get_product: photo IDs are product.image.asset_id and product.gallery[].asset_id; current room membership is product.stay.photo_rooms. Supply exactly one destination: room_id with an existing ID, explicit room_id:null for Additional photos, or new_room_type. Omitting room_id does not mean null. Each selected photo needs its current expected_room_id; changed membership or a removed photo refuses the whole assignment, including new room creation. Returns the destination ID, new room ID if created and moved photo IDs. Changes only Blawby; it does not update Airbnb. Edit Airbnb’s photo tour separately in Airbnb.
Minimum role: admin. Required entitlement: None.
Annotations: title: Assign home photos to room, readOnlyHint: false, openWorldHint: true, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
new_room_type |
string | No | Create this room type and assign the photos to it. Omit room_id when using this destination. enum: ["art_studio","backyard","balcony","bedroom","bowling_alley","childrens_playroom","courtyard","darkroom","deck","dining_area","event_room","exterior","front_yard","full_bathroom","full_kitchen","game_room","garage","garden","gym","half_bathroom","hot_tub","kitchenette","laundry_area","library","living_room","movie_theater","music_studio","office","patio","photography_studio","pool","porch","rooftop","sunroom","terrace","theme_room","wine_cellar","woodshop","workshop","workspace"] |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
photos |
array of object (fields) | Yes | maxItems: 50; minItems: 1 |
product_id |
string | Yes | The place to stay: a product of kind stay, from list_products. minLength: 1 |
room_id |
string or null | No | Existing room ID from get_product → product.stay.photo_rooms, or explicit null for Additional photos. Omit only when supplying new_room_type. minLength: 1 |
additionalProperties: false; required: ["product_id","photos"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
created_room_id |
string or null | Yes | The newly created room’s ID when new_room_type was supplied; otherwise null. |
destination_room_id |
string or null | Yes | The saved destination room; null means Additional photos. |
moved_photo_ids |
array of string (fields) | Yes | The selected photo IDs whose assignment was saved. minItems: 1; uniqueItems: true |
product_id |
string | Yes | minLength: 1 |
additionalProperties: false; required: ["product_id","destination_room_id","created_room_id","moved_photo_ids"]
Create home room — create_home_room
Create an empty room or space, such as Bedroom or Patio, for grouping an existing home’s photos. This creates a room group, not a photo or business location, and requires no amenity answers. Use assign_home_photos_to_room to group existing home photos afterward; save_media_attachment saves new attachments and attach_media adds library images to the home’s gallery. Returns the new room ID. Each call creates a new room; if the outcome is uncertain, read get_product before retrying. Changes only Blawby; it does not update Airbnb. Edit Airbnb’s photo tour separately in Airbnb.
Minimum role: admin. Required entitlement: None.
Annotations: title: Create home room, readOnlyHint: false, openWorldHint: true, destructiveHint: false.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
product_id |
string | Yes | The place to stay: a product of kind stay, from list_products. minLength: 1 |
type |
string | Yes | Type of the empty room or space to create. enum: ["art_studio","backyard","balcony","bedroom","bowling_alley","childrens_playroom","courtyard","darkroom","deck","dining_area","event_room","exterior","front_yard","full_bathroom","full_kitchen","game_room","garage","garden","gym","half_bathroom","hot_tub","kitchenette","laundry_area","library","living_room","movie_theater","music_studio","office","patio","photography_studio","pool","porch","rooftop","sunroom","terrace","theme_room","wine_cellar","woodshop","workshop","workspace"] |
additionalProperties: false; required: ["product_id","type"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
product_id |
string | Yes | minLength: 1 |
room |
object (fields) | Yes | additionalProperties: false; required: ["id","type","photo_ids","details_version"] |
additionalProperties: false; required: ["product_id","room"]
Delete home room — delete_home_room
Delete a room or space group from a home. First call get_product for product.stay.photo_rooms and choose its exact room ID. Its photos become Additional photos; the home’s cover, gallery and library files remain. Returns the removed ID and current photo memberships. Changes only Blawby; it does not update Airbnb. Delete an Airbnb room separately in Airbnb.
Minimum role: admin. Required entitlement: None.
Annotations: title: Delete home room, readOnlyHint: false, openWorldHint: true, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
product_id |
string | Yes | The place to stay: a product of kind stay, from list_products. minLength: 1 |
room_id |
string | Yes | Room ID from get_product → product.stay.photo_rooms. minLength: 1 |
additionalProperties: false; required: ["product_id","room_id"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
deleted_room_id |
string | Yes | minLength: 1 |
photo_memberships |
array of object (fields) | Yes | Every photo retained on this home in Product photo order, with its current room assignment. Null means Additional photos. |
product_id |
string | Yes | minLength: 1 |
additionalProperties: false; required: ["product_id","deleted_room_id","photo_memberships"]
Delete stay payment — delete_stay_payment
Remove one offline payment record entered by mistake. First call get_product_booking for its payment ID. Returns the removed payment ID and current paid amount/status. Does not refund or move money, and cannot remove the guest’s Stripe payment.
Minimum role: admin. Required entitlement: None.
Annotations: title: Delete stay payment, readOnlyHint: false, openWorldHint: false, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
booking_id |
string | Yes | Stay ID: booking_id from list_product_bookings. minLength: 1 |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
payment_id |
string | Yes | ID from get_product_booking → record.payments[].id, or record_stay_payment → payment.id. Removes an offline record, not a Stripe payment or actual money. minLength: 1 |
additionalProperties: false; required: ["booking_id","payment_id"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
booking_id |
string | Yes | minLength: 1 |
currency |
string | Yes | minLength: 1 |
deleted_payment_id |
string | Yes | minLength: 1 |
paid_minor |
integer | Yes | |
payment_status |
string or null | Yes | enum: ["unpaid","partial","paid","overpaid",null] |
additionalProperties: false; required: ["booking_id","currency","paid_minor","payment_status","deleted_payment_id"]
Get stay calendar — get_stay_calendar
Read every night of a date range at one home: availability, nightly price, booking restrictions and the stays holding those nights. Returns scheduling details; each stay is its dates, status, guest and party; members read the guest’s first name and no channel. Owners and admins use get_product_booking for one booking’s contact and payment details, or get_product for the home’s photos and room groups.
Minimum role: member. Required entitlement: None.
Annotations: title: Get stay calendar, readOnlyHint: true, idempotentHint: true, openWorldHint: false, destructiveHint: false.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
from |
string | Yes | pattern: "^\d{4}-\d{2}-\d{2}$" |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
product_id |
string | Yes | The place to stay: a product of kind stay, from list_products. minLength: 1 |
to |
string | Yes | Exclusive; at most 500 days after from. pattern: "^\d{4}-\d{2}-\d{2}$" |
additionalProperties: false; required: ["product_id","from","to"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
channel_push |
object or null (fields) | No | What the home's connected channel took from this change: null when no channel push is needed; pushed when delivery completed; pending, with the reason, while it waits out Channex's rate limit or an unconfirmed attempt it sends again. A refused channel update returns a committed error. |
home |
object (fields) | Yes | additionalProperties: false; required: ["product_id","name","internal_name","timezone","currency","base_price_minor","min_nights","calendar_rules","address","cancellation_policy","long_term_cancellation_policy"] |
nights |
array of object (fields) | Yes | |
stays |
array of object (fields) | Yes |
required: ["home","nights","stays"]
Record stay payment — record_stay_payment
Record money received outside Blawby for a host-entered stay, such as cash or a bank transfer. Read get_product_booking for the stay ID and currency. A negative amount records an offline refund. Returns the exact recorded payment and current paid amount/status, without unrelated guest details or payment history. Moves no money.
Minimum role: admin. Required entitlement: None.
Annotations: title: Record stay payment, readOnlyHint: false, openWorldHint: false, destructiveHint: true, idempotentHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
amount_minor |
integer | Yes | Whole minor units of the stay’s currency from get_product_booking; negative records an offline refund, never zero. not: {"const":0} |
booking_id |
string | Yes | Stay ID: booking_id from list_product_bookings. minLength: 1 |
idempotency_key |
string | Yes | Reuse only for the identical amount, method, date, reference and note on this stay. Returns the exact recorded payment without a second entry. maxLength: 200; minLength: 1 |
method |
string | Yes | enum: ["cash","bank_transfer","card_external","other"] |
note |
string | No | maxLength: 1000 |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
paid_on |
string | Yes | pattern: "^\d{4}-\d{2}-\d{2}$" |
reference |
string | No | maxLength: 200 |
additionalProperties: false; required: ["booking_id","amount_minor","method","paid_on","idempotency_key"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
booking_id |
string | Yes | minLength: 1 |
currency |
string | Yes | minLength: 1 |
paid_minor |
integer | Yes | |
payment |
object (fields) | Yes | additionalProperties: false; required: ["id","booking_id","amount_minor","currency","method","paid_on","reference","note","created_at"] |
payment_status |
string or null | Yes | enum: ["unpaid","partial","paid","overpaid",null] |
additionalProperties: false; required: ["booking_id","currency","paid_minor","payment_status","payment"]
Set stay nights — set_stay_nights
Close or open nights, set a nightly price, or set stay rules for a date range at one place to stay. Fields left out keep each night’s value; weekdays narrows the range to nights on those weekdays; price_change_percent moves each chosen night’s own current price by a whole percent instead of setting one, and compounds if sent again; price_minor null inherits the weekend price on Friday/Saturday when configured, otherwise the base price; reset removes the range’s overrides. Updates the website’s bookable nights and, when connected, pushes prices, availability and stay rules to the home’s Airbnb listing through Channex. Returns channel_push on success. A failed channel update raises CHANNEL_PUSH_FAILED with committed:true; read the calendar before retrying.
Minimum role: admin. Required entitlement: None.
Annotations: title: Set stay nights, readOnlyHint: false, openWorldHint: true, destructiveHint: true, idempotentHint: false.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
closed |
boolean | No | |
closed_to_arrival |
boolean | No | |
closed_to_departure |
boolean | No | |
from |
string | Yes | pattern: "^\d{4}-\d{2}-\d{2}$" |
max_stay |
integer or null | No | minimum: 1 |
min_stay_arrival |
integer or null | No | minimum: 1 |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
price_change_percent |
integer | No | Moves each chosen night’s own current price by this percent, rounded to the minor unit. Not with price_minor or reset; 0 is refused. maximum: 50; minimum: -50; not: {"const":0} |
price_minor |
integer or null | No | minimum: 0 |
product_id |
string | Yes | The place to stay: a product of kind stay, from list_products. minLength: 1 |
reset |
boolean | No | True removes all nightly overrides in the range and cannot be combined with night settings. False or omitted requires at least one night setting. |
to |
string | Yes | Exclusive; at most 500 days after from. pattern: "^\d{4}-\d{2}-\d{2}$" |
weekdays |
array of integer (fields) | No | Only nights on these weekdays, 0 Sunday to 6 Saturday. Omitted means every night in the range. maxItems: 7; minItems: 1; uniqueItems: true |
additionalProperties: false; required: ["product_id","from","to"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
channel_push |
object or null (fields) | No | What the home's connected channel took from this change: null when no channel push is needed; pushed when delivery completed; pending, with the reason, while it waits out Channex's rate limit or an unconfirmed attempt it sends again. A refused channel update returns a committed error. |
home |
object (fields) | Yes | additionalProperties: false; required: ["product_id","name","internal_name","timezone","currency","base_price_minor","min_nights","calendar_rules","address","cancellation_policy","long_term_cancellation_policy"] |
nights |
array of object (fields) | Yes | |
stays |
array of object (fields) | Yes |
required: ["home","nights","stays"]
Update home accessibility — update_home_accessibility
Change one home accessibility answer. First call get_product for product.updated_at and product.stay.accessibility. True requires evidence images in this organization; saving appends selected library images to this home’s Product photos without changing the cover, existing order or room assignments. False/null requires []; null clears the answer. Evidence photos remain protected until the answer is cleared or the evidence replaced. A stale Product revision or photo order refuses the entire change. Changes only Blawby; it does not update Airbnb. Edit Airbnb accessibility separately in Airbnb.
Minimum role: admin. Required entitlement: None.
Annotations: title: Update home accessibility, readOnlyHint: false, openWorldHint: true, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
accessibility |
object (fields) | Yes | additionalProperties: false; required: ["feature","available","photo_ids"] |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
product_id |
string | Yes | The place to stay: a product of kind stay, from list_products. minLength: 1 |
updated_at |
string | Yes | product.updated_at from the latest get_product call. A stale value refuses the entire change. minLength: 1 |
additionalProperties: false; required: ["product_id","updated_at","accessibility"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
accessibility |
array of object (fields) | Yes | All six home accessibility features in catalog order, including unanswered null rows. maxItems: 6; minItems: 6 |
product_id |
string | Yes | minLength: 1 |
updated_at |
string | Yes | minLength: 1 |
additionalProperties: false; required: ["product_id","updated_at","accessibility"]
Update home room — update_home_room
Change a room’s beds, bedroom bathroom privacy, amenity assignments or one bedroom accessibility answer. First call get_product for product.stay.photo_rooms and the selected room’s details_version. Omitted fields remain unchanged. Bed allocations must fit the home’s declared total; assigning an amenity also adds it to the home’s amenity set, while unassigning only removes its room membership. Accessibility evidence may append library images to the home’s gallery. A stale room revision or invalid combination refuses the entire change. Returns the saved room details. Changes only Blawby; it does not update Airbnb. Edit Airbnb room details separately in Airbnb.
Minimum role: admin. Required entitlement: None.
Annotations: title: Update home room, readOnlyHint: false, openWorldHint: true, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
accessibility |
object (fields) | No | additionalProperties: false; required: ["feature","available","photo_ids"] |
amenities |
array of string (fields) | No | Replaces this room’s amenity memberships; [] unassigns all. Selected codes also join the home’s amenity set. Unassigning does not remove a home amenity. uniqueItems: true |
expected_details_version |
integer | Yes | details_version of this room from get_product → product.stay.photo_rooms. A stale value refuses the entire edit. minimum: 1 |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
private_attached_bathroom |
boolean or null | No | Whether this bedroom has a private attached bathroom. Null is unanswered. Only bedrooms may author this fact. |
product_id |
string | Yes | The place to stay: a product of kind stay, from list_products. minLength: 1 |
room_id |
string | Yes | Room ID from get_product → product.stay.photo_rooms. minLength: 1 |
sleeping_arrangements |
array or null (fields) | No | Room allocations from the declared listing bed total. Null is unanswered; [] explicitly states none. Each bed type occurs once; all room quantities together must fit within a known listing beds total. maxItems: 14 |
additionalProperties: false; required: ["product_id","room_id","expected_details_version"]
anyOf: shape 1, shape 2, shape 3, shape 4.
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
product_id |
string | Yes | minLength: 1 |
room |
object (fields) | Yes | additionalProperties: false; required: ["id","type","photo_ids","details_version","sleeping_arrangements","private_attached_bathroom","amenities","accessibility"] |
updated_at |
string | Yes | minLength: 1 |
additionalProperties: false; required: ["product_id","updated_at","room"]
Submissions
Create inquiry — create_inquiry
Record an inquiry, quote request or lead in the inbox for a named person, as the website's inquiry form does: their contact details, an optional message, and answers to the organization's inquiry questions (get_organization_settings → inquiry_questions). No appointment, capacity or payment is involved; to book a time use create_product_booking. Legal practices also require the person's consent acknowledgement. Reuse the same idempotency key for an identical retry; read the saved answers with get_conversation.
Minimum role: admin. Required entitlement: None.
Annotations: title: Create inquiry, readOnlyHint: false, openWorldHint: true, destructiveHint: true, idempotentHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
answers |
array of object (fields) | No | Answers to the configured questions by question ID: text for short_text/long_text, a choice ID for single_choice, choice IDs for multiple_choice, true or false for yes_no. Required questions must be answered. maxItems: 20 |
consent |
boolean | No | Legal practices only: the person acknowledged the contact and privacy notice. |
email |
string | Yes | maxLength: 200; minLength: 3 |
idempotency_key |
string | Yes | maxLength: 200; minLength: 1 |
locale |
string | No | The language the person wrote in; defaults to the website language. Answers are matched to the questions as worded in it. |
location_id |
string | No | Optional location the inquiry is about. |
message |
string | No | What they wrote. Required (10+ characters) when the organization has no inquiry questions; optional otherwise. maxLength: 2000 |
name |
string | Yes | maxLength: 100; minLength: 1 |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
phone |
string | No | Optional. International number with its country calling code, e.g. +66812345678. |
questions_revision |
string | No | inquiry_questions_revision the answers were collected against; required with answers. |
source |
string | Yes | Where the inquiry came from, such as phone call or event. maxLength: 100; minLength: 1 |
additionalProperties: false; required: ["name","email","source","idempotency_key"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
answers |
array of object (fields) | Yes | Answers to the tenant's own questions, with the wording the guest answered. Later edits to the questions do not change them. |
conversation_id |
string | Yes | |
replayed |
boolean | Yes | |
success |
boolean | Yes | const: true |
required: ["success","conversation_id","replayed","answers"]
Tasks
Complete task — complete_task
Mark a task done. Say what you found, with photos, in its conversation with send_message. Fix failed scheduled messages from their conversation.
Minimum role: member. Required entitlement: None.
Annotations: title: Complete task, readOnlyHint: false, openWorldHint: true, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
task_id |
string | Yes | minLength: 1 |
additionalProperties: false; required: ["task_id"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
task |
object (fields) | Yes | required: ["id","kind","status","version","image_url","status_line","title","when","detail","error","person","assignee","sheet","starts_at","due_at","timezone","notes","action","path","product_id","location_id","booking_id","conversation_id","can"] |
required: ["task"]
Create task — create_task
Create a task with optional dates and one assignee. Specify location_id when the product is offered at multiple locations. A new assignee may be notified according to their settings. Reuse idempotency_key only for the same request.
Minimum role: admin. Required entitlement: None.
Annotations: title: Create task, readOnlyHint: false, openWorldHint: true, destructiveHint: true, idempotentHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
assigned_member_id |
string or null | No | A Better Auth member id from list_tasks assignees; null to unassign. |
due_at |
string | No | An instant with Z or a numeric offset. format: "date-time" |
idempotency_key |
string | Yes | maxLength: 200; minLength: 1 |
location_id |
string | No | minLength: 1 |
notes |
string | No | maxLength: 5000 |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
product_id |
string | No | minLength: 1 |
starts_at |
string | No | An instant with Z or a numeric offset. format: "date-time" |
title |
string | Yes | maxLength: 200; minLength: 1 |
additionalProperties: false; required: ["title","idempotency_key"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
task |
object (fields) | Yes | required: ["id","kind","status","version","image_url","status_line","title","when","detail","error","person","assignee","sheet","starts_at","due_at","timezone","notes","action","path","product_id","location_id","booking_id","conversation_id","can"] |
required: ["task"]
List opportunities — list_opportunities
List what Today suggests: setup the business has not finished (connecting payments, adding a first offering, a price for each experience without one); and a welcome for each booked guest or client who has not heard from the business since booking. Each one goes away when that setup is done or the business messages the guest.
Minimum role: admin. Required entitlement: None.
Annotations: title: List opportunities, readOnlyHint: true, idempotentHint: true, openWorldHint: false, destructiveHint: false.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
location_id |
string | No | minLength: 1 |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
additionalProperties: false; required: []
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
opportunities |
array of object (fields) | Yes |
required: ["opportunities"]
List tasks — list_tasks
Read Today or Upcoming as stored tasks: turnovers, booking decisions, scheduled messages that did not send and tasks people added. Today is open work starting or due today or earlier plus what was done today; Upcoming is later open work by day. A member sees the tasks given to them and the turnovers at homes they look after. assignees lists who a manager can give work to.
Minimum role: member. Required entitlement: None.
Annotations: title: List tasks, readOnlyHint: true, idempotentHint: true, openWorldHint: false, destructiveHint: false.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
assignee |
string | No | me, all, or a member id. |
kind |
string | No | enum: ["turnover","message_delivery","booking_review","booking_change","custom","stay_ready","consultation_prep","consultation_follow_up"] |
location_id |
string | No | minLength: 1 |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
range |
string | No | enum: ["today","upcoming"] |
status |
string | No | enum: ["open","done","skipped","cancelled"] |
additionalProperties: false; required: []
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
assignees |
array of object (fields) | Yes | |
resolved_at |
string | Yes | |
sections |
array of object (fields) | Yes |
required: ["sections","assignees","resolved_at"]
Skip task — skip_task
Skip or dismiss a task. Say why in its conversation with send_message.
Minimum role: member. Required entitlement: None.
Annotations: title: Skip task, readOnlyHint: false, openWorldHint: false, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
task_id |
string | Yes | minLength: 1 |
additionalProperties: false; required: ["task_id"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
task |
object (fields) | Yes | required: ["id","kind","status","version","image_url","status_line","title","when","detail","error","person","assignee","sheet","starts_at","due_at","timezone","notes","action","path","product_id","location_id","booking_id","conversation_id","can"] |
required: ["task"]
Update task — update_task
Reassign, reschedule or edit the notes of an open task. Pass version from list_tasks; a newer version is refused so another change is not overwritten. A new assignee is told.
Minimum role: admin. Required entitlement: None.
Annotations: title: Update task, readOnlyHint: false, openWorldHint: true, destructiveHint: true.
Authentication: oauth2, scopes tenant.
Input
| Field | Type | Required | Description and constraints |
|---|---|---|---|
assigned_member_id |
string or null | No | A Better Auth member id from list_tasks assignees; null to unassign. |
due_at |
string or null | No | format: "date-time" |
notes |
string or null | No | maxLength: 5000 |
organization_id |
string | No | Internal organization ID from get_workspace_context or list_organizations. If omitted, uses the accessible organization saved by set_workspace_context, or the only accessible organization when no saved selection applies. Otherwise the call fails and requires a selection. Read get_workspace_context before relying on the default. A URL, domain, slug or business name is not an ID. minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
starts_at |
string or null | No | format: "date-time" |
task_id |
string | Yes | minLength: 1 |
title |
string | No | Only for a task someone added. maxLength: 200; minLength: 1 |
version |
integer | Yes | minimum: 1 |
additionalProperties: false; required: ["task_id","version"]
Output
| Field | Type | Required | Description and constraints |
|---|---|---|---|
task |
object (fields) | Yes | required: ["id","kind","status","version","image_url","status_line","title","when","detail","error","person","assignee","sheet","starts_at","due_at","timezone","notes","action","path","product_id","location_id","booking_id","conversation_id","can"] |
required: ["task"]
Shared field shapes
object or null fields
Value: object or null.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
offering |
object or null (fields) | Yes | |
range |
object (fields) | Yes | additionalProperties: false; required: ["start_date","end_date","start_label","end_label"] |
additionalProperties: false; required: ["offering","range"]
object or null fields
Value: object or null.
array of object fields
Value: array of object.
Array items: object.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
charts |
object | Yes | additionalProperties: {"additionalProperties":false,"properties":{"axis":{"items":{"additionalProperties":false,"properties":{"label":{"type":"string"},"value":{"type":"number"}},"required":["value","label"],"type":"object"},"type":"array"},"points":{"items":{"additionalProperties":false,"properties":{"display":{"type":"string"},"value":{"type":["number","null"]}},"required":["value","display"],"type":"object"},"type":"array"}},"required":["axis","points"],"type":"object"}; propertyNames: {"type":"string"} |
dates |
array of object (fields) | Yes |
additionalProperties: false; required: ["dates","charts"]
array of object fields
Value: array of object.
maxItems: 4; minItems: 1
Array items: object.
array of string fields
Value: array of string.
maxItems: 9
Array items: string.
array of object fields
Value: array of object.
maxItems: 10
Array items: object.
array of string fields
Value: array of string.
maxItems: 10; minItems: 1
Array items: string.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
desc |
boolean | No | Default true. |
field |
string | Yes | pattern: "^[A-Za-z0-9_:]+$" |
kind |
string | Yes | enum: ["metric","dimension"] |
additionalProperties: false; required: ["field","kind"]
array of object fields
Value: array of object.
Array items: object.
array of string fields
Value: array of string.
maxItems: 4
Array items: string.
array of object fields
Value: array of object.
maxItems: 10
Array items: object.
array of object fields
Value: array of object.
Array items: object.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
article_count |
integer | Yes | Articles in the category itself, drafts included. |
child_count |
integer | Yes | Subcategories directly under it. |
collection |
string | Yes | enum: ["blog","docs"] |
description |
string or null | Yes | |
id |
string | Yes | |
name |
string | Yes | |
parent_id |
string or null | Yes | The category it sits under; null at the top level. |
slug |
string | Yes | The category page's address: /blog/category/{slug} or /docs/category/{slug}. It does not change when the category is renamed. |
sort_order |
integer | Yes | Its place among its siblings. |
additionalProperties: false; required: ["id","collection","name","slug","description","parent_id","sort_order","article_count","child_count"]
array of object fields
Value: array of object.
minItems: 1
Array items: object.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
admin_edit_url |
string or null | Yes | |
category |
object or null (fields) | Yes | additionalProperties: false; required: ["id","name","slug"] |
collection |
string | Yes | enum: ["blog","docs"] |
content_blocks |
array of object (fields) | Yes | |
cover |
object or null (fields) | Yes | additionalProperties: false; required: ["asset_id","public_url","thumbnail_url","kind","alt_text","width","height"] |
created_at |
string | Yes | |
edit_url |
string or null | Yes | |
excerpt |
string or null | Yes | |
id |
string | Yes | |
preview_url |
string or null | Yes | |
public_path |
string or null | Yes | |
public_url |
string or null | Yes | |
published |
boolean | Yes | |
published_at |
string or null | Yes | |
seo_keywords |
string or null | Yes | |
slug |
string | Yes | |
sort_order |
integer | Yes | |
status |
string | Yes | enum: ["draft","published"] |
title |
string | Yes | |
updated_at |
string | Yes | |
view_url |
string or null | Yes | |
visibility |
string | Yes | enum: ["listed","unlisted"] |
additionalProperties: false; required: ["id","title","slug","excerpt","collection","category","sort_order","seo_keywords","published","published_at","status","visibility","created_at","updated_at","cover","admin_edit_url","edit_url","public_path","public_url","preview_url","view_url","content_blocks"]
array of object fields
Value: array of object.
Array items: object.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
has_more |
boolean | Yes | |
next_cursor |
string or null | Yes |
required: ["has_more","next_cursor"]
array of object fields
Value: array of object.
Array items: object.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
collection |
string | Yes | enum: ["blog","docs"] |
id |
string | Yes | |
public_url |
string or null | Yes | |
published |
boolean | Yes | |
published_at |
string or null | Yes | |
status |
string | Yes | enum: ["draft","published"] |
title |
string | Yes | |
updated_at |
string | Yes | |
visibility |
string | Yes | enum: ["listed","unlisted"] |
additionalProperties: false; required: ["id","title","collection","visibility","status","published","published_at","updated_at","public_url"]
array of string fields
Value: array of string.
minItems: 1
Array items: string.
See schema fields
Value: See schema.
required: ["parent_id"]
See schema fields
Value: See schema.
required: ["name"]
See schema fields
Value: See schema.
required: ["description"]
array of object fields
Value: array of object.
minItems: 1
Array items: object.
See schema fields
Value: See schema.
required: ["title"]
See schema fields
Value: See schema.
required: ["excerpt"]
See schema fields
Value: See schema.
required: ["collection"]
See schema fields
Value: See schema.
required: ["category_id"]
See schema fields
Value: See schema.
required: ["content_blocks"]
See schema fields
Value: See schema.
required: ["visibility"]
See schema fields
Value: See schema.
if: {"required":["content_blocks"]}; then: {"required":["updated_at"]}
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
available_actions |
array of string (fields) | Yes | |
conversation_id |
string | Yes | minLength: 1 |
ok |
boolean | Yes | const: true |
record |
object (fields) | Yes | required: ["id","kind","status","party_size","starts_at","ends_at","timezone","assigned_member_id","location_id","product_id","product_kind","product_name"] |
status |
number | Yes | const: 200 |
thread |
object (fields) | Yes | required: ["id","kind"] |
required: ["ok","status","conversation_id","record","available_actions","thread"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
booking_id |
string | Yes | minLength: 1 |
cancellation_reason |
string or null | Yes | |
cancelled_at |
string | Yes | minLength: 1 |
channel_push |
object or null (fields) | Yes | |
status |
string | Yes | const: "cancelled" |
unit |
string | Yes | const: "nights" |
version |
integer | Yes |
additionalProperties: false; required: ["booking_id","unit","status","version","cancelled_at","cancellation_reason","channel_push"]
array of string fields
Value: array of string.
Array items: string.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
assigned_member_id |
string or null | Yes | |
ends_at |
string | Yes | minLength: 1 |
id |
string | Yes | minLength: 1 |
kind |
string | Yes | enum: ["booking"] |
location_id |
string or null | Yes | |
party_size |
integer | Yes | minimum: 1 |
product_id |
string or null | Yes | |
product_kind |
string | Yes | What was booked: an experience, legal consultation, restaurant table or place to stay. enum: ["dish","experience","service","stay","table"] |
product_name |
string or null | Yes | |
starts_at |
string | Yes | minLength: 1 |
status |
string | Yes | enum: ["pending","confirmed","cancelled"] |
timezone |
string | Yes | minLength: 1 |
required: ["id","kind","status","party_size","starts_at","ends_at","timezone","assigned_member_id","location_id","product_id","product_kind","product_name"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
id |
string | Yes | minLength: 1 |
kind |
string | Yes | enum: ["booking"] |
required: ["id","kind"]
array of object fields
Value: array of object.
maxItems: 20
Array items: object.
See schema fields
Value: See schema.
not: {"required":["check_in_date"]}; required: ["product_session_id","party_size","guest_email","source","guest_acknowledgement"]
See schema fields
Value: See schema.
not: {"required":["product_session_id"]}; required: ["check_in_date","check_out_date","adults","total_minor"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
booking_id |
string | Yes | minLength: 1 |
conversation_id |
string | Yes | minLength: 1 |
http_status |
integer | Yes | maximum: 299; minimum: 200 |
replayed |
boolean | No | |
status |
string | Yes | enum: ["pending","confirmed","cancelled"] |
success |
boolean | Yes | const: true |
required: ["success","booking_id","conversation_id","status","http_status"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
booking_id |
string | Yes | minLength: 1 |
channel_push |
object or null (fields) | Yes | What the home's connected channel took from this change: null when no channel push is needed; pushed when delivery completed; pending, with the reason, while it waits out Channex's rate limit or an unconfirmed attempt it sends again. A refused channel update returns a committed error. |
check_in_date |
string | Yes | pattern: "^\d{4}-\d{2}-\d{2}$" |
check_out_date |
string | Yes | pattern: "^\d{4}-\d{2}-\d{2}$" |
conversation_id |
string | Yes | minLength: 1 |
product_id |
string | Yes | minLength: 1 |
status |
string | Yes | enum: ["pending","confirmed","cancelled"] |
success |
boolean | Yes | const: true |
unit |
string | Yes | const: "nights" |
updated_at |
string | Yes | minLength: 1 |
version |
integer | Yes |
required: ["booking_id","unit","product_id","conversation_id","status","version","updated_at","check_in_date","check_out_date","channel_push","success"]
array of object fields
Value: array of object.
minItems: 1
Array items: object.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
answers |
array of object (fields) | Yes | Answers to the tenant's own questions, with the wording the guest answered. Later edits to the questions do not change them. |
booking_id |
string | Yes | minLength: 1 |
conversation_id |
string | Yes | minLength: 1 |
guest |
object (fields) | Yes | required: ["name","email"] |
provenance |
object or null (fields) | Yes | required: ["source","external_reference","guest_acknowledgement"] |
record |
object (fields) | Yes | required: ["id","kind","status","party_size","starts_at","ends_at","timezone","assigned_member_id","location_id","product_id","product_kind","product_name"] |
unit |
string | Yes | const: "slot" |
updated_at |
string | Yes | minLength: 1 |
version |
integer | Yes | The booking version from get_product_booking. A stale version is refused. minimum: 1 |
required: ["booking_id","unit","conversation_id","version","updated_at","guest","answers","provenance","record"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
booking_id |
string | Yes | minLength: 1 |
record |
object (fields) | Yes | |
unit |
string | Yes | const: "nights" |
additionalProperties: false; required: ["booking_id","unit","record"]
array of object fields
Value: array of object.
Array items: object.
array of object fields
Value: array of object.
Array items: object.
See schema fields
Value: See schema.
required: ["product_session_id"]
See schema fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
apply |
boolean | Yes | const: true |
required: ["product_id","apply"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
change_status |
string | Yes | enum: ["awaiting_guest_acceptance","accepted","declined","moved"] |
conversation_id |
string | Yes | minLength: 1 |
record |
object (fields) | Yes | required: ["id","kind","status","party_size","starts_at","ends_at","timezone","assigned_member_id","location_id","product_id","product_kind","product_name"] |
success |
boolean | Yes | const: true |
required: ["success","conversation_id","change_status","record"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
booking_id |
string | Yes | minLength: 1 |
channel_push |
object or null (fields) | Yes | What the home's connected channel took from this change: null when no channel push is needed; pushed when delivery completed; pending, with the reason, while it waits out Channex's rate limit or an unconfirmed attempt it sends again. A refused channel update returns a committed error. |
check_in_date |
string | Yes | pattern: "^\d{4}-\d{2}-\d{2}$" |
check_out_date |
string | Yes | pattern: "^\d{4}-\d{2}-\d{2}$" |
conversation_id |
string | Yes | minLength: 1 |
product_id |
string | Yes | minLength: 1 |
scheduled_message_id |
string | Yes | minLength: 1 |
status |
string | Yes | enum: ["pending","confirmed","cancelled"] |
unit |
string | Yes | const: "nights" |
updated_at |
string | Yes | minLength: 1 |
version |
integer | Yes |
required: ["booking_id","unit","product_id","conversation_id","status","version","updated_at","check_in_date","check_out_date","channel_push","scheduled_message_id"]
See schema fields
Value: See schema.
required: ["check_in_date"]
See schema fields
Value: See schema.
required: ["check_out_date"]
See schema fields
Value: See schema.
required: ["arrival_time"]
See schema fields
Value: See schema.
required: ["adults"]
See schema fields
Value: See schema.
required: ["children"]
See schema fields
Value: See schema.
required: ["infants"]
See schema fields
Value: See schema.
required: ["guest_name"]
See schema fields
Value: See schema.
required: ["guest_email"]
See schema fields
Value: See schema.
required: ["guest_phone"]
See schema fields
Value: See schema.
required: ["total_minor"]
See schema fields
Value: See schema.
required: ["private_notes"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
booking_id |
string | Yes | minLength: 1 |
channel_push |
object or null (fields) | Yes | What the home's connected channel took from this change: null when no channel push is needed; pushed when delivery completed; pending, with the reason, while it waits out Channex's rate limit or an unconfirmed attempt it sends again. A refused channel update returns a committed error. |
check_in_date |
string | Yes | pattern: "^\d{4}-\d{2}-\d{2}$" |
check_out_date |
string | Yes | pattern: "^\d{4}-\d{2}-\d{2}$" |
conversation_id |
string | Yes | minLength: 1 |
product_id |
string | Yes | minLength: 1 |
status |
string | Yes | enum: ["pending","confirmed","cancelled"] |
unit |
string | Yes | const: "nights" |
updated_at |
string | Yes | minLength: 1 |
version |
integer | Yes |
required: ["booking_id","unit","product_id","conversation_id","status","version","updated_at","check_in_date","check_out_date","channel_push"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
booking_id |
string | Yes | minLength: 1 |
private_notes |
string or null | Yes | |
unit |
string | Yes | const: "slot" |
version |
integer | Yes | The booking version from get_product_booking. A stale version is refused. minimum: 1 |
required: ["booking_id","unit","version","private_notes"]
See schema fields
Value: See schema.
required: ["starts_at"]
See schema fields
Value: See schema.
required: ["ends_at"]
See schema fields
Value: See schema.
required: ["capacity"]
See schema fields
Value: See schema.
required: ["status"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
capacity |
integer or null | Yes | |
claimed |
integer | Yes | |
ends_at |
string | Yes | minLength: 1 |
id |
string | Yes | minLength: 1 |
is_full |
boolean | Yes | |
location_id |
string or null | Yes | |
organization_id |
string | Yes | minLength: 1 |
product_id |
string | Yes | minLength: 1 |
remaining |
integer or null | Yes | |
starts_at |
string | Yes | minLength: 1 |
status |
string | Yes | minLength: 1 |
timezone |
string | Yes | minLength: 1 |
updated_at |
string or null | Yes |
required: ["id","organization_id","product_id","location_id","starts_at","ends_at","timezone","capacity","status","claimed","remaining","is_full","updated_at"]
#/$defs/content_heading or #/$defs/content_markdown or #/$defs/content_image or #/$defs/content_gallery or #/$defs/content_video or #/$defs/content_faq or #/$defs/content_how_to or #/$defs/content_divider or #/$defs/content_cta or #/$defs/content_contact_cta or #/$defs/content_booking_cta or #/$defs/content_callout or #/$defs/content_hero or #/$defs/content_button_group or #/$defs/content_feature_grid or #/$defs/content_comparison or #/$defs/content_stat_grid or #/$defs/content_workflow_grid or #/$defs/content_showcase or #/$defs/content_language_reach or #/$defs/content_steps or #/$defs/content_video_feature or #/$defs/content_media_text or #/$defs/content_contact_form or #/$defs/content_team_grid or #/$defs/content_testimonial_grid or #/$defs/content_donation_choices or #/$defs/content_page_grid or #/$defs/content_product_grid or #/$defs/content_location_grid or #/$defs/content_social_posts or #/$defs/content_ai_assistance fields
Value: #/$defs/content_heading or #/$defs/content_markdown or #/$defs/content_image or #/$defs/content_gallery or #/$defs/content_video or #/$defs/content_faq or #/$defs/content_how_to or #/$defs/content_divider or #/$defs/content_cta or #/$defs/content_contact_cta or #/$defs/content_booking_cta or #/$defs/content_callout or #/$defs/content_hero or #/$defs/content_button_group or #/$defs/content_feature_grid or #/$defs/content_comparison or #/$defs/content_stat_grid or #/$defs/content_workflow_grid or #/$defs/content_showcase or #/$defs/content_language_reach or #/$defs/content_steps or #/$defs/content_video_feature or #/$defs/content_media_text or #/$defs/content_contact_form or #/$defs/content_team_grid or #/$defs/content_testimonial_grid or #/$defs/content_donation_choices or #/$defs/content_page_grid or #/$defs/content_product_grid or #/$defs/content_location_grid or #/$defs/content_social_posts or #/$defs/content_ai_assistance.
anyOf: shape 1, shape 2, shape 3, shape 4, shape 5, shape 6, shape 7, shape 8, shape 9, shape 10, shape 11, shape 12, shape 13, shape 14, shape 15, shape 16, shape 17, shape 18, shape 19, shape 20, shape 21, shape 22, shape 23, shape 24, shape 25, shape 26, shape 27, shape 28, shape 29, shape 30, shape 31, shape 32.
array of #/$defs/content_block_media fields
Value: array of #/$defs/content_block_media.
Array items: #/$defs/content_block_media.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
after_block_id |
string or null | No | The block this one follows. Omit to append at the end. |
data |
object (fields) | Yes | additionalProperties: false; required: ["text"] |
document_id |
string | Yes | The blog post id or site page variant id. |
level |
integer or null | No | Heading blocks only. maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | No | Required on image blocks: one item, the picture. Send a block's media as a read returned it. |
type |
string | Yes | const: "heading" |
required: ["document_id","type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
after_block_id |
string or null | No | The block this one follows. Omit to append at the end. |
data |
object (fields) | Yes | additionalProperties: false; required: ["markdown","editor_mode"] |
document_id |
string | Yes | The blog post id or site page variant id. |
level |
integer or null | No | Heading blocks only. maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | No | Required on image blocks: one item, the picture. Send a block's media as a read returned it. |
type |
string | Yes | const: "markdown" |
required: ["document_id","type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
after_block_id |
string or null | No | The block this one follows. Omit to append at the end. |
data |
object (fields) | Yes | additionalProperties: false; required: [] |
document_id |
string | Yes | The blog post id or site page variant id. |
level |
integer or null | No | Heading blocks only. maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | Yes | Required on image blocks: one item, the picture. Send a block's media as a read returned it. maxItems: 1; minItems: 1 |
type |
string | Yes | const: "image" |
required: ["document_id","type","data","media"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
after_block_id |
string or null | No | The block this one follows. Omit to append at the end. |
data |
object (fields) | Yes | additionalProperties: false; required: [] |
document_id |
string | Yes | The blog post id or site page variant id. |
level |
integer or null | No | Heading blocks only. maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | No | Required on image blocks: one item, the picture. Send a block's media as a read returned it. |
type |
string | Yes | const: "gallery" |
required: ["document_id","type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
after_block_id |
string or null | No | The block this one follows. Omit to append at the end. |
data |
object (fields) | Yes | additionalProperties: false; required: ["url","title"] |
document_id |
string | Yes | The blog post id or site page variant id. |
level |
integer or null | No | Heading blocks only. maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | No | Required on image blocks: one item, the picture. Send a block's media as a read returned it. |
type |
string | Yes | const: "video" |
required: ["document_id","type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
after_block_id |
string or null | No | The block this one follows. Omit to append at the end. |
data |
object (fields) | Yes | additionalProperties: false; required: ["source"] |
document_id |
string | Yes | The blog post id or site page variant id. |
level |
integer or null | No | Heading blocks only. maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | No | Required on image blocks: one item, the picture. Send a block's media as a read returned it. |
type |
string | Yes | const: "faq" |
required: ["document_id","type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
after_block_id |
string or null | No | The block this one follows. Omit to append at the end. |
data |
object (fields) | Yes | additionalProperties: false; required: ["steps"] |
document_id |
string | Yes | The blog post id or site page variant id. |
level |
integer or null | No | Heading blocks only. maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | No | Required on image blocks: one item, the picture. Send a block's media as a read returned it. |
type |
string | Yes | const: "how_to" |
required: ["document_id","type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
after_block_id |
string or null | No | The block this one follows. Omit to append at the end. |
data |
object (fields) | Yes | additionalProperties: false; required: [] |
document_id |
string | Yes | The blog post id or site page variant id. |
level |
integer or null | No | Heading blocks only. maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | No | Required on image blocks: one item, the picture. Send a block's media as a read returned it. |
type |
string | Yes | const: "divider" |
required: ["document_id","type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
after_block_id |
string or null | No | The block this one follows. Omit to append at the end. |
data |
object (fields) | Yes | additionalProperties: false; required: [] |
document_id |
string | Yes | The blog post id or site page variant id. |
level |
integer or null | No | Heading blocks only. maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | No | Required on image blocks: one item, the picture. Send a block's media as a read returned it. |
type |
string | Yes | const: "cta" |
required: ["document_id","type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
after_block_id |
string or null | No | The block this one follows. Omit to append at the end. |
data |
object (fields) | Yes | additionalProperties: false; required: [] |
document_id |
string | Yes | The blog post id or site page variant id. |
level |
integer or null | No | Heading blocks only. maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | No | Required on image blocks: one item, the picture. Send a block's media as a read returned it. |
type |
string | Yes | const: "contact_cta" |
required: ["document_id","type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
after_block_id |
string or null | No | The block this one follows. Omit to append at the end. |
data |
object (fields) | Yes | additionalProperties: false; required: [] |
document_id |
string | Yes | The blog post id or site page variant id. |
level |
integer or null | No | Heading blocks only. maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | No | Required on image blocks: one item, the picture. Send a block's media as a read returned it. |
type |
string | Yes | const: "booking_cta" |
required: ["document_id","type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
after_block_id |
string or null | No | The block this one follows. Omit to append at the end. |
data |
object (fields) | Yes | additionalProperties: false; required: [] |
document_id |
string | Yes | The blog post id or site page variant id. |
level |
integer or null | No | Heading blocks only. maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | No | Required on image blocks: one item, the picture. Send a block's media as a read returned it. |
type |
string | Yes | const: "callout" |
required: ["document_id","type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
after_block_id |
string or null | No | The block this one follows. Omit to append at the end. |
data |
object (fields) | Yes | additionalProperties: false; required: ["title"] |
document_id |
string | Yes | The blog post id or site page variant id. |
level |
integer or null | No | Heading blocks only. maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | No | Required on image blocks: one item, the picture. Send a block's media as a read returned it. |
type |
string | Yes | const: "hero" |
required: ["document_id","type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
after_block_id |
string or null | No | The block this one follows. Omit to append at the end. |
data |
object (fields) | Yes | additionalProperties: false; required: [] |
document_id |
string | Yes | The blog post id or site page variant id. |
level |
integer or null | No | Heading blocks only. maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | No | Required on image blocks: one item, the picture. Send a block's media as a read returned it. |
type |
string | Yes | const: "button_group" |
required: ["document_id","type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
after_block_id |
string or null | No | The block this one follows. Omit to append at the end. |
data |
object (fields) | Yes | additionalProperties: false; required: [] |
document_id |
string | Yes | The blog post id or site page variant id. |
level |
integer or null | No | Heading blocks only. maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | No | Required on image blocks: one item, the picture. Send a block's media as a read returned it. |
type |
string | Yes | const: "feature_grid" |
required: ["document_id","type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
after_block_id |
string or null | No | The block this one follows. Omit to append at the end. |
data |
object (fields) | Yes | additionalProperties: false; required: [] |
document_id |
string | Yes | The blog post id or site page variant id. |
level |
integer or null | No | Heading blocks only. maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | No | Required on image blocks: one item, the picture. Send a block's media as a read returned it. |
type |
string | Yes | const: "comparison" |
required: ["document_id","type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
after_block_id |
string or null | No | The block this one follows. Omit to append at the end. |
data |
object (fields) | Yes | additionalProperties: false; required: [] |
document_id |
string | Yes | The blog post id or site page variant id. |
level |
integer or null | No | Heading blocks only. maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | No | Required on image blocks: one item, the picture. Send a block's media as a read returned it. |
type |
string | Yes | const: "stat_grid" |
required: ["document_id","type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
after_block_id |
string or null | No | The block this one follows. Omit to append at the end. |
data |
object (fields) | Yes | additionalProperties: false; required: [] |
document_id |
string | Yes | The blog post id or site page variant id. |
level |
integer or null | No | Heading blocks only. maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | No | Required on image blocks: one item, the picture. Send a block's media as a read returned it. |
type |
string | Yes | const: "workflow_grid" |
required: ["document_id","type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
after_block_id |
string or null | No | The block this one follows. Omit to append at the end. |
data |
object (fields) | Yes | additionalProperties: false; required: [] |
document_id |
string | Yes | The blog post id or site page variant id. |
level |
integer or null | No | Heading blocks only. maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | No | Required on image blocks: one item, the picture. Send a block's media as a read returned it. |
type |
string | Yes | const: "showcase" |
required: ["document_id","type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
after_block_id |
string or null | No | The block this one follows. Omit to append at the end. |
data |
object (fields) | Yes | additionalProperties: false; required: [] |
document_id |
string | Yes | The blog post id or site page variant id. |
level |
integer or null | No | Heading blocks only. maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | No | Required on image blocks: one item, the picture. Send a block's media as a read returned it. |
type |
string | Yes | const: "language_reach" |
required: ["document_id","type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
after_block_id |
string or null | No | The block this one follows. Omit to append at the end. |
data |
object (fields) | Yes | additionalProperties: false; required: [] |
document_id |
string | Yes | The blog post id or site page variant id. |
level |
integer or null | No | Heading blocks only. maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | No | Required on image blocks: one item, the picture. Send a block's media as a read returned it. |
type |
string | Yes | const: "steps" |
required: ["document_id","type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
after_block_id |
string or null | No | The block this one follows. Omit to append at the end. |
data |
object (fields) | Yes | additionalProperties: false; required: [] |
document_id |
string | Yes | The blog post id or site page variant id. |
level |
integer or null | No | Heading blocks only. maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | No | Required on image blocks: one item, the picture. Send a block's media as a read returned it. |
type |
string | Yes | const: "video_feature" |
required: ["document_id","type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
after_block_id |
string or null | No | The block this one follows. Omit to append at the end. |
data |
object (fields) | Yes | additionalProperties: false; required: [] |
document_id |
string | Yes | The blog post id or site page variant id. |
level |
integer or null | No | Heading blocks only. maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | No | Required on image blocks: one item, the picture. Send a block's media as a read returned it. |
type |
string | Yes | const: "media_text" |
required: ["document_id","type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
after_block_id |
string or null | No | The block this one follows. Omit to append at the end. |
data |
object (fields) | Yes | additionalProperties: false; required: [] |
document_id |
string | Yes | The blog post id or site page variant id. |
level |
integer or null | No | Heading blocks only. maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | No | Required on image blocks: one item, the picture. Send a block's media as a read returned it. |
type |
string | Yes | const: "contact_form" |
required: ["document_id","type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
after_block_id |
string or null | No | The block this one follows. Omit to append at the end. |
data |
object (fields) | Yes | additionalProperties: false; required: [] |
document_id |
string | Yes | The blog post id or site page variant id. |
level |
integer or null | No | Heading blocks only. maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | No | Required on image blocks: one item, the picture. Send a block's media as a read returned it. |
type |
string | Yes | const: "team_grid" |
required: ["document_id","type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
after_block_id |
string or null | No | The block this one follows. Omit to append at the end. |
data |
object (fields) | Yes | additionalProperties: false; required: [] |
document_id |
string | Yes | The blog post id or site page variant id. |
level |
integer or null | No | Heading blocks only. maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | No | Required on image blocks: one item, the picture. Send a block's media as a read returned it. |
type |
string | Yes | const: "testimonial_grid" |
required: ["document_id","type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
after_block_id |
string or null | No | The block this one follows. Omit to append at the end. |
data |
object (fields) | Yes | additionalProperties: false; required: [] |
document_id |
string | Yes | The blog post id or site page variant id. |
level |
integer or null | No | Heading blocks only. maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | No | Required on image blocks: one item, the picture. Send a block's media as a read returned it. |
type |
string | Yes | const: "donation_choices" |
required: ["document_id","type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
after_block_id |
string or null | No | The block this one follows. Omit to append at the end. |
data |
object (fields) | Yes | additionalProperties: false; required: ["page_ids"] |
document_id |
string | Yes | The blog post id or site page variant id. |
level |
integer or null | No | Heading blocks only. maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | No | Required on image blocks: one item, the picture. Send a block's media as a read returned it. |
type |
string | Yes | const: "page_grid" |
required: ["document_id","type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
after_block_id |
string or null | No | The block this one follows. Omit to append at the end. |
data |
object (fields) | Yes | additionalProperties: false; required: [] |
document_id |
string | Yes | The blog post id or site page variant id. |
level |
integer or null | No | Heading blocks only. maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | No | Required on image blocks: one item, the picture. Send a block's media as a read returned it. |
type |
string | Yes | const: "product_grid" |
required: ["document_id","type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
after_block_id |
string or null | No | The block this one follows. Omit to append at the end. |
data |
object (fields) | Yes | additionalProperties: false; required: [] |
document_id |
string | Yes | The blog post id or site page variant id. |
level |
integer or null | No | Heading blocks only. maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | No | Required on image blocks: one item, the picture. Send a block's media as a read returned it. |
type |
string | Yes | const: "location_grid" |
required: ["document_id","type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
after_block_id |
string or null | No | The block this one follows. Omit to append at the end. |
data |
object (fields) | Yes | additionalProperties: false; required: [] |
document_id |
string | Yes | The blog post id or site page variant id. |
level |
integer or null | No | Heading blocks only. maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | No | Required on image blocks: one item, the picture. Send a block's media as a read returned it. |
type |
string | Yes | const: "social_posts" |
required: ["document_id","type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
after_block_id |
string or null | No | The block this one follows. Omit to append at the end. |
data |
object (fields) | Yes | additionalProperties: false; required: [] |
document_id |
string | Yes | The blog post id or site page variant id. |
level |
integer or null | No | Heading blocks only. maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | No | Required on image blocks: one item, the picture. Send a block's media as a read returned it. |
type |
string | Yes | const: "ai_assistance" |
required: ["document_id","type","data"]
array of object fields
Value: array of object.
Array items: object.
array of object fields
Value: array of object.
Array items: object.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
admin_edit_url |
string or null | Yes | |
blocks |
array of object (fields) | Yes | |
document |
object (fields) | Yes | required: ["id","updated_at"] |
id |
string | Yes | minLength: 1 |
locale |
string | Yes | minLength: 1 |
organization_id |
string | Yes | minLength: 1 |
page_id |
string | Yes | minLength: 1 |
page_type |
string | Yes | enum: ["custom","recipe","legal","system"] |
path |
string | Yes | |
product_id |
string or null | Yes | |
recipe |
string or null | Yes | |
sort_order |
number | Yes | |
summary |
string or null | Yes | |
title |
string | Yes | |
updated_at |
string | Yes | minLength: 1 |
required: ["id","page_id","organization_id","product_id","locale","path","title","summary","page_type","recipe","sort_order","updated_at","blocks","document","admin_edit_url"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
id |
string | Yes | |
locale |
string | Yes | |
path |
string | Yes | |
removed_locales |
array of string (fields) | Yes |
required: ["id","path","locale","removed_locales"]
array of object fields
Value: array of object.
Array items: object.
array of object fields
Value: array of object.
Array items: object.
#/$defs/content_heading or #/$defs/content_markdown or #/$defs/content_image or #/$defs/content_gallery or #/$defs/content_video or #/$defs/content_faq or #/$defs/content_how_to or #/$defs/content_divider or #/$defs/content_cta or #/$defs/content_contact_cta or #/$defs/content_booking_cta or #/$defs/content_callout or #/$defs/content_hero or #/$defs/content_button_group or #/$defs/content_feature_grid or #/$defs/content_comparison or #/$defs/content_stat_grid or #/$defs/content_workflow_grid or #/$defs/content_showcase or #/$defs/content_language_reach or #/$defs/content_steps or #/$defs/content_video_feature or #/$defs/content_media_text or #/$defs/content_contact_form or #/$defs/content_team_grid or #/$defs/content_testimonial_grid or #/$defs/content_donation_choices or #/$defs/content_page_grid or #/$defs/content_product_grid or #/$defs/content_location_grid or #/$defs/content_social_posts or #/$defs/content_ai_assistance fields
Value: #/$defs/content_heading or #/$defs/content_markdown or #/$defs/content_image or #/$defs/content_gallery or #/$defs/content_video or #/$defs/content_faq or #/$defs/content_how_to or #/$defs/content_divider or #/$defs/content_cta or #/$defs/content_contact_cta or #/$defs/content_booking_cta or #/$defs/content_callout or #/$defs/content_hero or #/$defs/content_button_group or #/$defs/content_feature_grid or #/$defs/content_comparison or #/$defs/content_stat_grid or #/$defs/content_workflow_grid or #/$defs/content_showcase or #/$defs/content_language_reach or #/$defs/content_steps or #/$defs/content_video_feature or #/$defs/content_media_text or #/$defs/content_contact_form or #/$defs/content_team_grid or #/$defs/content_testimonial_grid or #/$defs/content_donation_choices or #/$defs/content_page_grid or #/$defs/content_product_grid or #/$defs/content_location_grid or #/$defs/content_social_posts or #/$defs/content_ai_assistance.
anyOf: shape 1, shape 2, shape 3, shape 4, shape 5, shape 6, shape 7, shape 8, shape 9, shape 10, shape 11, shape 12, shape 13, shape 14, shape 15, shape 16, shape 17, shape 18, shape 19, shape 20, shape 21, shape 22, shape 23, shape 24, shape 25, shape 26, shape 27, shape 28, shape 29, shape 30, shape 31, shape 32.
array of #/$defs/content_block_media fields
Value: array of #/$defs/content_block_media.
Array items: #/$defs/content_block_media.
array of object fields
Value: array of object.
Array items: object.
array of string fields
Value: array of string.
Array items: string.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
location_id |
string or null | Yes | |
location_slug |
string or null | Yes | |
location_title |
string or null | Yes | |
organization_id |
string or null | Yes | |
organization_name |
string or null | Yes | |
organization_public_url |
string or null | Yes | |
organization_slug |
string or null | Yes | |
organization_subdomain |
string or null | Yes |
additionalProperties: false; required: ["organization_id","organization_name","organization_slug","organization_subdomain","organization_public_url","location_id","location_slug","location_title"]
array of object fields
Value: array of object.
Array items: object.
array of object fields
Value: array of object.
Array items: object.
See schema fields
Value: See schema.
required: ["organization_id"]
See schema fields
Value: See schema.
required: ["location_id"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
capabilities |
object (fields) | Yes | required: ["can_manage_participants","can_invite_guest","can_leave"] |
conversation |
object (fields) | Yes | required: ["id","organization_id","title","kind","participants","composer","booking_id"] |
entries |
array of object (fields) | Yes | |
page |
object (fields) | Yes | required: ["before","oldest","newest","read_through"] |
viewer_role |
string | Yes | const: "member" |
required: ["conversation","entries","page","viewer_role","capabilities"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
conversation_id |
string | Yes | |
entries |
array of object (fields) | Yes | |
page |
object (fields) | Yes | required: ["before","oldest","newest","read_through"] |
required: ["conversation_id","entries","page"]
array of object fields
Value: array of object.
Array items: object.
array of object fields
Value: array of object.
Array items: object.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
download_url |
string | Yes | |
file_id |
string | Yes | |
file_name |
string | No | |
mime_type |
string | No |
required: ["download_url","file_id"]
See schema fields
Value: See schema.
required: ["message"]
See schema fields
Value: See schema.
required: ["file"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
id |
string | Yes | |
sequence |
integer | Yes | minimum: 1 |
required: ["id","sequence"]
array of string fields
Value: array of string.
maxItems: 49; minItems: 1; uniqueItems: true
Array items: string.
array of string fields
Value: array of string.
maxItems: 49; minItems: 1; uniqueItems: true
Array items: string.
See schema fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
action |
string | No | const: "rename" |
required: ["name"]
See schema fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
action |
string | No | const: "add" |
required: ["member_user_ids"]
See schema fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
action |
string | No | const: "remove" |
required: ["user_id"]
See schema fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
action |
string | No | const: "leave" |
array of string fields
Value: array of string.
maxItems: 4; minItems: 2; uniqueItems: true
Array items: string.
array of string fields
Value: array of string.
maxItems: 15; minItems: 3; uniqueItems: true
Array items: string.
array of object fields
Value: array of object.
Array items: object.
array of object fields
Value: array of object.
Array items: object.
array of string fields
Value: array of string.
Array items: string.
array of object fields
Value: array of object.
Array items: object.
array of object fields
Value: array of object.
Array items: object.
array of object fields
Value: array of object.
Array items: object.
See schema fields
Value: See schema.
not: {"anyOf":[{"required":["budget_id"]},{"required":["daily_budget_micros"]}]}; required: ["status"]
See schema fields
Value: See schema.
required: ["budget_id","daily_budget_micros"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
id |
string | Yes | minLength: 1 |
status |
string | Yes | const: "cancelled" |
additionalProperties: false; required: ["id","status"]
object fields
Value: object.
oneOf: shape 1, shape 2, shape 3.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
body |
string | Yes | minLength: 1 |
created_at |
string | Yes | minLength: 1 |
id |
string | Yes | minLength: 1 |
organization_id |
string | Yes | minLength: 1 |
schedule |
object (fields) | Yes | |
title |
string | Yes | minLength: 1 |
updated_at |
string | Yes | minLength: 1 |
version |
integer | Yes | minimum: 1 |
required: ["id","organization_id","title","body","schedule","version","created_at","updated_at"]
object or null fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
check_in_instructions |
string or null | Yes | |
check_in_method |
string or null | Yes | |
checkout_instructions |
array or null (fields) | Yes | |
directions |
string or null | Yes | |
house_manual |
string or null | Yes | |
name |
string | Yes | minLength: 1 |
product_id |
string | Yes | minLength: 1 |
timezone |
string | Yes | minLength: 1 |
wifi_network |
string or null | Yes | |
wifi_password |
string or null | Yes |
additionalProperties: false; required: ["product_id","name","timezone","check_in_method","check_in_instructions","wifi_network","wifi_password","directions","house_manual","checkout_instructions"]
object or null fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
address |
string or null | Yes | |
ends |
string | Yes | minLength: 1 |
location |
string or null | Yes | |
name |
string or null | Yes | |
no_show_at |
string or null | Yes | |
party_size |
integer | Yes | |
phone |
string or null | Yes | |
starts |
string | Yes | minLength: 1 |
status |
string | Yes | minLength: 1 |
timezone |
string | Yes | minLength: 1 |
unit |
string | Yes | nights is a stay at a home; slot is a class, consultation or table. enum: ["slot","nights"] |
required: ["unit","status","name","location","address","phone","party_size","timezone","starts","ends","no_show_at"]
object or null fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
adults |
integer | Yes | |
check_in_date |
string | Yes | minLength: 1 |
check_out_date |
string | Yes | minLength: 1 |
children |
integer | Yes | |
guest_name |
string or null | Yes | |
id |
string | Yes | minLength: 1 |
infants |
integer | Yes | |
product_id |
string | Yes | minLength: 1 |
status |
string | Yes | minLength: 1 |
additionalProperties: false; required: ["id","product_id","status","check_in_date","check_out_date","guest_name","adults","children","infants"]
array of object fields
Value: array of object.
Array items: object.
array of object fields
Value: array of object.
Array items: object.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
author_user_id |
string or null | Yes | The member whose own send-later reply this is; null for an automatic message the business sends. |
body |
string | Yes | minLength: 1 |
booking_id |
string or null | Yes | The booking an automatic message is about, a stay’s included; null for a send-later reply. |
conversation_id |
string or null | Yes | |
created_at |
string | Yes | minLength: 1 |
due_at |
string or null | Yes | |
error_code |
string or null | Yes | |
error_field |
string or null | Yes | |
id |
string | Yes | minLength: 1 |
message_id |
string or null | Yes | |
organization_id |
string | Yes | minLength: 1 |
product_id |
string or null | Yes | |
reason |
string or null | Yes | |
sent_at |
string or null | Yes | |
started_at |
string or null | Yes | |
status |
string | Yes | enum: ["pending","sending","sent","failed","needs_review","cancelled","skipped"] |
template_id |
string or null | Yes | |
template_title |
string or null | Yes | The automatic message’s title; null for a send-later reply. |
template_version |
integer or null | Yes | minimum: 1 |
timezone |
string or null | Yes | The booking’s timezone for an automatic message; null for a send-later reply. |
updated_at |
string | Yes | minLength: 1 |
required: ["id","organization_id","product_id","booking_id","conversation_id","author_user_id","template_id","template_title","template_version","body","due_at","timezone","status","reason","error_code","error_field","message_id","started_at","sent_at","created_at","updated_at"]
array of object fields
Value: array of object.
Array items: object.
See schema fields
Value: See schema.
required: ["check_in_method"]
See schema fields
Value: See schema.
required: ["check_in_instructions"]
See schema fields
Value: See schema.
required: ["wifi_network"]
See schema fields
Value: See schema.
required: ["wifi_password"]
See schema fields
Value: See schema.
required: ["directions"]
See schema fields
Value: See schema.
required: ["house_manual"]
See schema fields
Value: See schema.
required: ["checkout_instructions"]
array of object fields
Value: array of object.
Array items: object.
object or null fields
Value: object or null.
anyOf: shape 1, shape 2, shape 3.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
check_in_instructions |
string or null | No | |
check_in_method |
string or null | No | |
checkout_instructions |
array or null (fields) | No | |
directions |
string or null | No | |
house_manual |
string or null | No | |
wifi_network |
string or null | No | |
wifi_password |
string or null | No |
additionalProperties: false
array of object fields
Value: array of object.
Array items: object.
array of object fields
Value: array of object.
Array items: object.
array of object fields
Value: array of object.
Array items: object.
object fields
Value: object.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
address |
object (fields) | No | additionalProperties: false |
alt_text |
string | No | |
brand_description |
string | No | |
compliance |
object (fields) | No | additionalProperties: false |
consultation |
object (fields) | No | additionalProperties: false |
description |
string | No | |
details |
object (fields) | No | additionalProperties: false |
inquiry_questions |
object | No | Translated question wording keyed by question ID: { label?, help_text?, choices?: { |
marketing_features |
array of string (fields) | No | |
metadata |
object (fields) | No | additionalProperties: false |
name |
string | No | |
questions |
object | No | Translated question wording keyed by question ID: { label?, help_text?, choices?: { |
seo_description |
string | No | |
seo_keywords |
string or null | No | |
seo_title |
string | No | |
short_description |
string | No | |
summary |
string or null | No | |
title |
string or null | No | |
unit_label |
string | No |
additionalProperties: false
See schema fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
resource_type |
string | No | const: "organization" |
values |
object (fields) | No | additionalProperties: false |
not: {"anyOf":[{"required":["content_blocks"]},{"required":["updated_at"]}]}
See schema fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
resource_type |
string | No | const: "business_location" |
values |
object (fields) | No | additionalProperties: false |
not: {"anyOf":[{"required":["content_blocks"]},{"required":["updated_at"]}]}
See schema fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
resource_type |
string | No | const: "product" |
values |
object (fields) | No | additionalProperties: false |
not: {"anyOf":[{"required":["content_blocks"]},{"required":["updated_at"]}]}
See schema fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
resource_type |
string | No | const: "collection" |
values |
object (fields) | No | additionalProperties: false |
not: {"anyOf":[{"required":["content_blocks"]},{"required":["updated_at"]}]}
See schema fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
resource_type |
string | No | const: "article_category" |
values |
object (fields) | No | additionalProperties: false |
not: {"anyOf":[{"required":["content_blocks"]},{"required":["updated_at"]}]}
See schema fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
resource_type |
string | No | const: "media_asset" |
values |
object (fields) | No | additionalProperties: false |
not: {"anyOf":[{"required":["content_blocks"]},{"required":["updated_at"]}]}
See schema fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
resource_type |
string | No | const: "content_document" |
values |
object (fields) | No | additionalProperties: false |
array of object fields
Value: array of object.
maxItems: 250; minItems: 1
Array items: object.
See schema fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
items |
array of See schema (fields) | No | |
resource_type |
string | No | const: "organization" |
See schema fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
items |
array of See schema (fields) | No | |
resource_type |
string | No | const: "business_location" |
See schema fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
items |
array of See schema (fields) | No | |
resource_type |
string | No | const: "product" |
See schema fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
items |
array of See schema (fields) | No | |
resource_type |
string | No | const: "collection" |
See schema fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
items |
array of See schema (fields) | No | |
resource_type |
string | No | const: "article_category" |
See schema fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
items |
array of See schema (fields) | No | |
resource_type |
string | No | const: "media_asset" |
array of object fields
Value: array of object.
Array items: object.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
address |
object or null (fields) | No | additionalProperties: false; required: ["regionCode","addressLines"] |
canonical_url |
string or null | No | |
created_at |
string | No | |
description |
string or null | No | |
email |
string or null | No | |
id |
string | No | minLength: 1 |
latitude |
number or null | No | maximum: 90; minimum: -90 |
longitude |
number or null | No | maximum: 180; minimum: -180 |
maps_url |
string or null | No | |
media |
array of object (fields) | No | |
opening_hours |
null or object (fields) | No | |
phone |
string or null | No | |
rating |
number or null | No | |
review_count |
number or null | No | |
seo_description |
string or null | No | |
seo_title |
string or null | No | |
short_description |
string or null | No | |
slug |
string | No | minLength: 1 |
special_hours |
null or array of object (fields) | No | |
status |
string | No | Operational state. Inactive locations are hidden. Active locations follow the website’s publication rules; business locations and live homes are counted separately for billing. enum: ["active","inactive"] |
stay_map_sharing |
string | No | Public map precision for places to stay at this location; both choices keep their street address private. enum: ["general","specific"] |
timezone |
string | No | Explicit IANA timezone identifier, such as Asia/Bangkok. Missing timezone is an error, never the browser timezone. minLength: 1 |
title |
string | No | |
updated_at |
string | No | |
website_url |
string or null | No |
required: []
object or null fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
addressLines |
array of string (fields) | Yes | Address lines in order, unbounded. minItems: 1 |
administrativeArea |
string | No | State, province or region. |
languageCode |
string | No | BCP-47 tag when the address is written in a specific language. |
locality |
string | No | Town or city. |
postalCode |
string | No | |
regionCode |
string | Yes | Two-letter uppercase country code, e.g. TH. pattern: "^[A-Z]{2}$" |
sublocality |
string | No | Neighbourhood or sub-district. |
additionalProperties: false; required: ["regionCode","addressLines"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
id |
string | Yes | minLength: 1 |
status |
string | Yes | Current operational status. New locations are active; a retry returns the saved location’s current status. enum: ["active","inactive"] |
title |
string | Yes |
additionalProperties: false; required: ["id","title","status"]
array of string fields
Value: array of string.
Array items: string.
array of object fields
Value: array of object.
Array items: object.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
address |
object or null (fields) | No | additionalProperties: false; required: ["regionCode","addressLines"] |
canonical_url |
string or null | No | |
created_at |
string | Yes | |
description |
string or null | No | |
email |
string or null | No | |
id |
string | Yes | minLength: 1 |
latitude |
number or null | Yes | maximum: 90; minimum: -90 |
longitude |
number or null | Yes | maximum: 180; minimum: -180 |
maps_url |
string or null | No | |
media |
array of object (fields) | Yes | |
opening_hours |
null or object (fields) | No | |
phone |
string or null | No | |
rating |
number or null | No | |
review_count |
number or null | No | |
seo_description |
string or null | No | |
seo_title |
string or null | No | |
short_description |
string or null | No | |
slug |
string | Yes | minLength: 1 |
special_hours |
null or array of object (fields) | No | |
status |
string | Yes | Operational state. Inactive locations are hidden. Active locations follow the website’s publication rules; business locations and live homes are counted separately for billing. enum: ["active","inactive"] |
stay_map_sharing |
string | Yes | Public map precision for places to stay at this location; both choices keep their street address private. enum: ["general","specific"] |
timezone |
string | Yes | Explicit IANA timezone identifier, such as Asia/Bangkok. Missing timezone is an error, never the browser timezone. minLength: 1 |
title |
string | Yes | |
updated_at |
string | Yes | |
website_url |
string or null | No |
required: ["id","slug","title","stay_map_sharing","latitude","longitude","status","timezone","created_at","updated_at","media"]
null or object fields
Value: null or object.
null or array of object fields
Value: null or array of object.
object fields
Value: object.
oneOf: shape 1, shape 2, shape 3, shape 4, shape 5, shape 6.
array of object fields
Value: array of object.
Array items: object.
object fields
Value: object.
oneOf: shape 1, shape 2, shape 3, shape 4, shape 5, shape 6, shape 7.
array of object fields
Value: array of object.
Array items: object.
array of object fields
Value: array of object.
Array items: object.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
download_url |
string | Yes | |
file_id |
string | Yes | |
file_name |
string | No | |
mime_type |
string | No |
required: ["download_url","file_id"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
download_url |
string | Yes | |
file_id |
string | Yes | |
file_name |
string | No | |
mime_type |
string | No |
required: ["download_url","file_id"]
object or null fields
Value: object or null.
object fields
Value: object.
oneOf: shape 1, shape 2, shape 3, shape 4, shape 5, shape 6.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
focus |
object (fields) | Yes | additionalProperties: false; required: ["x","y"] |
shape |
string | Yes | enum: ["original","square","circle"] |
additionalProperties: false; required: ["shape","focus"]
See schema fields
Value: See schema.
required: ["alt_text"]
See schema fields
Value: See schema.
required: ["category"]
array of object fields
Value: array of object.
Array items: object.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
delivery |
object or null (fields) | Yes | required: ["status","error"] |
email |
string | Yes | |
expiresAt |
string | Yes | format: "date-time" |
id |
string | Yes | |
role |
string | Yes | |
status |
string | Yes |
additionalProperties: false; required: ["id","email","role","status","expiresAt","delivery"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
brand_description |
string or null | No | |
created_at |
string | No | |
id |
string | Yes | |
media |
array of object (fields) | No | |
name |
string or null | No | |
organization_id |
string | No | |
public_url |
string or null | No | |
status |
string | Yes | |
subdomain |
string | Yes | |
theme |
string | No | |
updated_at |
string | No |
required: ["id","subdomain","status"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
address_visibility |
string | No | enum: ["visible","hidden"] |
announcement |
object or null (fields) | No | |
brand_description |
string or null | No | |
button_casing |
string | No | Button text casing: uppercase or none (natural case). Absent when the site uses the Default. enum: ["uppercase","none"] |
button_color |
string | No | Button fill: action (the palette's action color) or accent (the palette's accent color). Absent when the site uses the Default. enum: ["action","accent"] |
button_shape |
string | No | Button corner styling: pill (fully rounded), rounded (subtle radius), or sharp (square corners). Absent when the site uses the Default. enum: ["pill","rounded","sharp"] |
canonical_url |
string or null | No | |
careers_email |
string or null | No | |
catering_email |
string or null | No | |
contact_email |
string or null | No | |
created_at |
string | No | |
custom_domain_status |
string or null | No | |
default_currency |
string | Yes | |
font_preset |
string | No | enum: ["default","mali","sarabun","prompt","kanit","ibm-plex-sans-thai","noto-serif-thai","inter","dm-sans","montserrat","lora","playfair-display","cormorant-garamond","marcellus"] |
google_analytics_measurement_id |
string or null | No | |
heading_casing |
string | No | Display heading casing: uppercase or none (natural case). Absent when the site uses the Default. enum: ["uppercase","none"] |
id |
string | Yes | |
inquiry_questions |
array of object (fields) | No | The inquiry form's own questions, asked beside name, email, phone and message on every contact form the site places. maxItems: 20 |
inquiry_questions_revision |
string | No | Send as expected_inquiry_questions_revision when replacing inquiry_questions, and as questions_revision with an inquiry. |
integrations |
object (fields) | No | Saved connections and the provider account, property or site each acts on. A saved connection does not prove a report will pass; query_google_analytics, query_search_console and query_google_ads_report report their own failures. |
media |
array of object (fields) | No | |
name |
string or null | No | |
organization_id |
string | No | |
palette |
object or null (fields) | No | The colors the site renders, light and dark: its own, or the default. Null on Blawby's own site. |
palette_source |
string or null | No | enum: ["custom","default",null] |
partnerships_email |
string or null | No | |
press_email |
string or null | No | |
public_url |
string or null | No | |
seo_description |
string or null | No | |
seo_title |
string or null | No | |
social_card_refresh |
object or null (fields) | No | The latest brand-name change’s social-card refresh. Read with get_organization_settings until complete. Failed refreshes can be retried under Website → Brand → Name. additionalProperties: false; required: ["id","status","cursor","error"] |
status |
string | No | |
subdomain |
string | Yes | |
theme |
string | No | |
timezone |
string | Yes | |
updated_at |
string | No |
required: ["id","subdomain","default_currency","timezone"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
address_line_2 |
string | No | |
city |
string | No | |
country |
string | No | pattern: "^[A-Z]{2}$" |
phone |
string | No | International number with its country calling code, e.g. +66812345678. |
postal_code |
string | No | |
region |
string | No | |
street_address |
string | No | |
website_url |
string | No | format: "uri" |
additionalProperties: false
array of string fields
Value: array of string.
Array items: string.
array of object fields
Value: array of object.
Array items: object.
array of object fields
Value: array of object.
Array items: object.
array of object fields
Value: array of object.
Array items: object.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
id |
string | Yes | |
is_platform_admin |
boolean | Yes |
required: ["id","is_platform_admin"]
array of object fields
Value: array of object.
Array items: object.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
createdAt |
string | Yes | format: "date-time" |
id |
string | Yes | |
organizationId |
string | Yes | |
role |
string | Yes | |
userId |
string | Yes |
required: ["id","organizationId","userId","role","createdAt"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
external_url |
string or null | Yes | |
mode |
string | Yes | enum: ["native","external_url","native_disabled"] |
required: ["mode","external_url"]
object or null fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
cta_label |
string or null | No | Button label. Requires cta_url and vice versa. |
cta_url |
string or null | No | Button destination, http or https. Requires cta_label and vice versa. |
description |
string or null | No | maxLength: 500 |
dismissible |
boolean | No | Whether a visitor who closes it will not be shown it again on that device. |
enabled |
boolean | No | Whether the announcement is currently shown. false keeps the saved content without showing it. |
format |
string | No | Display style: modal popup dialog or top banner bar (default modal). enum: ["modal","banner"] |
headline |
string | Yes | Required in every write, even an empty string when disabling without discarding it. maxLength: 120 |
required: ["headline"]
array of object fields
Value: array of object.
maxItems: 20
Array items: object.
object or null fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
dark |
object (fields) | No | additionalProperties: false |
light |
object (fields) | No | additionalProperties: false |
starter |
string | No | enum: ["coastal","forest","terracotta","ink","blossom","saffron","slate","midnight"] |
additionalProperties: false
array of object fields
Value: array of object.
Array items: object.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
address_visibility |
string | No | enum: ["visible","hidden"] |
announcement |
object or null (fields) | No | |
brand_description |
string or null | No | |
button_casing |
string | No | Button text casing: uppercase or none (natural case). Absent when the site uses the Default. enum: ["uppercase","none"] |
button_color |
string | No | Button fill: action (the palette's action color) or accent (the palette's accent color). Absent when the site uses the Default. enum: ["action","accent"] |
button_shape |
string | No | Button corner styling: pill (fully rounded), rounded (subtle radius), or sharp (square corners). Absent when the site uses the Default. enum: ["pill","rounded","sharp"] |
canonical_url |
string or null | No | |
careers_email |
string or null | No | |
catering_email |
string or null | No | |
contact_email |
string or null | No | |
created_at |
string | No | |
custom_domain_status |
string or null | No | |
default_currency |
string | No | |
font_preset |
string | No | enum: ["default","mali","sarabun","prompt","kanit","ibm-plex-sans-thai","noto-serif-thai","inter","dm-sans","montserrat","lora","playfair-display","cormorant-garamond","marcellus"] |
google_analytics_measurement_id |
string or null | No | |
heading_casing |
string | No | Display heading casing: uppercase or none (natural case). Absent when the site uses the Default. enum: ["uppercase","none"] |
id |
string | No | |
inquiry_questions |
array of object (fields) | No | The inquiry form's own questions, asked beside name, email, phone and message on every contact form the site places. maxItems: 20 |
inquiry_questions_revision |
string | No | Send as expected_inquiry_questions_revision when replacing inquiry_questions, and as questions_revision with an inquiry. |
integrations |
object (fields) | No | Saved connections and the provider account, property or site each acts on. A saved connection does not prove a report will pass; query_google_analytics, query_search_console and query_google_ads_report report their own failures. |
media |
array of object (fields) | No | |
name |
string or null | No | |
organization_id |
string | No | |
palette |
object or null (fields) | No | The colors the site renders, light and dark: its own, or the default. Null on Blawby's own site. |
palette_source |
string or null | No | enum: ["custom","default",null] |
partnerships_email |
string or null | No | |
press_email |
string or null | No | |
public_url |
string or null | No | |
seo_description |
string or null | No | |
seo_title |
string or null | No | |
social_card_refresh |
object or null (fields) | No | The latest brand-name change’s social-card refresh. Read with get_organization_settings until complete. Failed refreshes can be retried under Website → Brand → Name. additionalProperties: false; required: ["id","status","cursor","error"] |
status |
string | No | |
subdomain |
string | No | |
theme |
string | No | |
timezone |
string | No | |
updated_at |
string | No |
additionalProperties: false
object or null fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
cursor |
string or null | Yes | |
error |
string or null | Yes | |
id |
string | Yes | |
status |
string | Yes | enum: ["pending","complete","failed"] |
additionalProperties: false; required: ["id","status","cursor","error"]
array of object fields
Value: array of object.
Array items: object.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
amount |
integer | Yes | |
buyer_name |
string or null | No | |
captured_amount |
integer | Yes | |
created_at |
string | No | |
currency |
string | Yes | |
ends_at |
string or null | No | |
id |
string | Yes | |
image_url |
string or null | No | |
refunded_amount |
integer | Yes | |
starts_at |
string or null | No | |
timezone |
string or null | No | |
title |
string | Yes | |
to |
string | Yes |
additionalProperties: false; required: ["id","currency","amount","captured_amount","refunded_amount","title","to"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
price |
object (fields) | No | |
product_id |
string or null | No | |
quantity |
integer | Yes | |
session_id |
string or null | No | |
title |
string | Yes | |
variant_id |
string or null | No |
required: ["title","quantity"]
array of object fields
Value: array of object.
Array items: object.
object or null fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
available |
array of object (fields) | Yes | |
pending |
array of object (fields) | Yes |
required: ["available","pending"]
array of object fields
Value: array of object.
Array items: object.
array of object fields
Value: array of object.
Array items: object.
array of object fields
Value: array of object.
Array items: object.
array of object fields
Value: array of object.
Array items: object.
string or null fields
Value: string or null.
object or null fields
Value: object or null.
string or null fields
Value: string or null.
array of object fields
Value: array of object.
Array items: object.
string or null fields
Value: string or null.
string or null fields
Value: string or null.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
body |
string or null | No | |
call_to_action |
object or null (fields) | No | |
canonical_url |
string or null | No | |
created_at |
string | No | |
id |
string | Yes | |
location_id |
string or null | No | |
media |
array of object (fields) | Yes | Cover, then gallery, in order. |
organization_id |
string | No | |
preview_url |
string or null | No | A signed link to the draft as visitors will see it. |
public_path |
string | No | |
public_url |
string or null | No | |
publications |
array of object (fields) | Yes | |
published_at |
string or null | No | |
slug |
string | Yes | |
status |
string | Yes | enum: ["draft","published"] |
title |
string or null | No | |
updated_at |
string | Yes | The updated_at update_post and publish_post take. |
view_url |
string or null | No | |
visibility |
string | Yes | enum: ["listed","unlisted"] |
required: ["id","slug","status","visibility","media","publications","updated_at"]
object or null fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
id |
string | Yes | |
state |
string | Yes | enum: ["removed"] |
required: ["id","state"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
body |
string or null | Yes | |
channel |
string | Yes | enum: ["facebook","instagram","discord"] |
media |
array of object (fields) | Yes | |
provider_post_id |
string | Yes | Native provider identity, not a website post_id. |
public_url |
string or null | Yes | The provider link. A Discord message link opens only for members of that channel. |
published_at |
string | Yes | |
target_id |
string | Yes |
additionalProperties: false; required: ["channel","target_id","provider_post_id","body","public_url","published_at","media"]
array of object fields
Value: array of object.
Array items: object.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
channel |
string | Yes | enum: ["organization"] |
label |
string | Yes | |
target_id |
string | Yes |
required: ["channel","target_id","label"]
array of object fields
Value: array of object.
Array items: object.
array of object fields
Value: array of object.
Array items: object.
array of object fields
Value: array of object.
maxItems: 4; minItems: 1
Array items: object.
array of object fields
Value: array of object.
Array items: object.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
channel |
string | Yes | enum: ["organization","facebook","instagram","discord"] |
code |
string | No | |
message |
string | No | |
public_url |
string or null | No | |
publication_id |
string | No | |
status |
string | Yes | enum: ["published","already_published","failed","skipped"] |
target_id |
string | Yes |
additionalProperties: false; required: ["channel","target_id","status"]
string or null fields
Value: string or null.
See schema fields
Value: See schema.
required: ["body"]
See schema fields
Value: See schema.
required: ["call_to_action"]
array of object fields
Value: array of object.
maxItems: 400; minItems: 1
Array items: object.
array of object fields
Value: array of object.
Array items: object.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
description |
string or null | Yes | |
id |
string | Yes | |
image |
object or null (fields) | Yes | The section's own photo; set it with set_media owner_type collection, slot image. required: ["asset_id","kind","public_url","status"] |
location_id |
string or null | Yes | |
name |
string | Yes | |
organization_id |
string | Yes | |
slug |
string | Yes | |
sort_order |
integer | Yes |
additionalProperties: false; required: ["id","organization_id","location_id","name","slug","description","image","sort_order"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
accessibility_contact_required |
boolean | No | Ask guests needing accessibility support to contact the business before booking. |
assigned_member_id |
string | No | Host membership ID from list_organization_members → members[].id or get_member_scheduling → members[].id, not userId. Every bookable offering has one: it handles all its bookings. Guests see this member’s approved public profile. Read get_member_public_profile; publication requires an approved profile with a nonblank public_name. |
confirmation_mode |
string | No | instant confirms immediately (default); review waits for staff approval. default: "instant"; enum: ["instant","review"] |
default_capacity |
integer or null | Yes | Places per session; null means unlimited. minimum: 1 |
duration_minutes |
integer | Yes | Minutes each visit occupies its booking slot or seats, independent of the interval between start times. minimum: 1 |
location_id |
string or null | Yes | |
minimum_guest_age |
integer or null | No | Youngest guest admitted, stated to guests before booking; null states none. minimum: 0 |
online_payment_required |
boolean | No | True requires online payment when booking; false is the default and does not collect online. default: false |
party_size_max |
integer or null | No | Largest party one booking takes; null is limited only by the session's places. A larger party contacts the business. minimum: 1 |
party_size_min |
integer or null | No | Smallest party one booking takes; null has no minimum. minimum: 1 |
payment_basis |
string | No | What the online price is charged for: per_guest (each place, a class seat) or per_booking (the booking as a whole, a table's deposit). enum: ["per_guest","per_booking"] |
payment_min_party_size |
integer or null | No | Smallest party that pays online, for example a deposit for parties of 6 or more; smaller parties book without paying. Null means every party pays when online_payment_required is true. minimum: 1 |
scheduling_mode |
string | No | Legal consultations require provider scheduling with an explicitly assigned attorney. business: the business publishes its own sessions; the assigned member hosts them, but their working hours do not set the times. Experiences may use it. provider: times come from the assigned member’s working hours. Physical provider times also respect the selected member’s availability; online times come from their working hours. enum: ["business","provider"] |
seating_interval_minutes |
integer or null | No | Tables only, and required for them: minutes between seatings. A table is seated from each opening of its location's opening hours (or that date's special hours) and every interval after, while duration_minutes still ends by closing. Change when tables are bookable with update_location hours, block_dates and open_dates. maximum: 1440; minimum: 5 |
sessions |
array of object (fields) | No | maxItems: 100; minItems: 1 |
weekly_slots |
array of object (fields) | No | maxItems: 100; minItems: 1 |
additionalProperties: false; required: ["location_id","duration_minutes","default_capacity"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
allergens |
array of string (fields) | No | Allergens the merchant states this dish contains. maxItems: 100; uniqueItems: true |
carbon_monoxide_detector_details |
string | No | Share where each carbon monoxide alarm is located. maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
climbing_structures |
boolean | No | Play or climbing structures are available to guests. |
climbing_structures_details |
string | No | Host-authored details about climbing or play structures. Requires its disclosure to be Yes. maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
commercial_photography_allowed |
boolean | No | Whether guests may take commercial photos or film at the property. |
dangerous_animals |
boolean | No | Animals that could cause harm live on or near the property. |
dangerous_animals_details |
string | No | Host-authored details about potentially dangerous animals. Requires its disclosure to be Yes. maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
dietary_notes |
array of string (fields) | No | Merchant-stated dietary facts displayed with a dish. maxItems: 100; uniqueItems: true |
events_allowed |
boolean | No | Whether guests may host events at the property. |
exterior_security_cameras |
boolean | No | Describe exterior cameras, what they monitor and whether they record audio or video. |
exterior_security_cameras_details |
string | No | Host-authored details about exterior security cameras. Requires its disclosure to be Yes. maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
featured |
boolean | No | Highlight this item on the menu and homepage. |
getting_around |
string | No | Host-authored transport and getting-around information for this home. maxLength: 10000; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
guest_access |
string | No | The spaces and facilities guests can use during their stay. maxLength: 10000; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
house_rules |
string | No | The host’s rules for guests staying in the home, shown with the listing. maxLength: 10000; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
included_items |
array of string (fields) | No | Items or work included in the stated price, shown in their own public section. maxItems: 100; uniqueItems: true |
ingredients |
array of string (fields) | No | Ingredients shown in the dish details. maxItems: 100; uniqueItems: true |
interaction_with_guests |
string | No | How guests can contact the host and what support is available. maxLength: 10000; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
limited_essentials |
boolean | No | Tell guests which everyday essentials are unavailable. |
limited_essentials_details |
string | No | Host-authored details about limited essential amenities. Requires its disclosure to be Yes. maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
meeting_point |
string | No | Instructions shown in the meeting section; meeting mode and video links are set in scheduling. maxLength: 10000; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
nearby_water |
boolean | No | Guests can reach a body of water on or next to the property. |
nearby_water_details |
string | No | Host-authored details about nearby water. Requires its disclosure to be Yes. maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
neighborhood_description |
string | No | Host-authored information about the neighborhood around this home. maxLength: 10000; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
no_property_parking |
boolean | No | Dedicated guest parking is not available on the property. |
no_property_parking_details |
string | No | Host-authored details about no parking on the property. Requires its disclosure to be Yes. maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
noise_decibel_monitors |
boolean | No | Devices measure sound levels without recording conversations. |
noise_decibel_monitors_details |
string | No | Host-authored details about noise decibel monitors. Requires its disclosure to be Yes. maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
noodle |
array of string (fields) | No | Authored noodle information shown as dish facts; these do not establish purchasable variants. maxItems: 100; uniqueItems: true |
other_details_to_note |
string | No | Additional information guests should know before booking. maxLength: 10000; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
pets_allowed |
boolean | No | Let guests know if they can bring pets. |
potential_noise |
boolean | No | Guests may hear traffic, construction or other noise. |
potential_noise_details |
string | No | Host-authored details about potential noise during stays. Requires its disclosure to be Yes. maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
preparation |
string | No | Preparation instructions shown to customers before a session or appointment. maxLength: 10000; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
pricing_note |
string | No | An explicitly stated price such as Market price; use only when no numeric price is set. maxLength: 1000; minLength: 1; pattern: "^(?=[\s\S]\S)[^\r\n]$" |
quiet_hours |
boolean | No | Hours when guests should keep noise to a minimum. |
quiet_hours_end |
string | No | Local end of quiet hours, required with quiet hours and its start time. enum: ["00:00","01:00","02:00","03:00","04:00","05:00","06:00","07:00","08:00","09:00","10:00","11:00","12:00","13:00","14:00","15:00","16:00","17:00","18:00","19:00","20:00","21:00","22:00","23:00"]; maxLength: 1000; minLength: 1; pattern: "^(?=[\s\S]\S)[^\r\n]$" |
quiet_hours_start |
string | No | Local start of quiet hours, required with quiet hours and its end time. enum: ["00:00","01:00","02:00","03:00","04:00","05:00","06:00","07:00","08:00","09:00","10:00","11:00","12:00","13:00","14:00","15:00","16:00","17:00","18:00","19:00","20:00","21:00","22:00","23:00"]; maxLength: 1000; minLength: 1; pattern: "^(?=[\s\S]\S)[^\r\n]$" |
resident_pets |
boolean | No | Guests may encounter animals that live here. |
resident_pets_details |
string | No | Host-authored details about pets live on the property. Requires its disclosure to be Yes. maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
shared_spaces |
boolean | No | Guests share some spaces with other people. |
shared_spaces_details |
string | No | Host-authored details about shared spaces. Requires its disclosure to be Yes. maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
sizes |
array of string (fields) | No | Authored serving information; priced choices belong in variants. maxItems: 100; uniqueItems: true |
smoke_detector_details |
string | No | Share where each smoke alarm is located. maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
smoking_allowed |
boolean | No | Whether guests may smoke or vape at the property. |
soup |
array of string (fields) | No | Authored soup information shown with the dish. maxItems: 100; uniqueItems: true |
special_safety_considerations |
string | No | Other property features that guests should know could be unsafe, and why. maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
stairs_required |
boolean | No | Guests need to use stairs during their stay. |
stairs_required_details |
string | No | Host-authored details about guests must climb stairs. Requires its disclosure to be Yes. maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
tagline |
string | No | A short sentence shown below the product title. maxLength: 1000; minLength: 1; pattern: "^(?=[\s\S]\S)[^\r\n]$" |
toppings |
array of string (fields) | No | Authored topping information; priced choices belong in variants. maxItems: 100; uniqueItems: true |
unprotected_heights |
boolean | No | Elevated areas are accessible without a railing or other protection. |
unprotected_heights_details |
string | No | Host-authored details about unprotected heights. Requires its disclosure to be Yes. maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
unsecured_pool |
boolean | No | Guests can reach a pool or hot tub without a gate or lock. |
unsecured_pool_details |
string | No | Host-authored details about unsecured pool or hot tub. Requires its disclosure to be Yes. maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
weapons_on_property |
boolean | No | Tell guests about weapons stored on the property. |
weapons_on_property_details |
string | No | Host-authored details about weapons on the property. Requires its disclosure to be Yes. maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
what_to_bring |
array of string (fields) | No | Items customers should bring, shown in the preparation section. maxItems: 100; uniqueItems: true |
your_property |
string | No | The spaces and features guests should know about this home. maxLength: 10000; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
additionalProperties: false
array of string fields
Value: array of string.
maxItems: 15
Array items: string.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
blocks |
array of object (fields) | Yes | Complete canonical block array. Each existing block must retain its id unless its removal is explicitly confirmed. Block data never contains asset IDs or delivery URLs. Omit media to preserve that block's current placements; provide media explicitly to replace them, or call set_media with owner_type "content_block", the block id, and the intended slot. |
page_type |
string | No | The page's type. Send the page_type from the last read unless you are changing it. enum: ["custom","recipe","legal","system"] |
path |
string | No | The page's public path. A practice area or consultation may omit it to get the first free /services/ |
recipe |
string or null | No | The site section this page fills, or null for a page that fills none. Send the recipe from the last read unless you are changing it; an omitted recipe is not kept. |
sort_order |
number | No | The page's position in the site's page list. Send the sort_order from the last read unless you are reordering. |
summary |
string or null | No | Omit to preserve on update; null clears it. |
title |
string | Yes | The page's name, e.g. About. The site name is appended to the browser title. Always sent in full — an omitted title is not kept. |
additionalProperties: false; required: ["title","blocks"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
amenities |
array of string (fields) | No | Amenity codes the home offers; replaces the whole positive list. Empty offers none. uniqueItems: true |
amenity_answers |
array of object (fields) | No | Sparse amenity answer patch: true offers it, false explicitly reports absence, null clears to unknown. Omitted codes remain. Positive-list edits preserve false reports and remove omitted positive reports to unknown. Contradictions between amenities and amenity_answers are refused. |
assigned_member_id |
string | Yes | Host membership ID from list_organization_members → members[].id or get_member_scheduling → members[].id, not userId. Every home has one: it handles the home's stays and turnovers and shows their approved public profile to guests. Publication requires an approved profile with a nonblank public_name; read get_member_public_profile. |
bathrooms |
number or null | No | Whole and half baths, such as 1.5. maximum: 50; minimum: 0; multipleOf: 0.5 |
bedrooms |
integer or null | No | Bedrooms; 0 is a studio. maximum: 50; minimum: 0 |
beds |
integer or null | No | maximum: 9007199254740991; minimum: 0 |
calendar_rules |
object or null (fields) | No | Actual optional listing rules. Null removes them. Dated overrides take precedence over weekday minimums, then the required default. Friday/Saturday use the weekend price when supplied. additionalProperties: false |
cancellation_policy |
string or null | No | Policy shown to guests for stays under 28 nights. Null when the provider has not supplied one. New authored homes start on Flexible. It does not refund by itself. enum: ["flexible","moderate","limited","firm","strict",null] |
check_in_end_time |
string or null | No | Local 24-hour end of the check-in window; null is a flexible end. A time earlier than check_in_time is after midnight. pattern: "^([01]\d|2[0-3]):[0-5]\d$" |
check_in_time |
string or null | Yes | Local 24-hour time guests may arrive from, in the location’s timezone. pattern: "^([01]\d|2[0-3]):[0-5]\d$" |
check_out_time |
string or null | Yes | Local 24-hour time guests leave by. pattern: "^([01]\d|2[0-3]):[0-5]\d$" |
internal_name |
string | No | Short operator-only home name. Initially the listing title; edited independently from Product.name and never sent to Airbnb or guests. maxLength: 240; minLength: 1 |
listing_floor |
integer or null | No | The listing’s floor, counted from 1. Cannot exceed total_floors when both are known; null when not said. maximum: 9007199254740991; minimum: 1 |
listing_type |
string or null | No | Whether guests book the entire place, a private room or a shared room. Null when not said. enum: ["entire_place","private_room","shared_room",null] |
location_id |
string | Yes | |
long_term_cancellation_policy |
string or null | No | Policy shown to guests for stays of 28 nights or more. Null when the provider has not supplied one. New authored homes start on Firm Long Term. enum: ["firm","strict",null] |
max_guests |
integer | Yes | maximum: 99; minimum: 1 |
min_nights |
integer | Yes | The listing’s required default minimum; individual arrival dates may override it. maximum: 1125; minimum: 1 |
property_size |
number or null | No | Property area in property_size_unit. Size and unit must both be set or both null. exclusiveMinimum: 0 |
property_size_unit |
string or null | No | The unit of property_size. Size and unit must both be set or both null. enum: ["square_meters","square_feet",null] |
property_type |
string or null | No | Airbnb property type, one the property_type_group offers. Null with property_type_group when not said. enum: ["apartment","condominium","serviced_apartment","loft","house","townhouse","bungalow","cabin","chalet","earthhouse","hut","lighthouse","villa","dome","cottage","farmstay","houseboat","tiny_house","guesthouse","private_suite","boat","castle","cave","igloo","island","plane","rv","tent","tipi","train","treehouse","yurt","other","barn","campsite","windmill","bus","holiday_park","ranch","religious_building","riad","shipping_container","tower","bnb","nature_eco_lodge","boutique_hotel","hostel","aparthotel","hotel","resort",null] |
property_type_group |
string or null | No | Airbnb's property group: apartments (Apartment: apartment, condominium, serviced_apartment, loft); houses (House: house, townhouse, bungalow, cabin, chalet, earthhouse, hut, lighthouse, villa, dome, cottage, farmstay, houseboat, tiny_house); secondary_units (Secondary unit: guesthouse, private_suite, farmstay); unique_homes (Unique space: boat, castle, cave, earthhouse, hut, igloo, island, lighthouse, plane, rv, tent, tipi, train, treehouse, yurt, other, dome, barn, campsite, farmstay, houseboat, tiny_house, windmill, bus, holiday_park, ranch, religious_building, riad, shipping_container, tower); bnb (Bed and breakfast: bnb, nature_eco_lodge, farmstay); boutique_hotels_and_more (Boutique hotel: boutique_hotel, nature_eco_lodge, hostel, serviced_apartment, aparthotel, hotel, resort). Supply property_type with it; both are set or both null. enum: ["apartments","houses","secondary_units","unique_homes","bnb","boutique_hotels_and_more",null] |
total_floors |
integer or null | No | Total floors in the property; null when not said. maximum: 9007199254740991; minimum: 1 |
year_built |
integer or null | No | Year the property was built; null when not said. maximum: 9007199254740991; minimum: 1 |
additionalProperties: false; required: ["location_id","check_in_time","check_out_time","max_guests","min_nights","assigned_member_id"]
array of object fields
Value: array of object.
maxItems: 250; minItems: 1
Array items: object.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
active |
boolean | Yes | The merchant sale switch. Not visibility and not stock: a disabled product is not sold out. |
admin_edit_url |
string or null | No | The dashboard editor for this product, on the platform host. |
booking |
object or null (fields) | No | required: ["duration_minutes","seating_interval_minutes","default_capacity","confirmation_mode","online_payment_required","held_online","advance_notice_minutes","party_size_min","party_size_max","minimum_guest_age","accessibility_contact_required","payment_basis","payment_min_party_size","questions","questions_revision"] |
booking_readiness |
object or null (fields) | No | required: ["ready","missing"] |
collections |
array of object (fields) | Yes | |
created_at |
string | Yes | |
description |
string | Yes | |
details |
object (fields) | Yes | additionalProperties: false |
gallery |
array of object (fields) | No | |
id |
string | Yes | |
image |
object or null (fields) | No | required: ["asset_id","kind","public_url","status"] |
kind |
string | Yes | enum: ["dish","experience","service","stay","table"] |
locations |
array of object (fields) | Yes | |
marketing_features |
array of string (fields) | No | |
metadata |
object | No | additionalProperties: {"type":"string"} |
name |
string | Yes | |
order_url |
string or null | No | |
page |
object or null (fields) | No | The source page this product owns, or null. Edit its content with the site-page tools; its binding is the page's product_id. required: ["id","path","title"] |
public_url |
string or null | No | |
publications |
array of object (fields) | Yes | |
slug |
string | Yes | |
source |
string | Yes | enum: ["manual","template","ai","import","copy"] |
stay |
object or null (fields) | No | Non-null exactly for a place to stay: its one location and stay settings (arrival, departure, guests, minimum nights, who looks after it, what it is and offers, its cancellation policies). Guest-facing house rules are the house_rules detail. Authored photo_rooms and listing accessibility are read-only here and use their stay operations. required: ["internal_name","location_id","check_in_time","check_in_end_time","check_out_time","max_guests","min_nights","calendar_rules","assigned_member_id","photo_rooms","accessibility","questions","questions_revision","property_type_group","property_type","listing_type","total_floors","listing_floor","year_built","property_size","property_size_unit","bedrooms","beds","bathrooms","amenities","amenity_answers","cancellation_policy","long_term_cancellation_policy"] |
tax_code |
string or null | No | |
unit_label |
string or null | No | |
updated_at |
string | Yes | |
variants |
array of object (fields) | Yes |
additionalProperties: false; required: ["id","kind","name","slug","description","active","variants","details","publications","locations","collections","source","created_at","updated_at"]
array of object fields
Value: array of object.
Array items: object.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
by_kind |
object (fields) | Yes | additionalProperties: false; required: ["dish","experience","service","stay","table"] |
total |
integer | Yes | minimum: 0 |
additionalProperties: false; required: ["total","by_kind"]
array of object fields
Value: array of object.
Array items: object.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
featured |
boolean | No | |
kind |
string | Yes | enum: ["dish","experience","service","stay","table","all"] |
location_id |
string | No | |
organization_id |
string | Yes | |
published_only |
boolean | Yes | |
view |
string | Yes | const: "catalog" |
additionalProperties: false; required: ["view","organization_id","kind","published_only"]
array of object fields
Value: array of object.
maxItems: 200
Array items: object.
array of object fields
Value: array of object.
Array items: object.
array of string fields
Value: array of string.
minItems: 1; uniqueItems: true
Array items: string.
array of string fields
Value: array of string.
uniqueItems: true
Array items: string.
array of object fields
Value: array of object.
Array items: object.
array of object fields
Value: array of object.
Array items: object.
array of string fields
Value: array of string.
maxItems: 2000; uniqueItems: true
Array items: string.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
collection_id |
string | Yes | minLength: 1 |
expected_product_ids |
array of string (fields) | Yes | maxItems: 2000; uniqueItems: true |
additionalProperties: false; required: ["collection_id","expected_product_ids"]
array of string fields
Value: array of string.
maxItems: 2000; uniqueItems: true
Array items: string.
See schema fields
Value: See schema.
if: {"required":["move_to"]}; then: {"required":["expected_product_ids"]}
array of object fields
Value: array of object.
maxItems: 20
Array items: object.
object or null fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
accessibility_contact_required |
boolean | Yes | Ask guests needing accessibility support to contact the business before booking. |
advance_notice_minutes |
integer or null | Yes | Minimum notice in minutes (1440 is 1 day, 2880 is 2 days): clients cannot book or cancel online a session that starts sooner, and no booking is moved into one. Free cancellation closes at least 24 hours before the start either way. Null means no notice. minimum: 0 |
assigned_member_id |
string or null | No | Better Auth organization membership ID of the host who handles every booking; null only after that member left the business. |
confirmation_mode |
string | Yes | instant confirms immediately (default); review waits for staff approval. default: "instant"; enum: ["instant","review"] |
default_capacity |
integer or null | Yes | minimum: 0 |
duration_minutes |
integer or null | Yes | minimum: 1 |
held_online |
boolean | Yes | True holds the offering online: its times are its provider's working hours, in the provider's timezone. Requires scheduling_mode provider with an assigned member. |
minimum_guest_age |
integer or null | Yes | Youngest guest admitted, stated to guests before booking; null states none. minimum: 0 |
online_payment_required |
boolean | Yes | True requires online payment when booking; false is the default and does not collect online. default: false |
organization_id |
string | No | |
party_size_max |
integer or null | Yes | Largest party one booking takes; null is limited only by the session's places. A larger party contacts the business. minimum: 1 |
party_size_min |
integer or null | Yes | Smallest party one booking takes; null has no minimum. minimum: 1 |
payment_basis |
string | Yes | What the online price is charged for: per_guest (each place, a class seat) or per_booking (the booking as a whole, a table's deposit). enum: ["per_guest","per_booking"] |
payment_min_party_size |
integer or null | Yes | Smallest party that pays online, for example a deposit for parties of 6 or more; smaller parties book without paying. Null means every party pays when online_payment_required is true. minimum: 1 |
product_id |
string | No | |
questions |
array of object (fields) | Yes | The tenant's own questions asked beside the required booking fields; create_product_booking answers them by ID. maxItems: 20 |
questions_revision |
string | Yes | Send as expected_questions_revision when replacing questions, and as questions_revision when submitting answers. |
scheduling_mode |
string | No | Legal consultations require provider scheduling with an explicitly assigned attorney. business: the business publishes its own sessions; the assigned member hosts them, but their working hours do not set the times. Experiences may use it. provider: times come from the assigned member’s working hours. Physical provider times also respect the selected member’s availability; online times come from their working hours. enum: ["business","provider"] |
seating_interval_minutes |
integer or null | Yes | A table's minutes between seatings through its location's hours; null for every other offering. maximum: 1440; minimum: 5 |
required: ["duration_minutes","seating_interval_minutes","default_capacity","confirmation_mode","online_payment_required","held_online","advance_notice_minutes","party_size_min","party_size_max","minimum_guest_age","accessibility_contact_required","payment_basis","payment_min_party_size","questions","questions_revision"]
array of object fields
Value: array of object.
maxItems: 30; minItems: 1
Array items: object.
array of object fields
Value: array of object.
Array items: object.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
allergens |
array of string or null (fields) | No | Allergens the merchant states this dish contains. |
carbon_monoxide_detector_details |
string or null (fields) | No | Share where each carbon monoxide alarm is located. |
climbing_structures |
boolean or null | No | Play or climbing structures are available to guests. |
climbing_structures_details |
string or null (fields) | No | Host-authored details about climbing or play structures. Requires its disclosure to be Yes. |
commercial_photography_allowed |
boolean or null | No | Whether guests may take commercial photos or film at the property. |
dangerous_animals |
boolean or null | No | Animals that could cause harm live on or near the property. |
dangerous_animals_details |
string or null (fields) | No | Host-authored details about potentially dangerous animals. Requires its disclosure to be Yes. |
dietary_notes |
array of string or null (fields) | No | Merchant-stated dietary facts displayed with a dish. |
events_allowed |
boolean or null | No | Whether guests may host events at the property. |
exterior_security_cameras |
boolean or null | No | Describe exterior cameras, what they monitor and whether they record audio or video. |
exterior_security_cameras_details |
string or null (fields) | No | Host-authored details about exterior security cameras. Requires its disclosure to be Yes. |
featured |
boolean or null | No | Highlight this item on the menu and homepage. |
getting_around |
string or null (fields) | No | Host-authored transport and getting-around information for this home. |
guest_access |
string or null (fields) | No | The spaces and facilities guests can use during their stay. |
house_rules |
string or null (fields) | No | The host’s rules for guests staying in the home, shown with the listing. |
included_items |
array of string or null (fields) | No | Items or work included in the stated price, shown in their own public section. |
ingredients |
array of string or null (fields) | No | Ingredients shown in the dish details. |
interaction_with_guests |
string or null (fields) | No | How guests can contact the host and what support is available. |
limited_essentials |
boolean or null | No | Tell guests which everyday essentials are unavailable. |
limited_essentials_details |
string or null (fields) | No | Host-authored details about limited essential amenities. Requires its disclosure to be Yes. |
meeting_point |
string or null (fields) | No | Instructions shown in the meeting section; meeting mode and video links are set in scheduling. |
nearby_water |
boolean or null | No | Guests can reach a body of water on or next to the property. |
nearby_water_details |
string or null (fields) | No | Host-authored details about nearby water. Requires its disclosure to be Yes. |
neighborhood_description |
string or null (fields) | No | Host-authored information about the neighborhood around this home. |
no_property_parking |
boolean or null | No | Dedicated guest parking is not available on the property. |
no_property_parking_details |
string or null (fields) | No | Host-authored details about no parking on the property. Requires its disclosure to be Yes. |
noise_decibel_monitors |
boolean or null | No | Devices measure sound levels without recording conversations. |
noise_decibel_monitors_details |
string or null (fields) | No | Host-authored details about noise decibel monitors. Requires its disclosure to be Yes. |
noodle |
array of string or null (fields) | No | Authored noodle information shown as dish facts; these do not establish purchasable variants. |
other_details_to_note |
string or null (fields) | No | Additional information guests should know before booking. |
pets_allowed |
boolean or null | No | Let guests know if they can bring pets. |
potential_noise |
boolean or null | No | Guests may hear traffic, construction or other noise. |
potential_noise_details |
string or null (fields) | No | Host-authored details about potential noise during stays. Requires its disclosure to be Yes. |
preparation |
string or null (fields) | No | Preparation instructions shown to customers before a session or appointment. |
pricing_note |
string or null (fields) | No | An explicitly stated price such as Market price; use only when no numeric price is set. |
quiet_hours |
boolean or null | No | Hours when guests should keep noise to a minimum. |
quiet_hours_end |
string or null (fields) | No | Local end of quiet hours, required with quiet hours and its start time. |
quiet_hours_start |
string or null (fields) | No | Local start of quiet hours, required with quiet hours and its end time. |
resident_pets |
boolean or null | No | Guests may encounter animals that live here. |
resident_pets_details |
string or null (fields) | No | Host-authored details about pets live on the property. Requires its disclosure to be Yes. |
shared_spaces |
boolean or null | No | Guests share some spaces with other people. |
shared_spaces_details |
string or null (fields) | No | Host-authored details about shared spaces. Requires its disclosure to be Yes. |
sizes |
array of string or null (fields) | No | Authored serving information; priced choices belong in variants. |
smoke_detector_details |
string or null (fields) | No | Share where each smoke alarm is located. |
smoking_allowed |
boolean or null | No | Whether guests may smoke or vape at the property. |
soup |
array of string or null (fields) | No | Authored soup information shown with the dish. |
special_safety_considerations |
string or null (fields) | No | Other property features that guests should know could be unsafe, and why. |
stairs_required |
boolean or null | No | Guests need to use stairs during their stay. |
stairs_required_details |
string or null (fields) | No | Host-authored details about guests must climb stairs. Requires its disclosure to be Yes. |
tagline |
string or null (fields) | No | A short sentence shown below the product title. |
toppings |
array of string or null (fields) | No | Authored topping information; priced choices belong in variants. |
unprotected_heights |
boolean or null | No | Elevated areas are accessible without a railing or other protection. |
unprotected_heights_details |
string or null (fields) | No | Host-authored details about unprotected heights. Requires its disclosure to be Yes. |
unsecured_pool |
boolean or null | No | Guests can reach a pool or hot tub without a gate or lock. |
unsecured_pool_details |
string or null (fields) | No | Host-authored details about unsecured pool or hot tub. Requires its disclosure to be Yes. |
weapons_on_property |
boolean or null | No | Tell guests about weapons stored on the property. |
weapons_on_property_details |
string or null (fields) | No | Host-authored details about weapons on the property. Requires its disclosure to be Yes. |
what_to_bring |
array of string or null (fields) | No | Items customers should bring, shown in the preparation section. |
your_property |
string or null (fields) | No | The spaces and features guests should know about this home. |
additionalProperties: false
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
amenities |
array of string (fields) | No | Amenity codes the home offers; replaces the whole positive list. Empty offers none. uniqueItems: true |
amenity_answers |
array of object (fields) | No | Sparse amenity answer patch: true offers it, false explicitly reports absence, null clears to unknown. Omitted codes remain. Positive-list edits preserve false reports and remove omitted positive reports to unknown. Contradictions between amenities and amenity_answers are refused. |
assigned_member_id |
string | No | Host membership ID from list_organization_members → members[].id or get_member_scheduling → members[].id, not userId. Every home has one: it handles the home's stays and turnovers and shows their approved public profile to guests. Publication requires an approved profile with a nonblank public_name; read get_member_public_profile. |
bathrooms |
number or null | No | Whole and half baths, such as 1.5. maximum: 50; minimum: 0; multipleOf: 0.5 |
bedrooms |
integer or null | No | Bedrooms; 0 is a studio. maximum: 50; minimum: 0 |
beds |
integer or null | No | maximum: 9007199254740991; minimum: 0 |
calendar_rules |
object or null (fields) | No | Actual optional listing rules. Null removes them. Dated overrides take precedence over weekday minimums, then the required default. Friday/Saturday use the weekend price when supplied. additionalProperties: false |
cancellation_policy |
string or null | No | Policy shown to guests for stays under 28 nights. Null when the provider has not supplied one. New authored homes start on Flexible. It does not refund by itself. enum: ["flexible","moderate","limited","firm","strict",null] |
check_in_end_time |
string or null | No | Local 24-hour end of the check-in window; null is a flexible end. A time earlier than check_in_time is after midnight. pattern: "^([01]\d|2[0-3]):[0-5]\d$" |
check_in_time |
string or null | No | Local 24-hour time guests may arrive from, in the location’s timezone. pattern: "^([01]\d|2[0-3]):[0-5]\d$" |
check_out_time |
string or null | No | Local 24-hour time guests leave by. pattern: "^([01]\d|2[0-3]):[0-5]\d$" |
expected_questions_revision |
string | No | stay.questions_revision from get_product; required with questions. |
internal_name |
string | No | Short operator-only home name. Initially the listing title; edited independently from Product.name and never sent to Airbnb or guests. maxLength: 240; minLength: 1 |
listing_floor |
integer or null | No | The listing’s floor, counted from 1. Cannot exceed total_floors when both are known; null when not said. maximum: 9007199254740991; minimum: 1 |
listing_type |
string or null | No | Whether guests book the entire place, a private room or a shared room. Null when not said. enum: ["entire_place","private_room","shared_room",null] |
long_term_cancellation_policy |
string or null | No | Policy shown to guests for stays of 28 nights or more. Null when the provider has not supplied one. New authored homes start on Firm Long Term. enum: ["firm","strict",null] |
max_guests |
integer | No | maximum: 99; minimum: 1 |
min_nights |
integer | No | The listing’s required default minimum; individual arrival dates may override it. maximum: 1125; minimum: 1 |
property_size |
number or null | No | Property area in property_size_unit. Size and unit must both be set or both null. exclusiveMinimum: 0 |
property_size_unit |
string or null | No | The unit of property_size. Size and unit must both be set or both null. enum: ["square_meters","square_feet",null] |
property_type |
string or null | No | Airbnb property type, one the property_type_group offers. Null with property_type_group when not said. enum: ["apartment","condominium","serviced_apartment","loft","house","townhouse","bungalow","cabin","chalet","earthhouse","hut","lighthouse","villa","dome","cottage","farmstay","houseboat","tiny_house","guesthouse","private_suite","boat","castle","cave","igloo","island","plane","rv","tent","tipi","train","treehouse","yurt","other","barn","campsite","windmill","bus","holiday_park","ranch","religious_building","riad","shipping_container","tower","bnb","nature_eco_lodge","boutique_hotel","hostel","aparthotel","hotel","resort",null] |
property_type_group |
string or null | No | Airbnb's property group: apartments (Apartment: apartment, condominium, serviced_apartment, loft); houses (House: house, townhouse, bungalow, cabin, chalet, earthhouse, hut, lighthouse, villa, dome, cottage, farmstay, houseboat, tiny_house); secondary_units (Secondary unit: guesthouse, private_suite, farmstay); unique_homes (Unique space: boat, castle, cave, earthhouse, hut, igloo, island, lighthouse, plane, rv, tent, tipi, train, treehouse, yurt, other, dome, barn, campsite, farmstay, houseboat, tiny_house, windmill, bus, holiday_park, ranch, religious_building, riad, shipping_container, tower); bnb (Bed and breakfast: bnb, nature_eco_lodge, farmstay); boutique_hotels_and_more (Boutique hotel: boutique_hotel, nature_eco_lodge, hostel, serviced_apartment, aparthotel, hotel, resort). Supply property_type with it; both are set or both null. enum: ["apartments","houses","secondary_units","unique_homes","bnb","boutique_hotels_and_more",null] |
questions |
array of object (fields) | No | Replace the questions asked with each direct stay booking. Read get_product first and keep existing question IDs. maxItems: 20 |
total_floors |
integer or null | No | Total floors in the property; null when not said. maximum: 9007199254740991; minimum: 1 |
year_built |
integer or null | No | Year the property was built; null when not said. maximum: 9007199254740991; minimum: 1 |
additionalProperties: false
array of object fields
Value: array of object.
maxItems: 250; minItems: 1
Array items: object.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
active |
boolean | Yes | The merchant sale switch. Not visibility and not stock: a disabled product is not sold out. |
admin_edit_url |
string or null | No | The dashboard editor for this product, on the platform host. |
booking |
object or null (fields) | No | required: ["duration_minutes","seating_interval_minutes","default_capacity","confirmation_mode","online_payment_required","held_online","advance_notice_minutes","party_size_min","party_size_max","minimum_guest_age","accessibility_contact_required","payment_basis","payment_min_party_size","questions","questions_revision"] |
booking_readiness |
object or null (fields) | No | required: ["ready","missing"] |
channel_push |
object or null (fields) | Yes | |
collections |
array of object (fields) | Yes | |
created_at |
string | Yes | |
description |
string | Yes | |
details |
object (fields) | Yes | additionalProperties: false |
gallery |
array of object (fields) | No | |
id |
string | Yes | |
image |
object or null (fields) | No | required: ["asset_id","kind","public_url","status"] |
kind |
string | Yes | enum: ["dish","experience","service","stay","table"] |
locations |
array of object (fields) | Yes | |
marketing_features |
array of string (fields) | No | |
metadata |
object | No | additionalProperties: {"type":"string"} |
name |
string | Yes | |
order_url |
string or null | No | |
page |
object or null (fields) | No | The source page this product owns, or null. Edit its content with the site-page tools; its binding is the page's product_id. required: ["id","path","title"] |
public_url |
string or null | No | |
publications |
array of object (fields) | Yes | |
slug |
string | Yes | |
source |
string | Yes | enum: ["manual","template","ai","import","copy"] |
stay |
object or null (fields) | No | Non-null exactly for a place to stay: its one location and stay settings (arrival, departure, guests, minimum nights, who looks after it, what it is and offers, its cancellation policies). Guest-facing house rules are the house_rules detail. Authored photo_rooms and listing accessibility are read-only here and use their stay operations. required: ["internal_name","location_id","check_in_time","check_in_end_time","check_out_time","max_guests","min_nights","calendar_rules","assigned_member_id","photo_rooms","accessibility","questions","questions_revision","property_type_group","property_type","listing_type","total_floors","listing_floor","year_built","property_size","property_size_unit","bedrooms","beds","bathrooms","amenities","amenity_answers","cancellation_policy","long_term_cancellation_policy"] |
tax_code |
string or null | No | |
unit_label |
string or null | No | |
updated_at |
string | Yes | |
variants |
array of object (fields) | Yes |
additionalProperties: false; required: ["id","kind","name","slug","description","active","variants","details","publications","locations","collections","source","created_at","updated_at","channel_push"]
object or null fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
member_id |
string | Yes | |
public_approved |
integer | Yes | 1 approves this authored profile for display as a host on public offerings; 0 withholds it. enum: [0,1] |
public_bio |
string or null | Yes | |
public_name |
string or null | Yes | |
public_photo_url |
string or null | Yes | |
updated_at |
string | Yes |
additionalProperties: false; required: ["member_id","updated_at","public_name","public_photo_url","public_bio","public_approved"]
array of object fields
Value: array of object.
Array items: object.
object or null fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
calendar_account_id |
string or null | Yes | |
calendar_conflict_count |
integer | Yes | |
calendar_conflicts |
array of object (fields) | Yes | |
calendar_ids |
array of string (fields) | Yes | |
calendar_status |
string | Yes | enum: ["internal","disconnected","ready"] |
member_id |
string | Yes | |
time_off |
array or null (fields) | Yes | |
timezone |
string or null | Yes | |
updated_at |
string | Yes | |
weekly |
array or null (fields) | Yes |
additionalProperties: false; required: ["member_id","timezone","updated_at","weekly","time_off","calendar_account_id","calendar_ids","calendar_status","calendar_conflict_count","calendar_conflicts"]
See schema fields
Value: See schema.
required: ["scheduling"]
See schema fields
Value: See schema.
required: ["members"]
array of string fields
Value: array of string.
maxItems: 10; uniqueItems: true
Array items: string.
See schema fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
account_id |
string | No | minLength: 1 |
See schema fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
account_id |
null | No | |
calendar_ids |
See schema | No | maxItems: 0 |
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
calendar_account_id |
string or null | Yes | |
calendar_conflict_count |
integer | Yes | |
calendar_ids |
array of string (fields) | Yes | |
calendar_status |
string | Yes | enum: ["internal","disconnected","ready"] |
member_id |
string | Yes | |
updated_at |
string | Yes |
additionalProperties: false; required: ["member_id","updated_at","calendar_account_id","calendar_ids","calendar_status","calendar_conflict_count"]
array of object fields
Value: array of object.
maxItems: 100
Array items: object.
array of object fields
Value: array of object.
maxItems: 28
Array items: object.
See schema fields
Value: See schema.
required: ["timezone"]
See schema fields
Value: See schema.
required: ["weekly"]
See schema fields
Value: See schema.
required: ["time_off"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
member_id |
string | Yes | |
time_off |
array or null (fields) | Yes | |
timezone |
string or null | Yes | |
updated_at |
string | Yes | |
weekly |
array or null (fields) | Yes |
additionalProperties: false; required: ["member_id","updated_at","timezone","weekly","time_off"]
See schema fields
Value: See schema.
required: ["public_name"]
See schema fields
Value: See schema.
required: ["public_photo_url"]
See schema fields
Value: See schema.
required: ["public_bio"]
See schema fields
Value: See schema.
required: ["public_approved"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
member_id |
string | Yes | |
public_approved |
integer | Yes | 1 approves this authored profile for display as a host on public offerings; 0 withholds it. enum: [0,1] |
public_bio |
string or null | Yes | |
public_name |
string or null | Yes | |
public_photo_url |
string or null | Yes | |
updated_at |
string | Yes |
additionalProperties: false; required: ["member_id","updated_at","public_name","public_photo_url","public_bio","public_approved"]
See schema fields
Value: See schema.
not: {"properties":{"location_id":{"type":"string"},"page_path":{"type":"string"}},"required":["location_id","page_path"]}
array of object fields
Value: array of object.
Array items: object.
array of object fields
Value: array of object.
minItems: 1
Array items: object.
See schema fields
Value: See schema.
required: ["question"]
See schema fields
Value: See schema.
required: ["answer"]
See schema fields
Value: See schema.
required: ["question_author"]
See schema fields
Value: See schema.
required: ["is_owner_answer"]
See schema fields
Value: See schema.
required: ["sort_order"]
array of object fields
Value: array of object.
Array items: object.
array of object fields
Value: array of object.
maxItems: 50; minItems: 1
Array items: object.
See schema fields
Value: See schema.
not: {"required":["new_room_type"]}; required: ["room_id"]
See schema fields
Value: See schema.
not: {"required":["room_id"]}; required: ["new_room_type"]
array of string fields
Value: array of string.
minItems: 1; uniqueItems: true
Array items: string.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
details_version |
integer | Yes | Revision of this room’s details. minimum: 1 |
id |
string | Yes | minLength: 1 |
photo_ids |
array of string (fields) | Yes | uniqueItems: true |
type |
string | Yes | enum: ["art_studio","backyard","balcony","bedroom","bowling_alley","childrens_playroom","courtyard","darkroom","deck","dining_area","event_room","exterior","front_yard","full_bathroom","full_kitchen","game_room","garage","garden","gym","half_bathroom","hot_tub","kitchenette","laundry_area","library","living_room","movie_theater","music_studio","office","patio","photography_studio","pool","porch","rooftop","sunroom","terrace","theme_room","wine_cellar","woodshop","workshop","workspace"] |
additionalProperties: false; required: ["id","type","photo_ids","details_version"]
array of object fields
Value: array of object.
Array items: object.
object or null fields
Value: object or null.
anyOf: shape 1, shape 2, shape 3.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
address |
object or null (fields) | Yes | The home's address: street, city, state, ISO country and postal code. Null only for a location saved without one. required: ["address","city","state","country","zip_code"] |
base_price_minor |
integer or null | Yes | |
calendar_rules |
object or null (fields) | Yes | Actual optional listing rules. Null removes them. Dated overrides take precedence over weekday minimums, then the required default. Friday/Saturday use the weekend price when supplied. additionalProperties: false |
cancellation_policy |
string or null | Yes | Policy shown to guests for stays under 28 nights. Null when the provider has not supplied one. New authored homes start on Flexible. It does not refund by itself. enum: ["flexible","moderate","limited","firm","strict",null] |
currency |
string | Yes | minLength: 1 |
internal_name |
string | Yes | minLength: 1 |
long_term_cancellation_policy |
string or null | Yes | Policy shown to guests for stays of 28 nights or more. Null when the provider has not supplied one. New authored homes start on Firm Long Term. enum: ["firm","strict",null] |
min_nights |
integer | Yes | |
name |
string | Yes | minLength: 1 |
product_id |
string | Yes | minLength: 1 |
timezone |
string | Yes | minLength: 1 |
additionalProperties: false; required: ["product_id","name","internal_name","timezone","currency","base_price_minor","min_nights","calendar_rules","address","cancellation_policy","long_term_cancellation_policy"]
array of object fields
Value: array of object.
Array items: object.
array of object fields
Value: array of object.
Array items: object.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
amount_minor |
integer | Yes | |
booking_id |
string | Yes | minLength: 1 |
created_at |
string | Yes | minLength: 1 |
currency |
string | Yes | minLength: 1 |
id |
string | Yes | minLength: 1 |
method |
string | Yes | enum: ["cash","bank_transfer","card_external","other"] |
note |
string or null | Yes | |
paid_on |
string | Yes | pattern: "^\d{4}-\d{2}-\d{2}$" |
reference |
string or null | Yes |
additionalProperties: false; required: ["id","booking_id","amount_minor","currency","method","paid_on","reference","note","created_at"]
array of integer fields
Value: array of integer.
maxItems: 7; minItems: 1; uniqueItems: true
Array items: integer.
See schema fields
Value: See schema.
not: {"required":["price_minor","price_change_percent"]}
See schema fields
Value: See schema.
not: {"properties":{"reset":{"const":true}},"required":["reset","price_change_percent"]}
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
available |
boolean or null | Yes | The host’s answer, without a review or approval status. Null clears the answer to unknown. |
feature |
string | Yes | enum: ["disabled_parking_spot","path_to_entrance_lit_at_night","home_step_free_access","home_wide_doorway","pool_hoist","ceiling_hoist"] |
photo_ids |
array of string (fields) | Yes | Same-organization active image asset IDs in canonical Product photo order. A true answer needs evidence; false/null requires []. Save appends selected library images to Product photos atomically, preserving existing cover/order without assigning a tour room. maxItems: 50; uniqueItems: true |
additionalProperties: false; required: ["feature","available","photo_ids"]
array of object fields
Value: array of object.
maxItems: 6; minItems: 6
Array items: object.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
available |
boolean or null | Yes | The host’s answer, without a review or approval status. Null clears the answer to unknown. |
feature |
string | Yes | enum: ["step_free_access","wide_doorway"] |
photo_ids |
array of string (fields) | Yes | Same-organization active image asset IDs in canonical Product photo order. A true answer needs evidence; false/null requires []. Save appends selected library images to Product photos atomically, preserving existing cover/order without assigning a tour room. maxItems: 50; uniqueItems: true |
additionalProperties: false; required: ["feature","available","photo_ids"]
array of string fields
Value: array of string.
uniqueItems: true
Array items: string.
array or null fields
Value: array or null.
maxItems: 14
Array items: object.
See schema fields
Value: See schema.
required: ["sleeping_arrangements"]
See schema fields
Value: See schema.
required: ["private_attached_bathroom"]
See schema fields
Value: See schema.
required: ["amenities"]
See schema fields
Value: See schema.
required: ["accessibility"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
accessibility |
array of object (fields) | Yes | Both bedroom features in catalog order, including unanswered null rows; [] for other room types. maxItems: 2 |
amenities |
array of string (fields) | Yes | Amenities assigned to this room, each once. uniqueItems: true |
details_version |
integer | Yes | Revision of this room’s details. minimum: 1 |
id |
string | Yes | minLength: 1 |
photo_ids |
array of string (fields) | Yes | uniqueItems: true |
private_attached_bathroom |
boolean or null | Yes | Whether this bedroom has a private attached bathroom. Null is unanswered. Only bedrooms may author this fact. |
sleeping_arrangements |
array or null (fields) | Yes | This room’s allocated beds. Null is unanswered; [] explicitly states none. maxItems: 14 |
type |
string | Yes | enum: ["art_studio","backyard","balcony","bedroom","bowling_alley","childrens_playroom","courtyard","darkroom","deck","dining_area","event_room","exterior","front_yard","full_bathroom","full_kitchen","game_room","garage","garden","gym","half_bathroom","hot_tub","kitchenette","laundry_area","library","living_room","movie_theater","music_studio","office","patio","photography_studio","pool","porch","rooftop","sunroom","terrace","theme_room","wine_cellar","woodshop","workshop","workspace"] |
additionalProperties: false; required: ["id","type","photo_ids","details_version","sleeping_arrangements","private_attached_bathroom","amenities","accessibility"]
array of object fields
Value: array of object.
Array items: object.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
action |
object or null | Yes | |
assignee |
object or null (fields) | Yes | |
booking_id |
string or null | Yes | |
can |
object (fields) | Yes | required: ["complete","skip","reopen","assign","edit"] |
conversation_id |
string or null | Yes | |
detail |
string or null | Yes | |
due_at |
string or null | Yes | |
error |
string or null | Yes | |
id |
string | Yes | |
image_url |
string or null | Yes | |
kind |
string | Yes | enum: ["turnover","message_delivery","booking_review","booking_change","custom","stay_ready","consultation_prep","consultation_follow_up"] |
location_id |
string or null | Yes | |
notes |
string or null | Yes | |
path |
string or null | Yes | |
person |
object or null (fields) | Yes | |
product_id |
string or null | Yes | |
product_session_id |
string | No | |
sheet |
object (fields) | Yes | required: ["heading","title","date"] |
starts_at |
string or null | Yes | |
status |
string | Yes | enum: ["open","done","skipped","cancelled"] |
status_line |
string or null | Yes | |
timezone |
string | Yes | |
title |
string | Yes | |
version |
integer | Yes | |
when |
string or null | Yes |
required: ["id","kind","status","version","image_url","status_line","title","when","detail","error","person","assignee","sheet","starts_at","due_at","timezone","notes","action","path","product_id","location_id","booking_id","conversation_id","can"]
array of object fields
Value: array of object.
Array items: object.
array of object fields
Value: array of object.
Array items: object.
array of object fields
Value: array of object.
Array items: object.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
label |
string | Yes | |
to |
string | Yes |
additionalProperties: false; required: ["label","to"]
null fields
Value: null.
object or null fields
Value: object or null.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
end_date |
string | Yes | pattern: "^\d{4}-\d{2}-\d{2}$" |
end_label |
string | Yes | |
start_date |
string | Yes | pattern: "^\d{4}-\d{2}-\d{2}$" |
start_label |
string | Yes |
additionalProperties: false; required: ["start_date","end_date","start_label","end_label"]
object fields
Value: object.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
chartable |
boolean | Yes | |
display |
string | Yes | |
key |
string | Yes | |
label |
string | Yes |
additionalProperties: false; required: ["key","label","display","chartable"]
array of object fields
Value: array of object.
Array items: object.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
end_date |
string | Yes | pattern: "^\d{4}-\d{2}-\d{2}$" |
name |
string | No | Names the range in the dateRange dimension GA4 adds when there is more than one. maxLength: 40 |
start_date |
string | Yes | pattern: "^\d{4}-\d{2}-\d{2}$" |
additionalProperties: false; required: ["start_date","end_date"]
string fields
Value: string.
pattern: "^[A-Za-z0-9_:]+$"
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
dimension |
string | Yes | pattern: "^[A-Za-z0-9_:]+$" |
match |
string | Yes | enum: ["EXACT","BEGINS_WITH","ENDS_WITH","CONTAINS","FULL_REGEXP"] |
value |
string | Yes | maxLength: 500 |
additionalProperties: false; required: ["dimension","match","value"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
dimensions |
object | Yes | additionalProperties: {"type":"string"} |
metrics |
object | Yes | additionalProperties: {"type":"number"} |
required: ["dimensions","metrics"]
string fields
Value: string.
enum: ["query","page","country","device","date","searchAppearance"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
dimension |
string | Yes | enum: ["query","page","country","device","searchAppearance"] |
expression |
string | Yes | maxLength: 4096 |
operator |
string | Yes | enum: ["equals","notEquals","contains","notContains","includingRegex","excludingRegex"] |
additionalProperties: false; required: ["dimension","operator","expression"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
clicks |
number | Yes | |
ctr |
number | Yes | Clicks per impression, 0 to 1. |
impressions |
number | Yes | |
keys |
object | Yes | additionalProperties: {"type":"string"} |
position |
number | Yes | Average position, 1 is the top. |
required: ["keys","clicks","impressions","ctr","position"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
#/$defs/content_heading or #/$defs/content_markdown or #/$defs/content_image or #/$defs/content_gallery or #/$defs/content_video or #/$defs/content_faq or #/$defs/content_how_to or #/$defs/content_divider or #/$defs/content_ai_assistance or #/$defs/content_cta or #/$defs/content_callout (fields) | Yes | |
id |
string | No | |
level |
number or null | No | |
media |
array of #/$defs/content_block_media (fields) | No | Required on image blocks: one item, the picture. A block read back keeps its media by sending it as read. |
parent_block_id |
string or null | No | |
source_block_id |
string or null | No | |
type |
string | Yes | enum: ["heading","markdown","image","gallery","video","faq","how_to","divider","ai_assistance","cta","callout"] |
updated_at |
string or null | No | As read. Ignored on a whole-document write. |
additionalProperties: false; required: ["type","data"]
anyOf: shape 1, shape 2, shape 3, shape 4, shape 5, shape 6, shape 7, shape 8, shape 9, shape 10, shape 11.
object or null fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
id |
string | Yes | |
name |
string | Yes | |
slug |
string | Yes |
additionalProperties: false; required: ["id","name","slug"]
array of object fields
Value: array of object.
Array items: object.
object or null fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
alt_text |
string or null | Yes | |
asset_id |
string | Yes | |
height |
number or null | Yes | |
kind |
string or null | Yes | |
public_url |
string or null | Yes | |
thumbnail_url |
string or null | Yes | |
width |
number or null | Yes |
additionalProperties: false; required: ["asset_id","public_url","thumbnail_url","kind","alt_text","width","height"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
admin_edit_url |
string or null | Yes | |
category |
object or null (fields) | Yes | additionalProperties: false; required: ["id","name","slug"] |
collection |
string | Yes | enum: ["blog","docs"] |
cover |
object or null (fields) | Yes | additionalProperties: false; required: ["asset_id","public_url","thumbnail_url","kind","alt_text","width","height"] |
created_at |
string | Yes | |
edit_url |
string or null | Yes | |
excerpt |
string or null | Yes | |
id |
string | Yes | |
preview_url |
string or null | Yes | |
public_path |
string or null | Yes | |
public_url |
string or null | Yes | |
published |
boolean | Yes | |
published_at |
string or null | Yes | |
seo_keywords |
string or null | Yes | |
slug |
string | Yes | |
sort_order |
integer | Yes | |
status |
string | Yes | enum: ["draft","published"] |
title |
string | Yes | |
updated_at |
string | Yes | |
view_url |
string or null | Yes | |
visibility |
string | Yes | enum: ["listed","unlisted"] |
additionalProperties: false; required: ["id","title","slug","excerpt","collection","category","sort_order","seo_keywords","published","published_at","status","visibility","created_at","updated_at","cover","admin_edit_url","edit_url","public_path","public_url","preview_url","view_url"]
string fields
Value: string.
string fields
Value: string.
minLength: 1
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
question_id |
string | Yes | |
value |
string or array of string or boolean (fields) | Yes |
additionalProperties: false; required: ["question_id","value"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
email |
string | Yes | minLength: 1 |
name |
string | Yes | minLength: 1 |
phone |
string or null | No |
required: ["name","email"]
object or null fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
external_reference |
string or null | Yes | |
guest_acknowledgement |
boolean | Yes | |
source |
string | Yes | minLength: 1 |
required: ["source","external_reference","guest_acknowledgement"]
object fields
Value: object.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
assigned_member_id |
string or null | Yes | |
booking_id |
string | Yes | minLength: 1 |
conversation_id |
string or null | Yes | |
ends_at |
string | Yes | minLength: 1 |
guest |
object or null (fields) | Yes | additionalProperties: false; required: ["name"] |
is_complete |
boolean | Yes | |
location_id |
string or null | Yes | |
party_size |
integer | Yes | |
product_id |
string | Yes | minLength: 1 |
product_kind |
string | Yes | What was booked: an experience, legal consultation, restaurant table or place to stay. enum: ["dish","experience","service","stay","table"] |
product_session_id |
string or null | Yes | The session a slot booking holds; null for a stay, which holds nights. |
product_variant_id |
string or null | Yes | |
provenance |
object or null (fields) | Yes | required: ["source","external_reference","guest_acknowledgement"] |
starts_at |
string | Yes | minLength: 1 |
status |
string | Yes | enum: ["pending","confirmed","cancelled"] |
timezone |
string | Yes | minLength: 1 |
unit |
string | Yes | What the booking holds: a session's places (slot) or a home's nights (nights). enum: ["slot","nights"] |
updated_at |
string | Yes | minLength: 1 |
version |
integer | Yes | The booking version from get_product_booking. A stale version is refused. minimum: 1 |
required: ["booking_id","conversation_id","product_id","product_kind","product_variant_id","product_session_id","unit","status","is_complete","party_size","version","updated_at","assigned_member_id","location_id","starts_at","ends_at","timezone","guest","provenance"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
text |
string | Yes |
additionalProperties: false; required: ["text"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
editor_mode |
string | Yes | enum: ["rich","source"] |
markdown |
string | Yes | Markdown. |
title |
string or null | No |
additionalProperties: false; required: ["markdown","editor_mode"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
caption |
string or null | No |
additionalProperties: false; required: []
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
caption |
string or null | No |
additionalProperties: false; required: []
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
caption |
string or null | No | |
title |
string | Yes | |
upload_date |
string or null | No | |
url |
string | Yes |
additionalProperties: false; required: ["url","title"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
items |
array of object (fields) | No | |
source |
string | Yes | enum: ["page_qa","organization_qa"] |
title |
string or null | No |
additionalProperties: false; required: ["source"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
description |
string or null | No | |
estimated_time |
string or null | No | |
label |
string or null | No | |
steps |
array of object (fields) | Yes | minItems: 1 |
supply_items |
array of string (fields) | No | |
title |
string or null | No | |
tool_items |
array of string (fields) | No |
additionalProperties: false; required: ["steps"]
object fields
Value: object.
additionalProperties: false; required: []
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
accent |
string or null | No | |
description |
string or null | No | |
label |
string or null | No | |
layout |
string or null | No | enum: ["centered","compact",null] |
secondary_label |
string or null | No | |
secondary_url |
string or null | No | |
status |
string or null | No | enum: ["active","hidden",null] |
title |
string or null | No | |
url |
string or null | No |
additionalProperties: false; required: []
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
accent |
string or null | No | |
description |
string or null | No | |
label |
string or null | No | |
layout |
string or null | No | enum: ["centered","compact",null] |
secondary_label |
string or null | No | |
secondary_url |
string or null | No | |
title |
string or null | No | |
url |
string or null | No |
additionalProperties: false; required: []
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
accent |
string or null | No | |
description |
string or null | No | |
label |
string or null | No | |
layout |
string or null | No | enum: ["centered","compact",null] |
notice |
string or null | No | |
price_line |
string or null | No | |
secondary_label |
string or null | No | |
secondary_url |
string or null | No | |
title |
string or null | No | |
url |
string or null | No |
additionalProperties: false; required: []
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
badge |
string or null | No | |
body |
string or null | No | |
buttons |
array of object (fields) | No | |
items |
array of object (fields) | No | |
title |
string or null | No | |
tone |
string or null | No | enum: ["neutral","info","success","warning","danger",null] |
additionalProperties: false; required: []
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
accent |
string or null | No | |
caption |
string or null | No | |
cta_label |
string or null | No | |
cta_url |
string or null | No | |
eyebrow |
string or null | No | |
image_position |
string or null | No | enum: ["top","center","bottom",null] |
image_ratio |
string or null | No | enum: ["original","portrait","square","landscape",null] |
rotating_accents |
array of string (fields) | No | |
secondary_label |
string or null | No | |
secondary_url |
string or null | No | |
subtitle |
string or null | No | |
title |
string | Yes |
additionalProperties: false; required: ["title"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
buttons |
array of object (fields) | No | |
layout |
string or null | No | enum: ["buttons","links",null] |
additionalProperties: false; required: []
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
calculator |
object (fields) | No | |
cta_label |
string or null | No | |
cta_url |
string or null | No | |
description |
string or null | No | |
eyebrow |
string or null | No | |
items |
array of object (fields) | No | |
layout |
string or null | No | enum: ["cards","pictures","columns","strip",null] |
limit |
integer | No | minimum: 1 |
source |
string or null | No | enum: ["manual","organization_posts","calculator","billing_plans","billing_features",null] |
title |
string or null | No | |
title_muted |
string or null | No |
additionalProperties: false; required: []
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
description |
string or null | No | |
problem_items |
array of object (fields) | No | |
problem_label |
string or null | No | |
problem_title |
string or null | No | |
solution_items |
array of object (fields) | No | |
solution_label |
string or null | No | |
solution_title |
string or null | No | |
title |
string or null | No |
additionalProperties: false; required: []
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
description |
string or null | No | |
items |
array of object (fields) | No | |
label |
string or null | No | |
title |
string or null | No |
additionalProperties: false; required: []
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
cta_label |
string or null | No | |
cta_url |
string or null | No | |
description |
string or null | No | |
items |
array of object (fields) | No | |
label |
string or null | No | |
prompt_heading |
string or null | No | |
title |
string or null | No |
additionalProperties: false; required: []
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
items |
array of object (fields) | No |
additionalProperties: false; required: []
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
description |
string or null | No | |
items |
array of object (fields) | No | |
pin_label |
string or null | No | |
subtitle |
string or null | No | |
title |
string or null | No |
additionalProperties: false; required: []
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
cta_label |
string or null | No | |
cta_url |
string or null | No | |
items |
array of object (fields) | No | |
title |
string or null | No |
additionalProperties: false; required: []
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
description |
string or null | No | |
items |
array of object (fields) | No | |
title |
string or null | No | |
upload_date |
string or null | No | |
video_title |
string or null | No | |
video_url |
string or null | No |
additionalProperties: false; required: []
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
body |
string or null | No | |
caption |
string or null | No | |
example_type |
string or null | No | enum: ["websites","posts","app_screens",null] |
eyebrow |
string or null | No | |
image_position |
string or null | No | enum: ["top","center","bottom",null] |
image_ratio |
string or null | No | enum: ["original","portrait","square","landscape",null] |
items |
array of object (fields) | No | |
label |
string or null | No | |
layout |
string or null | No | enum: ["standard","editorial",null] |
title |
string or null | No | |
tone |
string or null | No | enum: ["light","dark",null] |
url |
string or null | No |
additionalProperties: false; required: []
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
booking_label |
string or null | No | |
booking_product_id |
string or null | No | |
description |
string or null | No | |
title |
string or null | No |
additionalProperties: false; required: []
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
description |
string or null | No | |
items |
array of object (fields) | No | |
title |
string or null | No |
additionalProperties: false; required: []
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
description |
string or null | No | |
title |
string or null | No |
additionalProperties: false; required: []
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
description |
string or null | No | |
destination |
string or null | No | |
tiers |
array of object (fields) | No | |
title |
string or null | No |
additionalProperties: false; required: []
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
accent |
string or null | No | |
description |
string or null | No | |
page_ids |
array of string (fields) | Yes | minItems: 1; uniqueItems: true |
title |
string or null | No |
additionalProperties: false; required: ["page_ids"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
collection_id |
string or null | No | |
description |
string or null | No | |
product_ids |
array of string (fields) | No | uniqueItems: true |
title |
string or null | No |
additionalProperties: false; required: []
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
description |
string or null | No | |
location_ids |
array of string (fields) | No | uniqueItems: true |
title |
string or null | No |
additionalProperties: false; required: []
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
call_to_action |
object (fields) | No | additionalProperties: false; required: [] |
description |
string or null | No | |
limit |
integer | No | maximum: 12; minimum: 1 |
location_id |
string or null | No | |
title |
string or null | No |
additionalProperties: false; required: []
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
intro |
string or null | No | |
label |
string or null | No | |
prompts |
array of object (fields) | No |
additionalProperties: false; required: []
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
alt_text |
string or null | No | |
asset_id |
string | Yes | |
file_name |
string or null | No | |
height |
number or null | No | |
kind |
string or null | No | |
public_url |
string or null | No | |
slot |
string (fields) | Yes | |
sort_order |
number or null | No | |
thumbnail_url |
string or null | No | |
width |
number or null | No |
additionalProperties: false; required: ["asset_id","slot"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
text |
string | Yes |
additionalProperties: false; required: ["text"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
editor_mode |
string | Yes | enum: ["rich","source"] |
markdown |
string | Yes | Markdown. |
title |
string or null | No |
additionalProperties: false; required: ["markdown","editor_mode"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
caption |
string or null | No |
additionalProperties: false; required: []
array of #/$defs/content_block_media fields
Value: array of #/$defs/content_block_media.
maxItems: 1; minItems: 1
Array items: #/$defs/content_block_media.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
caption |
string or null | No | |
title |
string | Yes | |
upload_date |
string or null | No | |
url |
string | Yes |
additionalProperties: false; required: ["url","title"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
items |
array of object (fields) | No | |
source |
string | Yes | enum: ["page_qa","organization_qa"] |
title |
string or null | No |
additionalProperties: false; required: ["source"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
description |
string or null | No | |
estimated_time |
string or null | No | |
label |
string or null | No | |
steps |
array of object (fields) | Yes | minItems: 1 |
supply_items |
array of string (fields) | No | |
title |
string or null | No | |
tool_items |
array of string (fields) | No |
additionalProperties: false; required: ["steps"]
object fields
Value: object.
additionalProperties: false; required: []
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
accent |
string or null | No | |
description |
string or null | No | |
label |
string or null | No | |
layout |
string or null | No | enum: ["centered","compact",null] |
secondary_label |
string or null | No | |
secondary_url |
string or null | No | |
status |
string or null | No | enum: ["active","hidden",null] |
title |
string or null | No | |
url |
string or null | No |
additionalProperties: false; required: []
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
accent |
string or null | No | |
description |
string or null | No | |
label |
string or null | No | |
layout |
string or null | No | enum: ["centered","compact",null] |
secondary_label |
string or null | No | |
secondary_url |
string or null | No | |
title |
string or null | No | |
url |
string or null | No |
additionalProperties: false; required: []
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
accent |
string or null | No | |
description |
string or null | No | |
label |
string or null | No | |
layout |
string or null | No | enum: ["centered","compact",null] |
notice |
string or null | No | |
price_line |
string or null | No | |
secondary_label |
string or null | No | |
secondary_url |
string or null | No | |
title |
string or null | No | |
url |
string or null | No |
additionalProperties: false; required: []
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
badge |
string or null | No | |
body |
string or null | No | |
buttons |
array of object (fields) | No | |
items |
array of object (fields) | No | |
title |
string or null | No | |
tone |
string or null | No | enum: ["neutral","info","success","warning","danger",null] |
additionalProperties: false; required: []
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
accent |
string or null | No | |
caption |
string or null | No | |
cta_label |
string or null | No | |
cta_url |
string or null | No | |
eyebrow |
string or null | No | |
image_position |
string or null | No | enum: ["top","center","bottom",null] |
image_ratio |
string or null | No | enum: ["original","portrait","square","landscape",null] |
rotating_accents |
array of string (fields) | No | |
secondary_label |
string or null | No | |
secondary_url |
string or null | No | |
subtitle |
string or null | No | |
title |
string | Yes |
additionalProperties: false; required: ["title"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
buttons |
array of object (fields) | No | |
layout |
string or null | No | enum: ["buttons","links",null] |
additionalProperties: false; required: []
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
calculator |
object (fields) | No | |
cta_label |
string or null | No | |
cta_url |
string or null | No | |
description |
string or null | No | |
eyebrow |
string or null | No | |
items |
array of object (fields) | No | |
layout |
string or null | No | enum: ["cards","pictures","columns","strip",null] |
limit |
integer | No | minimum: 1 |
source |
string or null | No | enum: ["manual","organization_posts","calculator","billing_plans","billing_features",null] |
title |
string or null | No | |
title_muted |
string or null | No |
additionalProperties: false; required: []
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
description |
string or null | No | |
problem_items |
array of object (fields) | No | |
problem_label |
string or null | No | |
problem_title |
string or null | No | |
solution_items |
array of object (fields) | No | |
solution_label |
string or null | No | |
solution_title |
string or null | No | |
title |
string or null | No |
additionalProperties: false; required: []
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
description |
string or null | No | |
items |
array of object (fields) | No | |
label |
string or null | No | |
title |
string or null | No |
additionalProperties: false; required: []
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
cta_label |
string or null | No | |
cta_url |
string or null | No | |
description |
string or null | No | |
items |
array of object (fields) | No | |
label |
string or null | No | |
prompt_heading |
string or null | No | |
title |
string or null | No |
additionalProperties: false; required: []
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
items |
array of object (fields) | No |
additionalProperties: false; required: []
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
description |
string or null | No | |
items |
array of object (fields) | No | |
pin_label |
string or null | No | |
subtitle |
string or null | No | |
title |
string or null | No |
additionalProperties: false; required: []
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
cta_label |
string or null | No | |
cta_url |
string or null | No | |
items |
array of object (fields) | No | |
title |
string or null | No |
additionalProperties: false; required: []
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
description |
string or null | No | |
items |
array of object (fields) | No | |
title |
string or null | No | |
upload_date |
string or null | No | |
video_title |
string or null | No | |
video_url |
string or null | No |
additionalProperties: false; required: []
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
body |
string or null | No | |
caption |
string or null | No | |
example_type |
string or null | No | enum: ["websites","posts","app_screens",null] |
eyebrow |
string or null | No | |
image_position |
string or null | No | enum: ["top","center","bottom",null] |
image_ratio |
string or null | No | enum: ["original","portrait","square","landscape",null] |
items |
array of object (fields) | No | |
label |
string or null | No | |
layout |
string or null | No | enum: ["standard","editorial",null] |
title |
string or null | No | |
tone |
string or null | No | enum: ["light","dark",null] |
url |
string or null | No |
additionalProperties: false; required: []
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
booking_label |
string or null | No | |
booking_product_id |
string or null | No | |
description |
string or null | No | |
title |
string or null | No |
additionalProperties: false; required: []
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
description |
string or null | No | |
items |
array of object (fields) | No | |
title |
string or null | No |
additionalProperties: false; required: []
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
description |
string or null | No | |
title |
string or null | No |
additionalProperties: false; required: []
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
description |
string or null | No | |
destination |
string or null | No | |
tiers |
array of object (fields) | No | |
title |
string or null | No |
additionalProperties: false; required: []
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
accent |
string or null | No | |
description |
string or null | No | |
page_ids |
array of string (fields) | Yes | minItems: 1; uniqueItems: true |
title |
string or null | No |
additionalProperties: false; required: ["page_ids"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
collection_id |
string or null | No | |
description |
string or null | No | |
product_ids |
array of string (fields) | No | uniqueItems: true |
title |
string or null | No |
additionalProperties: false; required: []
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
description |
string or null | No | |
location_ids |
array of string (fields) | No | uniqueItems: true |
title |
string or null | No |
additionalProperties: false; required: []
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
call_to_action |
object (fields) | No | additionalProperties: false; required: [] |
description |
string or null | No | |
limit |
integer | No | maximum: 12; minimum: 1 |
location_id |
string or null | No | |
title |
string or null | No |
additionalProperties: false; required: []
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
intro |
string or null | No | |
label |
string or null | No | |
prompts |
array of object (fields) | No |
additionalProperties: false; required: []
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object | Yes | |
id |
string | Yes | |
level |
number or null | Yes | |
media |
array of #/$defs/content_block_media (fields) | Yes | |
parent_block_id |
string or null | Yes | |
position |
integer | No | |
source_block_id |
string or null | No | |
type |
string | Yes | enum: ["heading","markdown","image","gallery","video","faq","how_to","divider","cta","contact_cta","booking_cta","callout","hero","button_group","feature_grid","comparison","stat_grid","workflow_grid","showcase","language_reach","steps","video_feature","media_text","contact_form","team_grid","testimonial_grid","donation_choices","page_grid","product_grid","location_grid","social_posts","ai_assistance"] |
updated_at |
string | Yes | The block's own concurrency token, for replace_content_block and delete_content_block. |
additionalProperties: false; required: ["id","parent_block_id","type","level","data","media","updated_at"]
anyOf: shape 1, shape 2, shape 3, shape 4, shape 5, shape 6, shape 7, shape 8, shape 9, shape 10, shape 11, shape 12, shape 13, shape 14, shape 15, shape 16, shape 17, shape 18, shape 19, shape 20, shape 21, shape 22, shape 23, shape 24, shape 25, shape 26, shape 27, shape 28, shape 29, shape 30, shape 31, shape 32.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
#/$defs/content_heading or #/$defs/content_markdown or #/$defs/content_image or #/$defs/content_gallery or #/$defs/content_video or #/$defs/content_faq or #/$defs/content_how_to or #/$defs/content_divider or #/$defs/content_cta or #/$defs/content_contact_cta or #/$defs/content_booking_cta or #/$defs/content_callout or #/$defs/content_hero or #/$defs/content_button_group or #/$defs/content_feature_grid or #/$defs/content_comparison or #/$defs/content_stat_grid or #/$defs/content_workflow_grid or #/$defs/content_showcase or #/$defs/content_language_reach or #/$defs/content_steps or #/$defs/content_video_feature or #/$defs/content_media_text or #/$defs/content_contact_form or #/$defs/content_team_grid or #/$defs/content_testimonial_grid or #/$defs/content_donation_choices or #/$defs/content_page_grid or #/$defs/content_product_grid or #/$defs/content_location_grid or #/$defs/content_social_posts or #/$defs/content_ai_assistance (fields) | Yes | |
id |
string | No | |
level |
integer or null | No | maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | No | |
parent_block_id |
string or null | No | |
source_block_id |
string or null | No | |
type |
string | Yes | enum: ["heading","markdown","image","gallery","video","faq","how_to","divider","cta","contact_cta","booking_cta","callout","hero","button_group","feature_grid","comparison","stat_grid","workflow_grid","showcase","language_reach","steps","video_feature","media_text","contact_form","team_grid","testimonial_grid","donation_choices","page_grid","product_grid","location_grid","social_posts","ai_assistance"] |
updated_at |
string or null | No | As read. Ignored on a whole-document write. |
additionalProperties: false; required: ["type","data"]
anyOf: shape 1, shape 2, shape 3, shape 4, shape 5, shape 6, shape 7, shape 8, shape 9, shape 10, shape 11, shape 12, shape 13, shape 14, shape 15, shape 16, shape 17, shape 18, shape 19, shape 20, shape 21, shape 22, shape 23, shape 24, shape 25, shape 26, shape 27, shape 28, shape 29, shape 30, shape 31, shape 32.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
id |
string | Yes | minLength: 1 |
updated_at |
string | Yes | minLength: 1 |
required: ["id","updated_at"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
path |
string | Yes | |
public_url |
string or null | Yes | |
recipe |
string or null | Yes |
required: ["path","recipe","public_url"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
admin_edit_url |
string or null | Yes | |
id |
string | Yes | minLength: 1 |
locale |
string | Yes | minLength: 1 |
page_id |
string | Yes | minLength: 1 |
page_type |
string | Yes | enum: ["custom","recipe","legal","system"] |
path |
string | Yes | |
product_id |
string or null | Yes | |
recipe |
string or null | Yes | |
removable |
boolean | Yes | |
sort_order |
number | Yes | |
title |
string | Yes | |
updated_at |
string | Yes | minLength: 1 |
additionalProperties: false; required: ["id","page_id","locale","path","title","page_type","recipe","sort_order","updated_at","product_id","removable","admin_edit_url"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
active |
boolean | Yes | True when this is the currently active MCP location context. |
id |
string | Yes | |
place_name |
string or null | No | The neighbourhood this location's address names, or its town. Derived from the address; call get_location for the address itself. |
slug |
string | Yes | |
status |
string | Yes | |
title |
string | Yes |
required: ["id","slug","title","status","active"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
active |
boolean | Yes | True when this is the currently active MCP organization context. |
id |
string | Yes | |
name |
string or null | No | |
slug |
string or null | No |
required: ["id","active"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
can_invite_guest |
boolean | Yes | |
can_leave |
boolean | Yes | |
can_manage_participants |
boolean | Yes |
required: ["can_manage_participants","can_invite_guest","can_leave"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
booking_id |
string or null | Yes | |
composer |
object (fields) | Yes | required: ["channel"] |
id |
string | Yes | |
kind |
string | Yes | enum: ["guest","support","team"] |
organization_id |
string | Yes | |
participants |
array of See schema | Yes | |
title |
string | Yes |
required: ["id","organization_id","title","kind","participants","composer","booking_id"]
array of object fields
Value: array of object.
Array items: object.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
before |
integer or null | Yes | minimum: 1 |
newest |
integer or null | Yes | minimum: 1 |
oldest |
integer or null | Yes | minimum: 1 |
read_through |
integer or null | Yes | minimum: 1 |
required: ["before","oldest","newest","read_through"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
email |
string | Yes | |
id |
string | Yes | |
image |
string or null | Yes | |
member_id |
string | Yes | |
name |
string | Yes | |
role |
string | Yes |
required: ["id","member_id","name","image","email","role"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
channel |
string | Yes | enum: ["airbnb","direct"] |
conversation_id |
string | Yes | |
home |
string or null | Yes | |
kind |
string | Yes | guest: a contact or a booking’s guest; support: Airbnb Support; team: members of this business. enum: ["guest","support","team"] |
preview |
string | Yes | |
preview_from |
string or null | Yes | |
time |
string | Yes | |
title |
string | Yes | Who the conversation is with: the guest, Airbnb Support, or the team conversation’s name or people. |
unread |
boolean | Yes | A message from someone else you have not read, as Messages shows it. |
when |
string or null | Yes |
additionalProperties: false; required: ["conversation_id","kind","title","channel","home","when","preview","preview_from","time","unread"]
string fields
Value: string.
maxLength: 90; minLength: 1
string fields
Value: string.
maxLength: 30; minLength: 1
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
match_type |
string | No | enum: ["EXACT","PHRASE","BROAD"] |
text |
string | Yes | minLength: 1 |
required: ["text"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
id |
string | Yes | |
name |
string | Yes | |
status |
string | Yes |
required: ["id","name","status"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
matchType |
string | Yes | |
negative |
boolean | Yes | |
status |
string or null | Yes | |
text |
string | Yes |
required: ["text","matchType","status","negative"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
budgetAmountMicros |
number | Yes | |
budgetId |
string or null | No | |
channelType |
string | Yes | |
clicks |
number | Yes | |
conversions |
number | Yes | |
costMicros |
number | Yes | |
id |
string | Yes | |
impressions |
number | Yes | |
name |
string | Yes | |
status |
string | Yes |
required: ["id","name","status","channelType","budgetAmountMicros","clicks","impressions","costMicros","conversions"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
adGroupId |
string or null | Yes | |
campaignId |
string or null | Yes | |
campaignName |
string or null | Yes | |
clicks |
number | Yes | |
conversions |
number | Yes | |
conversionsValue |
number | Yes | |
costMicros |
number | Yes | |
date |
string or null | Yes | campaign_daily: the day. |
detail |
string or null | Yes | keywords: match type; search_terms: whether the term was added or excluded; geography: physical presence or area of interest. |
impressions |
number | Yes | |
text |
string | Yes | The campaign, search term, keyword, landing page URL or country. |
required: ["text","detail","date","campaignId","campaignName","adGroupId","impressions","clicks","costMicros","conversions","conversionsValue"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
delay_minutes |
number | Yes | const: 5 |
product_ids |
array of string (fields) | Yes | The offerings whose bookings get this message. maxItems: 100; minItems: 1; uniqueItems: true |
trigger |
string | Yes | const: "booking_received" |
additionalProperties: false; required: ["trigger","delay_minutes","product_ids"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
local_time |
string | Yes | pattern: "^([01]\d|2[0-3]):[0-5]\d$" |
offset_days |
integer | Yes | maximum: 7; minimum: -7 |
product_ids |
array of string (fields) | Yes | The offerings whose bookings get this message. maxItems: 100; minItems: 1; uniqueItems: true |
trigger |
string | Yes | check_in is when the booking starts: a stay’s check-in, or a consultation’s, class’s or table booking’s start time. check_out is when it ends. enum: ["check_in","check_out"] |
additionalProperties: false; required: ["trigger","offset_days","local_time","product_ids"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
offset_hours |
integer | Yes | maximum: 72; minimum: -72 |
product_ids |
array of string (fields) | Yes | The offerings whose bookings get this message. maxItems: 100; minItems: 1; uniqueItems: true |
trigger |
string | Yes | check_in is when the booking starts: a stay’s check-in, or a consultation’s, class’s or table booking’s start time. check_out is when it ends. enum: ["check_in","check_out"] |
additionalProperties: false; required: ["trigger","offset_hours","product_ids"]
array or null fields
Value: array or null.
Array items: object.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
details |
string or null | Yes | Required for additional. maxLength: 500; minLength: 1 |
task |
string | Yes | enum: ["gather_towels","throw_trash","turn_off","lock_up","return_keys","additional"] |
additionalProperties: false; required: ["task","details"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
airbnb_url |
string | Yes | format: "uri" |
field |
string | Yes | minLength: 1 |
additionalProperties: false; required: ["field","airbnb_url"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
detail |
null | Yes | |
state |
string | Yes | const: "pushed" |
required: ["state","detail"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
detail |
string | Yes | minLength: 1 |
state |
string | Yes | const: "pending" |
required: ["state","detail"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
created_at |
string | Yes | |
id |
string | Yes | |
is_source |
boolean | Yes | |
label |
string or null | Yes | |
locale |
string | Yes | |
organization_id |
string | Yes | |
status |
string | Yes | enum: ["published","disabled"] |
updated_at |
string | Yes |
additionalProperties: false; required: ["id","organization_id","locale","label","is_source","status","created_at","updated_at"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
id |
string | Yes | |
localization |
object or null (fields) | Yes | additionalProperties: false; required: ["values"] |
location_id |
string or null | Yes | |
source |
object (fields) | Yes | additionalProperties: false; required: ["name","description"] |
additionalProperties: false; required: ["id","location_id","source","localization"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
id |
string | Yes | |
kind |
string | Yes | enum: ["dish","experience","service","stay","table"] |
localization |
object or null (fields) | Yes | additionalProperties: false; required: ["values","route_path"] |
source |
object (fields) | Yes | additionalProperties: false; required: ["name","description","marketing_features","unit_label","details"] |
additionalProperties: false; required: ["id","kind","source","localization"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
created_at |
string | Yes | |
created_by_user_id |
string | Yes | |
id |
string | Yes | |
locale |
string | Yes | |
organization_id |
string | Yes | |
resource_id |
string | Yes | |
resource_type |
string | Yes | enum: ["organization","business_location","product","collection","article_category","media_asset"] |
route_path |
string or null | Yes | |
updated_at |
string | Yes | |
updated_by_user_id |
string | Yes | |
values |
object | Yes |
additionalProperties: false; required: ["id","organization_id","locale","created_at","updated_at","resource_type","resource_id","values","route_path","created_by_user_id","updated_by_user_id"]
anyOf: shape 1, shape 2, shape 3, shape 4, shape 5, shape 6.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
content_blocks |
array of object (fields) | Yes | |
created_at |
string | Yes | |
id |
string | Yes | |
kind |
string | Yes | enum: ["page","article","social_post","qa"] |
locale |
string | Yes | |
metadata |
object | Yes | additionalProperties: true |
organization_id |
string | Yes | |
path |
string or null | Yes | |
root_id |
string | Yes | |
row_role |
string | Yes | const: "representation" |
seo_keywords |
string or null | Yes | |
slug |
string or null | Yes | |
summary |
string or null | Yes | |
title |
string or null | Yes | |
updated_at |
string | Yes |
additionalProperties: false; required: ["id","organization_id","locale","created_at","updated_at","kind","row_role","root_id","title","summary","slug","path","seo_keywords","metadata","content_blocks"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
addressLines |
array of string (fields) | No | |
administrativeArea |
string | No | |
locality |
string | No | |
sublocality |
string | No |
additionalProperties: false
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
disclaimer |
string | No | |
footer_disclaimer |
string | No | |
service_area |
string | No |
additionalProperties: false
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
cta_label |
string | No |
additionalProperties: false
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
allergens |
array of string (fields) | No | Allergens the merchant states this dish contains. maxItems: 100; uniqueItems: true |
carbon_monoxide_detector_details |
string | No | Share where each carbon monoxide alarm is located. maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
climbing_structures_details |
string | No | Host-authored details about climbing or play structures. Requires its disclosure to be Yes. maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
dangerous_animals_details |
string | No | Host-authored details about potentially dangerous animals. Requires its disclosure to be Yes. maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
dietary_notes |
array of string (fields) | No | Merchant-stated dietary facts displayed with a dish. maxItems: 100; uniqueItems: true |
exterior_security_cameras_details |
string | No | Host-authored details about exterior security cameras. Requires its disclosure to be Yes. maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
getting_around |
string | No | Host-authored transport and getting-around information for this home. maxLength: 10000; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
guest_access |
string | No | The spaces and facilities guests can use during their stay. maxLength: 10000; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
house_rules |
string | No | The host’s rules for guests staying in the home, shown with the listing. maxLength: 10000; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
included_items |
array of string (fields) | No | Items or work included in the stated price, shown in their own public section. maxItems: 100; uniqueItems: true |
ingredients |
array of string (fields) | No | Ingredients shown in the dish details. maxItems: 100; uniqueItems: true |
interaction_with_guests |
string | No | How guests can contact the host and what support is available. maxLength: 10000; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
limited_essentials_details |
string | No | Host-authored details about limited essential amenities. Requires its disclosure to be Yes. maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
meeting_point |
string | No | Instructions shown in the meeting section; meeting mode and video links are set in scheduling. maxLength: 10000; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
nearby_water_details |
string | No | Host-authored details about nearby water. Requires its disclosure to be Yes. maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
neighborhood_description |
string | No | Host-authored information about the neighborhood around this home. maxLength: 10000; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
no_property_parking_details |
string | No | Host-authored details about no parking on the property. Requires its disclosure to be Yes. maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
noise_decibel_monitors_details |
string | No | Host-authored details about noise decibel monitors. Requires its disclosure to be Yes. maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
noodle |
array of string (fields) | No | Authored noodle information shown as dish facts; these do not establish purchasable variants. maxItems: 100; uniqueItems: true |
other_details_to_note |
string | No | Additional information guests should know before booking. maxLength: 10000; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
potential_noise_details |
string | No | Host-authored details about potential noise during stays. Requires its disclosure to be Yes. maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
preparation |
string | No | Preparation instructions shown to customers before a session or appointment. maxLength: 10000; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
pricing_note |
string | No | An explicitly stated price such as Market price; use only when no numeric price is set. maxLength: 1000; minLength: 1; pattern: "^(?=[\s\S]\S)[^\r\n]$" |
resident_pets_details |
string | No | Host-authored details about pets live on the property. Requires its disclosure to be Yes. maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
shared_spaces_details |
string | No | Host-authored details about shared spaces. Requires its disclosure to be Yes. maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
sizes |
array of string (fields) | No | Authored serving information; priced choices belong in variants. maxItems: 100; uniqueItems: true |
smoke_detector_details |
string | No | Share where each smoke alarm is located. maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
soup |
array of string (fields) | No | Authored soup information shown with the dish. maxItems: 100; uniqueItems: true |
special_safety_considerations |
string | No | Other property features that guests should know could be unsafe, and why. maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
stairs_required_details |
string | No | Host-authored details about guests must climb stairs. Requires its disclosure to be Yes. maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
tagline |
string | No | A short sentence shown below the product title. maxLength: 1000; minLength: 1; pattern: "^(?=[\s\S]\S)[^\r\n]$" |
toppings |
array of string (fields) | No | Authored topping information; priced choices belong in variants. maxItems: 100; uniqueItems: true |
unprotected_heights_details |
string | No | Host-authored details about unprotected heights. Requires its disclosure to be Yes. maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
unsecured_pool_details |
string | No | Host-authored details about unsecured pool or hot tub. Requires its disclosure to be Yes. maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
weapons_on_property_details |
string | No | Host-authored details about weapons on the property. Requires its disclosure to be Yes. maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
what_to_bring |
array of string (fields) | No | Items customers should bring, shown in the preparation section. maxItems: 100; uniqueItems: true |
your_property |
string | No | The spaces and features guests should know about this home. maxLength: 10000; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
additionalProperties: false
array of string fields
Value: array of string.
Array items: string.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
call_to_action |
object (fields) | No | additionalProperties: false; required: ["label"] |
additionalProperties: false
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
brand_description |
string | No | |
compliance |
object (fields) | No | additionalProperties: false |
consultation |
object (fields) | No | additionalProperties: false |
inquiry_questions |
object | No | Translated question wording keyed by question ID: { label?, help_text?, choices?: { |
name |
string | No | |
seo_description |
string | No | |
seo_title |
string | No |
additionalProperties: false
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
address |
object (fields) | No | additionalProperties: false |
description |
string | No | |
seo_description |
string | No | |
seo_title |
string | No | |
short_description |
string | No | |
title |
string | No |
additionalProperties: false
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
description |
string | No | |
details |
object (fields) | No | additionalProperties: false |
marketing_features |
array of string (fields) | No | |
name |
string | No | |
questions |
object | No | Translated question wording keyed by question ID: { label?, help_text?, choices?: { |
unit_label |
string | No |
additionalProperties: false
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
description |
string | No | |
name |
string | No |
additionalProperties: false
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
alt_text |
string | No |
additionalProperties: false
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
metadata |
object (fields) | No | additionalProperties: false |
seo_keywords |
string or null | No | |
summary |
string or null | No | |
title |
string or null | No |
additionalProperties: false
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
resource_id |
string | Yes | |
route_path |
null | No | |
values |
object (fields) | Yes | additionalProperties: false |
additionalProperties: false; required: ["resource_id","values"]
array of See schema fields
Value: array of See schema.
Array items: See schema.
array of See schema fields
Value: array of See schema.
Array items: See schema.
array of See schema fields
Value: array of See schema.
Array items: See schema.
array of See schema fields
Value: array of See schema.
Array items: See schema.
array of See schema fields
Value: array of See schema.
Array items: See schema.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
assigned_member_id |
string or null | No | |
assigned_member_name |
string or null | No | |
booking_id |
string or null | Yes | The booking to read with get_product_booking. A stay may have a row for its arrival and for its departure. |
conversation_id |
string or null | Yes | |
day_key |
string | Yes | |
ends_at |
string or null | Yes | |
guest_image_url |
string or null | No | |
id |
string | Yes | |
kind |
string | Yes | enum: ["booking","post","stay"] |
location_id |
string or null | Yes | |
location_title |
string or null | No | |
name |
string or null | No | |
organization_id |
string | Yes | |
party_size |
integer or null | Yes | |
product_id |
string or null | Yes | |
resource_image_url |
string or null | No | |
show_time_zone |
boolean | No | |
starts_at |
string | Yes | |
status |
string | Yes | |
stay_channel |
string or null | Yes | enum: ["airbnb","vrbo","booking_com","direct",null] |
stay_moment |
string or null | Yes | enum: ["arrival","departure","turnover","current",null] |
subtitle |
string or null | No | |
timezone |
string | Yes | |
title |
string | Yes | |
to |
string | No |
required: ["id","kind","conversation_id","booking_id","product_id","stay_channel","stay_moment","starts_at","ends_at","day_key","timezone","title","status","organization_id","location_id","party_size"]
array of object fields
Value: array of object.
Array items: object.
null or object fields
Value: null or object.
null or array of object fields
Value: null or array of object.
array of string fields
Value: array of string.
minItems: 1
Array items: string.
string fields
Value: string.
enum: ["booking","post","stay"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
date |
string | Yes | |
location_id |
string | Yes | |
note |
string or null | No | |
reason |
string | Yes | enum: ["inactive","closure","dated_hours","regular_hours"] |
required: ["date","location_id","reason"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
periods |
array of object (fields) | Yes |
additionalProperties: false; required: ["periods"]
array of object fields
Value: array of object.
Array items: object.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
owner_id |
string | Yes | |
owner_type |
string | Yes | enum: ["organization"] |
slot |
string | Yes | enum: ["compliance_document"] |
additionalProperties: false; required: ["owner_type","owner_id","slot"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
owner_id |
string | Yes | |
owner_type |
string | Yes | enum: ["business_location"] |
slot |
string | Yes | enum: ["gallery"] |
additionalProperties: false; required: ["owner_type","owner_id","slot"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
owner_id |
string | Yes | |
owner_type |
string | Yes | enum: ["product"] |
slot |
string | Yes | enum: ["gallery"] |
additionalProperties: false; required: ["owner_type","owner_id","slot"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
owner_id |
string | Yes | |
owner_type |
string | Yes | enum: ["content_document"] |
slot |
string | Yes | enum: ["gallery"] |
additionalProperties: false; required: ["owner_type","owner_id","slot"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
owner_id |
string | Yes | |
owner_type |
string | Yes | enum: ["content_block"] |
slot |
string | Yes | enum: ["gallery"] |
additionalProperties: false; required: ["owner_type","owner_id","slot"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
owner_id |
string | Yes | |
owner_type |
string | Yes | enum: ["review_request"] |
slot |
string | Yes | enum: ["gallery"] |
additionalProperties: false; required: ["owner_type","owner_id","slot"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
alt_text |
string or null | No | |
asset_id |
string | Yes | |
duration |
number or null | No | |
height |
number or null | No | |
kind |
string | Yes | enum: ["image","video","file"] |
mime_type |
string or null | No | |
provider |
string | No | |
public_url |
string | Yes | |
status |
string | Yes | enum: ["active"] |
thumbnail_url |
string or null | No | |
width |
number or null | No |
required: ["asset_id","kind","public_url","status"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
owner_id |
string | Yes | |
owner_type |
string | Yes | enum: ["organization"] |
slot |
string | Yes | enum: ["logo","logo_dark","favicon","social_share","compliance_document","announcement"] |
additionalProperties: false; required: ["owner_type","owner_id","slot"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
owner_id |
string | Yes | |
owner_type |
string | Yes | enum: ["business_location"] |
slot |
string | Yes | enum: ["hero","gallery"] |
additionalProperties: false; required: ["owner_type","owner_id","slot"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
owner_id |
string | Yes | |
owner_type |
string | Yes | enum: ["product"] |
slot |
string | Yes | enum: ["image","gallery"] |
additionalProperties: false; required: ["owner_type","owner_id","slot"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
owner_id |
string | Yes | |
owner_type |
string | Yes | enum: ["collection"] |
slot |
string | Yes | enum: ["image"] |
additionalProperties: false; required: ["owner_type","owner_id","slot"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
owner_id |
string | Yes | |
owner_type |
string | Yes | enum: ["content_document"] |
slot |
string | Yes | enum: ["cover","gallery"] |
additionalProperties: false; required: ["owner_type","owner_id","slot"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
owner_id |
string | Yes | |
owner_type |
string | Yes | enum: ["content_block"] |
slot |
string (fields) | Yes |
additionalProperties: false; required: ["owner_type","owner_id","slot"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
alt_text |
string or null | Yes | |
asset_id |
string | Yes | |
category |
string or null | Yes | |
created_at |
string | Yes | |
duration |
number or null | Yes | Video duration in seconds. |
file_name |
string or null | Yes | |
file_size |
integer or null | Yes | Stored file size in bytes. |
height |
integer or null | Yes | |
kind |
string | Yes | enum: ["image","video","file"] |
mime_type |
string or null | Yes | |
provider |
string | Yes | |
public_url |
string or null | Yes | |
source |
string | Yes | |
status |
string | Yes | enum: ["pending","active","deleted","failed"] |
thumbnail_url |
string or null | Yes | |
updated_at |
string | Yes | |
width |
integer or null | Yes |
additionalProperties: false; required: ["asset_id","kind","provider","source","public_url","thumbnail_url","alt_text","category","status","file_name","created_at","mime_type","file_size","width","height","duration","updated_at"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
after_asset_id |
string | No | |
asset_id |
string | Yes | |
before_asset_id |
string | No |
additionalProperties: false; not: {"required":["before_asset_id","after_asset_id"]}; required: ["asset_id"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
owner_id |
string | Yes | |
owner_type |
string | Yes | enum: ["organization"] |
slot |
string | Yes | enum: ["logo","logo_dark","favicon","social_share","announcement"] |
additionalProperties: false; required: ["owner_type","owner_id","slot"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
owner_id |
string | Yes | |
owner_type |
string | Yes | enum: ["business_location"] |
slot |
string | Yes | enum: ["hero"] |
additionalProperties: false; required: ["owner_type","owner_id","slot"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
owner_id |
string | Yes | |
owner_type |
string | Yes | enum: ["product"] |
slot |
string | Yes | enum: ["image"] |
additionalProperties: false; required: ["owner_type","owner_id","slot"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
owner_id |
string | Yes | |
owner_type |
string | Yes | enum: ["content_document"] |
slot |
string | Yes | enum: ["cover"] |
additionalProperties: false; required: ["owner_type","owner_id","slot"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
owner_id |
string | Yes | |
owner_type |
string | Yes | enum: ["content_block"] |
slot |
string (fields) | Yes |
additionalProperties: false; required: ["owner_type","owner_id","slot"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
x |
number | Yes | maximum: 1; minimum: 0 |
y |
number | Yes | maximum: 1; minimum: 0 |
additionalProperties: false; required: ["x","y"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
daily_budget |
string or null | No | |
id |
string | Yes | |
name |
string | Yes | |
objective |
string or null | No | |
status |
string | Yes |
required: ["id","name","status"]
object or null fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
error |
string or null | Yes | |
status |
string | Yes |
required: ["status","error"]
array of object fields
Value: array of object.
Array items: object.
object or null fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
cta_label |
string or null | No | |
cta_url |
string or null | No | |
description |
string or null | No | |
dismissible |
boolean | No | |
enabled |
boolean | No | |
format |
string | No | enum: ["modal","banner"] |
headline |
string | No |
array of object fields
Value: array of object.
maxItems: 20
Array items: object.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
google_ads |
object or null (fields) | No | |
google_analytics |
object or null (fields) | No | |
google_search_console |
object or null (fields) | No |
object or null fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
dark |
object (fields) | No | additionalProperties: false |
light |
object (fields) | No | additionalProperties: false |
string fields
Value: string.
enum: ["name","source_locale","currency","timezone","subdomain"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
amount_minor |
integer | No | minimum: 0 |
category |
string | No | |
name |
string | Yes | minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
additionalProperties: false; required: ["name"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
createdAt |
string | Yes | format: "date-time" |
id |
string | Yes | |
organizationId |
string | Yes | |
role |
string | Yes | |
user |
object (fields) | Yes | required: ["id","name","email"] |
userId |
string | Yes |
required: ["id","organizationId","userId","role","createdAt","user"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
active |
boolean | Yes | True when this is the currently active MCP organization context. |
id |
string | Yes | |
name |
string | Yes | Business name, or the subdomain slug when it has none. |
public_url |
string or null | No | |
slug |
string or null | No | Organization slug. Use the location slug from list_locations for /dashboard/{organization_slug}/locations/{location_slug} |
status |
string | Yes | enum: ["active","inactive","suspended"] |
subdomain |
string or null | No |
required: ["id","name","status","active"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
choices |
array of object (fields) | No | maxItems: 20 |
help_text |
string or null | No | maxLength: 500 |
id |
string | No | Existing question ID to keep. Omit for a new question; one is assigned from its label. maxLength: 64; pattern: "^[a-z0-9][a-z0-9_-]{0,63}$" |
label |
string | Yes | maxLength: 200; minLength: 1 |
required |
boolean | Yes | |
type |
string | Yes | enum: ["short_text","long_text","single_choice","multiple_choice","yes_no"] |
additionalProperties: false; required: ["label","type","required"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
accent |
string | No | Emphasis, decoration and highlighted buttons. |
action |
string | No | Buttons, links and selected states. |
ground |
string | No | The page background. |
muted |
string | No | Captions, details and supporting copy. |
surface |
string | No | Cards, the header and footer, dialogs and fields. |
text |
string | No | Body copy and headings. |
additionalProperties: false
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
minimum |
number | Yes | |
mode |
string | Yes | |
pair |
string | Yes | |
ratio |
number | Yes |
required: ["mode","pair","ratio","minimum"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
amount |
integer | No | |
currency |
string | No | |
evidence_due_at |
string or null | No | |
id |
string | No | |
reason |
string | No | |
status |
string | No | |
updated_at |
string | No |
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
currency |
string | No | |
tax_behavior |
string | No | |
type |
string | No | |
unit_amount |
integer | No |
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
amount |
integer | Yes | |
id |
string | Yes | |
status |
string | Yes |
required: ["id","amount","status"]
array of object fields
Value: array of object.
Array items: object.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
amount |
integer | Yes | |
arrival_date |
integer | No | |
automatic |
boolean | No | |
created |
integer | No | |
currency |
string | Yes | |
dashboard_url |
string | Yes | |
id |
string | Yes | |
status |
string | Yes |
required: ["id","amount","currency","status","dashboard_url"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
captured_amount |
integer | Yes | |
currency |
string | Yes | |
disputed_amount |
integer | Yes | |
refunded_amount |
integer | Yes |
required: ["currency","captured_amount","refunded_amount","disputed_amount"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
amount |
integer | Yes | |
currency |
string | Yes | |
kind |
string | Yes | |
pending_delivery |
integer | Yes |
required: ["currency","kind","amount","pending_delivery"]
string fields
Value: string.
maxLength: 5000
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
label |
string | Yes | maxLength: 60; minLength: 1 |
url |
string | Yes | https://…, http://… or tel:+… |
additionalProperties: false; required: ["label","url"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
asset_id |
string | Yes | minLength: 1 |
slot |
enum | Yes | enum: ["cover","gallery"] |
additionalProperties: false; required: ["asset_id","slot"]
string fields
Value: string.
maxLength: 200
object or null fields
Value: object or null.
array of object fields
Value: array of object.
Array items: object.
array of object fields
Value: array of object.
Array items: object.
array of object fields
Value: array of object.
Array items: object.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
channel |
string | Yes | enum: ["facebook","instagram","discord"] |
connect_url |
string | Yes | Where a person connects or changes this account in the dashboard. |
connected |
boolean | Yes | |
connection_revision |
string or null | Yes | |
deletion_unavailable_reason |
string or null | Yes | |
problems |
array of object (fields) | Yes | |
supported_formats |
array of string (fields) | Yes | |
supported_operations |
array of string (fields) | Yes | |
target_id |
string or null | Yes | |
target_name |
string or null | Yes |
required: ["channel","connected","target_id","target_name","connection_revision","supported_formats","problems","supported_operations","deletion_unavailable_reason","connect_url"]
object fields
Value: object.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
active |
boolean | No | Enable or disable this product. Increasing the number of live homes requires the dashboard. |
description |
string | No | |
details |
object (fields) | No | Named customer-facing facts for the product kind. This is a complete replacement map; preserve fields to retain. pricing_note contains explicitly stated price wording and requires empty numeric prices. additionalProperties: false |
kind |
string | Yes | The customer-facing kind: dish (food or drink), experience (experience or class), service (practice area or consultation), stay (place to stay), or table (a restaurant location’s tables, booked as a reservation). Determines the allowed descriptive fields; booking and stock remain separate capabilities. enum: ["dish","experience","service","stay","table"] |
marketing_features |
array of string (fields) | No | Generic selling bullets. Inclusions, preparation instructions and policies are separate details. maxItems: 15 |
metadata |
object | No | Opaque string annotations for integrations. No pricing, scheduling, stock or filtering behavior may read these. additionalProperties: {"type":"string"} |
name |
string | Yes | |
order_url |
string or null | No | External ordering or booking destination, such as Uber Eats, an experience checkout, or Clio Grow. When set, public actions use this URL instead of native booking. Null restores the configured native flow. |
stay |
object (fields) | No | Required for kind stay and refused for every other kind: the location the home is at (fixed once created) and its stay settings. Guest-facing house rules go in details.house_rules. Base nightly rate is the variant price. additionalProperties: false; required: ["location_id","check_in_time","check_out_time","max_guests","min_nights","assigned_member_id"] |
tax_code |
string or null | No | |
unit_label |
string or null | No | A unit noun such as "person" or "night". Never pricing prose. |
variants |
array of object (fields) | No | Omit to create a single default variant. maxItems: 250; minItems: 1 |
additionalProperties: false; required: ["name","kind"]
object or null fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
alt_text |
string or null | No | |
asset_id |
string | Yes | |
duration |
number or null | No | |
height |
number or null | No | |
kind |
string | Yes | enum: ["image","video","file"] |
mime_type |
string or null | No | |
provider |
string | No | |
public_url |
string | Yes | |
status |
string | Yes | enum: ["active"] |
thumbnail_url |
string or null | No | |
width |
number or null | No |
required: ["asset_id","kind","public_url","status"]
array of object fields
Value: array of object.
maxItems: 100; minItems: 1
Array items: object.
array of object fields
Value: array of object.
maxItems: 100; minItems: 1
Array items: object.
array of string fields
Value: array of string.
maxItems: 100; uniqueItems: true
Array items: string.
array of string fields
Value: array of string.
maxItems: 100; uniqueItems: true
Array items: string.
array of string fields
Value: array of string.
maxItems: 100; uniqueItems: true
Array items: string.
array of string fields
Value: array of string.
maxItems: 100; uniqueItems: true
Array items: string.
array of string fields
Value: array of string.
maxItems: 100; uniqueItems: true
Array items: string.
array of string fields
Value: array of string.
maxItems: 100; uniqueItems: true
Array items: string.
array of string fields
Value: array of string.
maxItems: 100; uniqueItems: true
Array items: string.
array of string fields
Value: array of string.
maxItems: 100; uniqueItems: true
Array items: string.
array of string fields
Value: array of string.
maxItems: 100; uniqueItems: true
Array items: string.
array of string fields
Value: array of string.
uniqueItems: true
Array items: string.
array of object fields
Value: array of object.
Array items: object.
object or null fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
day_of_week_min_nights |
array of integer (fields) | No | Monday-first minimum nights. -1 means this weekday inherits the listing default. maxItems: 7; minItems: 7 |
direct_discounts |
object (fields) | No | Direct website bookings only. Only the largest eligible percentage applies. additionalProperties: false |
weekend_price_minor |
integer | No | Whole minor units of the organization currency, e.g. cents. minimum: 0 |
additionalProperties: false
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
active |
boolean | No | |
id |
string | No | |
name |
string | Yes | |
prices |
array of object (fields) | No | maxItems: 20 |
sku |
string or null | No | |
sort_order |
integer | No |
additionalProperties: false; required: ["name"]
object or null fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
missing |
array of string (fields) | Yes | |
ready |
boolean | Yes |
required: ["ready","missing"]
array of object fields
Value: array of object.
Array items: object.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
allergens |
array of string (fields) | No | Allergens the merchant states this dish contains. maxItems: 100; uniqueItems: true |
carbon_monoxide_detector_details |
string | No | Share where each carbon monoxide alarm is located. maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
climbing_structures |
boolean | No | Play or climbing structures are available to guests. |
climbing_structures_details |
string | No | Host-authored details about climbing or play structures. Requires its disclosure to be Yes. maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
commercial_photography_allowed |
boolean | No | Whether guests may take commercial photos or film at the property. |
dangerous_animals |
boolean | No | Animals that could cause harm live on or near the property. |
dangerous_animals_details |
string | No | Host-authored details about potentially dangerous animals. Requires its disclosure to be Yes. maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
dietary_notes |
array of string (fields) | No | Merchant-stated dietary facts displayed with a dish. maxItems: 100; uniqueItems: true |
events_allowed |
boolean | No | Whether guests may host events at the property. |
exterior_security_cameras |
boolean | No | Describe exterior cameras, what they monitor and whether they record audio or video. |
exterior_security_cameras_details |
string | No | Host-authored details about exterior security cameras. Requires its disclosure to be Yes. maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
featured |
boolean | No | Highlight this item on the menu and homepage. |
getting_around |
string | No | Host-authored transport and getting-around information for this home. maxLength: 10000; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
guest_access |
string | No | The spaces and facilities guests can use during their stay. maxLength: 10000; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
house_rules |
string | No | The host’s rules for guests staying in the home, shown with the listing. maxLength: 10000; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
included_items |
array of string (fields) | No | Items or work included in the stated price, shown in their own public section. maxItems: 100; uniqueItems: true |
ingredients |
array of string (fields) | No | Ingredients shown in the dish details. maxItems: 100; uniqueItems: true |
interaction_with_guests |
string | No | How guests can contact the host and what support is available. maxLength: 10000; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
limited_essentials |
boolean | No | Tell guests which everyday essentials are unavailable. |
limited_essentials_details |
string | No | Host-authored details about limited essential amenities. Requires its disclosure to be Yes. maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
meeting_point |
string | No | Instructions shown in the meeting section; meeting mode and video links are set in scheduling. maxLength: 10000; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
nearby_water |
boolean | No | Guests can reach a body of water on or next to the property. |
nearby_water_details |
string | No | Host-authored details about nearby water. Requires its disclosure to be Yes. maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
neighborhood_description |
string | No | Host-authored information about the neighborhood around this home. maxLength: 10000; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
no_property_parking |
boolean | No | Dedicated guest parking is not available on the property. |
no_property_parking_details |
string | No | Host-authored details about no parking on the property. Requires its disclosure to be Yes. maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
noise_decibel_monitors |
boolean | No | Devices measure sound levels without recording conversations. |
noise_decibel_monitors_details |
string | No | Host-authored details about noise decibel monitors. Requires its disclosure to be Yes. maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
noodle |
array of string (fields) | No | Authored noodle information shown as dish facts; these do not establish purchasable variants. maxItems: 100; uniqueItems: true |
other_details_to_note |
string | No | Additional information guests should know before booking. maxLength: 10000; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
pets_allowed |
boolean | No | Let guests know if they can bring pets. |
potential_noise |
boolean | No | Guests may hear traffic, construction or other noise. |
potential_noise_details |
string | No | Host-authored details about potential noise during stays. Requires its disclosure to be Yes. maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
preparation |
string | No | Preparation instructions shown to customers before a session or appointment. maxLength: 10000; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
pricing_note |
string | No | An explicitly stated price such as Market price; use only when no numeric price is set. maxLength: 1000; minLength: 1; pattern: "^(?=[\s\S]\S)[^\r\n]$" |
quiet_hours |
boolean | No | Hours when guests should keep noise to a minimum. |
quiet_hours_end |
string | No | Local end of quiet hours, required with quiet hours and its start time. enum: ["00:00","01:00","02:00","03:00","04:00","05:00","06:00","07:00","08:00","09:00","10:00","11:00","12:00","13:00","14:00","15:00","16:00","17:00","18:00","19:00","20:00","21:00","22:00","23:00"]; maxLength: 1000; minLength: 1; pattern: "^(?=[\s\S]\S)[^\r\n]$" |
quiet_hours_start |
string | No | Local start of quiet hours, required with quiet hours and its end time. enum: ["00:00","01:00","02:00","03:00","04:00","05:00","06:00","07:00","08:00","09:00","10:00","11:00","12:00","13:00","14:00","15:00","16:00","17:00","18:00","19:00","20:00","21:00","22:00","23:00"]; maxLength: 1000; minLength: 1; pattern: "^(?=[\s\S]\S)[^\r\n]$" |
resident_pets |
boolean | No | Guests may encounter animals that live here. |
resident_pets_details |
string | No | Host-authored details about pets live on the property. Requires its disclosure to be Yes. maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
shared_spaces |
boolean | No | Guests share some spaces with other people. |
shared_spaces_details |
string | No | Host-authored details about shared spaces. Requires its disclosure to be Yes. maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
sizes |
array of string (fields) | No | Authored serving information; priced choices belong in variants. maxItems: 100; uniqueItems: true |
smoke_detector_details |
string | No | Share where each smoke alarm is located. maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
smoking_allowed |
boolean | No | Whether guests may smoke or vape at the property. |
soup |
array of string (fields) | No | Authored soup information shown with the dish. maxItems: 100; uniqueItems: true |
special_safety_considerations |
string | No | Other property features that guests should know could be unsafe, and why. maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
stairs_required |
boolean | No | Guests need to use stairs during their stay. |
stairs_required_details |
string | No | Host-authored details about guests must climb stairs. Requires its disclosure to be Yes. maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
tagline |
string | No | A short sentence shown below the product title. maxLength: 1000; minLength: 1; pattern: "^(?=[\s\S]\S)[^\r\n]$" |
toppings |
array of string (fields) | No | Authored topping information; priced choices belong in variants. maxItems: 100; uniqueItems: true |
unprotected_heights |
boolean | No | Elevated areas are accessible without a railing or other protection. |
unprotected_heights_details |
string | No | Host-authored details about unprotected heights. Requires its disclosure to be Yes. maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
unsecured_pool |
boolean | No | Guests can reach a pool or hot tub without a gate or lock. |
unsecured_pool_details |
string | No | Host-authored details about unsecured pool or hot tub. Requires its disclosure to be Yes. maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
weapons_on_property |
boolean | No | Tell guests about weapons stored on the property. |
weapons_on_property_details |
string | No | Host-authored details about weapons on the property. Requires its disclosure to be Yes. maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
what_to_bring |
array of string (fields) | No | Items customers should bring, shown in the preparation section. maxItems: 100; uniqueItems: true |
your_property |
string | No | The spaces and features guests should know about this home. maxLength: 10000; minLength: 1; pattern: "^[\s\S]\S[\s\S]$" |
additionalProperties: false
object or null fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
alt_text |
string or null | No | |
asset_id |
string | Yes | |
duration |
number or null | No | |
height |
number or null | No | |
kind |
string | Yes | enum: ["image","video","file"] |
mime_type |
string or null | No | |
provider |
string | No | |
public_url |
string | Yes | |
status |
string | Yes | enum: ["active"] |
thumbnail_url |
string or null | No | |
width |
number or null | No |
required: ["asset_id","kind","public_url","status"]
array of object fields
Value: array of object.
Array items: object.
object or null fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
id |
string | Yes | |
path |
string | Yes | |
title |
string | Yes |
required: ["id","path","title"]
array of object fields
Value: array of object.
Array items: object.
object or null fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
accessibility |
array of object (fields) | Yes | All six home accessibility features in catalog order, including unanswered null rows. maxItems: 6; minItems: 6 |
amenities |
array of string (fields) | Yes | Amenity codes the home offers. Empty means no positive amenity answers. uniqueItems: true |
amenity_answers |
array of object (fields) | Yes | Explicit amenity reports, each code once, in catalog order. Missing codes are unknown. amenities is the true-only projection. |
assigned_member_id |
string or null | Yes | Better Auth organization membership ID of the home’s assigned host; null only after that member left the business. |
bathrooms |
number or null | Yes | Whole and half baths, such as 1.5. maximum: 50; minimum: 0; multipleOf: 0.5 |
bedrooms |
integer or null | Yes | Bedrooms; 0 is a studio. maximum: 50; minimum: 0 |
beds |
integer or null | Yes | maximum: 9007199254740991; minimum: 0 |
calendar_rules |
object or null (fields) | Yes | Actual optional listing rules. Null removes them. Dated overrides take precedence over weekday minimums, then the required default. Friday/Saturday use the weekend price when supplied. additionalProperties: false |
cancellation_policy |
string or null | Yes | Policy shown to guests for stays under 28 nights. Null when the provider has not supplied one. New authored homes start on Flexible. It does not refund by itself. enum: ["flexible","moderate","limited","firm","strict",null] |
check_in_end_time |
string or null | Yes | Local 24-hour end of the check-in window; null is a flexible end. A time earlier than check_in_time is after midnight. pattern: "^([01]\d|2[0-3]):[0-5]\d$" |
check_in_time |
string or null | Yes | Local 24-hour time guests may arrive from, in the location’s timezone. pattern: "^([01]\d|2[0-3]):[0-5]\d$" |
check_out_time |
string or null | Yes | Local 24-hour time guests leave by. pattern: "^([01]\d|2[0-3]):[0-5]\d$" |
internal_name |
string | Yes | Short operator-only home name. Initially the listing title; edited independently from Product.name and never sent to Airbnb or guests. maxLength: 240; minLength: 1 |
listing_floor |
integer or null | Yes | The listing’s floor, counted from 1. Cannot exceed total_floors when both are known; null when not said. maximum: 9007199254740991; minimum: 1 |
listing_type |
string or null | Yes | Whether guests book the entire place, a private room or a shared room. Null when not said. enum: ["entire_place","private_room","shared_room",null] |
location_id |
string | Yes | |
long_term_cancellation_policy |
string or null | Yes | Policy shown to guests for stays of 28 nights or more. Null when the provider has not supplied one. New authored homes start on Firm Long Term. enum: ["firm","strict",null] |
max_guests |
integer | Yes | maximum: 99; minimum: 1 |
min_nights |
integer | Yes | The listing’s required default minimum; individual arrival dates may override it. maximum: 1125; minimum: 1 |
photo_rooms |
array of object (fields) | Yes | |
property_size |
number or null | Yes | Property area in property_size_unit. Size and unit must both be set or both null. exclusiveMinimum: 0 |
property_size_unit |
string or null | Yes | The unit of property_size. Size and unit must both be set or both null. enum: ["square_meters","square_feet",null] |
property_type |
string or null | Yes | Airbnb property type, one the property_type_group offers. Null with property_type_group when not said. enum: ["apartment","condominium","serviced_apartment","loft","house","townhouse","bungalow","cabin","chalet","earthhouse","hut","lighthouse","villa","dome","cottage","farmstay","houseboat","tiny_house","guesthouse","private_suite","boat","castle","cave","igloo","island","plane","rv","tent","tipi","train","treehouse","yurt","other","barn","campsite","windmill","bus","holiday_park","ranch","religious_building","riad","shipping_container","tower","bnb","nature_eco_lodge","boutique_hotel","hostel","aparthotel","hotel","resort",null] |
property_type_group |
string or null | Yes | Airbnb's property group: apartments (Apartment: apartment, condominium, serviced_apartment, loft); houses (House: house, townhouse, bungalow, cabin, chalet, earthhouse, hut, lighthouse, villa, dome, cottage, farmstay, houseboat, tiny_house); secondary_units (Secondary unit: guesthouse, private_suite, farmstay); unique_homes (Unique space: boat, castle, cave, earthhouse, hut, igloo, island, lighthouse, plane, rv, tent, tipi, train, treehouse, yurt, other, dome, barn, campsite, farmstay, houseboat, tiny_house, windmill, bus, holiday_park, ranch, religious_building, riad, shipping_container, tower); bnb (Bed and breakfast: bnb, nature_eco_lodge, farmstay); boutique_hotels_and_more (Boutique hotel: boutique_hotel, nature_eco_lodge, hostel, serviced_apartment, aparthotel, hotel, resort). enum: ["apartments","houses","secondary_units","unique_homes","bnb","boutique_hotels_and_more",null] |
questions |
array of object (fields) | Yes | The host's own questions asked with each direct stay booking. maxItems: 20 |
questions_revision |
string | Yes | Send as expected_questions_revision when replacing questions, and as questions_revision when submitting answers. |
total_floors |
integer or null | Yes | Total floors in the property; null when not said. maximum: 9007199254740991; minimum: 1 |
year_built |
integer or null | Yes | Year the property was built; null when not said. maximum: 9007199254740991; minimum: 1 |
required: ["internal_name","location_id","check_in_time","check_in_end_time","check_out_time","max_guests","min_nights","calendar_rules","assigned_member_id","photo_rooms","accessibility","questions","questions_revision","property_type_group","property_type","listing_type","total_floors","listing_floor","year_built","property_size","property_size_unit","bedrooms","beds","bathrooms","amenities","amenity_answers","cancellation_policy","long_term_cancellation_policy"]
array of object fields
Value: array of object.
Array items: object.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
dish |
integer | Yes | minimum: 0 |
experience |
integer | Yes | minimum: 0 |
service |
integer | Yes | minimum: 0 |
stay |
integer | Yes | minimum: 0 |
table |
integer | Yes | minimum: 0 |
additionalProperties: false; required: ["dish","experience","service","stay","table"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
active |
boolean | Yes | |
collections |
array of object (fields) | Yes | |
featured |
boolean | Yes | |
id |
string | Yes | |
kind |
string | Yes | enum: ["dish","experience","service","stay","table"] |
locations |
array of object (fields) | Yes | |
name |
string | Yes | |
prices |
array of object (fields) | Yes | |
pricing_note |
string | No | |
publications |
array of object (fields) | Yes | |
slug |
string | Yes | |
variant_count |
integer | Yes |
required: ["id","kind","name","slug","active","featured","variant_count","collections","publications","locations","prices"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
active |
boolean | No | Enable or disable this product. Increasing the number of live homes requires the dashboard. |
description |
string | No | |
details |
object (fields) | No | Named customer-facing facts for the product kind. This is a complete replacement map; preserve fields to retain. pricing_note contains explicitly stated price wording and requires empty numeric prices. additionalProperties: false |
kind |
string | Yes | The customer-facing kind: dish (food or drink), experience (experience or class), service (practice area or consultation), stay (place to stay), or table (a restaurant location’s tables, booked as a reservation). Determines the allowed descriptive fields; booking and stock remain separate capabilities. enum: ["dish","experience","service","stay","table"] |
marketing_features |
array of string (fields) | No | Generic selling bullets. Inclusions, preparation instructions and policies are separate details. maxItems: 15 |
metadata |
object | No | Opaque string annotations for integrations. No pricing, scheduling, stock or filtering behavior may read these. additionalProperties: {"type":"string"} |
name |
string | Yes | |
order_url |
string or null | No | External ordering or booking destination, such as Uber Eats, an experience checkout, or Clio Grow. When set, public actions use this URL instead of native booking. Null restores the configured native flow. |
product_id |
string | No | minLength: 1 |
stay |
object (fields) | No | Required for kind stay and refused for every other kind: the location the home is at (fixed once created) and its stay settings. Guest-facing house rules go in details.house_rules. Base nightly rate is the variant price. additionalProperties: false; required: ["location_id","check_in_time","check_out_time","max_guests","min_nights","assigned_member_id"] |
tax_code |
string or null | No | |
unit_label |
string or null | No | A unit noun such as "person" or "night". Never pricing prose. |
variants |
array of object (fields) | No | Omit to create a single default variant. maxItems: 250; minItems: 1 |
additionalProperties: false; required: ["name","kind"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
start_time |
string | Yes | Local HH:mm start time; visit duration is configured separately. pattern: "^([01][0-9]|2[0-3]):[0-5][0-9]$" |
weekday |
integer | Yes | maximum: 6; minimum: 0 |
additionalProperties: false; required: ["weekday","start_time"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
capacity |
integer or null | Yes | |
id |
string | Yes | |
location_id |
string | Yes | |
organization_id |
string | Yes | |
product_id |
string | Yes | |
start_time |
string | Yes | |
timezone |
string | Yes | |
weekday |
integer | Yes | maximum: 6; minimum: 0 |
additionalProperties: false; required: ["id","organization_id","product_id","location_id","timezone","weekday","start_time","capacity"]
array of object fields
Value: array of object.
maxItems: 20
Array items: object.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
collection_id |
string | No | |
items |
array of object (fields) | Yes | maxItems: 100; minItems: 1 |
name |
string | Yes | minLength: 1 |
additionalProperties: false; required: ["name","items"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
collection |
object (fields) | Yes | additionalProperties: false; required: ["id","organization_id","location_id","name","slug","description","image","sort_order"] |
products |
array of object (fields) | Yes |
additionalProperties: false; required: ["collection","products"]
array of string or null fields
Value: array of string or null.
string or null fields
Value: string or null.
string or null fields
Value: string or null.
string or null fields
Value: string or null.
array of string or null fields
Value: array of string or null.
string or null fields
Value: string or null.
string or null fields
Value: string or null.
string or null fields
Value: string or null.
string or null fields
Value: string or null.
array of string or null fields
Value: array of string or null.
array of string or null fields
Value: array of string or null.
string or null fields
Value: string or null.
string or null fields
Value: string or null.
string or null fields
Value: string or null.
string or null fields
Value: string or null.
string or null fields
Value: string or null.
string or null fields
Value: string or null.
string or null fields
Value: string or null.
array of string or null fields
Value: array of string or null.
string or null fields
Value: string or null.
string or null fields
Value: string or null.
string or null fields
Value: string or null.
string or null fields
Value: string or null.
string or null fields
Value: string or null.
string or null fields
Value: string or null.
string or null fields
Value: string or null.
string or null fields
Value: string or null.
array of string or null fields
Value: array of string or null.
string or null fields
Value: string or null.
array of string or null fields
Value: array of string or null.
string or null fields
Value: string or null.
string or null fields
Value: string or null.
string or null fields
Value: string or null.
array of string or null fields
Value: array of string or null.
string or null fields
Value: string or null.
string or null fields
Value: string or null.
string or null fields
Value: string or null.
array of string or null fields
Value: array of string or null.
string or null fields
Value: string or null.
array of object fields
Value: array of object.
maxItems: 20
Array items: object.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
active |
boolean | No | |
id |
string | No | |
name |
string | No | |
prices |
array of object (fields) | No | Partial existing prices by id or new offers. Omitted prices remain unless prices_mode is replace. A new offer requires unit_amount. maxItems: 20 |
prices_mode |
string | No | merge keeps prices omitted from the supplied list. replace explicitly removes omitted prices; an empty list clears them. Applies only with prices. default: "merge"; enum: ["merge","replace"] |
sku |
string or null | No | |
sort_order |
integer | No |
additionalProperties: false; required: []
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
id |
string | Yes | |
image |
string or null | Yes | |
name |
string | Yes | |
scheduling |
object or null (fields) | Yes | additionalProperties: false; required: ["member_id","timezone","updated_at","weekly","time_off","calendar_account_id","calendar_ids","calendar_status","calendar_conflict_count","calendar_conflicts"] |
self |
boolean | Yes |
required: ["id","name","image","self","scheduling"]
array of object fields
Value: array of object.
Array items: object.
array or null fields
Value: array or null.
Array items: object.
array or null fields
Value: array or null.
Array items: object.
string fields
Value: string.
maxLength: 1024; minLength: 1
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
end |
string | Yes | format: "date-time" |
start |
string | Yes | format: "date-time" |
additionalProperties: false; required: ["start","end"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
end |
string | Yes | pattern: "^([01][0-9]|2[0-3]):[0-5][0-9]$" |
start |
string | Yes | pattern: "^([01][0-9]|2[0-3]):[0-5][0-9]$" |
weekday |
integer | Yes | maximum: 6; minimum: 0 |
additionalProperties: false; required: ["weekday","start","end"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
answer |
string or null | Yes | |
created_at |
string | Yes | |
id |
string | Yes | |
location_id |
string or null | Yes | |
question |
string | Yes | |
sort_order |
number | Yes | |
source |
string | Yes | |
status |
string | Yes | enum: ["published","hidden"] |
updated_at |
string | Yes |
required: ["id","question","answer","sort_order","location_id","source","status","created_at","updated_at"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
id |
string | Yes | minLength: 1 |
sort_order |
integer | Yes |
additionalProperties: false; required: ["id","sort_order"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
author_name |
string or null | No | |
category_ratings |
array of object (fields) | No | The guest's optional 1-5 scores for the visit's fixed questions; a skipped question has no entry. |
collection_method |
string or null | No | |
content |
string or null | No | |
created_at |
string or null | Yes | |
id |
string | Yes | |
location_id |
string or null | No | |
original_reference |
string or null | No | |
original_review_date |
string or null | No | |
owner_reply |
string or null | No | |
private_feedback |
string or null | No | What the guest told the business privately. Never published. |
publication_authorized |
boolean | Yes | |
rating |
number | Yes | |
source |
string | Yes | |
status |
string | Yes | |
title |
string or null | No | |
updated_at |
string | Yes | |
verified |
boolean | Yes |
required: ["id","rating","source","status","created_at","updated_at","publication_authorized","verified"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
expected_room_id |
string or null | Yes | Containing room’s id from get_product → product.stay.photo_rooms; null if no room contains this photo. A changed membership refuses the whole assignment. |
photo_id |
string | Yes | Image or video asset ID already placed on this home: get_product → product.image.asset_id or product.gallery[].asset_id. minLength: 1 |
additionalProperties: false; required: ["photo_id","expected_room_id"]
array of string fields
Value: array of string.
uniqueItems: true
Array items: string.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
photo_id |
string | Yes | minLength: 1 |
room_id |
string or null | Yes |
additionalProperties: false; required: ["photo_id","room_id"]
object or null fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
address |
string | Yes | minLength: 1 |
city |
string or null | Yes | |
country |
string | Yes | pattern: "^[A-Z]{2}$" |
state |
string or null | Yes | |
zip_code |
string or null | Yes |
required: ["address","city","state","country","zip_code"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
available |
boolean | Yes | |
booking_id |
string or null | Yes | |
calendar |
string or null | Yes | The linked calendar (Vrbo) that shows this night taken; null when none does. Such a night is not available. enum: ["vrbo",null] |
channel |
object or null (fields) | Yes | required: ["state","detail"] |
closed |
boolean | Yes | |
closed_to_arrival |
boolean | Yes | |
closed_to_departure |
boolean | Yes | |
date |
string | Yes | pattern: "^\d{4}-\d{2}-\d{2}$" |
held_until |
string or null | Yes | When a guest checkout hold on this night lapses; null when no guest is paying for it. A held night is not available. |
max_stay |
integer or null | Yes | |
min_stay_arrival |
integer | Yes | |
price_minor |
integer or null | Yes | |
source |
string or null | Yes | enum: ["host","import",null] |
required: ["date","available","booking_id","closed","price_minor","min_stay_arrival","max_stay","closed_to_arrival","closed_to_departure","source","held_until","calendar","channel"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
adults |
integer | Yes | |
booking_id |
string | Yes | minLength: 1 |
channel |
string | No | Where the stay was booked; owners and admins only. enum: ["airbnb","vrbo","booking_com","direct"] |
check_in_date |
string | Yes | pattern: "^\d{4}-\d{2}-\d{2}$" |
check_out_date |
string | Yes | pattern: "^\d{4}-\d{2}-\d{2}$" |
children |
integer | Yes | |
guest_name |
string or null | Yes | The guest as their conversation names them; a member reads the first name. |
product_id |
string | Yes | minLength: 1 |
status |
string | Yes | enum: ["pending","confirmed","cancelled"] |
unit |
string | Yes | const: "nights" |
additionalProperties: false; required: ["unit","booking_id","product_id","status","guest_name","adults","children","check_in_date","check_out_date"]
integer fields
Value: integer.
maximum: 6; minimum: 0
array of string fields
Value: array of string.
maxItems: 50; uniqueItems: true
Array items: string.
See schema fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
available |
boolean | No | const: true |
photo_ids |
See schema | No | minItems: 1 |
See schema fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
available |
enum | No | enum: [false,null] |
photo_ids |
See schema | No | maxItems: 0 |
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
available |
boolean or null | Yes | The host’s answer; null is unanswered. No review or approval is implied. |
feature |
string | Yes | enum: ["disabled_parking_spot","path_to_entrance_lit_at_night","home_step_free_access","home_wide_doorway","pool_hoist","ceiling_hoist"] |
photo_ids |
array of string (fields) | Yes | Evidence image IDs in the home’s Product photo order. Empty for false or unknown answers. maxItems: 50; uniqueItems: true |
additionalProperties: false; required: ["feature","available","photo_ids"]
string fields
Value: string.
enum: ["ac","dryer","essentials","heating","hot_water","kitchen","tv","washer","wireless_internet","bathtub","bidet","body_soap","cleaning_products","conditioner","hair_dryer","alfresco_shower","shampoo","shower_gel","bed_linens","wardrobe_or_closet","clothes_drying_rack","extra_pillows_and_blankets","hangers","iron","mosquito_net","room_darkening_shades","safe","arcade_machine","batting_cage","books","bowling_alley","climbing_wall","ethernet_connection","exercise_equipment","game_console","laser_tag","life_size_games","mini_golf","home_theater","piano","ping_pong_table","pool_table","record_player","skate_ramp","sound_system","theme_room","baby_bath","baby_monitor","childrens_bike","playroom","stair_gates","babysitter_recommendations","board_games","changing_table","childrens_books_and_toys","childrens_dinnerware","crib","fireplace_guards","high_chair","playground","outlet_covers","pack_n_play_travel_crib","table_corner_guards","window_guards","ceiling_fan","fireplace","portable_fans","carbon_monoxide_detector","fire_extinguisher","first_aid_kit","smoke_detector","laptop_friendly_workspace","pocket_wifi","baking_sheet","barbeque_utensils","bread_maker","blender","coffee","coffee_maker","cooking_basics","dining_table","dishes_and_silverware","dishwasher","freezer","hot_water_kettle","kitchenette","microwave","mini_fridge","oven","refrigerator","rice_maker","stove","toaster","trash_compacter","wine_glasses","beach_access","lake_access","laundromat_nearby","private_entrance","resort_access","ski_in_ski_out","waterfront","garden_or_backyard","bbq_area","beach_essentials","bicycle","boat_slip","fire_pit","hammock","kayak","alfresco_dining","outdoor_seating","outdoor_kitchen","patio_or_belcony","sun_loungers","free_parking","street_parking","paid_parking_on_premises","paid_parking","free_parking_off_premises","elevator","ev_charger","hockey_rink","gym","jacuzzi","pool","private_living_room","sauna","single_level_home","ebike_charger","solar_power","recycling","composting","doorman","gated_community","breakfast","cleaning_before_checkout","long_term_stays_allowed","luggage_dropoff_allowed","bay_view","beach_view","canal_view","city_view","courtyard_view","desert_view","garden_view","golf_view","harbor_view","lake_view","marina_view","mountain_view","ocean_view","park_view","pool_view","resort_view","river_view","sea_view","valley_view","vineyard_view","landmark_view"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
count |
integer | Yes | maximum: 50; minimum: 1 |
type |
string | Yes | enum: ["single","double","queen","king","small_double","bunk_bed","sofa_bed","couch","floor_mattress","air_mattress","crib","toddler_bed","hammock","water_bed"] |
additionalProperties: false; required: ["type","count"]
array of object fields
Value: array of object.
maxItems: 2
Array items: object.
array of string fields
Value: array of string.
uniqueItems: true
Array items: string.
array or null fields
Value: array or null.
maxItems: 14
Array items: object.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
help_text |
string or null | Yes | |
label |
string | Yes | |
question_id |
string | Yes | |
selected_choices |
array of object (fields) | Yes | |
type |
string | Yes | enum: ["short_text","long_text","single_choice","multiple_choice","yes_no"] |
value |
string or array of string or boolean (fields) | Yes | Text, the selected choice ID, the selected choice IDs, or true/false for yes/no. |
additionalProperties: false; required: ["question_id","label","type","help_text","value","selected_choices"]
object or null fields
Value: object or null.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
assign |
boolean | Yes | |
complete |
boolean | Yes | |
edit |
boolean | Yes | |
reopen |
boolean | Yes | |
skip |
boolean | Yes |
required: ["complete","skip","reopen","assign","edit"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
date |
string or null | Yes | |
heading |
string | Yes | |
title |
string | Yes |
required: ["heading","title","date"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
conversation_id |
string or null | Yes | The guest conversation a welcome is sent in; null for a setup item. |
detail |
string | Yes | |
icon |
string | Yes | |
id |
string | Yes | |
location_id |
string or null | Yes | |
message |
string or null | Yes | The message it pre-writes from the business’s own records. Review it, then send it with send_message in conversation_id’s conversation; nothing is sent until then. |
path |
string | Yes | |
product_id |
string or null | Yes | |
status_line |
string | Yes | |
title |
string | Yes |
required: ["id","status_line","title","detail","icon","path","product_id","location_id","conversation_id","message"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
id |
string | Yes | |
initial |
string | Yes | |
name |
string | Yes | |
type |
string | Yes | enum: ["member"] |
you |
boolean | Yes |
required: ["type","id","name","initial","you"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
id |
string | Yes | |
subtitle |
string or null | Yes | |
tasks |
array of object (fields) | Yes | |
title |
string or null | Yes |
required: ["id","title","subtitle","tasks"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
choices |
array of object (fields) | Yes | |
label |
string | Yes |
additionalProperties: false; required: ["label","choices"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
columns |
array of object (fields) | Yes | |
empty |
string | Yes | |
heading |
string | Yes | |
kind |
string | Yes | const: "rows" |
rows |
array of object (fields) | Yes |
additionalProperties: false; required: ["kind","heading","columns","rows","empty"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
empty |
string | Yes | |
kind |
string | Yes | const: "reviews" |
reviews |
array of object (fields) | Yes |
additionalProperties: false; required: ["kind","reviews","empty"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
date |
string | Yes | pattern: "^\d{4}-\d{2}-\d{2}$" |
label |
string | Yes |
additionalProperties: false; required: ["date","label"]
#/$defs/content_heading or #/$defs/content_markdown or #/$defs/content_image or #/$defs/content_gallery or #/$defs/content_video or #/$defs/content_faq or #/$defs/content_how_to or #/$defs/content_divider or #/$defs/content_ai_assistance or #/$defs/content_cta or #/$defs/content_callout fields
Value: #/$defs/content_heading or #/$defs/content_markdown or #/$defs/content_image or #/$defs/content_gallery or #/$defs/content_video or #/$defs/content_faq or #/$defs/content_how_to or #/$defs/content_divider or #/$defs/content_ai_assistance or #/$defs/content_cta or #/$defs/content_callout.
anyOf: shape 1, shape 2, shape 3, shape 4, shape 5, shape 6, shape 7, shape 8, shape 9, shape 10, shape 11.
array of #/$defs/content_block_media fields
Value: array of #/$defs/content_block_media.
Array items: #/$defs/content_block_media.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: ["text"] |
id |
string | No | |
level |
number or null | No | |
media |
array of #/$defs/content_block_media (fields) | No | Required on image blocks: one item, the picture. A block read back keeps its media by sending it as read. |
parent_block_id |
string or null | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "heading" |
updated_at |
string or null | No | As read. Ignored on a whole-document write. |
additionalProperties: false; required: ["type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: ["markdown","editor_mode"] |
id |
string | No | |
level |
number or null | No | |
media |
array of #/$defs/content_block_media (fields) | No | Required on image blocks: one item, the picture. A block read back keeps its media by sending it as read. |
parent_block_id |
string or null | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "markdown" |
updated_at |
string or null | No | As read. Ignored on a whole-document write. |
additionalProperties: false; required: ["type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: [] |
id |
string | No | |
level |
number or null | No | |
media |
array of #/$defs/content_block_media (fields) | No | Required on image blocks: one item, the picture. A block read back keeps its media by sending it as read. |
parent_block_id |
string or null | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "image" |
updated_at |
string or null | No | As read. Ignored on a whole-document write. |
additionalProperties: false; required: ["type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: [] |
id |
string | No | |
level |
number or null | No | |
media |
array of #/$defs/content_block_media (fields) | No | Required on image blocks: one item, the picture. A block read back keeps its media by sending it as read. |
parent_block_id |
string or null | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "gallery" |
updated_at |
string or null | No | As read. Ignored on a whole-document write. |
additionalProperties: false; required: ["type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: ["url","title"] |
id |
string | No | |
level |
number or null | No | |
media |
array of #/$defs/content_block_media (fields) | No | Required on image blocks: one item, the picture. A block read back keeps its media by sending it as read. |
parent_block_id |
string or null | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "video" |
updated_at |
string or null | No | As read. Ignored on a whole-document write. |
additionalProperties: false; required: ["type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: ["source"] |
id |
string | No | |
level |
number or null | No | |
media |
array of #/$defs/content_block_media (fields) | No | Required on image blocks: one item, the picture. A block read back keeps its media by sending it as read. |
parent_block_id |
string or null | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "faq" |
updated_at |
string or null | No | As read. Ignored on a whole-document write. |
additionalProperties: false; required: ["type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: ["steps"] |
id |
string | No | |
level |
number or null | No | |
media |
array of #/$defs/content_block_media (fields) | No | Required on image blocks: one item, the picture. A block read back keeps its media by sending it as read. |
parent_block_id |
string or null | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "how_to" |
updated_at |
string or null | No | As read. Ignored on a whole-document write. |
additionalProperties: false; required: ["type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: [] |
id |
string | No | |
level |
number or null | No | |
media |
array of #/$defs/content_block_media (fields) | No | Required on image blocks: one item, the picture. A block read back keeps its media by sending it as read. |
parent_block_id |
string or null | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "divider" |
updated_at |
string or null | No | As read. Ignored on a whole-document write. |
additionalProperties: false; required: ["type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: [] |
id |
string | No | |
level |
number or null | No | |
media |
array of #/$defs/content_block_media (fields) | No | Required on image blocks: one item, the picture. A block read back keeps its media by sending it as read. |
parent_block_id |
string or null | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "ai_assistance" |
updated_at |
string or null | No | As read. Ignored on a whole-document write. |
additionalProperties: false; required: ["type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: [] |
id |
string | No | |
level |
number or null | No | |
media |
array of #/$defs/content_block_media (fields) | No | Required on image blocks: one item, the picture. A block read back keeps its media by sending it as read. |
parent_block_id |
string or null | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "cta" |
updated_at |
string or null | No | As read. Ignored on a whole-document write. |
additionalProperties: false; required: ["type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: [] |
id |
string | No | |
level |
number or null | No | |
media |
array of #/$defs/content_block_media (fields) | No | Required on image blocks: one item, the picture. A block read back keeps its media by sending it as read. |
parent_block_id |
string or null | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "callout" |
updated_at |
string or null | No | As read. Ignored on a whole-document write. |
additionalProperties: false; required: ["type","data"]
string or array of string or boolean fields
Value: string or array of string or boolean.
anyOf: shape 1, shape 2, shape 3.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
adults |
integer | Yes | |
answers |
array of object (fields) | Yes | The guest's answers to the home's questions, worded as they answered them. The stay keeps them even when its conversation is deleted. |
booked_home_name |
string or null | Yes | |
booked_product_id |
string or null | Yes | The listing a channel reservation is booked on when the host moved the guest to another home; null when they sleep where they booked. |
cancellation_policy |
string or null | Yes | The home cancellation policy the guest booked under on the site; it decides what their own cancellation refunds. Null for a stay not paid on the site. enum: ["flexible","moderate","limited","firm","strict","long_term_firm","long_term_strict",null] |
cancellation_reason |
string or null | Yes | |
cancelled_at |
string or null | Yes | |
channel |
string | Yes | enum: ["airbnb","vrbo","booking_com","direct"] |
channel_booking_id |
string or null | Yes | |
channel_booking_url |
string or null | Yes | The reservation on its channel (Airbnb's host reservation page), where a channel stay is changed or cancelled. Null for other stays. |
channel_push |
object or null (fields) | No | What the home's connected channel took from this change: null when no channel push is needed; pushed when delivery completed; pending, with the reason, while it waits out Channex's rate limit or an unconfirmed attempt it sends again. A refused channel update returns a committed error. |
check_in_date |
string | Yes | pattern: "^\d{4}-\d{2}-\d{2}$" |
check_out_date |
string | Yes | pattern: "^\d{4}-\d{2}-\d{2}$" |
children |
integer | Yes | |
conversation_id |
string | Yes | The guest conversation about this stay, for get_conversation and send_message. Every stay has one. minLength: 1 |
created_at |
string | Yes | minLength: 1 |
currency |
string | Yes | minLength: 1 |
ends_at |
string | Yes | Checkout: an ISO instant at the home's checkout time, or the day alone when the home has no checkout time. minLength: 1 |
external_booking_id |
string or null | Yes | |
guest_email |
string or null | Yes | |
guest_image_url |
string or null | Yes | The linked Better Auth account’s current portrait. Null for guests without an account portrait. |
guest_name |
string or null | Yes | The guest as their conversation names them; null for a channel conversation that names no one. |
guest_phone |
string or null | Yes | |
id |
string | Yes | minLength: 1 |
infants |
integer | Yes | |
location_id |
string | Yes | minLength: 1 |
no_show_at |
string or null | Yes | When the host recorded that the guest never arrived; null otherwise. |
online_payment |
object or null (fields) | Yes | The Stripe payment the guest made when booking this stay on the site; null for a stay booked any other way. paid_minor counts it net of refunds. required: ["payment_id","currency","amount_minor","captured_minor","refunded_minor","receipt_url","created_at"] |
overbooked |
boolean | Yes | |
owner |
string | Yes | enum: ["app","channel"] |
paid_minor |
integer | Yes | |
party_size |
integer | Yes | Adults and children; infants are extra. |
payment_status |
string or null | Yes | enum: ["unpaid","partial","paid","overpaid",null] |
payments |
array of object (fields) | Yes | |
private_notes |
string or null | Yes | The host's own note, never shown to the guest. |
product_id |
string | Yes | minLength: 1 |
provider |
string or null | Yes | |
starts_at |
string | Yes | Check-in: an ISO instant at the home's check-in time (or the arrival the host recorded), or the day alone when the home has no check-in time. minLength: 1 |
status |
string | Yes | enum: ["pending","confirmed","cancelled"] |
timezone |
string | Yes | minLength: 1 |
total_minor |
integer | Yes | |
updated_at |
string | Yes | minLength: 1 |
user_id |
string or null | Yes | |
version |
integer | Yes |
required: ["id","product_id","booked_product_id","booked_home_name","location_id","timezone","channel","owner","status","overbooked","starts_at","ends_at","check_in_date","check_out_date","adults","children","infants","party_size","guest_name","guest_email","guest_phone","user_id","total_minor","currency","private_notes","provider","external_booking_id","channel_booking_id","channel_booking_url","conversation_id","cancelled_at","cancellation_reason","cancellation_policy","no_show_at","answers","version","created_at","updated_at","guest_image_url","payments","online_payment","paid_minor","payment_status"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
adults |
integer | Yes | |
check_in_date |
string | Yes | pattern: "^\d{4}-\d{2}-\d{2}$" |
check_out_date |
string | Yes | pattern: "^\d{4}-\d{2}-\d{2}$" |
children |
integer | Yes | |
ends_at |
string | Yes | Checkout: an ISO instant at the home's checkout time, or the day alone when the home has no checkout time. minLength: 1 |
guest_name |
string or null | Yes | The guest as their conversation names them; null for a channel conversation that names no one. |
id |
string | Yes | minLength: 1 |
infants |
integer | Yes | |
location_id |
string | Yes | minLength: 1 |
no_show_at |
string or null | Yes | When the host recorded that the guest never arrived; null otherwise. |
product_id |
string | Yes | minLength: 1 |
starts_at |
string | Yes | Check-in: an ISO instant at the home's check-in time (or the arrival the host recorded), or the day alone when the home has no check-in time. minLength: 1 |
status |
string | Yes | enum: ["pending","confirmed","cancelled"] |
timezone |
string | Yes | minLength: 1 |
additionalProperties: false; required: ["id","product_id","location_id","timezone","status","starts_at","ends_at","check_in_date","check_out_date","adults","children","infants","guest_name","no_show_at"]
object or null fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
name |
string or null | Yes |
additionalProperties: false; required: ["name"]
array of object fields
Value: array of object.
Array items: object.
array of object fields
Value: array of object.
minItems: 1
Array items: object.
array of object fields
Value: array of object.
Array items: object.
array of object fields
Value: array of object.
Array items: object.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
note |
string | No | |
rows |
array of array of number or string or null (fields) | No |
array of object fields
Value: array of object.
Array items: object.
array of object fields
Value: array of object.
Array items: object.
array of object fields
Value: array of object.
Array items: object.
array of object fields
Value: array of object.
Array items: object.
array of object fields
Value: array of object.
Array items: object.
array of object fields
Value: array of object.
Array items: object.
array of object fields
Value: array of object.
Array items: object.
array of string fields
Value: array of string.
minItems: 1; uniqueItems: true
Array items: string.
array of string fields
Value: array of string.
uniqueItems: true
Array items: string.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
label |
string or null | No | |
url |
string or null | No |
additionalProperties: false; required: []
array of object fields
Value: array of object.
Array items: object.
string fields
Value: string.
anyOf: shape 1, shape 2, shape 3, shape 4, shape 5, shape 6, shape 7, shape 8.
array of #/$defs/content_block_media fields
Value: array of #/$defs/content_block_media.
Array items: #/$defs/content_block_media.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: ["text"] |
id |
string | Yes | |
level |
number or null | Yes | |
media |
array of #/$defs/content_block_media (fields) | Yes | |
parent_block_id |
string or null | Yes | |
position |
integer | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "heading" |
updated_at |
string | Yes | The block's own concurrency token, for replace_content_block and delete_content_block. |
additionalProperties: false; required: ["id","parent_block_id","type","level","data","media","updated_at"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: ["markdown","editor_mode"] |
id |
string | Yes | |
level |
number or null | Yes | |
media |
array of #/$defs/content_block_media (fields) | Yes | |
parent_block_id |
string or null | Yes | |
position |
integer | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "markdown" |
updated_at |
string | Yes | The block's own concurrency token, for replace_content_block and delete_content_block. |
additionalProperties: false; required: ["id","parent_block_id","type","level","data","media","updated_at"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: [] |
id |
string | Yes | |
level |
number or null | Yes | |
media |
array of #/$defs/content_block_media (fields) | Yes | |
parent_block_id |
string or null | Yes | |
position |
integer | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "image" |
updated_at |
string | Yes | The block's own concurrency token, for replace_content_block and delete_content_block. |
additionalProperties: false; required: ["id","parent_block_id","type","level","data","media","updated_at"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: [] |
id |
string | Yes | |
level |
number or null | Yes | |
media |
array of #/$defs/content_block_media (fields) | Yes | |
parent_block_id |
string or null | Yes | |
position |
integer | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "gallery" |
updated_at |
string | Yes | The block's own concurrency token, for replace_content_block and delete_content_block. |
additionalProperties: false; required: ["id","parent_block_id","type","level","data","media","updated_at"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: ["url","title"] |
id |
string | Yes | |
level |
number or null | Yes | |
media |
array of #/$defs/content_block_media (fields) | Yes | |
parent_block_id |
string or null | Yes | |
position |
integer | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "video" |
updated_at |
string | Yes | The block's own concurrency token, for replace_content_block and delete_content_block. |
additionalProperties: false; required: ["id","parent_block_id","type","level","data","media","updated_at"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: ["source"] |
id |
string | Yes | |
level |
number or null | Yes | |
media |
array of #/$defs/content_block_media (fields) | Yes | |
parent_block_id |
string or null | Yes | |
position |
integer | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "faq" |
updated_at |
string | Yes | The block's own concurrency token, for replace_content_block and delete_content_block. |
additionalProperties: false; required: ["id","parent_block_id","type","level","data","media","updated_at"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: ["steps"] |
id |
string | Yes | |
level |
number or null | Yes | |
media |
array of #/$defs/content_block_media (fields) | Yes | |
parent_block_id |
string or null | Yes | |
position |
integer | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "how_to" |
updated_at |
string | Yes | The block's own concurrency token, for replace_content_block and delete_content_block. |
additionalProperties: false; required: ["id","parent_block_id","type","level","data","media","updated_at"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: [] |
id |
string | Yes | |
level |
number or null | Yes | |
media |
array of #/$defs/content_block_media (fields) | Yes | |
parent_block_id |
string or null | Yes | |
position |
integer | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "divider" |
updated_at |
string | Yes | The block's own concurrency token, for replace_content_block and delete_content_block. |
additionalProperties: false; required: ["id","parent_block_id","type","level","data","media","updated_at"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: [] |
id |
string | Yes | |
level |
number or null | Yes | |
media |
array of #/$defs/content_block_media (fields) | Yes | |
parent_block_id |
string or null | Yes | |
position |
integer | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "cta" |
updated_at |
string | Yes | The block's own concurrency token, for replace_content_block and delete_content_block. |
additionalProperties: false; required: ["id","parent_block_id","type","level","data","media","updated_at"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: [] |
id |
string | Yes | |
level |
number or null | Yes | |
media |
array of #/$defs/content_block_media (fields) | Yes | |
parent_block_id |
string or null | Yes | |
position |
integer | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "contact_cta" |
updated_at |
string | Yes | The block's own concurrency token, for replace_content_block and delete_content_block. |
additionalProperties: false; required: ["id","parent_block_id","type","level","data","media","updated_at"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: [] |
id |
string | Yes | |
level |
number or null | Yes | |
media |
array of #/$defs/content_block_media (fields) | Yes | |
parent_block_id |
string or null | Yes | |
position |
integer | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "booking_cta" |
updated_at |
string | Yes | The block's own concurrency token, for replace_content_block and delete_content_block. |
additionalProperties: false; required: ["id","parent_block_id","type","level","data","media","updated_at"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: [] |
id |
string | Yes | |
level |
number or null | Yes | |
media |
array of #/$defs/content_block_media (fields) | Yes | |
parent_block_id |
string or null | Yes | |
position |
integer | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "callout" |
updated_at |
string | Yes | The block's own concurrency token, for replace_content_block and delete_content_block. |
additionalProperties: false; required: ["id","parent_block_id","type","level","data","media","updated_at"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: ["title"] |
id |
string | Yes | |
level |
number or null | Yes | |
media |
array of #/$defs/content_block_media (fields) | Yes | |
parent_block_id |
string or null | Yes | |
position |
integer | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "hero" |
updated_at |
string | Yes | The block's own concurrency token, for replace_content_block and delete_content_block. |
additionalProperties: false; required: ["id","parent_block_id","type","level","data","media","updated_at"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: [] |
id |
string | Yes | |
level |
number or null | Yes | |
media |
array of #/$defs/content_block_media (fields) | Yes | |
parent_block_id |
string or null | Yes | |
position |
integer | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "button_group" |
updated_at |
string | Yes | The block's own concurrency token, for replace_content_block and delete_content_block. |
additionalProperties: false; required: ["id","parent_block_id","type","level","data","media","updated_at"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: [] |
id |
string | Yes | |
level |
number or null | Yes | |
media |
array of #/$defs/content_block_media (fields) | Yes | |
parent_block_id |
string or null | Yes | |
position |
integer | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "feature_grid" |
updated_at |
string | Yes | The block's own concurrency token, for replace_content_block and delete_content_block. |
additionalProperties: false; required: ["id","parent_block_id","type","level","data","media","updated_at"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: [] |
id |
string | Yes | |
level |
number or null | Yes | |
media |
array of #/$defs/content_block_media (fields) | Yes | |
parent_block_id |
string or null | Yes | |
position |
integer | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "comparison" |
updated_at |
string | Yes | The block's own concurrency token, for replace_content_block and delete_content_block. |
additionalProperties: false; required: ["id","parent_block_id","type","level","data","media","updated_at"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: [] |
id |
string | Yes | |
level |
number or null | Yes | |
media |
array of #/$defs/content_block_media (fields) | Yes | |
parent_block_id |
string or null | Yes | |
position |
integer | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "stat_grid" |
updated_at |
string | Yes | The block's own concurrency token, for replace_content_block and delete_content_block. |
additionalProperties: false; required: ["id","parent_block_id","type","level","data","media","updated_at"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: [] |
id |
string | Yes | |
level |
number or null | Yes | |
media |
array of #/$defs/content_block_media (fields) | Yes | |
parent_block_id |
string or null | Yes | |
position |
integer | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "workflow_grid" |
updated_at |
string | Yes | The block's own concurrency token, for replace_content_block and delete_content_block. |
additionalProperties: false; required: ["id","parent_block_id","type","level","data","media","updated_at"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: [] |
id |
string | Yes | |
level |
number or null | Yes | |
media |
array of #/$defs/content_block_media (fields) | Yes | |
parent_block_id |
string or null | Yes | |
position |
integer | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "showcase" |
updated_at |
string | Yes | The block's own concurrency token, for replace_content_block and delete_content_block. |
additionalProperties: false; required: ["id","parent_block_id","type","level","data","media","updated_at"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: [] |
id |
string | Yes | |
level |
number or null | Yes | |
media |
array of #/$defs/content_block_media (fields) | Yes | |
parent_block_id |
string or null | Yes | |
position |
integer | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "language_reach" |
updated_at |
string | Yes | The block's own concurrency token, for replace_content_block and delete_content_block. |
additionalProperties: false; required: ["id","parent_block_id","type","level","data","media","updated_at"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: [] |
id |
string | Yes | |
level |
number or null | Yes | |
media |
array of #/$defs/content_block_media (fields) | Yes | |
parent_block_id |
string or null | Yes | |
position |
integer | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "steps" |
updated_at |
string | Yes | The block's own concurrency token, for replace_content_block and delete_content_block. |
additionalProperties: false; required: ["id","parent_block_id","type","level","data","media","updated_at"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: [] |
id |
string | Yes | |
level |
number or null | Yes | |
media |
array of #/$defs/content_block_media (fields) | Yes | |
parent_block_id |
string or null | Yes | |
position |
integer | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "video_feature" |
updated_at |
string | Yes | The block's own concurrency token, for replace_content_block and delete_content_block. |
additionalProperties: false; required: ["id","parent_block_id","type","level","data","media","updated_at"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: [] |
id |
string | Yes | |
level |
number or null | Yes | |
media |
array of #/$defs/content_block_media (fields) | Yes | |
parent_block_id |
string or null | Yes | |
position |
integer | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "media_text" |
updated_at |
string | Yes | The block's own concurrency token, for replace_content_block and delete_content_block. |
additionalProperties: false; required: ["id","parent_block_id","type","level","data","media","updated_at"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: [] |
id |
string | Yes | |
level |
number or null | Yes | |
media |
array of #/$defs/content_block_media (fields) | Yes | |
parent_block_id |
string or null | Yes | |
position |
integer | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "contact_form" |
updated_at |
string | Yes | The block's own concurrency token, for replace_content_block and delete_content_block. |
additionalProperties: false; required: ["id","parent_block_id","type","level","data","media","updated_at"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: [] |
id |
string | Yes | |
level |
number or null | Yes | |
media |
array of #/$defs/content_block_media (fields) | Yes | |
parent_block_id |
string or null | Yes | |
position |
integer | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "team_grid" |
updated_at |
string | Yes | The block's own concurrency token, for replace_content_block and delete_content_block. |
additionalProperties: false; required: ["id","parent_block_id","type","level","data","media","updated_at"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: [] |
id |
string | Yes | |
level |
number or null | Yes | |
media |
array of #/$defs/content_block_media (fields) | Yes | |
parent_block_id |
string or null | Yes | |
position |
integer | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "testimonial_grid" |
updated_at |
string | Yes | The block's own concurrency token, for replace_content_block and delete_content_block. |
additionalProperties: false; required: ["id","parent_block_id","type","level","data","media","updated_at"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: [] |
id |
string | Yes | |
level |
number or null | Yes | |
media |
array of #/$defs/content_block_media (fields) | Yes | |
parent_block_id |
string or null | Yes | |
position |
integer | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "donation_choices" |
updated_at |
string | Yes | The block's own concurrency token, for replace_content_block and delete_content_block. |
additionalProperties: false; required: ["id","parent_block_id","type","level","data","media","updated_at"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: ["page_ids"] |
id |
string | Yes | |
level |
number or null | Yes | |
media |
array of #/$defs/content_block_media (fields) | Yes | |
parent_block_id |
string or null | Yes | |
position |
integer | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "page_grid" |
updated_at |
string | Yes | The block's own concurrency token, for replace_content_block and delete_content_block. |
additionalProperties: false; required: ["id","parent_block_id","type","level","data","media","updated_at"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: [] |
id |
string | Yes | |
level |
number or null | Yes | |
media |
array of #/$defs/content_block_media (fields) | Yes | |
parent_block_id |
string or null | Yes | |
position |
integer | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "product_grid" |
updated_at |
string | Yes | The block's own concurrency token, for replace_content_block and delete_content_block. |
additionalProperties: false; required: ["id","parent_block_id","type","level","data","media","updated_at"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: [] |
id |
string | Yes | |
level |
number or null | Yes | |
media |
array of #/$defs/content_block_media (fields) | Yes | |
parent_block_id |
string or null | Yes | |
position |
integer | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "location_grid" |
updated_at |
string | Yes | The block's own concurrency token, for replace_content_block and delete_content_block. |
additionalProperties: false; required: ["id","parent_block_id","type","level","data","media","updated_at"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: [] |
id |
string | Yes | |
level |
number or null | Yes | |
media |
array of #/$defs/content_block_media (fields) | Yes | |
parent_block_id |
string or null | Yes | |
position |
integer | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "social_posts" |
updated_at |
string | Yes | The block's own concurrency token, for replace_content_block and delete_content_block. |
additionalProperties: false; required: ["id","parent_block_id","type","level","data","media","updated_at"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: [] |
id |
string | Yes | |
level |
number or null | Yes | |
media |
array of #/$defs/content_block_media (fields) | Yes | |
parent_block_id |
string or null | Yes | |
position |
integer | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "ai_assistance" |
updated_at |
string | Yes | The block's own concurrency token, for replace_content_block and delete_content_block. |
additionalProperties: false; required: ["id","parent_block_id","type","level","data","media","updated_at"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: ["text"] |
id |
string | No | |
level |
integer or null | No | maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | No | |
parent_block_id |
string or null | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "heading" |
updated_at |
string or null | No | As read. Ignored on a whole-document write. |
additionalProperties: false; required: ["type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: ["markdown","editor_mode"] |
id |
string | No | |
level |
integer or null | No | maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | No | |
parent_block_id |
string or null | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "markdown" |
updated_at |
string or null | No | As read. Ignored on a whole-document write. |
additionalProperties: false; required: ["type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: [] |
id |
string | No | |
level |
integer or null | No | maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | No | |
parent_block_id |
string or null | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "image" |
updated_at |
string or null | No | As read. Ignored on a whole-document write. |
additionalProperties: false; required: ["type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: [] |
id |
string | No | |
level |
integer or null | No | maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | No | |
parent_block_id |
string or null | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "gallery" |
updated_at |
string or null | No | As read. Ignored on a whole-document write. |
additionalProperties: false; required: ["type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: ["url","title"] |
id |
string | No | |
level |
integer or null | No | maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | No | |
parent_block_id |
string or null | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "video" |
updated_at |
string or null | No | As read. Ignored on a whole-document write. |
additionalProperties: false; required: ["type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: ["source"] |
id |
string | No | |
level |
integer or null | No | maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | No | |
parent_block_id |
string or null | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "faq" |
updated_at |
string or null | No | As read. Ignored on a whole-document write. |
additionalProperties: false; required: ["type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: ["steps"] |
id |
string | No | |
level |
integer or null | No | maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | No | |
parent_block_id |
string or null | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "how_to" |
updated_at |
string or null | No | As read. Ignored on a whole-document write. |
additionalProperties: false; required: ["type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: [] |
id |
string | No | |
level |
integer or null | No | maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | No | |
parent_block_id |
string or null | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "divider" |
updated_at |
string or null | No | As read. Ignored on a whole-document write. |
additionalProperties: false; required: ["type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: [] |
id |
string | No | |
level |
integer or null | No | maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | No | |
parent_block_id |
string or null | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "cta" |
updated_at |
string or null | No | As read. Ignored on a whole-document write. |
additionalProperties: false; required: ["type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: [] |
id |
string | No | |
level |
integer or null | No | maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | No | |
parent_block_id |
string or null | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "contact_cta" |
updated_at |
string or null | No | As read. Ignored on a whole-document write. |
additionalProperties: false; required: ["type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: [] |
id |
string | No | |
level |
integer or null | No | maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | No | |
parent_block_id |
string or null | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "booking_cta" |
updated_at |
string or null | No | As read. Ignored on a whole-document write. |
additionalProperties: false; required: ["type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: [] |
id |
string | No | |
level |
integer or null | No | maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | No | |
parent_block_id |
string or null | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "callout" |
updated_at |
string or null | No | As read. Ignored on a whole-document write. |
additionalProperties: false; required: ["type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: ["title"] |
id |
string | No | |
level |
integer or null | No | maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | No | |
parent_block_id |
string or null | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "hero" |
updated_at |
string or null | No | As read. Ignored on a whole-document write. |
additionalProperties: false; required: ["type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: [] |
id |
string | No | |
level |
integer or null | No | maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | No | |
parent_block_id |
string or null | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "button_group" |
updated_at |
string or null | No | As read. Ignored on a whole-document write. |
additionalProperties: false; required: ["type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: [] |
id |
string | No | |
level |
integer or null | No | maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | No | |
parent_block_id |
string or null | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "feature_grid" |
updated_at |
string or null | No | As read. Ignored on a whole-document write. |
additionalProperties: false; required: ["type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: [] |
id |
string | No | |
level |
integer or null | No | maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | No | |
parent_block_id |
string or null | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "comparison" |
updated_at |
string or null | No | As read. Ignored on a whole-document write. |
additionalProperties: false; required: ["type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: [] |
id |
string | No | |
level |
integer or null | No | maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | No | |
parent_block_id |
string or null | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "stat_grid" |
updated_at |
string or null | No | As read. Ignored on a whole-document write. |
additionalProperties: false; required: ["type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: [] |
id |
string | No | |
level |
integer or null | No | maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | No | |
parent_block_id |
string or null | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "workflow_grid" |
updated_at |
string or null | No | As read. Ignored on a whole-document write. |
additionalProperties: false; required: ["type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: [] |
id |
string | No | |
level |
integer or null | No | maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | No | |
parent_block_id |
string or null | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "showcase" |
updated_at |
string or null | No | As read. Ignored on a whole-document write. |
additionalProperties: false; required: ["type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: [] |
id |
string | No | |
level |
integer or null | No | maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | No | |
parent_block_id |
string or null | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "language_reach" |
updated_at |
string or null | No | As read. Ignored on a whole-document write. |
additionalProperties: false; required: ["type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: [] |
id |
string | No | |
level |
integer or null | No | maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | No | |
parent_block_id |
string or null | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "steps" |
updated_at |
string or null | No | As read. Ignored on a whole-document write. |
additionalProperties: false; required: ["type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: [] |
id |
string | No | |
level |
integer or null | No | maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | No | |
parent_block_id |
string or null | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "video_feature" |
updated_at |
string or null | No | As read. Ignored on a whole-document write. |
additionalProperties: false; required: ["type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: [] |
id |
string | No | |
level |
integer or null | No | maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | No | |
parent_block_id |
string or null | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "media_text" |
updated_at |
string or null | No | As read. Ignored on a whole-document write. |
additionalProperties: false; required: ["type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: [] |
id |
string | No | |
level |
integer or null | No | maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | No | |
parent_block_id |
string or null | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "contact_form" |
updated_at |
string or null | No | As read. Ignored on a whole-document write. |
additionalProperties: false; required: ["type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: [] |
id |
string | No | |
level |
integer or null | No | maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | No | |
parent_block_id |
string or null | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "team_grid" |
updated_at |
string or null | No | As read. Ignored on a whole-document write. |
additionalProperties: false; required: ["type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: [] |
id |
string | No | |
level |
integer or null | No | maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | No | |
parent_block_id |
string or null | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "testimonial_grid" |
updated_at |
string or null | No | As read. Ignored on a whole-document write. |
additionalProperties: false; required: ["type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: [] |
id |
string | No | |
level |
integer or null | No | maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | No | |
parent_block_id |
string or null | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "donation_choices" |
updated_at |
string or null | No | As read. Ignored on a whole-document write. |
additionalProperties: false; required: ["type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: ["page_ids"] |
id |
string | No | |
level |
integer or null | No | maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | No | |
parent_block_id |
string or null | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "page_grid" |
updated_at |
string or null | No | As read. Ignored on a whole-document write. |
additionalProperties: false; required: ["type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: [] |
id |
string | No | |
level |
integer or null | No | maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | No | |
parent_block_id |
string or null | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "product_grid" |
updated_at |
string or null | No | As read. Ignored on a whole-document write. |
additionalProperties: false; required: ["type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: [] |
id |
string | No | |
level |
integer or null | No | maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | No | |
parent_block_id |
string or null | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "location_grid" |
updated_at |
string or null | No | As read. Ignored on a whole-document write. |
additionalProperties: false; required: ["type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: [] |
id |
string | No | |
level |
integer or null | No | maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | No | |
parent_block_id |
string or null | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "social_posts" |
updated_at |
string or null | No | As read. Ignored on a whole-document write. |
additionalProperties: false; required: ["type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data |
object (fields) | Yes | additionalProperties: false; required: [] |
id |
string | No | |
level |
integer or null | No | maximum: 6; minimum: 1 |
media |
array of #/$defs/content_block_media (fields) | No | |
parent_block_id |
string or null | No | |
source_block_id |
string or null | No | |
type |
string | Yes | const: "ai_assistance" |
updated_at |
string or null | No | As read. Ignored on a whole-document write. |
additionalProperties: false; required: ["type","data"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
channel |
string | Yes | enum: ["email","airbnb","team"] |
required: ["channel"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
id |
string | Yes | |
type |
string | Yes | enum: ["message","day","event"] |
required: ["id","type"]
array of string fields
Value: array of string.
maxItems: 100; minItems: 1; uniqueItems: true
Array items: string.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
details |
string or null | Yes | |
task |
string | Yes | minLength: 1 |
additionalProperties: false; required: ["task","details"]
object or null fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
values |
object (fields) | Yes | additionalProperties: false |
additionalProperties: false; required: ["values"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
description |
string or null | Yes | |
name |
string | Yes |
additionalProperties: false; required: ["name","description"]
object or null fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
route_path |
string or null | Yes | |
values |
object (fields) | Yes | additionalProperties: false |
additionalProperties: false; required: ["values","route_path"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
description |
string | Yes | |
details |
object (fields) | Yes | additionalProperties: false |
marketing_features |
array of string (fields) | Yes | |
name |
string | Yes | |
unit_label |
string or null | Yes |
additionalProperties: false; required: ["name","description","marketing_features","unit_label","details"]
See schema fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
resource_type |
string | No | const: "organization" |
values |
object (fields) | No | additionalProperties: false |
See schema fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
resource_type |
string | No | const: "business_location" |
values |
object (fields) | No | additionalProperties: false |
See schema fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
resource_type |
string | No | const: "product" |
values |
object (fields) | No | additionalProperties: false |
See schema fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
resource_type |
string | No | const: "collection" |
values |
object (fields) | No | additionalProperties: false |
See schema fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
resource_type |
string | No | const: "article_category" |
values |
object (fields) | No | additionalProperties: false |
See schema fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
resource_type |
string | No | const: "media_asset" |
values |
object (fields) | No | additionalProperties: false |
string fields
Value: string.
pattern: "^[\s\S]\S[\s\S]$"
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
label |
string | Yes | pattern: "^[\s\S]\S[\s\S]$" |
additionalProperties: false; required: ["label"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
address |
object (fields) | No | additionalProperties: false |
alt_text |
string | No | |
brand_description |
string | No | |
compliance |
object (fields) | No | additionalProperties: false |
consultation |
object (fields) | No | additionalProperties: false |
description |
string | No | |
details |
object (fields) | No | additionalProperties: false |
inquiry_questions |
object | No | Translated question wording keyed by question ID: { label?, help_text?, choices?: { |
marketing_features |
array of string (fields) | No | |
name |
string | No | |
questions |
object | No | Translated question wording keyed by question ID: { label?, help_text?, choices?: { |
seo_description |
string | No | |
seo_title |
string | No | |
short_description |
string | No | |
title |
string | No | |
unit_label |
string | No |
additionalProperties: false
See schema fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
values |
object (fields) | No | additionalProperties: false |
See schema fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
values |
object (fields) | No | additionalProperties: false |
See schema fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
values |
object (fields) | No | additionalProperties: false |
See schema fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
values |
object (fields) | No | additionalProperties: false |
See schema fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
values |
object (fields) | No | additionalProperties: false |
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
alt_text |
string or null | No | |
asset_id |
string | Yes | |
kind |
string | Yes | enum: ["image","video"] |
public_url |
string | Yes | |
sort_order |
number | Yes | |
thumbnail_url |
string or null | No |
required: ["asset_id","kind","public_url","sort_order"]
string fields
Value: string.
minLength: 1; pattern: "^[\s\S]\S[\s\S]$"
array of object fields
Value: array of object.
Array items: object.
object fields
Value: object.
string fields
Value: string.
anyOf: shape 1, shape 2, shape 3, shape 4, shape 5, shape 6, shape 7, shape 8.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
asset_id |
string | Yes | |
kind |
string | Yes | |
public_url |
string or null | Yes | |
slot |
string | Yes | |
thumbnail_url |
string or null | Yes |
required: ["asset_id","slot","public_url","thumbnail_url","kind"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
choices |
array of object (fields) | Yes | maxItems: 20 |
help_text |
string or null | Yes | maxLength: 500 |
id |
string | Yes | Stable question ID; submissions answer by this ID. maxLength: 64; pattern: "^[a-z0-9][a-z0-9_-]{0,63}$" |
label |
string | Yes | maxLength: 200; minLength: 1 |
required |
boolean | Yes | |
type |
string | Yes | enum: ["short_text","long_text","single_choice","multiple_choice","yes_no"] |
additionalProperties: false; required: ["id","label","type","required","help_text","choices"]
object or null fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
account_id |
string | No | |
connected_at |
string | No | |
connected_through |
object or null (fields) | No | |
last_error |
string or null | No | |
measurement_id |
string or null | No | |
status |
string or null | No | |
target_id |
string or null | No | |
target_name |
string or null | No | |
verified |
boolean or null | No |
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
email |
string | Yes | |
id |
string | Yes | |
image |
string or null | No | |
name |
string | Yes |
required: ["id","name","email"]
array of object fields
Value: array of object.
maxItems: 20
Array items: object.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
amount |
integer | Yes | |
currency |
string | Yes |
required: ["currency","amount"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
label |
string | Yes | |
url |
string | Yes |
additionalProperties: false; required: ["label","url"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
alt_text |
string or null | No | |
asset_id |
string | Yes | |
duration |
number or null | No | |
height |
number or null | No | |
kind |
string | Yes | enum: ["image","video"] |
mime_type |
string or null | No | |
public_url |
string | Yes | |
slot |
string | Yes | enum: ["cover","gallery"] |
sort_order |
number | Yes | |
thumbnail_url |
string or null | No | |
updated_at |
string | No | |
width |
number or null | No |
required: ["asset_id","public_url","kind","slot","sort_order"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
channel |
string | Yes | enum: ["facebook","instagram","discord"] |
code |
string or null | Yes | |
id |
string | Yes | The publication_id reconcile_post_publication takes. |
local_content_changed |
boolean | Yes | The website copy changed after this was sent. The external post was not edited. |
message |
string or null | Yes | |
provider_post_id |
string or null | Yes | |
public_url |
string or null | Yes | The provider's own permalink, when it returned one. A Discord message link opens only for members of that channel. |
published_at |
string or null | Yes | |
state |
string | Yes | enum: ["preparing","publishing","published","failed","unknown","removed"] |
target_id |
string | Yes |
additionalProperties: false; required: ["id","channel","target_id","state","provider_post_id","public_url","code","message","published_at","local_content_changed"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
kind |
string | Yes | enum: ["image","video"] |
provider_media_id |
string or null | Yes | |
public_url |
string or null | Yes | |
thumbnail_url |
string or null | Yes |
additionalProperties: false; required: ["provider_media_id","kind","public_url","thumbnail_url"]
array of object fields
Value: array of object.
Array items: object.
array of string fields
Value: array of string.
Array items: string.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
channel |
enum | Yes | enum: ["organization"] |
additionalProperties: false; required: ["channel"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
channel |
enum | Yes | enum: ["facebook","instagram","discord"] |
connection_revision |
string | Yes | The connection_revision get_social_connections returned with it. |
target_id |
string | Yes | The Page, professional account or Discord channel id from get_social_connections. |
additionalProperties: false; required: ["channel","target_id","connection_revision"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
capacity |
integer or null | No | minimum: 1 |
ends_at |
string | Yes | format: "date-time" |
starts_at |
string | Yes | format: "date-time" |
additionalProperties: false; required: ["starts_at","ends_at"]
string fields
Value: string.
maxLength: 1000; minLength: 1; pattern: "^(?=[\s\S]\S)[^\r\n]$"
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
available |
boolean or null | Yes | |
code |
string | Yes | enum: ["ac","dryer","essentials","heating","hot_water","kitchen","tv","washer","wireless_internet","bathtub","bidet","body_soap","cleaning_products","conditioner","hair_dryer","alfresco_shower","shampoo","shower_gel","bed_linens","wardrobe_or_closet","clothes_drying_rack","extra_pillows_and_blankets","hangers","iron","mosquito_net","room_darkening_shades","safe","arcade_machine","batting_cage","books","bowling_alley","climbing_wall","ethernet_connection","exercise_equipment","game_console","laser_tag","life_size_games","mini_golf","home_theater","piano","ping_pong_table","pool_table","record_player","skate_ramp","sound_system","theme_room","baby_bath","baby_monitor","childrens_bike","playroom","stair_gates","babysitter_recommendations","board_games","changing_table","childrens_books_and_toys","childrens_dinnerware","crib","fireplace_guards","high_chair","playground","outlet_covers","pack_n_play_travel_crib","table_corner_guards","window_guards","ceiling_fan","fireplace","portable_fans","carbon_monoxide_detector","fire_extinguisher","first_aid_kit","smoke_detector","laptop_friendly_workspace","pocket_wifi","baking_sheet","barbeque_utensils","bread_maker","blender","coffee","coffee_maker","cooking_basics","dining_table","dishes_and_silverware","dishwasher","freezer","hot_water_kettle","kitchenette","microwave","mini_fridge","oven","refrigerator","rice_maker","stove","toaster","trash_compacter","wine_glasses","beach_access","lake_access","laundromat_nearby","private_entrance","resort_access","ski_in_ski_out","waterfront","garden_or_backyard","bbq_area","beach_essentials","bicycle","boat_slip","fire_pit","hammock","kayak","alfresco_dining","outdoor_seating","outdoor_kitchen","patio_or_belcony","sun_loungers","free_parking","street_parking","paid_parking_on_premises","paid_parking","free_parking_off_premises","elevator","ev_charger","hockey_rink","gym","jacuzzi","pool","private_living_room","sauna","single_level_home","ebike_charger","solar_power","recycling","composting","doorman","gated_community","breakfast","cleaning_before_checkout","long_term_stays_allowed","luggage_dropoff_allowed","bay_view","beach_view","canal_view","city_view","courtyard_view","desert_view","garden_view","golf_view","harbor_view","lake_view","marina_view","mountain_view","ocean_view","park_view","pool_view","resort_view","river_view","sea_view","valley_view","vineyard_view","landmark_view"] |
additionalProperties: false; required: ["code","available"]
array of integer fields
Value: array of integer.
maxItems: 7; minItems: 7
Array items: integer.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
last_minute_percent |
integer | No | For bookings made 14 days or less before arrival maximum: 99; minimum: 1 |
monthly_percent |
integer | No | For stays of 28 nights or more maximum: 99; minimum: 1 |
weekly_percent |
integer | No | For stays of 7 nights or more maximum: 99; minimum: 1 |
additionalProperties: false
array of object fields
Value: array of object.
maxItems: 20
Array items: object.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
collection_id |
string | Yes | |
sort_order |
integer | Yes |
required: ["collection_id","sort_order"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
active |
boolean | Yes | |
location_id |
string | Yes | |
published |
boolean | Yes |
required: ["location_id","active","published"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
organization_id |
string | Yes | |
published |
boolean | Yes |
required: ["organization_id","published"]
array of string fields
Value: array of string.
uniqueItems: true
Array items: string.
array of object fields
Value: array of object.
Array items: object.
array of object fields
Value: array of object.
Array items: object.
array of object fields
Value: array of object.
maxItems: 20
Array items: object.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
active |
boolean | Yes | |
id |
string | Yes | |
name |
string | Yes | |
prices |
array of object (fields) | Yes | |
product_id |
string | Yes | |
sku |
string or null | Yes | |
sort_order |
integer | Yes |
additionalProperties: false; required: ["id","product_id","name","sku","active","sort_order","prices"]
array of object fields
Value: array of object.
Array items: object.
array of object fields
Value: array of object.
maxItems: 100; minItems: 1
Array items: object.
array of object fields
Value: array of object.
Array items: object.
string fields
Value: string.
maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$"
string fields
Value: string.
maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$"
string fields
Value: string.
maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$"
string fields
Value: string.
maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$"
string fields
Value: string.
maxLength: 10000; minLength: 1; pattern: "^[\s\S]\S[\s\S]$"
string fields
Value: string.
maxLength: 10000; minLength: 1; pattern: "^[\s\S]\S[\s\S]$"
string fields
Value: string.
maxLength: 10000; minLength: 1; pattern: "^[\s\S]\S[\s\S]$"
string fields
Value: string.
maxLength: 10000; minLength: 1; pattern: "^[\s\S]\S[\s\S]$"
string fields
Value: string.
maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$"
string fields
Value: string.
maxLength: 10000; minLength: 1; pattern: "^[\s\S]\S[\s\S]$"
string fields
Value: string.
maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$"
string fields
Value: string.
maxLength: 10000; minLength: 1; pattern: "^[\s\S]\S[\s\S]$"
string fields
Value: string.
maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$"
string fields
Value: string.
maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$"
string fields
Value: string.
maxLength: 10000; minLength: 1; pattern: "^[\s\S]\S[\s\S]$"
string fields
Value: string.
maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$"
string fields
Value: string.
maxLength: 10000; minLength: 1; pattern: "^[\s\S]\S[\s\S]$"
string fields
Value: string.
maxLength: 1000; minLength: 1; pattern: "^(?=[\s\S]\S)[^\r\n]$"
string fields
Value: string.
enum: ["00:00","01:00","02:00","03:00","04:00","05:00","06:00","07:00","08:00","09:00","10:00","11:00","12:00","13:00","14:00","15:00","16:00","17:00","18:00","19:00","20:00","21:00","22:00","23:00"]; maxLength: 1000; minLength: 1; pattern: "^(?=[\s\S]\S)[^\r\n]$"
string fields
Value: string.
enum: ["00:00","01:00","02:00","03:00","04:00","05:00","06:00","07:00","08:00","09:00","10:00","11:00","12:00","13:00","14:00","15:00","16:00","17:00","18:00","19:00","20:00","21:00","22:00","23:00"]; maxLength: 1000; minLength: 1; pattern: "^(?=[\s\S]\S)[^\r\n]$"
string fields
Value: string.
maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$"
string fields
Value: string.
maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$"
string fields
Value: string.
maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$"
string fields
Value: string.
maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$"
string fields
Value: string.
maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$"
string fields
Value: string.
maxLength: 1000; minLength: 1; pattern: "^(?=[\s\S]\S)[^\r\n]$"
string fields
Value: string.
maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$"
string fields
Value: string.
maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$"
string fields
Value: string.
maxLength: 300; minLength: 1; pattern: "^[\s\S]\S[\s\S]$"
string fields
Value: string.
maxLength: 10000; minLength: 1; pattern: "^[\s\S]\S[\s\S]$"
array of object fields
Value: array of object.
maxItems: 20
Array items: object.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
booking_count |
integer | Yes | minimum: 1 |
ends_at |
string | Yes | |
session_id |
string | Yes | |
starts_at |
string | Yes |
required: ["session_id","starts_at","ends_at","booking_count"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
end |
string | Yes | |
start |
string | Yes | |
weekday |
integer | Yes | maximum: 6; minimum: 0 |
required: ["weekday","start","end"]
array of object fields
Value: array of object.
Array items: object.
object or null fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
detail |
string or null | Yes | |
state |
string | Yes | enum: ["pending","pushed","needs_review"] |
required: ["state","detail"]
array of string fields
Value: array of string.
maxItems: 50; uniqueItems: true
Array items: string.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
available |
boolean or null | Yes | The host’s answer; null is unanswered. No review or approval is implied. |
feature |
string | Yes | enum: ["step_free_access","wide_doorway"] |
photo_ids |
array of string (fields) | Yes | Evidence image IDs in the home’s Product photo order. Empty for false or unknown answers. maxItems: 50; uniqueItems: true |
additionalProperties: false; required: ["feature","available","photo_ids"]
array of object fields
Value: array of object.
Array items: object.
string or array of string or boolean fields
Value: string or array of string or boolean.
anyOf: shape 1, shape 2, shape 3.
array of object fields
Value: array of object.
Array items: object.
array of object fields
Value: array of object.
Array items: object.
array of object fields
Value: array of object.
Array items: object.
array of object fields
Value: array of object.
Array items: object.
array of object fields
Value: array of object.
Array items: object.
boolean fields
Value: boolean.
array of object fields
Value: array of object.
Array items: object.
object or null fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
amount_minor |
integer | Yes | |
captured_minor |
integer | Yes | |
created_at |
string | Yes | minLength: 1 |
currency |
string | Yes | minLength: 1 |
payment_id |
string | Yes | minLength: 1 |
receipt_url |
string or null | Yes | |
refunded_minor |
integer | Yes |
required: ["payment_id","currency","amount_minor","captured_minor","refunded_minor","receipt_url","created_at"]
array of object fields
Value: array of object.
Array items: object.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
description |
string or null | No | |
title |
string | Yes |
additionalProperties: false; required: ["title"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
name |
string | Yes | |
text |
string or null | No |
additionalProperties: false; required: ["name"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
label |
string | Yes | |
url |
string or null | No |
additionalProperties: false; required: ["label"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
body |
string or null | No | Markdown. |
description |
string or null | No | |
icon |
string or null | No | |
label |
string or null | No | |
title |
string | Yes | |
url |
string or null | No | |
value |
string or null | No |
additionalProperties: false; required: ["title"]
array of array of number or string or null fields
Value: array of array of number or string or null.
Array items: array of number or string or null.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
title |
string | Yes | |
value |
string | Yes |
additionalProperties: false; required: ["value","title"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
description |
string or null | No | |
icon |
string or null | No | |
prompt |
string or null | No | |
title |
string | Yes |
additionalProperties: false; required: ["title"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
title |
string | Yes |
additionalProperties: false; required: ["title"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
locale |
string | Yes | enum: ["en","ja","th","vi"] |
title |
string | Yes |
additionalProperties: false; required: ["title","locale"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
title |
string | Yes | |
url |
string or null | No |
additionalProperties: false; required: ["title"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
bio |
string or null | No | |
first_name |
string | Yes | |
last_name |
string or null | No | |
title |
string or null | No |
additionalProperties: false; required: ["first_name"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
amount |
string or null | No | |
description |
string or null | No | |
title |
string | Yes |
additionalProperties: false; required: ["title"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
copy_label |
string or null | No | |
description |
string or null | No | |
prompt |
string or null | No | |
title |
string | Yes |
additionalProperties: false; required: ["title"]
string fields
Value: string.
enum: ["media","gallery","featured","decoration","parallax_sky","parallax_sky_xxs","parallax_sky_xs","parallax_sky_sm","parallax_sky_md","parallax_sky_lg","parallax_clouds","parallax_clouds_xxs","parallax_clouds_xs","parallax_clouds_sm","parallax_clouds_md","parallax_clouds_lg","parallax_mountains","parallax_mountains_xxs","parallax_mountains_xs","parallax_mountains_sm","parallax_mountains_md","parallax_mountains_lg","parallax_far_trees","parallax_far_trees_xxs","parallax_far_trees_xs","parallax_far_trees_sm","parallax_far_trees_md","parallax_far_trees_lg","parallax_building_trees","parallax_building_trees_xxs","parallax_building_trees_xs","parallax_building_trees_sm","parallax_building_trees_md","parallax_building_trees_lg","parallax_foreground","parallax_foreground_xxs","parallax_foreground_xs","parallax_foreground_sm","parallax_foreground_md","parallax_foreground_lg"]
string fields
Value: string.
examples: ["items.0.image"]; pattern: "^items\.\d+\.image$"
string fields
Value: string.
examples: ["items.0.left"]; pattern: "^items\.\d+\.left$"
string fields
Value: string.
examples: ["items.0.center"]; pattern: "^items\.\d+\.center$"
string fields
Value: string.
examples: ["items.0.right"]; pattern: "^items\.\d+\.right$"
string fields
Value: string.
examples: ["images.0"]; pattern: "^images\.\d+$"
string fields
Value: string.
examples: ["features.0.icon"]; pattern: "^features\.\d+\.icon$"
string fields
Value: string.
examples: ["people.0.image"]; pattern: "^people\.\d+\.image$"
string fields
Value: string.
minLength: 1
object fields
Value: object.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
ends_on |
string or null (fields) | Yes | |
kind |
string | Yes | const: "closure" |
note |
string or null | Yes | maxLength: 1000 |
starts_on |
string | Yes | Gregorian calendar date, YYYY-MM-DD. No timezone conversion. format: "date"; pattern: "^\d{4}-\d{2}-\d{2}$" |
additionalProperties: false; required: ["kind","starts_on","ends_on","note"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
date |
string | Yes | Gregorian calendar date, YYYY-MM-DD. No timezone conversion. format: "date"; pattern: "^\d{4}-\d{2}-\d{2}$" |
kind |
string | Yes | const: "hours" |
note |
string or null | Yes | maxLength: 1000 |
periods |
array of object (fields) | Yes |
additionalProperties: false; required: ["kind","date","periods","note"]
string fields
Value: string.
enum: ["media","featured","decoration","parallax_sky","parallax_sky_xxs","parallax_sky_xs","parallax_sky_sm","parallax_sky_md","parallax_sky_lg","parallax_clouds","parallax_clouds_xxs","parallax_clouds_xs","parallax_clouds_sm","parallax_clouds_md","parallax_clouds_lg","parallax_mountains","parallax_mountains_xxs","parallax_mountains_xs","parallax_mountains_sm","parallax_mountains_md","parallax_mountains_lg","parallax_far_trees","parallax_far_trees_xxs","parallax_far_trees_xs","parallax_far_trees_sm","parallax_far_trees_md","parallax_far_trees_lg","parallax_building_trees","parallax_building_trees_xxs","parallax_building_trees_xs","parallax_building_trees_sm","parallax_building_trees_md","parallax_building_trees_lg","parallax_foreground","parallax_foreground_xxs","parallax_foreground_xs","parallax_foreground_sm","parallax_foreground_md","parallax_foreground_lg"]
array of object fields
Value: array of object.
maxItems: 20
Array items: object.
object or null fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
email |
string or null | No | |
name |
string or null | No |
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
id |
string | No | Existing choice ID to keep. Omit for a new choice; one is assigned from its label. maxLength: 64; pattern: "^[a-z0-9][a-z0-9_-]{0,63}$" |
label |
string | Yes | maxLength: 120; minLength: 1 |
additionalProperties: false; required: ["label"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
code |
string | Yes | |
message |
string | Yes |
required: ["code","message"]
string fields
Value: string.
enum: ["list","read","publish","delete"]
integer fields
Value: integer.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
active |
boolean | No | |
compare_at_unit_amount |
integer or null | No | minimum: 0 |
currency |
string | No | ISO 4217 currency code. pattern: "^[A-Z]{3}$" |
id |
string | No | The id of a price this variant already has. Restating it keeps the price row, which payments and checkout holds reference; a price without an id is a new offer. |
location_id |
string or null | No | Scope this offer to one location, or null for every location the product is offered at. |
recurring_interval |
string or null | No | enum: ["day","week","month","year",null] |
recurring_interval_count |
integer or null | No | minimum: 1 |
tax_behavior |
string | No | enum: ["unspecified","inclusive","exclusive"] |
type |
string | No | enum: ["one_time","recurring"] |
unit_amount |
integer | Yes | maximum: 9007199254740991; minimum: 0 |
valid_from_at |
string or null | No | format: "date-time" |
valid_until_at |
string or null | No | format: "date-time" |
additionalProperties: false; required: ["unit_amount"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
available |
boolean | Yes | |
code |
string | Yes | enum: ["ac","dryer","essentials","heating","hot_water","kitchen","tv","washer","wireless_internet","bathtub","bidet","body_soap","cleaning_products","conditioner","hair_dryer","alfresco_shower","shampoo","shower_gel","bed_linens","wardrobe_or_closet","clothes_drying_rack","extra_pillows_and_blankets","hangers","iron","mosquito_net","room_darkening_shades","safe","arcade_machine","batting_cage","books","bowling_alley","climbing_wall","ethernet_connection","exercise_equipment","game_console","laser_tag","life_size_games","mini_golf","home_theater","piano","ping_pong_table","pool_table","record_player","skate_ramp","sound_system","theme_room","baby_bath","baby_monitor","childrens_bike","playroom","stair_gates","babysitter_recommendations","board_games","changing_table","childrens_books_and_toys","childrens_dinnerware","crib","fireplace_guards","high_chair","playground","outlet_covers","pack_n_play_travel_crib","table_corner_guards","window_guards","ceiling_fan","fireplace","portable_fans","carbon_monoxide_detector","fire_extinguisher","first_aid_kit","smoke_detector","laptop_friendly_workspace","pocket_wifi","baking_sheet","barbeque_utensils","bread_maker","blender","coffee","coffee_maker","cooking_basics","dining_table","dishes_and_silverware","dishwasher","freezer","hot_water_kettle","kitchenette","microwave","mini_fridge","oven","refrigerator","rice_maker","stove","toaster","trash_compacter","wine_glasses","beach_access","lake_access","laundromat_nearby","private_entrance","resort_access","ski_in_ski_out","waterfront","garden_or_backyard","bbq_area","beach_essentials","bicycle","boat_slip","fire_pit","hammock","kayak","alfresco_dining","outdoor_seating","outdoor_kitchen","patio_or_belcony","sun_loungers","free_parking","street_parking","paid_parking_on_premises","paid_parking","free_parking_off_premises","elevator","ev_charger","hockey_rink","gym","jacuzzi","pool","private_living_room","sauna","single_level_home","ebike_charger","solar_power","recycling","composting","doorman","gated_community","breakfast","cleaning_before_checkout","long_term_stays_allowed","luggage_dropoff_allowed","bay_view","beach_view","canal_view","city_view","courtyard_view","desert_view","garden_view","golf_view","harbor_view","lake_view","marina_view","mountain_view","ocean_view","park_view","pool_view","resort_view","river_view","sea_view","valley_view","vineyard_view","landmark_view"] |
additionalProperties: false; required: ["code","available"]
array of object fields
Value: array of object.
Array items: object.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
currency |
string | Yes | ISO 4217 currency code. pattern: "^[A-Z]{3}$" |
location_id |
string or null | Yes | |
recurring_interval |
string | No | enum: ["day","week","month","year"] |
recurring_interval_count |
integer | No | minimum: 1 |
type |
string | Yes | enum: ["one_time","recurring"] |
unit_amount |
integer | Yes | minimum: 0 |
variant_id |
string | Yes |
required: ["variant_id","location_id","currency","unit_amount","type"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
active |
boolean | No | Enable or disable this product. Increasing the number of live homes requires the dashboard. |
description |
string | No | |
details |
object (fields) | No | Named customer-facing facts for the product kind. This is a complete replacement map; preserve fields to retain. pricing_note contains explicitly stated price wording and requires empty numeric prices. additionalProperties: false |
kind |
string | No | const: "dish" |
marketing_features |
array of string (fields) | No | Generic selling bullets. Inclusions, preparation instructions and policies are separate details. maxItems: 15 |
metadata |
object | No | Opaque string annotations for integrations. No pricing, scheduling, stock or filtering behavior may read these. additionalProperties: {"type":"string"} |
name |
string | Yes | |
order_url |
string or null | No | External ordering or booking destination, such as Uber Eats, an experience checkout, or Clio Grow. When set, public actions use this URL instead of native booking. Null restores the configured native flow. |
product_id |
string | No | |
tax_code |
string or null | No | |
unit_label |
string or null | No | A unit noun such as "person" or "night". Never pricing prose. |
variants |
array of object (fields) | No | Partial existing variants by id or new variants. Omitted variants and prices remain; use update_product for intentional removal. maxItems: 250; minItems: 1 |
additionalProperties: false; required: ["name"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
active |
boolean | Yes | The merchant sale switch. Not visibility and not stock: a disabled product is not sold out. |
collections |
array of object (fields) | Yes | |
description |
string | Yes | |
details |
object (fields) | Yes | additionalProperties: false |
id |
string | Yes | |
kind |
string | Yes | const: "dish" |
locations |
array of object (fields) | Yes | |
marketing_features |
array of string (fields) | Yes | |
metadata |
object | Yes | additionalProperties: {"type":"string"} |
name |
string | Yes | |
order_url |
string or null | Yes | |
publications |
array of object (fields) | Yes | |
slug |
string | Yes | |
tax_code |
string or null | Yes | |
unit_label |
string or null | Yes | |
updated_at |
string | Yes | |
variants |
array of object (fields) | Yes |
additionalProperties: false; required: ["id","kind","name","slug","description","active","order_url","unit_label","marketing_features","metadata","tax_code","variants","details","publications","locations","collections","updated_at"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
active |
boolean | No | |
compare_at_unit_amount |
integer or null | No | minimum: 0 |
currency |
string | No | ISO 4217 currency code. pattern: "^[A-Z]{3}$" |
id |
string | No | The id of a price this variant already has. Restating it keeps the price row, which payments and checkout holds reference; a price without an id is a new offer. |
location_id |
string or null | No | Scope this offer to one location, or null for every location the product is offered at. |
recurring_interval |
string or null | No | enum: ["day","week","month","year",null] |
recurring_interval_count |
integer or null | No | minimum: 1 |
tax_behavior |
string | No | enum: ["unspecified","inclusive","exclusive"] |
type |
string | No | enum: ["one_time","recurring"] |
unit_amount |
integer | No | maximum: 9007199254740991; minimum: 0 |
valid_from_at |
string or null | No | format: "date-time" |
valid_until_at |
string or null | No | format: "date-time" |
additionalProperties: false; required: []
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
category |
string | Yes | |
rating |
number | Yes |
required: ["category","rating"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
id |
string | Yes | |
label |
string | Yes |
additionalProperties: false; required: ["id","label"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
legend |
string | Yes | |
options |
array of object (fields) | Yes | |
param |
string | Yes | enum: ["kind","location_id"] |
selected |
string | Yes |
additionalProperties: false; required: ["param","legend","options","selected"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
label |
string | Yes |
additionalProperties: false; required: ["label"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
cells |
array of string (fields) | Yes | |
key |
string | Yes | |
label |
string | Yes |
additionalProperties: false; required: ["key","label","cells"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
author |
string | Yes | |
categories |
string or null | Yes | |
content |
string or null | Yes | |
id |
string | Yes | |
line |
string | Yes | |
private_feedback |
string or null | Yes | |
rating |
integer | Yes | maximum: 5; minimum: 1 |
status |
string or null | Yes | |
title |
string or null | Yes |
additionalProperties: false; required: ["id","author","rating","status","line","categories","title","content","private_feedback"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
amount_minor |
integer | Yes | |
booking_id |
string | Yes | minLength: 1 |
created_at |
string | Yes | minLength: 1 |
created_by |
string | Yes | minLength: 1 |
currency |
string | Yes | minLength: 1 |
id |
string | Yes | minLength: 1 |
method |
string | Yes | enum: ["cash","bank_transfer","card_external","other"] |
note |
string or null | Yes | |
paid_on |
string | Yes | pattern: "^\d{4}-\d{2}-\d{2}$" |
reference |
string or null | Yes |
required: ["id","booking_id","amount_minor","currency","method","paid_on","reference","note","created_at","created_by"]
array of number or string or null fields
Value: array of number or string or null.
Array items: number or string or null.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
close |
object (fields) | Yes | additionalProperties: false; required: ["day","hour","minute"] |
open |
object (fields) | Yes | additionalProperties: false; required: ["day","hour","minute"] |
additionalProperties: false; required: ["open","close"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
open |
object (fields) | Yes | additionalProperties: false; required: ["day","hour","minute"] |
additionalProperties: false; required: ["open"]
string or null fields
Value: string or null.
array of object fields
Value: array of object.
Array items: object.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
id |
string | Yes | Stable choice ID. maxLength: 64; pattern: "^[a-z0-9][a-z0-9_-]{0,63}$" |
label |
string | Yes | maxLength: 120; minLength: 1 |
additionalProperties: false; required: ["id","label"]
integer fields
Value: integer.
const: -1
integer fields
Value: integer.
maximum: 1125; minimum: 1
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
active |
boolean | Yes | |
compare_at_unit_amount |
integer or null | No | |
currency |
string | Yes | |
id |
string | Yes | |
location_id |
string or null | Yes | The location this offer applies at, or null for a location-neutral offer. Null is a declared scope, not a missing value. |
recurring_interval |
string or null | No | enum: ["day","week","month","year",null] |
recurring_interval_count |
integer or null | No | |
tax_behavior |
string | Yes | enum: ["unspecified","inclusive","exclusive"] |
type |
string | Yes | enum: ["one_time","recurring"] |
unit_amount |
integer | Yes | Integer amount in the currency smallest unit. |
valid_from_at |
string or null | No | |
valid_until_at |
string or null | No |
additionalProperties: false; required: ["id","location_id","active","currency","unit_amount","type","tax_behavior"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
allergens |
array of string (fields) | No | Allergens the merchant states this dish contains. maxItems: 100; uniqueItems: true |
dietary_notes |
array of string (fields) | No | Merchant-stated dietary facts displayed with a dish. maxItems: 100; uniqueItems: true |
featured |
boolean | No | Highlight this item on the menu and homepage. |
ingredients |
array of string (fields) | No | Ingredients shown in the dish details. maxItems: 100; uniqueItems: true |
noodle |
array of string (fields) | No | Authored noodle information shown as dish facts; these do not establish purchasable variants. maxItems: 100; uniqueItems: true |
pricing_note |
string | No | An explicitly stated price such as Market price; use only when no numeric price is set. maxLength: 1000; minLength: 1; pattern: "^(?=[\s\S]\S)[^\r\n]$" |
sizes |
array of string (fields) | No | Authored serving information; priced choices belong in variants. maxItems: 100; uniqueItems: true |
soup |
array of string (fields) | No | Authored soup information shown with the dish. maxItems: 100; uniqueItems: true |
tagline |
string | No | A short sentence shown below the product title. maxLength: 1000; minLength: 1; pattern: "^(?=[\s\S]\S)[^\r\n]$" |
toppings |
array of string (fields) | No | Authored topping information; priced choices belong in variants. maxItems: 100; uniqueItems: true |
additionalProperties: false
array of object fields
Value: array of object.
maxItems: 250; minItems: 1
Array items: object.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
allergens |
array of string (fields) | No | Allergens the merchant states this dish contains. maxItems: 100; uniqueItems: true |
dietary_notes |
array of string (fields) | No | Merchant-stated dietary facts displayed with a dish. maxItems: 100; uniqueItems: true |
featured |
boolean | No | Highlight this item on the menu and homepage. |
ingredients |
array of string (fields) | No | Ingredients shown in the dish details. maxItems: 100; uniqueItems: true |
noodle |
array of string (fields) | No | Authored noodle information shown as dish facts; these do not establish purchasable variants. maxItems: 100; uniqueItems: true |
pricing_note |
string | No | An explicitly stated price such as Market price; use only when no numeric price is set. maxLength: 1000; minLength: 1; pattern: "^(?=[\s\S]\S)[^\r\n]$" |
sizes |
array of string (fields) | No | Authored serving information; priced choices belong in variants. maxItems: 100; uniqueItems: true |
soup |
array of string (fields) | No | Authored soup information shown with the dish. maxItems: 100; uniqueItems: true |
tagline |
string | No | A short sentence shown below the product title. maxLength: 1000; minLength: 1; pattern: "^(?=[\s\S]\S)[^\r\n]$" |
toppings |
array of string (fields) | No | Authored topping information; priced choices belong in variants. maxItems: 100; uniqueItems: true |
additionalProperties: false
array of object fields
Value: array of object.
Array items: object.
number or string or null fields
Value: number or string or null.
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
day |
integer | Yes | maximum: 6; minimum: 0 |
hour |
integer | Yes | maximum: 23; minimum: 0 |
minute |
integer | Yes | maximum: 59; minimum: 0 |
additionalProperties: false; required: ["day","hour","minute"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
day |
number | Yes | const: 0 |
hour |
number | Yes | const: 0 |
minute |
number | Yes | const: 0 |
additionalProperties: false; required: ["day","hour","minute"]
string fields
Value: string.
format: "date"; pattern: "^\d{4}-\d{2}-\d{2}$"
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
close_day_offset |
enum | Yes | enum: [0,1] |
close_time |
string | Yes | Local wall-clock time, HH:mm (24-hour), in the explicitly selected location timezone. pattern: "^(?:[01]\d|2[0-3]):[0-5]\d$" |
open_time |
string | Yes | Local wall-clock time, HH:mm (24-hour), in the explicitly selected location timezone. pattern: "^(?:[01]\d|2[0-3]):[0-5]\d$" |
additionalProperties: false; required: ["open_time","close_time","close_day_offset"]
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
active |
boolean | No | |
id |
string | No | |
name |
string | No | |
prices |
array of object (fields) | No | Partial existing prices by id or new offers. Omitted prices remain. A new offer requires unit_amount. maxItems: 20 |
sku |
string or null | No | |
sort_order |
integer | No |
additionalProperties: false; required: []
object fields
| Field | Type | Required | Description and constraints |
|---|---|---|---|
label |
string | Yes | |
value |
string | Yes |
additionalProperties: false; required: ["value","label"]
array of object fields
Value: array of object.
maxItems: 20
Array items: object.