{
    "openapi": "3.1.0",
    "info": {
        "title": "Ergon CMS — Site API",
        "version": "1",
        "description": "Everything a customer app (for example built with Flutter) needs from an Ergon CMS website: content, sign-in, shop, bookings, events and more. Public endpoints need no key. Every answer is {\"data\": …} (lists add \"meta\" and \"links\"); errors are {\"error\": {\"code\", \"message\", \"fields\"}}. Money is in cents. Guide: https://ergon-code.dev/docs/site-api"
    },
    "servers": [
        {
            "url": "https://your-site.example/api/site/v1"
        }
    ],
    "paths": {
        "/auth/email/resend": {
            "post": {
                "operationId": "authResend",
                "summary": "Email a new confirmation code",
                "tags": [
                    "Auth"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    },
                    {}
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "email": {
                                        "type": "string",
                                        "format": "email"
                                    }
                                },
                                "required": [
                                    "email"
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "422": {
                        "$ref": "#/components/responses/Invalid"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/auth/email/verify": {
            "post": {
                "operationId": "authVerify",
                "summary": "Confirm the email address with the 6-digit code",
                "tags": [
                    "Auth"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    },
                    {}
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "email": {
                                        "type": "string",
                                        "format": "email"
                                    },
                                    "code": {
                                        "type": "string"
                                    },
                                    "device": {
                                        "type": "string",
                                        "description": "a name for this device, shown under signed-in devices"
                                    }
                                },
                                "required": [
                                    "email",
                                    "code"
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "access_token, refresh_token, expires_in and the customer",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "422": {
                        "$ref": "#/components/responses/Invalid"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/auth/login": {
            "post": {
                "operationId": "authLogin",
                "summary": "Sign in with email and password",
                "tags": [
                    "Auth"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    },
                    {}
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "email": {
                                        "type": "string",
                                        "format": "email"
                                    },
                                    "password": {
                                        "type": "string"
                                    },
                                    "code": {
                                        "type": "string",
                                        "description": "two-factor code, when asked for"
                                    },
                                    "device": {
                                        "type": "string",
                                        "description": "a name for this device, shown under signed-in devices"
                                    }
                                },
                                "required": [
                                    "email",
                                    "password"
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "access_token, refresh_token, expires_in and the customer. two_factor_required → send again with code; email_not_verified → a new code was emailed",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "422": {
                        "$ref": "#/components/responses/Invalid"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/auth/logout": {
            "post": {
                "operationId": "authLogout",
                "summary": "Sign out this device",
                "tags": [
                    "Auth"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "422": {
                        "$ref": "#/components/responses/Invalid"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/auth/logout-all": {
            "post": {
                "operationId": "authLogoutAll",
                "summary": "Sign out every device",
                "tags": [
                    "Auth"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "422": {
                        "$ref": "#/components/responses/Invalid"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/auth/passkey": {
            "post": {
                "operationId": "authPasskey",
                "summary": "Finish a passkey sign-in",
                "tags": [
                    "Auth"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    },
                    {}
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "challenge_id": {
                                        "type": "string"
                                    },
                                    "credential": {
                                        "type": "object",
                                        "description": "the assertion from the platform"
                                    },
                                    "device": {
                                        "type": "string",
                                        "description": "a name for this device, shown under signed-in devices"
                                    }
                                },
                                "required": [
                                    "challenge_id",
                                    "credential"
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "access_token, refresh_token, expires_in and the customer",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "422": {
                        "$ref": "#/components/responses/Invalid"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/auth/passkey/options": {
            "post": {
                "operationId": "authPasskeyOptions",
                "summary": "Start a passkey sign-in",
                "tags": [
                    "Auth"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    },
                    {}
                ],
                "responses": {
                    "200": {
                        "description": "challenge_id and the WebAuthn request options for the platform passkey API",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "422": {
                        "$ref": "#/components/responses/Invalid"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/auth/password/forgot": {
            "post": {
                "operationId": "authForgot",
                "summary": "Email a password reset code",
                "description": "Always answers sent: true, so it never tells whether an address has an account.",
                "tags": [
                    "Auth"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    },
                    {}
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "email": {
                                        "type": "string",
                                        "format": "email"
                                    }
                                },
                                "required": [
                                    "email"
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "422": {
                        "$ref": "#/components/responses/Invalid"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/auth/password/reset": {
            "post": {
                "operationId": "authReset",
                "summary": "Set a new password with the emailed code",
                "description": "Signs the customer out on every other device.",
                "tags": [
                    "Auth"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    },
                    {}
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "email": {
                                        "type": "string",
                                        "format": "email"
                                    },
                                    "code": {
                                        "type": "string"
                                    },
                                    "password": {
                                        "type": "string"
                                    },
                                    "password_confirmation": {
                                        "type": "string"
                                    },
                                    "device": {
                                        "type": "string",
                                        "description": "a name for this device, shown under signed-in devices"
                                    }
                                },
                                "required": [
                                    "email",
                                    "code",
                                    "password",
                                    "password_confirmation"
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "access_token, refresh_token, expires_in and the customer",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "422": {
                        "$ref": "#/components/responses/Invalid"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/auth/refresh": {
            "post": {
                "operationId": "authRefresh",
                "summary": "Renew the access token",
                "description": "Refresh tokens rotate: each one works once. Using one twice ends that sign-in everywhere.",
                "tags": [
                    "Auth"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    },
                    {}
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "refresh_token": {
                                        "type": "string"
                                    }
                                },
                                "required": [
                                    "refresh_token"
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "access_token, refresh_token, expires_in and the customer",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "422": {
                        "$ref": "#/components/responses/Invalid"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/auth/register": {
            "post": {
                "operationId": "authRegister",
                "summary": "Create a customer account",
                "tags": [
                    "Auth"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    },
                    {}
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "name": {
                                        "type": "string"
                                    },
                                    "email": {
                                        "type": "string",
                                        "format": "email"
                                    },
                                    "password": {
                                        "type": "string"
                                    },
                                    "password_confirmation": {
                                        "type": "string"
                                    },
                                    "device": {
                                        "type": "string",
                                        "description": "a name for this device, shown under signed-in devices"
                                    }
                                },
                                "required": [
                                    "name",
                                    "email",
                                    "password",
                                    "password_confirmation"
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "When email confirmation is on: verification_required and a code is emailed; otherwise access_token, refresh_token, expires_in and the customer",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "422": {
                        "$ref": "#/components/responses/Invalid"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/auth/social/{provider}": {
            "post": {
                "operationId": "authSocial",
                "summary": "Sign in with Apple or Google",
                "description": "Send the ID token the platform SDK gave the app; it is verified against the client ids in Settings → API → Apps for your customers.",
                "tags": [
                    "Auth"
                ],
                "parameters": [
                    {
                        "name": "provider",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    },
                    {}
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "id_token": {
                                        "type": "string"
                                    },
                                    "name": {
                                        "type": "string",
                                        "description": "Apple sends the name only the first time"
                                    },
                                    "device": {
                                        "type": "string",
                                        "description": "a name for this device, shown under signed-in devices"
                                    }
                                },
                                "required": [
                                    "id_token"
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "access_token, refresh_token, expires_in and the customer",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/Invalid"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/booking/services": {
            "get": {
                "operationId": "bookingServices",
                "summary": "Bookable services (appointments, classes, rooms, hire)",
                "tags": [
                    "Booking"
                ],
                "parameters": [
                    {
                        "name": "kind",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "appointment",
                                "class",
                                "room",
                                "rental"
                            ]
                        }
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    },
                    {}
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Not modified (If-None-Match matched the ETag)"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/booking/services/{slug}": {
            "get": {
                "operationId": "bookingService",
                "summary": "One service with its availability",
                "description": "availability by kind — appointment: ?date=YYYY-MM-DD&party= gives slots · class: upcoming sessions · room: ?from=&to=&adults=&children=&infants=&plan=&extras[]= gives a quote · rental: ?from=&to= gives a quote and the deposit.",
                "tags": [
                    "Booking"
                ],
                "parameters": [
                    {
                        "name": "slug",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "date",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date"
                        }
                    },
                    {
                        "name": "party",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        }
                    },
                    {
                        "name": "from",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date"
                        }
                    },
                    {
                        "name": "to",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date"
                        }
                    },
                    {
                        "name": "adults",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        }
                    },
                    {
                        "name": "children",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        }
                    },
                    {
                        "name": "infants",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        }
                    },
                    {
                        "name": "plan",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        }
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    },
                    {}
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Not modified (If-None-Match matched the ETag)"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            },
            "post": {
                "operationId": "bookingBook",
                "summary": "Book",
                "description": "Fields by kind — appointment: start (ISO time from slots), party · class: session, party, waitlist · room: from, to, adults, children, infants, plan, extras · rental: from, to. Always name and email (taken from the account when signed in), phone, note. A booking that must be paid lands in the cart (next: checkout).",
                "tags": [
                    "Booking"
                ],
                "parameters": [
                    {
                        "name": "slug",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    },
                    {
                        "$ref": "#/components/parameters/SessionToken"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    },
                    {}
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "start": {
                                        "type": "string",
                                        "format": "date-time"
                                    },
                                    "session": {
                                        "type": "integer"
                                    },
                                    "from": {
                                        "type": "string",
                                        "format": "date"
                                    },
                                    "to": {
                                        "type": "string",
                                        "format": "date"
                                    },
                                    "party": {
                                        "type": "integer"
                                    },
                                    "name": {
                                        "type": "string"
                                    },
                                    "email": {
                                        "type": "string",
                                        "format": "email"
                                    },
                                    "phone": {
                                        "type": "string"
                                    },
                                    "note": {
                                        "type": "string"
                                    }
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/Invalid"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/bookings/{reference}": {
            "get": {
                "operationId": "bookingsShow",
                "summary": "One booking",
                "tags": [
                    "Bookings"
                ],
                "parameters": [
                    {
                        "name": "reference",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "t",
                        "in": "query",
                        "schema": {
                            "type": "string"
                        },
                        "description": "the access key (guests)"
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    },
                    {
                        "$ref": "#/components/parameters/SessionToken"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    },
                    {}
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Not modified (If-None-Match matched the ETag)"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/bookings/{reference}/cancel": {
            "post": {
                "operationId": "bookingsCancel",
                "summary": "Cancel a booking",
                "description": "Allowed until the notice period; a paid booking is cancelled by the business.",
                "tags": [
                    "Bookings"
                ],
                "parameters": [
                    {
                        "name": "reference",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    },
                    {
                        "$ref": "#/components/parameters/SessionToken"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    },
                    {}
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "t": {
                                        "type": "string",
                                        "description": "guests"
                                    }
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/Invalid"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/bootstrap": {
            "get": {
                "operationId": "bootstrap",
                "summary": "Everything the app needs at start",
                "description": "Site name, colours, languages, which features the site has (shop, booking, events …), minimum app versions with store links, maintenance notice, legal links, the page blocks the app draws natively. Call it on every start; it is cached (ETag).",
                "tags": [
                    "Bootstrap"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    },
                    {}
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Not modified (If-None-Match matched the ETag)"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/cart": {
            "get": {
                "operationId": "cart",
                "summary": "The app session's cart with server totals",
                "tags": [
                    "Cart"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    },
                    {
                        "$ref": "#/components/parameters/SessionToken"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    },
                    {}
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Not modified (If-None-Match matched the ETag)"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            },
            "delete": {
                "operationId": "cartClear",
                "summary": "Empty the cart",
                "tags": [
                    "Cart"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    },
                    {
                        "$ref": "#/components/parameters/SessionToken"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    },
                    {}
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "422": {
                        "$ref": "#/components/responses/Invalid"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/cart/coupon": {
            "post": {
                "operationId": "cartCoupon",
                "summary": "Apply a coupon code",
                "tags": [
                    "Cart"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    },
                    {
                        "$ref": "#/components/parameters/SessionToken"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    },
                    {}
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "code": {
                                        "type": "string"
                                    }
                                },
                                "required": [
                                    "code"
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "the cart",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "422": {
                        "$ref": "#/components/responses/Invalid"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            },
            "delete": {
                "operationId": "cartCouponRemove",
                "summary": "Remove a coupon",
                "tags": [
                    "Cart"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    },
                    {
                        "$ref": "#/components/parameters/SessionToken"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    },
                    {}
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "code": {
                                        "type": "string"
                                    }
                                },
                                "required": [
                                    "code"
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "422": {
                        "$ref": "#/components/responses/Invalid"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/cart/gift-card": {
            "post": {
                "operationId": "cartGiftcard",
                "summary": "Pay with a gift card",
                "tags": [
                    "Cart"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    },
                    {
                        "$ref": "#/components/parameters/SessionToken"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    },
                    {}
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "code": {
                                        "type": "string"
                                    }
                                },
                                "required": [
                                    "code"
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "the cart",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "422": {
                        "$ref": "#/components/responses/Invalid"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            },
            "delete": {
                "operationId": "cartGiftcardRemove",
                "summary": "Remove the gift card",
                "tags": [
                    "Cart"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    },
                    {
                        "$ref": "#/components/parameters/SessionToken"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    },
                    {}
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "422": {
                        "$ref": "#/components/responses/Invalid"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/cart/items": {
            "post": {
                "operationId": "cartAdd",
                "summary": "Put a product in the cart",
                "tags": [
                    "Cart"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    },
                    {
                        "$ref": "#/components/parameters/SessionToken"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    },
                    {}
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "product_id": {
                                        "type": "integer",
                                        "description": "its default variant"
                                    },
                                    "variant_id": {
                                        "type": "integer"
                                    },
                                    "quantity": {
                                        "type": "integer"
                                    },
                                    "spec": {
                                        "type": "object",
                                        "description": "chosen options"
                                    }
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "422": {
                        "$ref": "#/components/responses/Invalid"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/cart/items/{item}": {
            "patch": {
                "operationId": "cartUpdate",
                "summary": "Change a line's quantity (0 removes it)",
                "tags": [
                    "Cart"
                ],
                "parameters": [
                    {
                        "name": "item",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    },
                    {
                        "$ref": "#/components/parameters/SessionToken"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    },
                    {}
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "quantity": {
                                        "type": "integer"
                                    }
                                },
                                "required": [
                                    "quantity"
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/Invalid"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            },
            "delete": {
                "operationId": "cartRemove",
                "summary": "Remove a line",
                "tags": [
                    "Cart"
                ],
                "parameters": [
                    {
                        "name": "item",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    },
                    {
                        "$ref": "#/components/parameters/SessionToken"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    },
                    {}
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/Invalid"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/cart/points": {
            "post": {
                "operationId": "cartPoints",
                "summary": "Redeem points on the cart",
                "tags": [
                    "Cart"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    },
                    {
                        "$ref": "#/components/parameters/SessionToken"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "points": {
                                        "type": "integer"
                                    }
                                },
                                "required": [
                                    "points"
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "422": {
                        "$ref": "#/components/responses/Invalid"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            },
            "delete": {
                "operationId": "cartPointsRemove",
                "summary": "Stop redeeming points",
                "tags": [
                    "Cart"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    },
                    {
                        "$ref": "#/components/parameters/SessionToken"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "422": {
                        "$ref": "#/components/responses/Invalid"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/categories": {
            "get": {
                "operationId": "postsCategories",
                "summary": "Blog categories",
                "tags": [
                    "Categories"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    },
                    {}
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Not modified (If-None-Match matched the ETag)"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/chat/messages": {
            "get": {
                "operationId": "chatMessages",
                "summary": "The chat conversation of this app session",
                "tags": [
                    "Chat"
                ],
                "parameters": [
                    {
                        "name": "after",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "only messages after this id (polling)"
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    },
                    {
                        "$ref": "#/components/parameters/SessionToken"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    },
                    {}
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Not modified (If-None-Match matched the ETag)"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            },
            "post": {
                "operationId": "chatSend",
                "summary": "Write in the chat",
                "tags": [
                    "Chat"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    },
                    {
                        "$ref": "#/components/parameters/SessionToken"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    },
                    {}
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "body": {
                                        "type": "string"
                                    },
                                    "name": {
                                        "type": "string"
                                    },
                                    "email": {
                                        "type": "string",
                                        "format": "email"
                                    }
                                },
                                "required": [
                                    "body"
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "422": {
                        "$ref": "#/components/responses/Invalid"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/checkout": {
            "get": {
                "operationId": "checkout",
                "summary": "Everything the checkout screen needs",
                "tags": [
                    "Checkout"
                ],
                "parameters": [
                    {
                        "name": "country",
                        "in": "query",
                        "schema": {
                            "type": "string"
                        },
                        "description": "ISO code for the shipping quotes"
                    },
                    {
                        "name": "shipping_method",
                        "in": "query",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    },
                    {
                        "$ref": "#/components/parameters/SessionToken"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    },
                    {}
                ],
                "responses": {
                    "200": {
                        "description": "cart with shipping_quotes, gateways, countries, legal links, extra_fields plugins ask for, the signed-in customer",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Not modified (If-None-Match matched the ETag)"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            },
            "post": {
                "operationId": "checkoutPlace",
                "summary": "Place the order and start the payment",
                "description": "Send an Idempotency-Key: a retried tap never orders twice. payment.status: paid (nothing left to pay) · client (pay in the app: payment.data has the Stripe client_secret and publishable_key for PaymentSheet) · redirect (open payment.url in an in-app browser, then poll GET /orders/{reference}) · pending (pay later; payment.instructions). Keep `access` to open the order as a guest.",
                "tags": [
                    "Checkout"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    },
                    {
                        "$ref": "#/components/parameters/SessionToken"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    },
                    {}
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "email": {
                                        "type": "string",
                                        "format": "email"
                                    },
                                    "gateway": {
                                        "type": "string",
                                        "description": "an id from GET /checkout"
                                    },
                                    "terms": {
                                        "type": "boolean",
                                        "description": "the customer ticked the terms"
                                    },
                                    "billing_address": {
                                        "type": "object",
                                        "description": "name, line1, postcode, city, country (+ company, line2, phone)"
                                    },
                                    "ship_to_different": {
                                        "type": "boolean"
                                    },
                                    "shipping_address": {
                                        "type": "object"
                                    },
                                    "shipping_method": {
                                        "type": "string"
                                    },
                                    "note": {
                                        "type": "string"
                                    }
                                },
                                "required": [
                                    "email",
                                    "gateway",
                                    "terms",
                                    "billing_address"
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "422": {
                        "$ref": "#/components/responses/Invalid"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/collections": {
            "get": {
                "operationId": "collections",
                "summary": "Public content types (team, menu, FAQ …)",
                "tags": [
                    "Collections"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    },
                    {}
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Not modified (If-None-Match matched the ETag)"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/collections/{type}": {
            "get": {
                "operationId": "collectionsEntries",
                "summary": "Published entries of a type",
                "tags": [
                    "Collections"
                ],
                "parameters": [
                    {
                        "name": "type",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    },
                    {}
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Page"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Not modified (If-None-Match matched the ETag)"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/collections/{type}/{slug}": {
            "get": {
                "operationId": "collectionsEntry",
                "summary": "One entry with its fields",
                "tags": [
                    "Collections"
                ],
                "parameters": [
                    {
                        "name": "type",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "slug",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    },
                    {}
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Not modified (If-None-Match matched the ETag)"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/comments": {
            "get": {
                "operationId": "comments",
                "summary": "Approved comments of a page or post",
                "tags": [
                    "Comments"
                ],
                "parameters": [
                    {
                        "name": "path",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "e.g. /blog/spring-menu"
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    },
                    {}
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Not modified (If-None-Match matched the ETag)"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            },
            "post": {
                "operationId": "commentsStore",
                "summary": "Write a comment",
                "description": "Held for approval as on the website.",
                "tags": [
                    "Comments"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    },
                    {}
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "path": {
                                        "type": "string"
                                    },
                                    "body": {
                                        "type": "string"
                                    },
                                    "name": {
                                        "type": "string",
                                        "description": "needed when not signed in"
                                    },
                                    "email": {
                                        "type": "string",
                                        "format": "email",
                                        "description": "needed when not signed in"
                                    },
                                    "parent_id": {
                                        "type": "integer"
                                    }
                                },
                                "required": [
                                    "path",
                                    "body"
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "422": {
                        "$ref": "#/components/responses/Invalid"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/contact": {
            "post": {
                "operationId": "contact",
                "summary": "Send the contact form",
                "tags": [
                    "Contact"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    },
                    {}
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "email": {
                                        "type": "string",
                                        "format": "email"
                                    },
                                    "message": {
                                        "type": "string"
                                    },
                                    "name": {
                                        "type": "string"
                                    },
                                    "phone": {
                                        "type": "string"
                                    },
                                    "company": {
                                        "type": "string"
                                    },
                                    "subject": {
                                        "type": "string"
                                    }
                                },
                                "required": [
                                    "email",
                                    "message"
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "422": {
                        "$ref": "#/components/responses/Invalid"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/events": {
            "get": {
                "operationId": "events",
                "summary": "Upcoming events",
                "tags": [
                    "Events"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    },
                    {}
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Page"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Not modified (If-None-Match matched the ETag)"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/events/{slug}": {
            "get": {
                "operationId": "eventsShow",
                "summary": "One event",
                "tags": [
                    "Events"
                ],
                "parameters": [
                    {
                        "name": "slug",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    },
                    {}
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Not modified (If-None-Match matched the ETag)"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/events/{slug}/rsvp": {
            "post": {
                "operationId": "eventsRsvp",
                "summary": "RSVP / get tickets",
                "description": "A paid event puts the tickets in the cart (next: checkout). Keep `access` to open the ticket as a guest. check_in_code is what the app shows as a QR code at the door.",
                "tags": [
                    "Events"
                ],
                "parameters": [
                    {
                        "name": "slug",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    },
                    {
                        "$ref": "#/components/parameters/SessionToken"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    },
                    {}
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "guests": {
                                        "type": "integer"
                                    },
                                    "name": {
                                        "type": "string",
                                        "description": "guests"
                                    },
                                    "email": {
                                        "type": "string",
                                        "format": "email",
                                        "description": "guests"
                                    }
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/Invalid"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/forms/{key}": {
            "get": {
                "operationId": "formsShow",
                "summary": "A form's fields, in the asked language",
                "description": "requires_sign_in: true for forms protected by a captcha on the website — the app sends them as a signed-in customer.",
                "tags": [
                    "Forms"
                ],
                "parameters": [
                    {
                        "name": "key",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    },
                    {}
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Not modified (If-None-Match matched the ETag)"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            },
            "post": {
                "operationId": "formsSubmit",
                "summary": "Send a form",
                "description": "Body: the field keys from GET /forms/{key}. Validated with the form's own rules.",
                "tags": [
                    "Forms"
                ],
                "parameters": [
                    {
                        "name": "key",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    },
                    {}
                ],
                "responses": {
                    "201": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/Invalid"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/me": {
            "get": {
                "operationId": "me",
                "summary": "The signed-in customer",
                "tags": [
                    "Account"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Not modified (If-None-Match matched the ETag)"
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            },
            "patch": {
                "operationId": "meUpdate",
                "summary": "Change name or email",
                "description": "A new email address needs the current password.",
                "tags": [
                    "Account"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "name": {
                                        "type": "string"
                                    },
                                    "email": {
                                        "type": "string",
                                        "format": "email"
                                    },
                                    "current_password": {
                                        "type": "string"
                                    }
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "422": {
                        "$ref": "#/components/responses/Invalid"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            },
            "delete": {
                "operationId": "meDestroy",
                "summary": "Delete the account",
                "description": "App Store rule 5.1.1(v): an app that creates accounts must let people delete them. Needs the password, or a code from /password/forgot for accounts made with Apple/Google.",
                "tags": [
                    "Account"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "password": {
                                        "type": "string"
                                    },
                                    "code": {
                                        "type": "string"
                                    }
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "422": {
                        "$ref": "#/components/responses/Invalid"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/me/addresses": {
            "get": {
                "operationId": "meAddresses",
                "summary": "Saved addresses",
                "tags": [
                    "Addresses"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    },
                    {
                        "$ref": "#/components/parameters/SessionToken"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Not modified (If-None-Match matched the ETag)"
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            },
            "post": {
                "operationId": "meAddressesStore",
                "summary": "Save an address (up to 20)",
                "tags": [
                    "Addresses"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    },
                    {
                        "$ref": "#/components/parameters/SessionToken"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "name": {
                                        "type": "string"
                                    },
                                    "line1": {
                                        "type": "string"
                                    },
                                    "postcode": {
                                        "type": "string"
                                    },
                                    "city": {
                                        "type": "string"
                                    },
                                    "country": {
                                        "type": "string"
                                    },
                                    "label": {
                                        "type": "string"
                                    },
                                    "company": {
                                        "type": "string"
                                    },
                                    "line2": {
                                        "type": "string"
                                    },
                                    "phone": {
                                        "type": "string"
                                    },
                                    "is_default": {
                                        "type": "boolean"
                                    }
                                },
                                "required": [
                                    "name",
                                    "line1",
                                    "postcode",
                                    "city",
                                    "country"
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "422": {
                        "$ref": "#/components/responses/Invalid"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/me/addresses/{address}": {
            "put": {
                "operationId": "meAddressesUpdate",
                "summary": "Change an address",
                "tags": [
                    "Addresses"
                ],
                "parameters": [
                    {
                        "name": "address",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    },
                    {
                        "$ref": "#/components/parameters/SessionToken"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "name": {
                                        "type": "string"
                                    },
                                    "line1": {
                                        "type": "string"
                                    },
                                    "postcode": {
                                        "type": "string"
                                    },
                                    "city": {
                                        "type": "string"
                                    },
                                    "country": {
                                        "type": "string"
                                    }
                                },
                                "required": [
                                    "name",
                                    "line1",
                                    "postcode",
                                    "city",
                                    "country"
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/Invalid"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            },
            "delete": {
                "operationId": "meAddressesDestroy",
                "summary": "Delete an address",
                "tags": [
                    "Addresses"
                ],
                "parameters": [
                    {
                        "name": "address",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    },
                    {
                        "$ref": "#/components/parameters/SessionToken"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/Invalid"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/me/bookings": {
            "get": {
                "operationId": "meBookings",
                "summary": "The customer's bookings",
                "tags": [
                    "Bookings"
                ],
                "parameters": [
                    {
                        "name": "when",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "upcoming",
                                "past"
                            ]
                        }
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    },
                    {
                        "$ref": "#/components/parameters/SessionToken"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Page"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Not modified (If-None-Match matched the ETag)"
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/me/devices": {
            "post": {
                "operationId": "devicesStore",
                "summary": "Register this device for push",
                "tags": [
                    "Devices"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "token": {
                                        "type": "string",
                                        "description": "the FCM token"
                                    },
                                    "platform": {
                                        "type": "string",
                                        "enum": [
                                            "ios",
                                            "android",
                                            "web"
                                        ]
                                    },
                                    "topics": {
                                        "type": "array",
                                        "items": {
                                            "type": "string"
                                        },
                                        "description": "e.g. news; only topics the site offers are kept"
                                    },
                                    "locale": {
                                        "type": "string"
                                    }
                                },
                                "required": [
                                    "token",
                                    "platform"
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "422": {
                        "$ref": "#/components/responses/Invalid"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            },
            "delete": {
                "operationId": "devicesDestroy",
                "summary": "Stop push to this device",
                "tags": [
                    "Devices"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "token": {
                                        "type": "string"
                                    }
                                },
                                "required": [
                                    "token"
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "422": {
                        "$ref": "#/components/responses/Invalid"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/me/export": {
            "get": {
                "operationId": "meExport",
                "summary": "Everything stored about the customer (GDPR Art. 15/20)",
                "tags": [
                    "Account"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Not modified (If-None-Match matched the ETag)"
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/me/membership": {
            "get": {
                "operationId": "meMembership",
                "summary": "The customer's membership level",
                "tags": [
                    "Membership"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    },
                    {
                        "$ref": "#/components/parameters/SessionToken"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Not modified (If-None-Match matched the ETag)"
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/me/notifications": {
            "get": {
                "operationId": "notifications",
                "summary": "The customer's inbox",
                "tags": [
                    "Notifications"
                ],
                "parameters": [
                    {
                        "name": "status",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "unread"
                            ]
                        }
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Page"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Not modified (If-None-Match matched the ETag)"
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/me/notifications/read-all": {
            "post": {
                "operationId": "notificationsReadAll",
                "summary": "Mark all read",
                "tags": [
                    "Notifications"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "422": {
                        "$ref": "#/components/responses/Invalid"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/me/notifications/{id}/read": {
            "post": {
                "operationId": "notificationsRead",
                "summary": "Mark one message read",
                "tags": [
                    "Notifications"
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/Invalid"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/me/orders": {
            "get": {
                "operationId": "meOrders",
                "summary": "The customer's orders",
                "tags": [
                    "Orders"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    },
                    {
                        "$ref": "#/components/parameters/SessionToken"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Page"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Not modified (If-None-Match matched the ETag)"
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/me/password": {
            "put": {
                "operationId": "mePassword",
                "summary": "Change the password",
                "tags": [
                    "Account"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "current_password": {
                                        "type": "string"
                                    },
                                    "password": {
                                        "type": "string"
                                    },
                                    "password_confirmation": {
                                        "type": "string"
                                    }
                                },
                                "required": [
                                    "current_password",
                                    "password",
                                    "password_confirmation"
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "422": {
                        "$ref": "#/components/responses/Invalid"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/me/points": {
            "get": {
                "operationId": "mePoints",
                "summary": "Points balance and what a point is worth",
                "tags": [
                    "Points"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    },
                    {
                        "$ref": "#/components/parameters/SessionToken"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Not modified (If-None-Match matched the ETag)"
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/me/sessions": {
            "get": {
                "operationId": "meSessions",
                "summary": "Signed-in devices",
                "tags": [
                    "Account"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Not modified (If-None-Match matched the ETag)"
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/me/sessions/{id}": {
            "delete": {
                "operationId": "meSessionsEnd",
                "summary": "Sign out one device",
                "tags": [
                    "Account"
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/Invalid"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/me/subscriptions": {
            "get": {
                "operationId": "meSubscriptions",
                "summary": "Subscriptions with their renewal links",
                "tags": [
                    "Subscriptions"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    },
                    {
                        "$ref": "#/components/parameters/SessionToken"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Not modified (If-None-Match matched the ETag)"
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/me/tickets": {
            "get": {
                "operationId": "meTickets",
                "summary": "The customer's tickets",
                "tags": [
                    "Tickets"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    },
                    {
                        "$ref": "#/components/parameters/SessionToken"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Page"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Not modified (If-None-Match matched the ETag)"
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/me/wishlist": {
            "get": {
                "operationId": "meWishlist",
                "summary": "The wishlist",
                "tags": [
                    "Wishlist"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    },
                    {
                        "$ref": "#/components/parameters/SessionToken"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Not modified (If-None-Match matched the ETag)"
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            },
            "post": {
                "operationId": "meWishlistToggle",
                "summary": "Save or unsave a product",
                "tags": [
                    "Wishlist"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    },
                    {
                        "$ref": "#/components/parameters/SessionToken"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "product_id": {
                                        "type": "integer"
                                    }
                                },
                                "required": [
                                    "product_id"
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "422": {
                        "$ref": "#/components/responses/Invalid"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/me/wishlist/{product}": {
            "delete": {
                "operationId": "meWishlistRemove",
                "summary": "Remove a product",
                "tags": [
                    "Wishlist"
                ],
                "parameters": [
                    {
                        "name": "product",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    },
                    {
                        "$ref": "#/components/parameters/SessionToken"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#/components/responses/Unauthenticated"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/Invalid"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/membership/tiers": {
            "get": {
                "operationId": "membershipTiers",
                "summary": "Membership tiers on offer",
                "tags": [
                    "Membership"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    },
                    {}
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Not modified (If-None-Match matched the ETag)"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/menus": {
            "get": {
                "operationId": "menus",
                "summary": "All menus by location",
                "tags": [
                    "Menus"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    },
                    {}
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Not modified (If-None-Match matched the ETag)"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/menus/{location}": {
            "get": {
                "operationId": "menusShow",
                "summary": "One menu",
                "tags": [
                    "Menus"
                ],
                "parameters": [
                    {
                        "name": "location",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    },
                    {}
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Not modified (If-None-Match matched the ETag)"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/newsletter": {
            "get": {
                "operationId": "newsletter",
                "summary": "The consent text and privacy link to show next to the sign-up",
                "tags": [
                    "Newsletter"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    },
                    {}
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Not modified (If-None-Match matched the ETag)"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            },
            "post": {
                "operationId": "newsletterSubscribe",
                "summary": "Sign up (double opt-in)",
                "description": "Sends the confirmation email; the address is subscribed once it is confirmed.",
                "tags": [
                    "Newsletter"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    },
                    {}
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "email": {
                                        "type": "string",
                                        "format": "email"
                                    },
                                    "consent": {
                                        "type": "boolean",
                                        "description": "must be true"
                                    },
                                    "name": {
                                        "type": "string"
                                    },
                                    "interests": {
                                        "type": "string"
                                    }
                                },
                                "required": [
                                    "email",
                                    "consent"
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "422": {
                        "$ref": "#/components/responses/Invalid"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/orders/{reference}": {
            "get": {
                "operationId": "ordersShow",
                "summary": "One order",
                "description": "Includes downloads and invoices when those plugins are active.",
                "tags": [
                    "Orders"
                ],
                "parameters": [
                    {
                        "name": "reference",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "access",
                        "in": "query",
                        "schema": {
                            "type": "string"
                        },
                        "description": "the key from checkout (guests)"
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    },
                    {
                        "$ref": "#/components/parameters/SessionToken"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    },
                    {}
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Not modified (If-None-Match matched the ETag)"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/orders/{reference}/messages": {
            "get": {
                "operationId": "ordersMessages",
                "summary": "The conversation about an order",
                "tags": [
                    "Orders"
                ],
                "parameters": [
                    {
                        "name": "reference",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "access",
                        "in": "query",
                        "schema": {
                            "type": "string"
                        },
                        "description": "guests"
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    },
                    {
                        "$ref": "#/components/parameters/SessionToken"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    },
                    {}
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Not modified (If-None-Match matched the ETag)"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            },
            "post": {
                "operationId": "ordersMessagesStore",
                "summary": "Write to the shop about an order",
                "tags": [
                    "Orders"
                ],
                "parameters": [
                    {
                        "name": "reference",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    },
                    {
                        "$ref": "#/components/parameters/SessionToken"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    },
                    {}
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "body": {
                                        "type": "string"
                                    }
                                },
                                "required": [
                                    "body"
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/Invalid"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/orders/{reference}/pay": {
            "post": {
                "operationId": "ordersPay",
                "summary": "Pay an open order again",
                "tags": [
                    "Orders"
                ],
                "parameters": [
                    {
                        "name": "reference",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    },
                    {
                        "$ref": "#/components/parameters/SessionToken"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    },
                    {}
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "gateway": {
                                        "type": "string"
                                    }
                                },
                                "required": [
                                    "gateway"
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/Invalid"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/pages": {
            "get": {
                "operationId": "pages",
                "summary": "Published pages",
                "tags": [
                    "Pages"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    },
                    {}
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Page"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Not modified (If-None-Match matched the ETag)"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/pages/{slug}": {
            "get": {
                "operationId": "pagesShow",
                "summary": "One page with its blocks",
                "description": "Blocks the app draws natively carry data; every block also carries ready html as a fallback. \"home\" is the front page. A members-only page answers 403 members_only with a paywall.",
                "tags": [
                    "Pages"
                ],
                "parameters": [
                    {
                        "name": "slug",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    },
                    {}
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Not modified (If-None-Match matched the ETag)"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/posts": {
            "get": {
                "operationId": "posts",
                "summary": "Published posts",
                "tags": [
                    "Posts"
                ],
                "parameters": [
                    {
                        "name": "category",
                        "in": "query",
                        "schema": {
                            "type": "string"
                        },
                        "description": "category slug"
                    },
                    {
                        "name": "tag",
                        "in": "query",
                        "schema": {
                            "type": "string"
                        },
                        "description": "tag slug"
                    },
                    {
                        "name": "q",
                        "in": "query",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    },
                    {}
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Page"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Not modified (If-None-Match matched the ETag)"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/posts/{slug}": {
            "get": {
                "operationId": "postsShow",
                "summary": "One post with its blocks",
                "description": "A members-only post answers 403 members_only with a paywall.",
                "tags": [
                    "Posts"
                ],
                "parameters": [
                    {
                        "name": "slug",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    },
                    {}
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Not modified (If-None-Match matched the ETag)"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/product-categories": {
            "get": {
                "operationId": "productsCategories",
                "summary": "Product categories",
                "tags": [
                    "Product Categories"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    },
                    {}
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Not modified (If-None-Match matched the ETag)"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/products": {
            "get": {
                "operationId": "products",
                "summary": "Published products",
                "tags": [
                    "Products"
                ],
                "parameters": [
                    {
                        "name": "category",
                        "in": "query",
                        "schema": {
                            "type": "string"
                        },
                        "description": "category slug"
                    },
                    {
                        "name": "type",
                        "in": "query",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "q",
                        "in": "query",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    },
                    {}
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Page"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Not modified (If-None-Match matched the ETag)"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/products/{slug}": {
            "get": {
                "operationId": "productsShow",
                "summary": "One product with variants, prices (Money) and blocks",
                "tags": [
                    "Products"
                ],
                "parameters": [
                    {
                        "name": "slug",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    },
                    {}
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Not modified (If-None-Match matched the ETag)"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/products/{slug}/reviews": {
            "get": {
                "operationId": "productsReviews",
                "summary": "Approved reviews and the rating summary",
                "tags": [
                    "Products"
                ],
                "parameters": [
                    {
                        "name": "slug",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        }
                    },
                    {
                        "name": "sort",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "newest",
                                "highest",
                                "oldest"
                            ]
                        }
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    },
                    {}
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Not modified (If-None-Match matched the ETag)"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/reviews": {
            "post": {
                "operationId": "reviewsStore",
                "summary": "Write a review (checked before it shows)",
                "tags": [
                    "Reviews"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    },
                    {
                        "$ref": "#/components/parameters/SessionToken"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    },
                    {}
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "product_id": {
                                        "type": "integer"
                                    },
                                    "rating": {
                                        "type": "integer",
                                        "description": "1 to 5"
                                    },
                                    "body": {
                                        "type": "string"
                                    },
                                    "title": {
                                        "type": "string"
                                    },
                                    "author_name": {
                                        "type": "string",
                                        "description": "guests"
                                    },
                                    "email": {
                                        "type": "string",
                                        "format": "email",
                                        "description": "guests"
                                    },
                                    "order": {
                                        "type": "string",
                                        "description": "order reference, for the verified badge"
                                    }
                                },
                                "required": [
                                    "product_id",
                                    "rating",
                                    "body"
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "422": {
                        "$ref": "#/components/responses/Invalid"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/search": {
            "get": {
                "operationId": "search",
                "summary": "Search the site",
                "tags": [
                    "Search"
                ],
                "parameters": [
                    {
                        "name": "q",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "at least 2 characters"
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    },
                    {}
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Not modified (If-None-Match matched the ETag)"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/tags": {
            "get": {
                "operationId": "postsTags",
                "summary": "Blog tags",
                "tags": [
                    "Tags"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    },
                    {}
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Not modified (If-None-Match matched the ETag)"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/tickets/{reference}": {
            "get": {
                "operationId": "ticketsShow",
                "summary": "One ticket",
                "tags": [
                    "Tickets"
                ],
                "parameters": [
                    {
                        "name": "reference",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "t",
                        "in": "query",
                        "schema": {
                            "type": "string"
                        },
                        "description": "the access key (guests)"
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    },
                    {
                        "$ref": "#/components/parameters/SessionToken"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    },
                    {}
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Not modified (If-None-Match matched the ETag)"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        },
        "/tickets/{reference}/cancel": {
            "post": {
                "operationId": "ticketsCancel",
                "summary": "Cancel an RSVP",
                "tags": [
                    "Tickets"
                ],
                "parameters": [
                    {
                        "name": "reference",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "$ref": "#/components/parameters/AcceptLanguage"
                    },
                    {
                        "$ref": "#/components/parameters/AppVersion"
                    },
                    {
                        "$ref": "#/components/parameters/SessionToken"
                    },
                    {
                        "$ref": "#/components/parameters/IdempotencyKey"
                    }
                ],
                "security": [
                    {
                        "bearer": []
                    },
                    {}
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "t": {
                                        "type": "string",
                                        "description": "guests"
                                    }
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFound"
                    },
                    "422": {
                        "$ref": "#/components/responses/Invalid"
                    },
                    "429": {
                        "$ref": "#/components/responses/TooMany"
                    }
                }
            }
        }
    },
    "components": {
        "securitySchemes": {
            "bearer": {
                "type": "http",
                "scheme": "bearer",
                "description": "A customer access token from /login, /register + /email/verify, /social/{provider} or /passkey. Short-lived; renew with /refresh."
            }
        },
        "parameters": {
            "AcceptLanguage": {
                "name": "Accept-Language",
                "in": "header",
                "schema": {
                    "type": "string"
                },
                "description": "Language of the content (or ?locale=)."
            },
            "AppVersion": {
                "name": "X-App-Version",
                "in": "header",
                "schema": {
                    "type": "string"
                },
                "description": "e.g. \"ios/1.4.0\" — shown in the API Monitor."
            },
            "SessionToken": {
                "name": "X-Session-Token",
                "in": "header",
                "schema": {
                    "type": "string",
                    "pattern": "^[A-Za-z0-9]{40}$"
                },
                "description": "The app session (cart, coupons, guest orders). The first answer hands one out in the same header; send it back on every call."
            },
            "IdempotencyKey": {
                "name": "Idempotency-Key",
                "in": "header",
                "schema": {
                    "type": "string",
                    "maxLength": 128
                },
                "description": "Repeat a write safely: the same key within 24 hours replays the first answer (Idempotent-Replayed: true)."
            }
        },
        "schemas": {
            "Data": {
                "type": "object",
                "required": [
                    "data"
                ],
                "properties": {
                    "data": {}
                }
            },
            "Page": {
                "type": "object",
                "required": [
                    "data",
                    "meta"
                ],
                "properties": {
                    "data": {
                        "type": "array",
                        "items": {}
                    },
                    "meta": {
                        "type": "object",
                        "properties": {
                            "page": {
                                "type": "integer"
                            },
                            "per_page": {
                                "type": "integer"
                            },
                            "total": {
                                "type": "integer"
                            },
                            "last_page": {
                                "type": "integer"
                            }
                        }
                    },
                    "links": {
                        "type": "object",
                        "properties": {
                            "next": {
                                "type": [
                                    "string",
                                    "null"
                                ]
                            },
                            "prev": {
                                "type": [
                                    "string",
                                    "null"
                                ]
                            }
                        }
                    }
                }
            },
            "Money": {
                "type": "object",
                "properties": {
                    "amount": {
                        "type": "integer",
                        "description": "cents"
                    },
                    "currency": {
                        "type": "string"
                    },
                    "formatted": {
                        "type": "string"
                    }
                }
            },
            "Image": {
                "type": [
                    "object",
                    "null"
                ],
                "properties": {
                    "url": {
                        "type": "string"
                    },
                    "alt": {
                        "type": "string"
                    },
                    "width": {
                        "type": "integer"
                    },
                    "height": {
                        "type": "integer"
                    },
                    "sizes": {
                        "type": "object"
                    },
                    "srcset": {
                        "type": "string"
                    }
                }
            },
            "Error": {
                "type": "object",
                "required": [
                    "error"
                ],
                "properties": {
                    "error": {
                        "type": "object",
                        "required": [
                            "code",
                            "message"
                        ],
                        "properties": {
                            "code": {
                                "type": "string",
                                "examples": [
                                    "validation_failed",
                                    "not_found",
                                    "unauthenticated",
                                    "members_only"
                                ]
                            },
                            "message": {
                                "type": "string"
                            },
                            "fields": {
                                "type": "object",
                                "additionalProperties": {
                                    "type": "array",
                                    "items": {
                                        "type": "string"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "responses": {
            "Unauthenticated": {
                "description": "Sign-in required, or the token expired (renew with /refresh).",
                "content": {
                    "application/json": {
                        "schema": {
                            "$ref": "#/components/schemas/Error"
                        }
                    }
                }
            },
            "NotFound": {
                "description": "Not found — or not yours to see.",
                "content": {
                    "application/json": {
                        "schema": {
                            "$ref": "#/components/schemas/Error"
                        }
                    }
                }
            },
            "Invalid": {
                "description": "validation_failed (see fields) or a rule of the shop/booking said no.",
                "content": {
                    "application/json": {
                        "schema": {
                            "$ref": "#/components/schemas/Error"
                        }
                    }
                }
            },
            "TooMany": {
                "description": "Rate limited; see Retry-After."
            }
        }
    },
    "tags": [
        {
            "name": "Account"
        },
        {
            "name": "Addresses"
        },
        {
            "name": "Auth"
        },
        {
            "name": "Booking"
        },
        {
            "name": "Bookings"
        },
        {
            "name": "Bootstrap"
        },
        {
            "name": "Cart"
        },
        {
            "name": "Categories"
        },
        {
            "name": "Chat"
        },
        {
            "name": "Checkout"
        },
        {
            "name": "Collections"
        },
        {
            "name": "Comments"
        },
        {
            "name": "Contact"
        },
        {
            "name": "Devices"
        },
        {
            "name": "Events"
        },
        {
            "name": "Forms"
        },
        {
            "name": "Membership"
        },
        {
            "name": "Menus"
        },
        {
            "name": "Newsletter"
        },
        {
            "name": "Notifications"
        },
        {
            "name": "Orders"
        },
        {
            "name": "Pages"
        },
        {
            "name": "Points"
        },
        {
            "name": "Posts"
        },
        {
            "name": "Product Categories"
        },
        {
            "name": "Products"
        },
        {
            "name": "Reviews"
        },
        {
            "name": "Search"
        },
        {
            "name": "Subscriptions"
        },
        {
            "name": "Tags"
        },
        {
            "name": "Tickets"
        },
        {
            "name": "Wishlist"
        }
    ]
}
