# operator-site-faqs

Public-facing FAQ list attached to a venue, owned and managed by the operator, readable by mapped partners.


## Get site FAQs for a venue

 - [GET /venues/{venueCompositeId}/site-faqs](https://docs.bookabletech.com/apis/production/operatorsitefaqsapi/operator-site-faqs/getvenuesitefaqs.md): Returns the stored FAQ array for the venue. When no FAQs are stored, returns an empty array.

## Replace site FAQs for a venue

 - [PUT /venues/{venueCompositeId}/site-faqs](https://docs.bookabletech.com/apis/production/operatorsitefaqsapi/operator-site-faqs/replacevenuesitefaqs.md): Replaces the stored FAQ array with the provided body. This is the bulk-import mechanism for a single venue — send the complete FAQ list in one call to import/replace it.
Upserts the row when no FAQs are currently stored for the venue.

## Patch site FAQs for a venue (RFC 6902)

 - [PATCH /venues/{venueCompositeId}/site-faqs](https://docs.bookabletech.com/apis/production/operatorsitefaqsapi/operator-site-faqs/patchvenuesitefaqs.md): Applies an RFC 6902 JSON Patch document to the stored FAQ array. Supported operations are add, remove, and replace. Paths are JSON Pointers (RFC 6901) into the stored array — e.g. /0/answer references the answer key of the first FAQ item, /- appends a new item to the end. Upserts when no row exists; the patch is applied against an empty array in that case.

Examples:

Append a new FAQ item:
json
[
  { "op": "add", "path": "/-", "value": { "question": "Do you take walk-ins?", "answer": "Yes, subject to availability." } }
]


Replace an existing item's answer:
json
[
  { "op": "replace", "path": "/0/answer", "value": "Updated answer text." }
]


Remove an item:
json
[
  { "op": "remove", "path": "/2" }
]

## Delete all site FAQs for a venue

 - [DELETE /venues/{venueCompositeId}/site-faqs](https://docs.bookabletech.com/apis/production/operatorsitefaqsapi/operator-site-faqs/deletevenuesitefaqs.md): Removes the entire stored FAQ row for the venue. Idempotent — returns 204 whether or not the row existed.

## Bulk apply site FAQs across many venues

 - [POST /venues/site-faqs/bulk](https://docs.bookabletech.com/apis/production/operatorsitefaqsapi/operator-site-faqs/bulkapplyvenuesitefaqs.md): Applies FAQ changes to many venues in a single all-or-nothing transaction. Any per-item failure (unknown venue, foreign venue group, invalid composite ID, invalid patch) rolls back the whole request.

Each item declares the target venue (venueCompositeId) and the mode:
- replace — overwrite the stored array with faqs.
- patch   — apply an RFC 6902 JSON Patch document (patch field) to the stored array.

Per mode, exactly one payload field is expected: faqs for replace, patch for patch.