[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M77ZKDPVX6KXGA04MZE5V4VG":3,"skill-same:01M77ZKDPVX6KXGA04MZE5V4VG":53},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":29,"ownerHtmlUrl":30,"ownerBlogUrl":29,"ownerDescription":31,"updatedAt":32,"install":33,"resources":46},"01M77ZKDPVX6KXGA04MZE5V4VG","pm-cloudbeds",null,"Cloudbeds connector knowledge and safe action guide.","polymetrics-ai\u002Fcli","polymetrics-ai","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F177650388?v=4","01M77Z920R1RTP5NXCP1V1HNMS","Polymetrics","01M77Z921DPWZC4DQSSZNWF82B",7,"AGPL-3.0","https:\u002F\u002Fgithub.com\u002Fpolymetrics-ai\u002Fcli\u002Fblob\u002Fmain\u002Fdocs\u002Fconnectors\u002Fcloudbeds\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: pm-cloudbeds\ndescription: Cloudbeds connector knowledge and safe action guide.\n---\n\n# pm-cloudbeds\n\n## Purpose\n\nReads Cloudbeds guests, hotels, rooms, reservations, transactions, rate plans, room types, items, taxes\u002Ffees, sources, groups, house accounts, housekeeping, custom fields, payment methods, webhooks, allotment blocks, and guest\u002Freservation notes, and writes guest, reservation, payment, folio, housekeeping, house-account, webhook, and room-block actions, through the Cloudbeds v1.2 REST API.\n\n## Icon\n\n- id: pm-sample\n- asset: icons\u002Fpm-sample.svg\n- source: polymetrics\n- review_status: polymetrics\n- review_url: https:\u002F\u002Fgithub.com\u002Fpolymetrics-ai\u002Fcli\n\n## Capabilities\n\n- check=true catalog=true read=true write=true query=false\n- Integration type: api\n\n## Authentication\n\n- Use pm credentials add with --from-env or --value-stdin for secret fields.\n\n## Configuration\n\n- base_url\n- property_id\n- rate_plans_end_date\n- rate_plans_start_date\n- api_key (secret) (required)\n\n## ETL Streams\n\n- guests:\n  - primary key: guestID\n  - fields: dateCreated(string), dateModified(string), guestEmail(string), guestID(string), guestName(string), isAnonymized(boolean), isMainGuest(boolean), propertyID(string), reservationID(string)\n- hotels:\n  - primary key: propertyID\n  - fields: organizationID(string), propertyCurrency(string), propertyDescription(string), propertyID(string), propertyImage(string), propertyName(string), propertyTimezone(string)\n- rooms:\n  - primary key: propertyID\n  - fields: propertyID(string), roomBlocks(array)\n- reservations:\n  - primary key: reservationID\n  - fields: adults(integer), balance(number), children(integer), dateCreated(string), dateModified(string), endDate(string), guestID(string), guestName(string), origin(string), propertyID(string), reservationID(string), sourceName(string), startDate(string), status(string)\n- transactions:\n  - primary key: transactionID\n  - fields: amount(number), category(string), currency(string), description(string), guestID(string), guestName(string), propertyID(string), reservationID(string), transactionCategory(string), transactionCode(string), transactionDateTime(string), transactionDateTimeUTC(string), transactionID(string), transactionType(string)\n- rate_plans:\n  - primary key: ratePlanID\n  - fields: addOns(array), baseRate(number), daysOfWeek(object), derivedType(string), derivedValue(number), isDerived(boolean), parentRateID(string), parentRatePlanID(string), parentRatePlanNamePrivate(string), parentRatePlanNamePublic(string), promoCode(string), propertyID(string), rateID(string), ratePlanID(string), ratePlanNamePrivate(string), ratePlanNamePublic(string), roomRate(number), roomRateDetailed(array), roomTypeID(string), roomTypeName(string), roomsAvailable(integer), totalRate(number)\n- room_types:\n  - primary key: roomTypeID\n  - fields: adultsIncluded(integer), childrenIncluded(integer), isPrivate(boolean), maxGuests(integer), propertyID(string), roomTypeDescription(string), roomTypeID(string), roomTypeName(string), roomTypeNameShort(string)\n- items:\n  - primary key: itemID\n  - fields: categoryID(string), categoryName(string), description(string), fees(array), grandTotal(number), itemCode(string), itemID(string), itemQuantity(integer), itemType(string), name(string), price(number), priceWithoutFeesAndTaxes(number), reorderNeeded(boolean), reorderThreshold(integer), sku(string), stockInventory(boolean), stopSell(boolean), stopSellMet(boolean), taxes(array), totalFees(number), totalTaxes(number)\n- item_categories:\n  - primary key: categoryID\n  - fields: categoryCode(string), categoryColor(string), categoryID(string), categoryName(string)\n- taxes_and_fees:\n  - primary key: type, feeID, taxID\n  - fields: amount(number), amountAdult(number), amountChild(number), amountRateBased(boolean), amountType(string), availableFor(array), childId(string), code(string), createdAt(string), dateRanges(array), expiredAt(string), feeID(string), feesCharged(array), inclusiveOrExclusive(string), isDeleted(boolean), kind(string), lengthOfStaySettings(object), name(string), roomTypes(array), taxID(string), taxesCharged(array), type(string)\n- sources:\n  - primary key: propertyID, sourceID\n  - fields: commission(number), fees(array), isThirdParty(boolean), paymentCollect(string), propertyID(string), sourceID(string), sourceName(string), status(string), taxes(array)\n- groups:\n  - primary key: groupCode\n  - fields: address1(string), address2(string), city(string), commissionType(string), contacts(array), countryCode(string), created(string), groupCode(string), legalName(string), name(string), sourceID(string), sourceName(string), state(string), status(string), taxDocumentType(string), taxIdNumber(string), type(string), zip(string)\n- house_accounts:\n  - primary key: accountID\n  - fields: accountID(string), accountName(string), accountStatus(string), isPrivate(boolean), propertyID(string), userName(string)\n- housekeepers:\n  - primary key: housekeeperID\n  - fields: housekeeperID(string), name(string), propertyID(string)\n- housekeeping_status:\n  - primary key: roomID\n  - fields: date(string), doNotDisturb(boolean), frontdeskStatus(string), housekeeper(string), housekeeperID(string), refusedService(boolean), roomBlocked(boolean), roomComments(string), roomCondition(string), roomID(string), roomName(string), roomOccupied(boolean), roomTypeID(string), roomTypeName(string), vacantPickup(boolean)\n- custom_fields:\n  - primary key: propertyID, shortcode\n  - fields: applyTo(string), displayed(boolean), isPersonal(boolean), maxCharacters(integer), name(string), propertyID(string), required(boolean), shortcode(string), type(string)\n- payment_methods:\n  - primary key: code\n  - fields: cardTypes(array), code(string), method(string), name(string)\n- webhooks:\n  - primary key: id\n  - fields: event(object), id(string), key(object), owner(object), subscriptionData(object), subscriptionType(string)\n- allotment_blocks:\n  - primary key: allotmentBlockId\n  - fields: allotmentBlockCode(string), allotmentBlockId(string), allotmentBlockName(string), allotmentBlockStatus(string), allotmentIntervals(array), allotmentType(string), autoRelease(object), bookingCodeUrl(string), eventCode(string), eventId(string), groupCode(string), groupId(string), isAutoRelease(boolean), propertyID(string), ratePlan(string), ratePlanId(string), rateType(string), releaseDate(string), releaseScheduleStatus(string), releaseScheduleType(string), releaseStatus(string), reservationsCount(integer), resources(array), roomsHeld(integer), roomsPickedUp(integer), roomsRemaining(integer)\n- guest_notes:\n  - primary key: guestNoteID\n  - fields: dateCreated(string), dateModified(string), guestID(string), guestNote(string), guestNoteID(string), userName(string)\n- reservation_notes:\n  - primary key: reservationNoteID\n  - fields: dateCreated(string), dateModified(string), reservationID(string), reservationNote(string), reservationNoteID(string), userName(string)\n\n## Sync Modes\n\n- ETL sync modes: full_refresh_append, full_refresh_overwrite\n\n## Reverse ETL Actions\n\n- create_guest:\n  - endpoint: POST \u002FpostGuest\n  - required fields: propertyID, reservationID\n  - risk: adds an additional guest to an existing reservation; no approval required\n- update_guest:\n  - endpoint: PUT \u002FputGuest\n  - required fields: propertyID, guestID\n  - risk: overwrites a guest's profile fields; no approval required\n- create_guest_note:\n  - endpoint: POST \u002FpostGuestNote\n  - required fields: propertyID, guestID, guestNote\n  - risk: adds a free-text note to a guest profile; no approval required\n- update_guest_note:\n  - endpoint: PUT \u002FputGuestNote\n  - required fields: propertyID, guestID, noteID, guestNote\n  - risk: overwrites an existing guest note's text; no approval required\n- delete_guest_note:\n  - endpoint: DELETE \u002FdeleteGuestNote?propertyID={{ record.propertyID }}&guestID={{ record.guestID }}&noteID={{ record.noteID }}\n  - required fields: propertyID, guestID, noteID\n  - risk: irreversibly removes a guest note; approval required\n- create_reservation:\n  - endpoint: POST \u002FpostReservation\n  - required fields: propertyID, startDate, endDate, guestFirstName, guestLastName, rooms\n  - risk: creates a new, billable reservation (books rooms and may authorize\u002Fcharge a card depending on paymentMethod); external mutation, no approval required for the booking itself but review payment-capturing config carefully\n- update_reservation:\n  - endpoint: PUT \u002FputReservation\n  - required fields: propertyID, reservationID\n  - risk: mutates an existing reservation's status\u002Fdates\u002Froom assignment; a status change to a cancelled\u002Fno-show state has real revenue and inventory-release consequences; no approval required (Cloudbeds' own confirmation flow, e.g. sendStatusChangeEmail, is the operator-facing guardrail)\n- create_reservation_note:\n  - endpoint: POST \u002FpostReservationNote\n  - required fields: propertyID, reservationID, reservationNote\n  - risk: adds a free-text note to a reservation; no approval required\n- update_reservation_note:\n  - endpoint: PUT \u002FputReservationNote\n  - required fields: propertyID, reservationID, reservationNoteID, reservationNote\n  - risk: overwrites an existing reservation note's text; no approval required\n- delete_reservation_note:\n  - endpoint: DELETE \u002FdeleteReservationNote?propertyID={{ record.propertyID }}&reservationID={{ record.reservationID }}&reservationNoteID={{ record.reservationNoteID }}\n  - required fields: propertyID, reservationID, reservationNoteID\n  - risk: irreversibly removes a reservation note; approval required\n- check_in_room:\n  - endpoint: POST \u002FpostRoomCheckIn\n  - required fields: propertyID, reservationID, roomID\n  - risk: checks a guest into a room, changing reservation\u002Froom status; no approval required\n- check_out_room:\n  - endpoint: POST \u002FpostRoomCheckOut\n  - required fields: propertyID, reservationID, roomID\n  - risk: checks a guest out of a room, changing reservation\u002Froom status and folio; no approval required\n- assign_room:\n  - endpoint: POST \u002FpostRoomAssign\n  - required fields: propertyID, reservationID, reservationRoomID, newRoomID\n  - risk: reassigns a reservation to a different physical room, optionally repricing; no approval required\n- post_payment:\n  - endpoint: POST \u002FpostPayment\n  - required fields: propertyID, type, amount\n  - risk: records a payment\u002Fdeposit against a reservation or house account; a real financial transaction — approval required\n- void_payment:\n  - endpoint: POST \u002FpostVoidPayment\n  - required fields: propertyID, paymentID\n  - risk: irreversibly voids a recorded payment; a real financial reversal — approval required\n- post_adjustment:\n  - endpoint: POST \u002FpostAdjustment\n  - required fields: propertyID, reservationID, type, amount\n  - risk: posts a manual folio adjustment (credit or charge) to a reservation; a real financial transaction — approval required\n- delete_adjustment:\n  - endpoint: DELETE \u002FdeleteAdjustment?reservationID={{ record.reservationID }}&adjustmentID={{ record.adjustmentID }}\n  - required fields: reservationID, adjustmentID\n  - risk: irreversibly removes a folio adjustment; a real financial reversal — approval required\n- post_item:\n  - endpoint: POST \u002FpostItem\n  - required fields: propertyID, itemID, itemQuantity\n  - risk: posts a catalog item sale to a reservation\u002Fhouse account folio; a real financial transaction — approval required\n- void_item:\n  - endpoint: POST \u002FpostVoidItem\n  - required fields: propertyID, soldProductID\n  - risk: irreversibly voids a previously-sold item line; a real financial reversal — approval required\n- create_item_category:\n  - endpoint: POST \u002FpostItemCategory\n  - required fields: propertyID, categoryName\n  - risk: creates a new item catalog category; no approval required\n- create_group_note:\n  - endpoint: POST \u002FpostGroupNote\n  - required fields: propertyID, groupCode, groupNote\n  - risk: adds a free-text note to a group profile; no approval required\n- update_housekeeping_status:\n  - endpoint: POST \u002FpostHousekeepingStatus\n  - required fields: propertyID, roomID\n  - risk: changes a room's live housekeeping\u002Fcleaning status; no approval required\n- create_housekeeper:\n  - endpoint: POST \u002FpostHousekeeper\n  - required fields: propertyID, name\n  - risk: creates a new housekeeper staff record; no approval required\n- update_housekeeper:\n  - endpoint: PUT \u002FputHousekeeper\n  - required fields: propertyID, housekeeperID, name\n  - risk: renames an existing housekeeper staff record; no approval required\n- assign_housekeeping:\n  - endpoint: POST \u002FpostHousekeepingAssignment\n  - required fields: propertyID, roomIDs, housekeeperID\n  - risk: assigns rooms to a housekeeper for cleaning; no approval required\n- create_house_account:\n  - endpoint: POST \u002FpostNewHouseAccount\n  - required fields: propertyID, accountName\n  - risk: creates a new house (folio) account for non-guest billing; no approval required\n- update_house_account_status:\n  - endpoint: PUT \u002FputHouseAccountStatus\n  - required fields: propertyID, houseAccountID, status\n  - risk: opens or closes a house account; closing prevents further postings against it; no approval required\n- create_webhook:\n  - endpoint: POST \u002FpostWebhook\n  - required fields: propertyID, object, action, endpointUrl\n  - risk: subscribes an external endpoint URL to receive Cloudbeds event notifications; low-risk external mutation, no approval required\n- delete_webhook:\n  - endpoint: DELETE \u002FdeleteWebhook?subscriptionID={{ record.subscriptionID }}\n  - required fields: subscriptionID\n  - risk: removes a webhook subscription; approval required (stops event delivery to the subscribed endpoint)\n- create_room_block:\n  - endpoint: POST \u002FpostRoomBlock\n  - required fields: propertyID, roomBlockType, startDate, endDate, rooms\n  - risk: holds rooms out of general sale for a block; no approval required\n- update_room_block:\n  - endpoint: PUT \u002FputRoomBlock\n  - required fields: propertyID, roomBlockID\n  - risk: changes an existing room block's held rooms\u002Fdates; no approval required\n- delete_room_block:\n  - endpoint: POST \u002FdeleteRoomBlock\n  - required fields: propertyID, roomBlockID\n  - risk: releases a room block back to general sale; irreversible for any rooms already picked up under it — approval required\n\n## Security\n\n- read risk: external Cloudbeds API read of guest, hotel, room, reservation, transaction, rate, inventory, and operational (housekeeping\u002Fwebhook\u002Fnotes) data\n- write risk: external mutation of Cloudbeds guests, reservations, payments\u002Ffolio items, house accounts, housekeeping state, groups, webhooks, and room blocks — several actions are real financial transactions (post_payment, void_payment, post_adjustment, post_item, void_item) or irreversible deletions\n- approval: financial-transaction and delete-kind actions (post_payment\u002Fvoid_payment\u002Fpost_adjustment\u002Fdelete_adjustment\u002Fpost_item\u002Fvoid_item\u002Fdelete_guest_note\u002Fdelete_reservation_note\u002Fdelete_webhook\u002Fdelete_room_block) require approval; profile\u002Fnote\u002Fstatus\u002Fassignment\u002Fcreate-kind actions do not\n- Never pass secret values in chat, shell arguments, logs, docs, or JSON output.\n\n## Commands\n\n### Inspect as a manual\n\n```bash\npm connectors inspect cloudbeds\n```\n\n### Inspect as structured JSON\n\n```bash\npm connectors inspect cloudbeds --json\n```\n\n## Agent Rules\n\n- Run pm connectors inspect cloudbeds before creating credentials or plans.\n- Use --json only when the caller needs structured output; use the manual for human-readable guidance.\n- Never ask the user to paste secret values into chat.\n- For reverse ETL writes, create a plan, show the preview, wait for explicit approval, then run with the approval token.\n","# pm-cloudbeds\n\n## Purpose\n\nReads Cloudbeds guests, hotels, rooms, reservations, transactions, rate plans, room types, items, taxes\u002Ffees, sources, groups, house accounts, housekeeping, custom fields, payment methods, webhooks, allotment blocks, and guest\u002Freservation notes, and writes guest, reservation, payment, folio, housekeeping, house-account, webhook, and room-block actions, through the Cloudbeds v1.2 REST API.\n\n## Icon\n\n- id: pm-sample\n- asset: icons\u002Fpm-sample.svg\n- source: polymetrics\n- review_status: polymetrics\n- review_url: https:\u002F\u002Fgithub.com\u002Fpolymetrics-ai\u002Fcli\n\n## Capabilities\n\n- check=true catalog=true read=true write=true query=false\n- Integration type: api\n\n## Authentication\n\n- Use pm credentials add with --from-env or --value-stdin for secret fields.\n\n## Configuration\n\n- base_url\n- property_id\n- rate_plans_end_date\n- rate_plans_start_date\n- api_key (secret) (required)\n\n## ETL Streams\n\n- guests:\n  - primary key: guestID\n  - fields: dateCreated(string), dateModified(string), guestEmail(string), guestID(string), guestName(string), isAnonymized(boolean), isMainGuest(boolean), propertyID(string), reservationID(string)\n- hotels:\n  - primary key: propertyID\n  - fields: organizationID(string), propertyCurrency(string), propertyDescription(string), propertyID(string), propertyImage(string), propertyName(string), propertyTimezone(string)\n- rooms:\n  - primary key: propertyID\n  - fields: propertyID(string), roomBlocks(array)\n- reservations:\n  - primary key: reservationID\n  - fields: adults(integer), balance(number), children(integer), dateCreated(string), dateModified(string), endDate(string), guestID(string), guestName(string), origin(string), propertyID(string), reservationID(string), sourceName(string), startDate(string), status(string)\n- transactions:\n  - primary key: transactionID\n  - fields: amount(number), category(string), currency(string), description(string), guestID(string), guestName(string), propertyID(string), reservationID(string), transactionCategory(string), transactionCode(string), transactionDateTime(string), transactionDateTimeUTC(string), transactionID(string), transactionType(string)\n- rate_plans:\n  - primary key: ratePlanID\n  - fields: addOns(array), baseRate(number), daysOfWeek(object), derivedType(string), derivedValue(number), isDerived(boolean), parentRateID(string), parentRatePlanID(string), parentRatePlanNamePrivate(string), parentRatePlanNamePublic(string), promoCode(string), propertyID(string), rateID(string), ratePlanID(string), ratePlanNamePrivate(string), ratePlanNamePublic(string), roomRate(number), roomRateDetailed(array), roomTypeID(string), roomTypeName(string), roomsAvailable(integer), totalRate(number)\n- room_types:\n  - primary key: roomTypeID\n  - fields: adultsIncluded(integer), childrenIncluded(integer), isPrivate(boolean), maxGuests(integer), propertyID(string), roomTypeDescription(string), roomTypeID(string), roomTypeName(string), roomTypeNameShort(string)\n- items:\n  - primary key: itemID\n  - fields: categoryID(string), categoryName(string), description(string), fees(array), grandTotal(number), itemCode(string), itemID(string), itemQuantity(integer), itemType(string), name(string), price(number), priceWithoutFeesAndTaxes(number), reorderNeeded(boolean), reorderThreshold(integer), sku(string), stockInventory(boolean), stopSell(boolean), stopSellMet(boolean), taxes(array), totalFees(number), totalTaxes(number)\n- item_categories:\n  - primary key: categoryID\n  - fields: categoryCode(string), categoryColor(string), categoryID(string), categoryName(string)\n- taxes_and_fees:\n  - primary key: type, feeID, taxID\n  - fields: amount(number), amountAdult(number), amountChild(number), amountRateBased(boolean), amountType(string), availableFor(array), childId(string), code(string), createdAt(string), dateRanges(array), expiredAt(string), feeID(string), feesCharged(array), inclusiveOrExclusive(string), isDeleted(boolean), kind(string), lengthOfStaySettings(object), name(string), roomTypes(array), taxID(string), taxesCharged(array), type(string)\n- sources:\n  - primary key: propertyID, sourceID\n  - fields: commission(number), fees(array), isThirdParty(boolean), paymentCollect(string), propertyID(string), sourceID(string), sourceName(string), status(string), taxes(array)\n- groups:\n  - primary key: groupCode\n  - fields: address1(string), address2(string), city(string), commissionType(string), contacts(array), countryCode(string), created(string), groupCode(string), legalName(string), name(string), sourceID(string), sourceName(string), state(string), status(string), taxDocumentType(string), taxIdNumber(string), type(string), zip(string)\n- house_accounts:\n  - primary key: accountID\n  - fields: accountID(string), accountName(string), accountStatus(string), isPrivate(boolean), propertyID(string), userName(string)\n- housekeepers:\n  - primary key: housekeeperID\n  - fields: housekeeperID(string), name(string), propertyID(string)\n- housekeeping_status:\n  - primary key: roomID\n  - fields: date(string), doNotDisturb(boolean), frontdeskStatus(string), housekeeper(string), housekeeperID(string), refusedService(boolean), roomBlocked(boolean), roomComments(string), roomCondition(string), roomID(string), roomName(string), roomOccupied(boolean), roomTypeID(string), roomTypeName(string), vacantPickup(boolean)\n- custom_fields:\n  - primary key: propertyID, shortcode\n  - fields: applyTo(string), displayed(boolean), isPersonal(boolean), maxCharacters(integer), name(string), propertyID(string), required(boolean), shortcode(string), type(string)\n- payment_methods:\n  - primary key: code\n  - fields: cardTypes(array), code(string), method(string), name(string)\n- webhooks:\n  - primary key: id\n  - fields: event(object), id(string), key(object), owner(object), subscriptionData(object), subscriptionType(string)\n- allotment_blocks:\n  - primary key: allotmentBlockId\n  - fields: allotmentBlockCode(string), allotmentBlockId(string), allotmentBlockName(string), allotmentBlockStatus(string), allotmentIntervals(array), allotmentType(string), autoRelease(object), bookingCodeUrl(string), eventCode(string), eventId(string), groupCode(string), groupId(string), isAutoRelease(boolean), propertyID(string), ratePlan(string), ratePlanId(string), rateType(string), releaseDate(string), releaseScheduleStatus(string), releaseScheduleType(string), releaseStatus(string), reservationsCount(integer), resources(array), roomsHeld(integer), roomsPickedUp(integer), roomsRemaining(integer)\n- guest_notes:\n  - primary key: guestNoteID\n  - fields: dateCreated(string), dateModified(string), guestID(string), guestNote(string), guestNoteID(string), userName(string)\n- reservation_notes:\n  - primary key: reservationNoteID\n  - fields: dateCreated(string), dateModified(string), reservationID(string), reservationNote(string), reservationNoteID(string), userName(string)\n\n## Sync Modes\n\n- ETL sync modes: full_refresh_append, full_refresh_overwrite\n\n## Reverse ETL Actions\n\n- create_guest:\n  - endpoint: POST \u002FpostGuest\n  - required fields: propertyID, reservationID\n  - risk: adds an additional guest to an existing reservation; no approval required\n- update_guest:\n  - endpoint: PUT \u002FputGuest\n  - required fields: propertyID, guestID\n  - risk: overwrites a guest's profile fields; no approval required\n- create_guest_note:\n  - endpoint: POST \u002FpostGuestNote\n  - required fields: propertyID, guestID, guestNote\n  - risk: adds a free-text note to a guest profile; no approval required\n- update_guest_note:\n  - endpoint: PUT \u002FputGuestNote\n  - required fields: propertyID, guestID, noteID, guestNote\n  - risk: overwrites an existing guest note's text; no approval required\n- delete_guest_note:\n  - endpoint: DELETE \u002FdeleteGuestNote?propertyID={{ record.propertyID }}&guestID={{ record.guestID }}&noteID={{ record.noteID }}\n  - required fields: propertyID, guestID, noteID\n  - risk: irreversibly removes a guest note; approval required\n- create_reservation:\n  - endpoint: POST \u002FpostReservation\n  - required fields: propertyID, startDate, endDate, guestFirstName, guestLastName, rooms\n  - risk: creates a new, billable reservation (books rooms and may authorize\u002Fcharge a card depending on paymentMethod); external mutation, no approval required for the booking itself but review payment-capturing config carefully\n- update_reservation:\n  - endpoint: PUT \u002FputReservation\n  - required fields: propertyID, reservationID\n  - risk: mutates an existing reservation's status\u002Fdates\u002Froom assignment; a status change to a cancelled\u002Fno-show state has real revenue and inventory-release consequences; no approval required (Cloudbeds' own confirmation flow, e.g. sendStatusChangeEmail, is the operator-facing guardrail)\n- create_reservation_note:\n  - endpoint: POST \u002FpostReservationNote\n  - required fields: propertyID, reservationID, reservationNote\n  - risk: adds a free-text note to a reservation; no approval required\n- update_reservation_note:\n  - endpoint: PUT \u002FputReservationNote\n  - required fields: propertyID, reservationID, reservationNoteID, reservationNote\n  - risk: overwrites an existing reservation note's text; no approval required\n- delete_reservation_note:\n  - endpoint: DELETE \u002FdeleteReservationNote?propertyID={{ record.propertyID }}&reservationID={{ record.reservationID }}&reservationNoteID={{ record.reservationNoteID }}\n  - required fields: propertyID, reservationID, reservationNoteID\n  - risk: irreversibly removes a reservation note; approval required\n- check_in_room:\n  - endpoint: POST \u002FpostRoomCheckIn\n  - required fields: propertyID, reservationID, roomID\n  - risk: checks a guest into a room, changing reservation\u002Froom status; no approval required\n- check_out_room:\n  - endpoint: POST \u002FpostRoomCheckOut\n  - required fields: propertyID, reservationID, roomID\n  - risk: checks a guest out of a room, changing reservation\u002Froom status and folio; no approval required\n- assign_room:\n  - endpoint: POST \u002FpostRoomAssign\n  - required fields: propertyID, reservationID, reservationRoomID, newRoomID\n  - risk: reassigns a reservation to a different physical room, optionally repricing; no approval required\n- post_payment:\n  - endpoint: POST \u002FpostPayment\n  - required fields: propertyID, type, amount\n  - risk: records a payment\u002Fdeposit against a reservation or house account; a real financial transaction — approval required\n- void_payment:\n  - endpoint: POST \u002FpostVoidPayment\n  - required fields: propertyID, paymentID\n  - risk: irreversibly voids a recorded payment; a real financial reversal — approval required\n- post_adjustment:\n  - endpoint: POST \u002FpostAdjustment\n  - required fields: propertyID, reservationID, type, amount\n  - risk: posts a manual folio adjustment (credit or charge) to a reservation; a real financial transaction — approval required\n- delete_adjustment:\n  - endpoint: DELETE \u002FdeleteAdjustment?reservationID={{ record.reservationID }}&adjustmentID={{ record.adjustmentID }}\n  - required fields: reservationID, adjustmentID\n  - risk: irreversibly removes a folio adjustment; a real financial reversal — approval required\n- post_item:\n  - endpoint: POST \u002FpostItem\n  - required fields: propertyID, itemID, itemQuantity\n  - risk: posts a catalog item sale to a reservation\u002Fhouse account folio; a real financial transaction — approval required\n- void_item:\n  - endpoint: POST \u002FpostVoidItem\n  - required fields: propertyID, soldProductID\n  - risk: irreversibly voids a previously-sold item line; a real financial reversal — approval required\n- create_item_category:\n  - endpoint: POST \u002FpostItemCategory\n  - required fields: propertyID, categoryName\n  - risk: creates a new item catalog category; no approval required\n- create_group_note:\n  - endpoint: POST \u002FpostGroupNote\n  - required fields: propertyID, groupCode, groupNote\n  - risk: adds a free-text note to a group profile; no approval required\n- update_housekeeping_status:\n  - endpoint: POST \u002FpostHousekeepingStatus\n  - required fields: propertyID, roomID\n  - risk: changes a room's live housekeeping\u002Fcleaning status; no approval required\n- create_housekeeper:\n  - endpoint: POST \u002FpostHousekeeper\n  - required fields: propertyID, name\n  - risk: creates a new housekeeper staff record; no approval required\n- update_housekeeper:\n  - endpoint: PUT \u002FputHousekeeper\n  - required fields: propertyID, housekeeperID, name\n  - risk: renames an existing housekeeper staff record; no approval required\n- assign_housekeeping:\n  - endpoint: POST \u002FpostHousekeepingAssignment\n  - required fields: propertyID, roomIDs, housekeeperID\n  - risk: assigns rooms to a housekeeper for cleaning; no approval required\n- create_house_account:\n  - endpoint: POST \u002FpostNewHouseAccount\n  - required fields: propertyID, accountName\n  - risk: creates a new house (folio) account for non-guest billing; no approval required\n- update_house_account_status:\n  - endpoint: PUT \u002FputHouseAccountStatus\n  - required fields: propertyID, houseAccountID, status\n  - risk: opens or closes a house account; closing prevents further postings against it; no approval required\n- create_webhook:\n  - endpoint: POST \u002FpostWebhook\n  - required fields: propertyID, object, action, endpointUrl\n  - risk: subscribes an external endpoint URL to receive Cloudbeds event notifications; low-risk external mutation, no approval required\n- delete_webhook:\n  - endpoint: DELETE \u002FdeleteWebhook?subscriptionID={{ record.subscriptionID }}\n  - required fields: subscriptionID\n  - risk: removes a webhook subscription; approval required (stops event delivery to the subscribed endpoint)\n- create_room_block:\n  - endpoint: POST \u002FpostRoomBlock\n  - required fields: propertyID, roomBlockType, startDate, endDate, rooms\n  - risk: holds rooms out of general sale for a block; no approval required\n- update_room_block:\n  - endpoint: PUT \u002FputRoomBlock\n  - required fields: propertyID, roomBlockID\n  - risk: changes an existing room block's held rooms\u002Fdates; no approval required\n- delete_room_block:\n  - endpoint: POST \u002FdeleteRoomBlock\n  - required fields: propertyID, roomBlockID\n  - risk: releases a room block back to general sale; irreversible for any rooms already picked up under it — approval required\n\n## Security\n\n- read risk: external Cloudbeds API read of guest, hotel, room, reservation, transaction, rate, inventory, and operational (housekeeping\u002Fwebhook\u002Fnotes) data\n- write risk: external mutation of Cloudbeds guests, reservations, payments\u002Ffolio items, house accounts, housekeeping state, groups, webhooks, and room blocks — several actions are real financial transactions (post_payment, void_payment, post_adjustment, post_item, void_item) or irreversible deletions\n- approval: financial-transaction and delete-kind actions (post_payment\u002Fvoid_payment\u002Fpost_adjustment\u002Fdelete_adjustment\u002Fpost_item\u002Fvoid_item\u002Fdelete_guest_note\u002Fdelete_reservation_note\u002Fdelete_webhook\u002Fdelete_room_block) require approval; profile\u002Fnote\u002Fstatus\u002Fassignment\u002Fcreate-kind actions do not\n- Never pass secret values in chat, shell arguments, logs, docs, or JSON output.\n\n## Commands\n\n### Inspect as a manual\n\n```bash\npm connectors inspect cloudbeds\n```\n\n### Inspect as structured JSON\n\n```bash\npm connectors inspect cloudbeds --json\n```\n\n## Agent Rules\n\n- Run pm connectors inspect cloudbeds before creating credentials or plans.\n- Use --json only when the caller needs structured output; use the manual for human-readable guidance.\n- Never ask the user to paste secret values into chat.\n- For reverse ETL writes, create a plan, show the preview, wait for explicit approval, then run with the approval token.\n",{"name":5,"description":7},"main","813f457a925f7ee3fe3bea101a43e445992c8552","docs\u002Fconnectors\u002Fcloudbeds",0,"https:\u002F\u002Fgithub.com\u002Fpolymetrics-ai\u002Fcli","https:\u002F\u002Fcli.polymetrics.ai","https:\u002F\u002Fgithub.com\u002Fpolymetrics-ai","Local-first data infrastructure for agents and developers.","2026-09-21 12:42:03",{"source":8,"skillName":5,"commands":34,"prompt":44,"zipAvailable":45},[35,38,41],{"tool":36,"command":37},"npx","npx skills add polymetrics-ai\u002Fcli --skill pm-cloudbeds",{"tool":39,"command":40},"bunx","bunx skills add polymetrics-ai\u002Fcli --skill pm-cloudbeds",{"tool":42,"command":43},"pnpm","pnpm dlx skills add polymetrics-ai\u002Fcli --skill pm-cloudbeds","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fpolymetrics-ai\u002Fcli\u002Fblob\u002Fmain\u002Fdocs\u002Fconnectors\u002Fcloudbeds\u002FSKILL.md",true,[47],{"path":48,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":51,"sourceHtmlUrl":52},"MANUAL.md","REFERENCE","参考文档",15817,"https:\u002F\u002Fgithub.com\u002Fpolymetrics-ai\u002Fcli\u002Fblob\u002Fmain\u002Fdocs\u002Fconnectors\u002Fcloudbeds\u002FMANUAL.md",[54,61,68,75,82,89],{"skillNo":55,"name":56,"nameZh":6,"description":57,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":58,"categories":59,"keywords":60,"publishedAt":19},"01M782EH9BFHYZVECKJ31F427S","recipe-preview-approve-reverse-etl","Preview and approve a reverse ETL plan safely.","https:\u002F\u002Fgithub.com\u002Fpolymetrics-ai\u002Fcli\u002Fblob\u002Fmain\u002Fdocs\u002Fskills\u002Frecipe-preview-approve-reverse-etl\u002FSKILL.md",[],[],{"skillNo":62,"name":63,"nameZh":6,"description":64,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":65,"categories":66,"keywords":67,"publishedAt":19},"01M782EFGH5NRZ2CXDK0V9YWFW","recipe-github-prs-to-warehouse","Sync GitHub pull requests into the local warehouse.","https:\u002F\u002Fgithub.com\u002Fpolymetrics-ai\u002Fcli\u002Fblob\u002Fmain\u002Fdocs\u002Fskills\u002Frecipe-github-prs-to-warehouse\u002FSKILL.md",[],[],{"skillNo":69,"name":70,"nameZh":6,"description":71,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":72,"categories":73,"keywords":74,"publishedAt":19},"01M782ECJZRQAK8E86CE7R2YM2","pm-zoom","Zoom connector knowledge and safe action guide.","https:\u002F\u002Fgithub.com\u002Fpolymetrics-ai\u002Fcli\u002Fblob\u002Fmain\u002Fdocs\u002Fskills\u002Fpm-zoom\u002FSKILL.md",[],[],{"skillNo":76,"name":77,"nameZh":6,"description":78,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":19},"01M782EASYDANMV35W2ZHG2QD0","pm-zonka-feedback","Zonka Feedback connector knowledge and safe action guide.","https:\u002F\u002Fgithub.com\u002Fpolymetrics-ai\u002Fcli\u002Fblob\u002Fmain\u002Fdocs\u002Fskills\u002Fpm-zonka-feedback\u002FSKILL.md",[],[],{"skillNo":83,"name":84,"nameZh":6,"description":85,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":19},"01M782E8WA94A906385AET1ZWH","pm-zoho-invoice","Zoho Invoice connector knowledge and safe action guide.","https:\u002F\u002Fgithub.com\u002Fpolymetrics-ai\u002Fcli\u002Fblob\u002Fmain\u002Fdocs\u002Fskills\u002Fpm-zoho-invoice\u002FSKILL.md",[],[],{"skillNo":90,"name":91,"nameZh":6,"description":92,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":93,"categories":94,"keywords":95,"publishedAt":19},"01M782E73M7F23B6VBGM72QMMQ","pm-zoho-inventory","Zoho Inventory connector knowledge and safe action guide.","https:\u002F\u002Fgithub.com\u002Fpolymetrics-ai\u002Fcli\u002Fblob\u002Fmain\u002Fdocs\u002Fskills\u002Fpm-zoho-inventory\u002FSKILL.md",[],[]]