# Podyx Studio API

> Compose custom booking integrations from independently usable capabilities.
> v2 guides explain choices and invariants; OpenAPI defines exact fields and permissions.
> Keep studio keys on your backend. Quotes and availability create no hold.

## Capability guides (v2)

- [Build your own integration](/api/docs/guides/v2/overview.md): Choose how your customers discover, book and manage studio time. Podyx supplies the catalog, availability, prices, client records and payment state; your application decides how to bring those capabilities together.
- [Access & permissions](/api/docs/guides/v2/access.md): Call the API from your backend with a studio key. The key establishes studio authority; your application authenticates its own visitors and decides which actions they may take.
- [Catalog & offers](/api/docs/guides/v2/catalog.md): Discover what the studio can sell before deciding how your selection interface works. Room-first and service-first experiences use the same resources and compatibility constraints.
- [Availability](/api/docs/guides/v2/availability.md): Ask for physical room windows before you know the duration, or concrete eligible starts once the selection is more complete. Neither response creates a reservation.
- [Quotes & requirements](/api/docs/guides/v2/quotes.md): Use Podyx to resolve the price and the details a customer must provide. Partial selections help you decide which question your interface asks next.
- [Clients & identity](/api/docs/guides/v2/clients.md): Associate a person with the studio independently of a booking, or let supported admission create the association. Creating a client is not customer authentication or account activation.
- [Bookings & sessions](/api/docs/guides/v2/bookings.md): Create a complete booking or compose changes around an existing session. A booking can contain several sessions; actions on one session must preserve its siblings.
- [Payments & refunds](/api/docs/guides/v2/payments.md): Choose native payment instructions or record money the studio actually collected elsewhere. Both models preserve Podyx's admission, pricing, approval and fulfillment rules.
- [State & recovery](/api/docs/guides/v2/recovery.md): Recover an uncertain write without creating a second booking, charge or financial obligation. Command acceptance and current resource state answer different questions.

## Contracts and human reference

- [Studio API v2 OpenAPI](/api/openapi-v2.json)
- [Legacy API v1 OpenAPI](/api/openapi.json)
- [Complete API reference](/api/docs)
- [HTML capability guides](/api/docs/guides)