Skip to content

feat: Expand push_data guidance in Reservation Automations guide#1197

Merged
itelo merged 4 commits into
mainfrom
feat/reservation-push-data-guidance
Jun 26, 2026
Merged

feat: Expand push_data guidance in Reservation Automations guide#1197
itelo merged 4 commits into
mainfrom
feat/reservation-push-data-guidance

Conversation

@itelo

@itelo itelo commented Jun 26, 2026

Copy link
Copy Markdown
Contributor

Linear: DOC-237

Summary

Expands section 3 (Push reservation data) of the Reservation Automations capability guide with practical guidance requested for the push_data workflow:

  • Update examples for the two most common edits — changing a reservation's time (starts_at/ends_at) and changing its assigned space (space_keys), both keyed by the same reservation_key.
  • Stable reservation_key guidance — explains the key should be your system's own booking ID and must not be derived from underlying resources (space, room, device, guest). Spells out the failure mode (a changed key reads as a new reservation → duplicate credentials on hardware) and documents the safe delete-before-update pattern when the key itself must change.
  • Push only confirmed reservations — recommends withholding intermediate states (inquiry/pending/tentative) and pushing only on confirmation, since each push_data can translate into a physical hardware operation; speculative pushes multiply commands and avoidable errors.

Notes

  • All additions live under the existing #3-push-reservation-data section and follow the section's curl-based example style.
  • No existing content changed; net +66 lines.

🤖 Generated with Claude Code

Add to section 3 (Push reservation data):
- Update examples for changing reservation time and assigned space
- Guidance to use a stable reservation_key not derived from underlying
  resources, plus the delete-before-update pattern when the key must change
- Recommendation to push only confirmed reservations to reduce unneeded
  hardware operations and avoidable errors

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@itelo itelo requested a review from a team as a code owner June 26, 2026 14:42
itelo and others added 3 commits June 26, 2026 11:49
Add a "Bookings that span multiple rooms" subsection: push one reservation
per sub-reservation, keyed by <reservation_id>_<sub_reservation_id> with each
sub-reservation's own space, so each room's access stays independently
addressable for updates and delete_data.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Restructure section 2 around the Console's Automation Rules model:
- Organize the access-method settings under a "When a reservation is created"
  rule and document the drag-to-reorder access-method preference order
- Add a "When a staff member is created" rule that provisions access for
  staff to their associated properties

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

@cwirk cwirk left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nice

@itelo itelo merged commit 3d1b553 into main Jun 26, 2026
10 checks passed
@itelo itelo deleted the feat/reservation-push-data-guidance branch June 26, 2026 19:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants