{"templateId":"openapi_docs","sharedDataIds":{"openAPIDocsStore":"oas-apis/production/MessagingApi.yml","sidebar":"sidebar-sidebar.yaml__apis_production_messagingapi"},"props":{"definitionId":"apis/production/MessagingApi.yml","dynamicMarkdocComponents":[],"baseSlug":"/apis/production/messagingapi","seo":{"title":"Messaging API","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"itemId":"","disableAutoScroll":true,"metadata":{"type":"openapi","title":"Messaging API","description":"API for retrieving the operator↔partner conversation stored against a booking.\n\nBookable relays the conversation between the venue operator and the integration partner over email\n(both parties email a per-booking conversation alias and Bookable forwards each message on).\n\nParticipants can take part in two ways:\n- **By email** — reply to the relay email from their normal mail client (attachments supported this way only).\n- **Programmatically** — `POST /bookings/{bookingId}/messages` to send a plain-text message. Bookable stores\n  it and relays it on to the other participant over the same conversation channel. `GET` returns the stored\n  conversation stack.\n\nThe send direction is derived from the caller's role: an Integration Partner sends to the venue operator\n(`partner_to_operator`); a venue group operator sends to the integration partner (`operator_to_partner`).\nEach stored message carries this absolute `direction`.\n\n**Pagination:** Uses page-based pagination via `pageNumber` and `pageSize`. Results are ordered\nby `sentAt` ascending (oldest first).\n\n**Availability:** Real email relay is not available in the Sandbox environment. In Sandbox only the\nwebhook-only test flow is reachable — see the `direction` override on `SendMessageRequest`, which stores\nthe message and fires the `message.received` webhook to your registered sandbox callback without sending\nany email.\n"},"compilationErrors":[],"markdown":{"partials":{},"variables":{"rbac":{"teams":["anonymous"]},"user":{},"remoteAddr":{"hostname":"docs.bookabletech.com","port":4000,"ipAddress":"216.73.216.98"},"lang":"default_locale","env":{"PUBLIC_REDOCLY_BRANCH_NAME":"master"}}},"pagePropGetterError":{"message":"","name":""}},"slug":"/apis/production/messagingapi","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}