# Understory API Documentation

This is the complete API documentation for connecting to the Understory API using MindCloud's Universal API.

MindCloud offers one normalized API to access 3,400+ apps from a single place. It centralizes authentication and normalizes app APIs so they are easier and more consistent to use.

## Quickstart

1. A **MindCloud account** — sign in or create an account at [MindCloud](https://app.mindcloud.co).
2. A **MindCloud API Key** — create one in [API Keys](https://app.mindcloud.co/user/api-keys). Keep it on your server.
3. At least one **Understory connection** — create or choose one in [Connections](https://app.mindcloud.co/credentials). Note its `connectionId`.

```text
POST https://connect.mindcloud.co/v2/universal/apps/understory/actions/{actionSlug}/run
```

## Understory actions

- POST `create-booking` Create Booking
- POST `create-webhook-subscription` Create Webhook Subscription
- DELETE `delete-webhook-subscription` Delete Webhook Subscription
- GET `get-booking` Get Booking
- GET `get-current-user` Get Current User
- GET `get-event` Get Event
- GET `get-event-availability` Get Event Availability
- GET `get-experience` Get Experience
- GET `get-order` Get Order
- GET `get-webhook-subscription` Get Webhook Subscription
- GET `list-booking-tickets` List Booking Tickets
- GET `list-bookings` List Bookings
- GET `list-event-availability` List Event Availability
- GET `list-events` List Events
- GET `list-experiences` List Experiences
- GET `list-information-requests` List Information Requests
- GET `list-marketing-consents` List Marketing Consents
- GET `list-order-line-items` List Order Line Items
- GET `list-order-refunds` List Order Refunds
- GET `list-order-transactions` List Order Transactions
- GET `list-orders` List Orders
- GET `list-ticket-variants` List Ticket Variants
- GET `list-webhook-subscriptions` List Webhook Subscriptions
- PUT `update-webhook-subscription` Update Webhook Subscription