Skip to content
Last updated

Changelog

This is the changelog of the Understory API.

All additions or changes to API endpoints, general usage updates, and behavior changes will be reflected below. Breaking changes will be high-lighted in line with our Breaking Changes policy and the affected APIs grace period will be noted.

See API Versioning to learn more.

2026-01-30

Webhooks API promoted to Alpha

The Webhooks API has been promoted from Preview to Alpha status. This means the API is now available for integration, though changes may still occur. See API Versioning for details.

2026-01-26

Webhooks API (Preview)

  • Added BaseEvent schema that defines the common envelope structure (id, type, timestamp, payload) for all webhook events

2026-01-09

Webhooks API (Preview)

The Webhooks API is now available in preview.

As a preview API, this is currently a draft and is subject to change without notice.

This API enables you to:

  • Create and manage webhook subscriptions to receive real-time notifications
  • Subscribe to events for experiences, events, and bookings

Key features:

  • Webhook subscription management (create, list, get, update, delete)
  • Signature verification using HMAC-SHA256 for secure webhook delivery
  • Secret key returned on subscription creation for signature verification

Available webhook events:

  • Experience: v1.experience.created, v1.experience.updated, v1.experience.deleted
  • Event: v1.event.created, v1.event.updated, v1.event.cancelled, v1.event.completed, v1.event.deleted
  • Booking: v1.booking.created, v1.booking.updated, v1.booking.cancelled

The specification can be inspected in API Reference: Webhook.

2025-12-19

Experiences API

  • Restructured InformationRequest model to support multiple input types via discriminator pattern
  • Added TextInformationRequest schema for free-form text input fields
  • Renamed label to question for clarity on what is presented to the guest
  • Promoted Get information requests and Get ticket variants endpoints to Alpha

2025-12-18

Event Availability API

  • Renamed remaining to cutoff_time in BookingCutoffConstraint for clarity

Other improvements

  • Added default error responses to information requests and ticket variants endpoints
  • Fixed Accept-Language header handling in Experiences API

2025-12-17

Events and Experiences APIs promoted to Alpha

The Events and Experiences APIs have been promoted from Preview to Alpha status. This means they are now available for integration, though changes may still occur. See API Versioning for details.

Additional improvements in this release:

  • Added UNKNOWN to state and visibility enums for better forward compatibility
  • Added INACTIVE state to the Experiences API
  • Improved error responses with proper 403 and 404 status codes
  • Updated Metadata schema to use additionalProperties with string values

Event Availability API updates

  • Renamed SeatsLimitConstraint to EventSeatsLimitConstraint (type: EVENT_SEATS_LIMIT)
  • Added new EventStateConstraint (type: EVENT_STATE) for event state-based availability

Pagination improvements across APIs

Pagination parameters have been standardized across the Bookings, Grow, Events, and Experiences APIs:

  • Added explicit minimum: 1 and maximum: 100 constraints to limit parameters
  • Improved documentation for cursor and limit parameters

2025-12-11

The Event Availability API is now available in alpha. This API allows querying availability for events, including remaining capacity and constraint information such as seat limits, booking limits, ticket limits, and booking cutoff times.

The specification can be inspected in API Reference: Event Availability.

2025-10-10

The Experiences API has been updated. Specifically, the media property in the image variant no longer has a preview_url field.

2025-09-30

The Experiences and Events preview APIs have been updated. This change includes a lot of changes to the general models while preserving the available data.

  • Experiences are no longer differentiated by being shared or not. All experiences should be considered the same.
  • Events now include sessions which contains the specific date and time for when the event is held. This moves a lot of fields from experiences into sessions for better separation and composability.
  • Computed fields have been removed from events' capacity. These can be calculated client side if needed based on total and reserved fields on the Capacity model.

2025-04-29

The Bookings API is moved to Alpha. This means the API is available for integration but changes might still occur. Read the API Versioning article for more details.

  • POST /v1/bookings: A new optional request body field metadata is added to allow for custom key/value pairs of metadata to be attached on the booking for later reference.
  • POST /v1/bookings: The endpoint now only returns the ID and status of a successfull booking operation.

2025-04-08

The Events API is now available in early preview. The specification can be inspected in API Reference: Event.

2025-04-07

The Experience API is now available in early preview. The specification can be inspected in API Reference: Experience.

2025-04-03

The Bookings API is now available in early preview. The specification can be inspected in API Reference: Booking.

2025-03-20

This release adds marketing consents to the API enabling marketing automation flows.

Read more about the API in the API Reference: Get marketing consents.

Back