{
  "info": {
    "name": "AXYN Ticketing API",
    "_postman_id": "axyn-ticketing-v1",
    "description": "Standalone AXYN ticketing platform API.\n\n## Authentication\n\nThree schemes are used:\n\n- **`x-api-key`**: per-tenant API key (with scopes) for server-to-server catalog/integration calls. Use `axyn_sk_test_...` keys for sandbox data and `axyn_sk_live_...` keys for live data on the same API host.\n- **`Authorization: Bearer`**: Supabase-issued user JWT for end-user and staff actions.\n- **`x-scanner-token`**: scanner device token for hosted/offline scanning.\n\nMost write endpoints on `/v1/orders` require an **`Idempotency-Key`** header. Scan endpoints return business outcomes in the response body (`result_code`) with HTTP 200; only transport/validation failures use 4xx/5xx.\n\n## Quickstart\n\n1. Mint a scoped test tenant API key (`x-api-key`) in Admin Developer settings.\n2. **Browse the catalog**: `GET /v1/events/{eventId}/tiers` (`catalog:read`).\n3. **Create an order**: `POST /v1/orders` with an `Idempotency-Key` header (Supabase JWT).\n4. **Pay**: complete the Stripe PaymentIntent client secret returned when payment is started. Test keys return Stripe test-mode client secrets.\n5. **Scan at the door**: `POST /v1/tickets/scan` (staff JWT) or `POST /v1/tickets/validate` (scanner device token).\n\n## Required disclosure\n\nEvery buyer checkout must show AXYN's privacy notice where the buyer enters their details or card (the notice at the point of collection that CCPA requires): the text `Ticketing by AXYN · Privacy`, with `Privacy` linking to `https://axyn.events/legal/privacy`. The Web SDK renders it in every checkout. API-only integrations must render it themselves, on every step that collects buyer details or a card, including cash-at-the-door and free orders.\n\nThe machine-readable contract is at `/openapi.json` and a Postman collection at `/postman_collection.json`.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "item": [
    {
      "name": "health",
      "item": [
        {
          "name": "Liveness probe",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/health",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "health"
              ]
            }
          }
        },
        {
          "name": "Readiness probe",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/readyz",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "readyz"
              ]
            }
          }
        }
      ],
      "description": "Liveness / readiness probes (no auth)."
    },
    {
      "name": "discovery",
      "item": [
        {
          "name": "List on-sale discovery events for the tenant",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "x-api-key",
                "value": "{{tenantApiKey}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/discovery/events?page={{page}}&limit={{limit}}&sort={{sort}}&venue={{venue}}&price_max={{price_max}}",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "discovery",
                "events"
              ],
              "query": [
                {
                  "key": "page",
                  "value": "{{page}}"
                },
                {
                  "key": "limit",
                  "value": "{{limit}}"
                },
                {
                  "key": "sort",
                  "value": "{{sort}}"
                },
                {
                  "key": "venue",
                  "value": "{{venue}}"
                },
                {
                  "key": "price_max",
                  "value": "{{price_max}}"
                }
              ]
            },
            "description": "ENG-154: public catalog projection. Requires a tenant API key with the discovery:read scope."
          }
        },
        {
          "name": "List discovery events near a lat/lng (ENG-156)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "x-api-key",
                "value": "{{tenantApiKey}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/discovery/nearby?lat={{lat}}&lng={{lng}}&radius={{radius}}&page={{page}}&limit={{limit}}&sort={{sort}}",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "discovery",
                "nearby"
              ],
              "query": [
                {
                  "key": "lat",
                  "value": "{{lat}}"
                },
                {
                  "key": "lng",
                  "value": "{{lng}}"
                },
                {
                  "key": "radius",
                  "value": "{{radius}}"
                },
                {
                  "key": "page",
                  "value": "{{page}}"
                },
                {
                  "key": "limit",
                  "value": "{{limit}}"
                },
                {
                  "key": "sort",
                  "value": "{{sort}}"
                }
              ]
            },
            "description": "Geo-ranked discovery list over the discovery_event projection. Requires tenant API key with discovery:read. lat, lng, and radius (meters) are required."
          }
        },
        {
          "name": "Autocomplete events and venues (ENG-155)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "x-api-key",
                "value": "{{tenantApiKey}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/discovery/autocomplete?q={{q}}&limit={{limit}}",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "discovery",
                "autocomplete"
              ],
              "query": [
                {
                  "key": "q",
                  "value": "{{q}}"
                },
                {
                  "key": "limit",
                  "value": "{{limit}}"
                }
              ]
            },
            "description": "Prefix autocomplete over discovery events and venues. Requires tenant API key with discovery:read."
          }
        },
        {
          "name": "Get a published editorial discovery collection (ENG-158)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "x-api-key",
                "value": "{{tenantApiKey}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/discovery/collections/:slug",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "discovery",
                "collections",
                ":slug"
              ],
              "variable": [
                {
                  "key": "slug",
                  "value": "{{slug}}"
                }
              ]
            },
            "description": "Returns a published collection by slug plus its curated discovery events. Requires tenant API key with discovery:read."
          }
        },
        {
          "name": "List discovery events for an organizer storefront (ENG-160 / ENG-522)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "x-api-key",
                "value": "{{tenantApiKey}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/orgs/:slug/events?page={{page}}&limit={{limit}}&sort={{sort}}",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "orgs",
                ":slug",
                "events"
              ],
              "query": [
                {
                  "key": "page",
                  "value": "{{page}}"
                },
                {
                  "key": "limit",
                  "value": "{{limit}}"
                },
                {
                  "key": "sort",
                  "value": "{{sort}}"
                }
              ],
              "variable": [
                {
                  "key": "slug",
                  "value": "{{slug}}"
                }
              ]
            },
            "description": "Organizer storefront discovery facet. Requires tenant API key with discovery:read. `data.org` includes public enrichment fields (about, contact, website, socials) when set (ENG-522)."
          }
        },
        {
          "name": "Get an artist discovery page (ENG-157)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "x-api-key",
                "value": "{{tenantApiKey}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/artists/:slug",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "artists",
                ":slug"
              ],
              "variable": [
                {
                  "key": "slug",
                  "value": "{{slug}}"
                }
              ]
            },
            "description": "Active artist page by slug. Requires tenant API key with discovery:read."
          }
        },
        {
          "name": "List discovery events for an artist (ENG-157)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "x-api-key",
                "value": "{{tenantApiKey}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/artists/:slug/events",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "artists",
                ":slug",
                "events"
              ],
              "variable": [
                {
                  "key": "slug",
                  "value": "{{slug}}"
                }
              ]
            },
            "description": "Upcoming/on-sale appearances for an artist slug. Requires tenant API key with discovery:read."
          }
        }
      ],
      "description": "Cross-tenant discovery feed over the discovery_event projection (tenant API key + discovery:read)."
    },
    {
      "name": "tenants",
      "item": [
        {
          "name": "An AXYN email send's Sent / Clicked / Bought (ENG-2563)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tenants/:tenantId/email-sends/:emailSendId/clicks",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tenants",
                ":tenantId",
                "email-sends",
                ":emailSendId",
                "clicks"
              ],
              "variable": [
                {
                  "key": "tenantId",
                  "value": "{{tenantId}}"
                },
                {
                  "key": "emailSendId",
                  "value": "{{emailSendId}}"
                }
              ]
            },
            "description": "Counts only, never a recipient. Clicked counts recipients with a click the landing page confirmed and no automated flag (too fast after delivery, several links at once, or after the hidden link). Bought counts recipients who paid within 7 days after a counted click."
          }
        },
        {
          "name": "List my Overview summary emails",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tenants/:tenantId/summary-emails/me",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tenants",
                ":tenantId",
                "summary-emails",
                "me"
              ],
              "variable": [
                {
                  "key": "tenantId",
                  "value": "{{tenantId}}"
                }
              ]
            },
            "description": "ENG-2404: staff JWT with a tenant-wide sales_dashboard.read grant (organizer_admin, event_manager, finance, viewer). Every event and series the caller gets a summary email for (cadence not off), by title. For Settings › Notifications."
          }
        },
        {
          "name": "Read my summary email for an event",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tenants/:tenantId/summary-emails/me/events/:eventId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tenants",
                ":tenantId",
                "summary-emails",
                "me",
                "events",
                ":eventId"
              ],
              "variable": [
                {
                  "key": "tenantId",
                  "value": "{{tenantId}}"
                },
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                }
              ]
            },
            "description": "ENG-2404: staff JWT with a tenant-wide sales_dashboard.read grant. The caller's own cadence for this event; off when never set."
          }
        },
        {
          "name": "Set my summary email for an event",
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tenants/:tenantId/summary-emails/me/events/:eventId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tenants",
                ":tenantId",
                "summary-emails",
                "me",
                "events",
                ":eventId"
              ],
              "variable": [
                {
                  "key": "tenantId",
                  "value": "{{tenantId}}"
                },
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                }
              ]
            },
            "description": "ENG-2404: staff JWT with a tenant-wide sales_dashboard.read grant. Sets the caller's own cadence for this event. The This week card's button and Export › Email me a summary write this one value. A super admin without a membership gets 403 summary_requires_membership.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"cadence\": \"off\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Read my summary email for a series",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tenants/:tenantId/summary-emails/me/series/:productionId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tenants",
                ":tenantId",
                "summary-emails",
                "me",
                "series",
                ":productionId"
              ],
              "variable": [
                {
                  "key": "tenantId",
                  "value": "{{tenantId}}"
                },
                {
                  "key": "productionId",
                  "value": "{{productionId}}"
                }
              ]
            },
            "description": "ENG-2404: staff JWT with a tenant-wide sales_dashboard.read grant. The caller's own cadence for this series; off when never set."
          }
        },
        {
          "name": "Set my summary email for a series",
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tenants/:tenantId/summary-emails/me/series/:productionId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tenants",
                ":tenantId",
                "summary-emails",
                "me",
                "series",
                ":productionId"
              ],
              "variable": [
                {
                  "key": "tenantId",
                  "value": "{{tenantId}}"
                },
                {
                  "key": "productionId",
                  "value": "{{productionId}}"
                }
              ]
            },
            "description": "ENG-2404: staff JWT with a tenant-wide sales_dashboard.read grant. Sets the caller's own cadence for this series. The This week card's button and Export › Email me a summary write this one value. A super admin without a membership gets 403 summary_requires_membership.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"cadence\": \"off\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Self-serve create a tenant (organizer signup)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{Idempotency-Key}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tenants",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tenants"
              ]
            },
            "description": "ENG-282: requires an organizer staff JWT and an Idempotency-Key header.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"display_name\": \"string\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "List the caller's tenant staff memberships",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/me/staff-memberships",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "me",
                "staff-memberships"
              ]
            },
            "description": "ENG-282: requires an organizer staff JWT."
          }
        },
        {
          "name": "List the organization's orders (ENG-3035)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tenants/:tenantId/orders?event_id={{event_id}}&production_id={{production_id}}&ticket_tier_id={{ticket_tier_id}}&status={{status}}&display_status={{display_status}}&q={{q}}&limit={{limit}}&offset={{offset}}",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tenants",
                ":tenantId",
                "orders"
              ],
              "query": [
                {
                  "key": "event_id",
                  "value": "{{event_id}}"
                },
                {
                  "key": "production_id",
                  "value": "{{production_id}}"
                },
                {
                  "key": "ticket_tier_id",
                  "value": "{{ticket_tier_id}}"
                },
                {
                  "key": "status",
                  "value": "{{status}}"
                },
                {
                  "key": "display_status",
                  "value": "{{display_status}}"
                },
                {
                  "key": "q",
                  "value": "{{q}}"
                },
                {
                  "key": "limit",
                  "value": "{{limit}}"
                },
                {
                  "key": "offset",
                  "value": "{{offset}}"
                }
              ],
              "variable": [
                {
                  "key": "tenantId",
                  "value": "{{tenantId}}"
                }
              ]
            },
            "description": "Newest first. Filter by `event_id` or `production_id` (a series lists the orders sold under it, by the series recorded on each order, so a long run never puts its shows in the URL), `ticket_tier_id`, `status`, and `q`: the buyer's name or email, or the start of an order number. Each row carries its lines (ticket type, show and start in the show's time zone, seats), add-ons, wallet and one display status. Needs tenant_orders.read (an event-scoped grant reads its own event with `event_id`). A viewer gets the buyer's email masked and no name or phone, and searches by order number only."
          }
        },
        {
          "name": "One order as the order panel shows it (ENG-3035)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tenants/:tenantId/orders/:orderId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tenants",
                ":tenantId",
                "orders",
                ":orderId"
              ],
              "variable": [
                {
                  "key": "tenantId",
                  "value": "{{tenantId}}"
                },
                {
                  "key": "orderId",
                  "value": "{{orderId}}"
                }
              ]
            },
            "description": "The order with its lines, add-ons, tickets (holder, who passed it on, show, seat), saved sessions, paid upgrades, ticket type moves, coupons, where it was bought, checkout answers, cash at the door, the staff it names, refund requests, payments and its money from the same computation as the Overview. An order of another organization answers the same 404 as an unknown one. Needs tenant_order.drill. A viewer gets no buyer or guest names, masked emails and no answers."
          }
        },
        {
          "name": "How buyers convert, for an event or a series (ENG-2313, ENG-2321)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tenants/:tenantId/dashboard/funnel-report?event_id={{event_id}}&series_id={{series_id}}&from={{from}}&to={{to}}&credit={{credit}}&show_id={{show_id}}&ticket_type_id={{ticket_type_id}}",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tenants",
                ":tenantId",
                "dashboard",
                "funnel-report"
              ],
              "query": [
                {
                  "key": "event_id",
                  "value": "{{event_id}}"
                },
                {
                  "key": "series_id",
                  "value": "{{series_id}}"
                },
                {
                  "key": "from",
                  "value": "{{from}}"
                },
                {
                  "key": "to",
                  "value": "{{to}}"
                },
                {
                  "key": "credit",
                  "value": "{{credit}}"
                },
                {
                  "key": "show_id",
                  "value": "{{show_id}}"
                },
                {
                  "key": "ticket_type_id",
                  "value": "{{ticket_type_id}}"
                }
              ],
              "variable": [
                {
                  "key": "tenantId",
                  "value": "{{tenantId}}"
                }
              ]
            },
            "description": "Every funnel step, why visitors stopped, value left behind, time to buy, each ticket and pass type, and performance by channel, place, device and where they bought. A visitor is one person as far as AXYN can tell: the 30-day visitor id when they allowed one, else the browser tab. Money is each paid order priced as on the Sales dashboard, so every table adds up to the Sales total; an order with no recorded journey has its own row. Give exactly one of `event_id` or `series_id`. A program inside a series has no report of its own (409 with its `series_id`). Needs sales_dashboard.read. A caller who also holds guest_list.read for the whole organization, other than a viewer (whose guest list is masked), gets `buyer_places` and every live place with no 5-visitor Other grouping; saved 13-month place totals keep their minimum (ENG-2769)."
          }
        },
        {
          "name": "Ways to sell more: the ideas an event or series qualifies for (ENG-2405)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tenants/:tenantId/overview-moves?event_id={{event_id}}&production_id={{production_id}}",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tenants",
                ":tenantId",
                "overview-moves"
              ],
              "query": [
                {
                  "key": "event_id",
                  "value": "{{event_id}}"
                },
                {
                  "key": "production_id",
                  "value": "{{production_id}}"
                }
              ],
              "variable": [
                {
                  "key": "tenantId",
                  "value": "{{tenantId}}"
                }
              ]
            },
            "description": "The Risk, Forecast and Geography ideas a standalone event or a series qualifies for on its Overview, as facts with every number they show: behind on-sale types and shared areas (largest money at risk first) with the non-discount idea first and a 10% code only in the final 14 days or with no visible cause; the type that sells out first with the comps it could release; a city whose share of visitors and buyers differ by 2x. Read only; nothing is created. A show inside a series has none (409). Needs sales_dashboard.read."
          }
        },
        {
          "name": "Open a Ways to sell more idea (ENG-2405)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tenants/:tenantId/overview-moves",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tenants",
                ":tenantId",
                "overview-moves"
              ],
              "variable": [
                {
                  "key": "tenantId",
                  "value": "{{tenantId}}"
                }
              ]
            },
            "description": "The idea's button was pressed. Returns the idea's move with the prefill its screen fills in: the one pending move is opened (again), its prefill refreshed from the idea as it stands and any Not now cleared; a move whose 7-day window is still running is returned as it is. Nothing else is created. Opening is a write, so it needs the permission its link will: comp_hold.manage for a comp release, event.write for every other idea (finance and viewers are refused).",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"kind\": \"risk\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Not now: hide a Ways to sell more idea for 7 days (ENG-2405)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tenants/:tenantId/overview-moves/snooze",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tenants",
                ":tenantId",
                "overview-moves",
                "snooze"
              ],
              "variable": [
                {
                  "key": "tenantId",
                  "value": "{{tenantId}}"
                }
              ]
            },
            "description": "Hides the idea for the whole team for 7 days, or until its gap moves more than 25% from now. Needs event.write.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"kind\": \"risk\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "A Ways to sell more move and its prefill (ENG-2405)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tenants/:tenantId/overview-moves/:moveId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tenants",
                ":tenantId",
                "overview-moves",
                ":moveId"
              ],
              "variable": [
                {
                  "key": "tenantId",
                  "value": "{{tenantId}}"
                },
                {
                  "key": "moveId",
                  "value": "{{moveId}}"
                }
              ]
            },
            "description": "The prefill a screen opened with ?move={id} reads; nothing in the link itself fills a field. Needs sales_dashboard.read."
          }
        },
        {
          "name": "Start a Ways to sell more move by linking what was saved (ENG-2405)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tenants/:tenantId/overview-moves/:moveId/link",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tenants",
                ":tenantId",
                "overview-moves",
                ":moveId",
                "link"
              ],
              "variable": [
                {
                  "key": "tenantId",
                  "value": "{{tenantId}}"
                },
                {
                  "key": "moveId",
                  "value": "{{moveId}}"
                }
              ]
            },
            "description": "Called right after the code, comp hold or tracking link the move opened was saved. Accepted only when it is in the move's organizer and event or series, fits the idea (a code covering the idea's types, a comp hold on its type now holding fewer, a tracking link) and was made or changed after the move opened. The move is then started and what it was expected to sell anyway over its window (7 days, or to the show start or sale end) is frozen from the forecast. A coupon or tracking link needs event.write; a comp hold needs comp_hold.manage.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"coupon_id\": \"00000000-0000-0000-0000-000000000000\",\n  \"hold_id\": \"00000000-0000-0000-0000-000000000000\",\n  \"tracking_link_id\": \"00000000-0000-0000-0000-000000000000\",\n  \"city_list\": true\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Whether this member hid the email nudge (ENG-2565)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tenants/:tenantId/email-nudge?event_id={{event_id}}&series_id={{series_id}}",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tenants",
                ":tenantId",
                "email-nudge"
              ],
              "query": [
                {
                  "key": "event_id",
                  "value": "{{event_id}}"
                },
                {
                  "key": "series_id",
                  "value": "{{series_id}}"
                }
              ],
              "variable": [
                {
                  "key": "tenantId",
                  "value": "{{tenantId}}"
                }
              ]
            },
            "description": "\"See what your emails sell\" on an event's or series' Conversion page. When it is due is the funnel report's `email_nudge`; this says whether the signed-in member hid it there. Needs sales_dashboard.read."
          }
        },
        {
          "name": "Hide or show the email nudge for this member (ENG-2565)",
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tenants/:tenantId/email-nudge",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tenants",
                ":tenantId",
                "email-nudge"
              ],
              "variable": [
                {
                  "key": "tenantId",
                  "value": "{{tenantId}}"
                }
              ]
            },
            "description": "Hides it (or shows it again) for the signed-in member on one event or series only; other members still see it. Needs sales_dashboard.read.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"hidden\": false\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Named tracking links of an event or series (ENG-2322)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tenants/:tenantId/tracking-links?event_id={{event_id}}&series_id={{series_id}}",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tenants",
                ":tenantId",
                "tracking-links"
              ],
              "query": [
                {
                  "key": "event_id",
                  "value": "{{event_id}}"
                },
                {
                  "key": "series_id",
                  "value": "{{series_id}}"
                }
              ],
              "variable": [
                {
                  "key": "tenantId",
                  "value": "{{tenantId}}"
                }
              ]
            },
            "description": "Active links first, then archived. A link is a label on a visit: it never unlocks a price, a hold or a discount. Needs sales_dashboard.read."
          }
        },
        {
          "name": "Name a tracking link (ENG-2322)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tenants/:tenantId/tracking-links",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tenants",
                ":tenantId",
                "tracking-links"
              ],
              "variable": [
                {
                  "key": "tenantId",
                  "value": "{{tenantId}}"
                }
              ]
            },
            "description": "Names are unique per event or series whatever their capitals and spacing; a duplicate answers 409 with the existing link. Up to 50 active links per event or series. Needs event.write.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"string\",\n  \"channel\": \"print\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Rename, move, archive or restore a tracking link (ENG-2322)",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tenants/:tenantId/tracking-links/:linkId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tenants",
                ":tenantId",
                "tracking-links",
                ":linkId"
              ],
              "variable": [
                {
                  "key": "tenantId",
                  "value": "{{tenantId}}"
                },
                {
                  "key": "linkId",
                  "value": "{{linkId}}"
                }
              ]
            },
            "description": "There is no delete. An archived link leaves the picker, keeps its history and still credits anyone who uses it. The code never changes. Needs event.write.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"string\",\n  \"channel\": \"print\",\n  \"archived\": false\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Checkout funnel of a series (ENG-2309)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tenants/:tenantId/dashboard/series/:productionId/checkout-funnel",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tenants",
                ":tenantId",
                "dashboard",
                "series",
                ":productionId",
                "checkout-funnel"
              ],
              "variable": [
                {
                  "key": "tenantId",
                  "value": "{{tenantId}}"
                },
                {
                  "key": "productionId",
                  "value": "{{productionId}}"
                }
              ]
            },
            "description": "One funnel for all the programs and passes of a series: journeys are the funnel facts recorded for the series, Paid is every paid order on any of its programs. Steps are null (shown as N/A) when nothing was recorded; a rate is never invented. A program inside a series has no funnel of its own. Needs sales_dashboard.read."
          }
        },
        {
          "name": "Read workspace defaults for checkout contact, tax, and partner insights",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tenants/:tenantId/workspace-defaults",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tenants",
                ":tenantId",
                "workspace-defaults"
              ],
              "variable": [
                {
                  "key": "tenantId",
                  "value": "{{tenantId}}"
                }
              ]
            },
            "description": "ENG-779: staff JWT with event.read. Returns typed workspace defaults; null means unset."
          }
        },
        {
          "name": "Update workspace defaults",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tenants/:tenantId/workspace-defaults",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tenants",
                ":tenantId",
                "workspace-defaults"
              ],
              "variable": [
                {
                  "key": "tenantId",
                  "value": "{{tenantId}}"
                }
              ]
            },
            "description": "ENG-779: staff JWT with tenant.workspace_defaults.manage (organizer_admin). Null clears a default. Does not rewrite overridden or published events.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"address_collection_mode\": \"postal_only\",\n  \"phone_collection_mode\": \"off\",\n  \"tax_rate_bps\": 0,\n  \"tax_not_applicable\": false,\n  \"partner_commerce_pixel_enabled\": false,\n  \"allow_upgrades\": false,\n  \"upgrade_cutoff_hours\": 0\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Read How buyers can pay (Apple Pay, Google Pay, Link) and where wallets work",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tenants/:tenantId/buyer-payment-methods",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tenants",
                ":tenantId",
                "buyer-payment-methods"
              ],
              "variable": [
                {
                  "key": "tenantId",
                  "value": "{{tenantId}}"
                }
              ]
            },
            "description": "ENG-2789: staff JWT with settlement.read. The organization-wide wallet switches (cards are always accepted) and, per site the organizer's own checkout ran on, whether Apple Pay and Google Pay work there (ENG-2663). A sandbox workspace reads its own switches."
          }
        },
        {
          "name": "Turn Apple Pay, Google Pay or Saved card (Link) on or off",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tenants/:tenantId/buyer-payment-methods",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tenants",
                ":tenantId",
                "buyer-payment-methods"
              ],
              "variable": [
                {
                  "key": "tenantId",
                  "value": "{{tenantId}}"
                }
              ]
            },
            "description": "ENG-2789: staff JWT with tenant.workspace_defaults.manage (organizer_admin). Send one or more of apple_pay, google_pay, link as booleans; unknown fields are refused. Applies to checkout loaded after the change; a payment form already open keeps its buttons.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"apple_pay\": false,\n  \"google_pay\": false,\n  \"link\": false\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Organizer sales dashboard",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tenants/:tenantId/dashboard?event_id={{event_id}}&production_id={{production_id}}",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tenants",
                ":tenantId",
                "dashboard"
              ],
              "query": [
                {
                  "key": "event_id",
                  "value": "{{event_id}}"
                },
                {
                  "key": "production_id",
                  "value": "{{production_id}}"
                }
              ],
              "variable": [
                {
                  "key": "tenantId",
                  "value": "{{tenantId}}"
                }
              ]
            },
            "description": "ENG-144 / ENG-2332. No filter: the portfolio (headline, events[], series[], event_counts). event_id: one event's Sales. production_id: a series' Sales in one request (series_sales, plus orders_summary, insights, channel_mix, promo_mix and velocity_series over the orders sold under the series; series_sales.door is check-ins over who was expected at the programs whose doors have opened, and attendance is null). event_id and production_id cannot be combined. An order sold under a series is reported on the series, never on a program: a program inside a series returns its own day tickets and door numbers, no money, no payout and no pass types, with production_id set. ENG-2399: `forecast` is the event's or series' sales forecast, whole run and per ticket/pass type, from the organizer's own past events blended with pooled similar events (medians and quartiles only, never another organizer's numbers); null with `forecast_reason` when there is nothing honest to show, null with no reason on the organization roll-up. `pace_status` and `expected_velocity` are read from the forecast. `latest_postponement` is the newest date move, if any. ENG-2402: `sales_series` (paid units, sales, orders and comps per day or week and per type; a series per pass plus Show tickets), `markers` and `facts` feed Sales over time; null / [] / null on the roll-up and for a program inside a series."
          }
        },
        {
          "name": "Accept a tenant staff invitation",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/staff/invitations/:token/accept",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "staff",
                "invitations",
                ":token",
                "accept"
              ],
              "variable": [
                {
                  "key": "token",
                  "value": "{{token}}"
                }
              ]
            },
            "description": "The signed-in user accepts the invitation named by its emailed token. The JWT email must match the invited email. Repeating an accept the caller already holds returns already_granted: true."
          }
        }
      ],
      "description": "Self-serve organizer tenant signup and membership discovery (Supabase JWT, non-anonymous)."
    },
    {
      "name": "catalog",
      "item": [
        {
          "name": "Read a native venue location (ENG-1617)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/venues/:venueId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "venues",
                ":venueId"
              ],
              "variable": [
                {
                  "key": "venueId",
                  "value": "{{venueId}}"
                }
              ]
            },
            "description": "Tenant-scoped read of an AXYN native venue's address and pin. GET never writes. Dual-auth: tenant API key with catalog:read, or staff JWT with event.read plus x-tenant-id. Tenant never from the body. A partner reads it over HTTP to compare linked venue pins."
          }
        },
        {
          "name": "List ticket tiers (API key: active buyer tiers; staff JWT: all admin tiers)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId/tiers",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId",
                "tiers"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                }
              ]
            }
          }
        },
        {
          "name": "Create a ticket tier (API key: eventId=venue_event_id + body.venue_id; staff: eventId=event.id)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId/tiers",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId",
                "tiers"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                }
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"string\",\n  \"venue_id\": \"00000000-0000-0000-0000-000000000000\",\n  \"price_cents\": 0,\n  \"inventory_total\": 0\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Quote Buyer pays / You keep for a ticket type (staff/API key)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId/tiers/fee-quote",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId",
                "tiers",
                "fee-quote"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                }
              ]
            },
            "description": "Same assemble path as checkout, qty=1, the published processing rate, tax excluded. Quotes both choices: who pays the AXYN fee (fee_payer) and who pays card processing (processing_fee_payer). Organizer calculator only. Never buyer-writable.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"price_cents\": 0\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Update a ticket tier",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/tiers/:tierId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                "tiers",
                ":tierId"
              ],
              "variable": [
                {
                  "key": "tierId",
                  "value": "{{tierId}}"
                }
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"pickup_follows_series\": false,\n  \"re_entry_follows_series\": false,\n  \"sales_follow_series\": false,\n  \"pass_coverage\": \"shows\",\n  \"pass_coverage_days\": [\n    \"string\"\n  ],\n  \"admit_times\": [\n    {\n      \"occurrence_event_id\": \"00000000-0000-0000-0000-000000000000\",\n      \"admit_opens_at\": \"2030-01-01T00:00:00.000Z\"\n    }\n  ],\n  \"name\": \"string\",\n  \"description\": \"string\",\n  \"currency\": \"string\",\n  \"price_cents\": 0,\n  \"min_per_order\": 0,\n  \"max_per_order\": 0,\n  \"inventory_total\": 0,\n  \"sort_order\": 0,\n  \"is_active\": false,\n  \"is_hidden\": false,\n  \"allow_multiple_coupons\": false,\n  \"fee_payer\": \"producer\",\n  \"processing_fee_payer\": \"producer\",\n  \"addon_fee_payer\": \"producer\",\n  \"sales_start_at\": \"2030-01-01T00:00:00.000Z\",\n  \"sales_end_at\": \"2030-01-01T00:00:00.000Z\",\n  \"admits\": [\n    {\n      \"occurrence_event_id\": \"00000000-0000-0000-0000-000000000000\"\n    }\n  ],\n  \"fulfillment_policy\": \"digital\",\n  \"pickup_requires_scan\": false,\n  \"pickup_required_before_admit\": false,\n  \"pickup_id_check_required\": false,\n  \"pickup_location_label\": \"string\",\n  \"pickup_address\": \"string\",\n  \"pickup_instructions\": \"string\",\n  \"pickup_opens_at\": \"2030-01-01T00:00:00.000Z\",\n  \"pickup_closes_at\": \"2030-01-01T00:00:00.000Z\",\n  \"pickup_reminder_enabled\": false,\n  \"re_entry_policy\": \"no_reentry\",\n  \"pickup_follows_event\": false,\n  \"re_entry_follows_event\": false,\n  \"re_entry_limit\": 0\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Delete a ticket tier (refused when inventory_sold > 0)",
          "request": {
            "method": "DELETE",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/tiers/:tierId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                "tiers",
                ":tierId"
              ],
              "variable": [
                {
                  "key": "tierId",
                  "value": "{{tierId}}"
                }
              ]
            }
          }
        },
        {
          "name": "Archive a ticket tier nobody holds a ticket on (ENG-2294)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/tiers/:tierId/archive",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                "tiers",
                ":tierId",
                "archive"
              ],
              "variable": [
                {
                  "key": "tierId",
                  "value": "{{tierId}}"
                }
              ]
            },
            "description": "Takes a ticket type or series pass out of Setup and off every buyer surface for good, keeping its orders and refunds. Allowed when nothing is held on it (inventory_reserved is 0) and every ticket issued on it is refunded, cancelled or voided. The tier is kept with is_active false and is_hidden true; it cannot be bought or restored. Archiving an already archived tier succeeds."
          }
        },
        {
          "name": "Preview the badge pickup change notice (ENG-1563)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/tiers/:tierId/pickup-notice",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                "tiers",
                ":tierId",
                "pickup-notice"
              ],
              "variable": [
                {
                  "key": "tierId",
                  "value": "{{tierId}}"
                }
              ]
            },
            "description": "After editing a badge pickup ticket type that has sold, shows who would be emailed (live tickets not yet picked up, one email per holder) and the exact email rendered from the current desk details. Sends nothing."
          }
        },
        {
          "name": "Send the badge pickup change notice (ENG-1563)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/tiers/:tierId/pickup-notice",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                "tiers",
                ":tierId",
                "pickup-notice"
              ],
              "variable": [
                {
                  "key": "tierId",
                  "value": "{{tierId}}"
                }
              ]
            },
            "description": "Organizer-confirmed. Queues one transactional email per holder with the current desk details and Live Pass links. Idempotent per details version: repeating it for unchanged details returns duplicates and sends nothing new."
          }
        },
        {
          "name": "Add a perk to a ticket tier",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/tiers/:tierId/perks",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                "tiers",
                ":tierId",
                "perks"
              ],
              "variable": [
                {
                  "key": "tierId",
                  "value": "{{tierId}}"
                }
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"label\": \"string\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Update a tier perk",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/tiers/:tierId/perks/:perkId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                "tiers",
                ":tierId",
                "perks",
                ":perkId"
              ],
              "variable": [
                {
                  "key": "tierId",
                  "value": "{{tierId}}"
                },
                {
                  "key": "perkId",
                  "value": "{{perkId}}"
                }
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"label\": \"string\",\n  \"display_order\": 0\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Delete a tier perk",
          "request": {
            "method": "DELETE",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/tiers/:tierId/perks/:perkId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                "tiers",
                ":tierId",
                "perks",
                ":perkId"
              ],
              "variable": [
                {
                  "key": "tierId",
                  "value": "{{tierId}}"
                },
                {
                  "key": "perkId",
                  "value": "{{perkId}}"
                }
              ]
            }
          }
        },
        {
          "name": "List coupons for an event (organizer-only; requires catalog:write scope or event.write staff permission)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId/coupons",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId",
                "coupons"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                }
              ]
            }
          }
        },
        {
          "name": "Create a show discount: a code or an automatic quantity discount (API key: eventId=venue_event_id; staff: eventId=event.id).",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId/coupons",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId",
                "coupons"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                }
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"code\": \"string\",\n  \"percent_bps\": 0,\n  \"amount_cents\": 0,\n  \"apply_mode\": \"cart_ticket_subtotal\",\n  \"max_redemptions\": 0,\n  \"max_discounted_tickets\": 0,\n  \"starts_at\": \"2030-01-01T00:00:00.000Z\",\n  \"ends_at\": \"2030-01-01T00:00:00.000Z\",\n  \"redemption_mode\": \"code\",\n  \"display_name\": \"string\",\n  \"quantity_mode\": \"per_group\",\n  \"min_quantity\": 0,\n  \"group_price_cents\": 0,\n  \"tier_ids\": [\n    \"00000000-0000-0000-0000-000000000000\"\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Switch a discount off (codes: permanent) or, for an automatic discount, back on. Values are immutable.",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/coupons/:couponId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                "coupons",
                ":couponId"
              ],
              "variable": [
                {
                  "key": "couponId",
                  "value": "{{couponId}}"
                }
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"is_active\": false\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Delete a coupon (only while redeemed_count = 0)",
          "request": {
            "method": "DELETE",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/coupons/:couponId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                "coupons",
                ":couponId"
              ],
              "variable": [
                {
                  "key": "couponId",
                  "value": "{{couponId}}"
                }
              ]
            }
          }
        },
        {
          "name": "List add-ons (API key: active for venue_event_id; staff JWT: all for event.id)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId/add-ons",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId",
                "add-ons"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                }
              ]
            }
          }
        },
        {
          "name": "Create an add-on (eventId = event.id)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId/add-ons",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId",
                "add-ons"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                }
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"string\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Update an add-on",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/add-ons/:addOnId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                "add-ons",
                ":addOnId"
              ],
              "variable": [
                {
                  "key": "addOnId",
                  "value": "{{addOnId}}"
                }
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"string\",\n  \"description\": \"string\",\n  \"price_cents\": 0,\n  \"inventory_total\": 0,\n  \"max_per_order\": 0,\n  \"applies_to\": \"order\",\n  \"default_state\": \"opt_out\",\n  \"is_skippable\": false,\n  \"is_active\": false\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Delete an add-on (refused when inventory_sold > 0)",
          "request": {
            "method": "DELETE",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/add-ons/:addOnId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                "add-ons",
                ":addOnId"
              ],
              "variable": [
                {
                  "key": "addOnId",
                  "value": "{{addOnId}}"
                }
              ]
            }
          }
        },
        {
          "name": "List add-on bundles for an event (with items)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId/bundles",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId",
                "bundles"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                }
              ]
            }
          }
        },
        {
          "name": "Create an add-on bundle (exactly one discount field)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId/bundles",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId",
                "bundles"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                }
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"string\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Update an add-on bundle",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/bundles/:bundleId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                "bundles",
                ":bundleId"
              ],
              "variable": [
                {
                  "key": "bundleId",
                  "value": "{{bundleId}}"
                }
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"string\",\n  \"discount_cents\": 0,\n  \"discount_percent_bps\": 0,\n  \"is_active\": false\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Delete an add-on bundle (cascades to its items)",
          "request": {
            "method": "DELETE",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/bundles/:bundleId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                "bundles",
                ":bundleId"
              ],
              "variable": [
                {
                  "key": "bundleId",
                  "value": "{{bundleId}}"
                }
              ]
            }
          }
        },
        {
          "name": "Add an add-on to a bundle",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/bundles/:bundleId/items",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                "bundles",
                ":bundleId",
                "items"
              ],
              "variable": [
                {
                  "key": "bundleId",
                  "value": "{{bundleId}}"
                }
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"add_on_id\": \"00000000-0000-0000-0000-000000000000\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Remove an item from a bundle",
          "request": {
            "method": "DELETE",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/bundles/:bundleId/items/:itemId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                "bundles",
                ":bundleId",
                "items",
                ":itemId"
              ],
              "variable": [
                {
                  "key": "bundleId",
                  "value": "{{bundleId}}"
                },
                {
                  "key": "itemId",
                  "value": "{{itemId}}"
                }
              ]
            }
          }
        },
        {
          "name": "Get the full seat map for a reserved-seat event",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId/seat-map",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId",
                "seat-map"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                }
              ]
            },
            "description": "A buyer API key (catalog:read) reads its own tenant's events in any status, and another organizer's event only while it is public (on_sale or sold_out), the same organizer resolution as GET /v1/events/{eventId}. Draft, cancelled or unknown events of another organizer, and sandbox organizers on the hosted buyer surface, return 404 event_not_found. Hold ownership and expiry are never exposed."
          }
        },
        {
          "name": "Find N adjacent seats (HF-012 group-adjacency guarantee)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId/best-available-group",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId",
                "best-available-group"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                }
              ]
            },
            "description": "Same organizer resolution as GET /v1/events/{eventId}/seat-map: the key tenant's own events, or another organizer's public (on_sale or sold_out) event; anything else is 404 event_not_found.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"n\": 0\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Bulk update reserved seats (tier / block / hold / honesty)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId/seats:update",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId",
                "seats:update"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                }
              ]
            },
            "description": "ENG-649 / ENG-736 / ENG-1131. Assign or clear ticket_tier_id, set status to available|blocked|held (staff_comp or house_hold), toggle accessible/restricted, pair companions, or park onto a named house hold. Refuses sold and checkout-held seats. Companion must be the same event. Cross-tenant ids return 404 with no extra hint. Clears seating_ready on success.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"seat_ids\": [\n    \"00000000-0000-0000-0000-000000000000\"\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "List named house holds for an event",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId/house-holds",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId",
                "house-holds"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                }
              ]
            },
            "description": "ENG-1133. Returns House / Artist / Press / Production / Access holds. Never includes the raw access code. Tenant from the API key or staff JWT. Cross-tenant event id → 404 with no extra hint."
          }
        },
        {
          "name": "Create a named house hold",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId/house-holds",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId",
                "house-holds"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                }
              ]
            },
            "description": "ENG-1133. Parks a named hold. with_access_code mints a one-time code that unlocks those chairs at the listed price — not a coupon. Tenant from the API key or staff JWT.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"string\",\n  \"hold_type\": \"house\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Rotate a house-hold access code",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId/house-holds/:holdId/rotate-code",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId",
                "house-holds",
                ":holdId",
                "rotate-code"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                },
                {
                  "key": "holdId",
                  "value": "{{holdId}}"
                }
              ]
            },
            "description": "ENG-1133. Replaces the code. The previous code stops working. Returns the new plain code once. Cross-tenant hold id → 404 with no extra hint."
          }
        },
        {
          "name": "Release seats on a named house hold",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId/house-holds/:holdId/release",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId",
                "house-holds",
                ":holdId",
                "release"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                },
                {
                  "key": "holdId",
                  "value": "{{holdId}}"
                }
              ]
            },
            "description": "ENG-1133 / ENG-1723. Returns held house_hold seats to open sale in one transaction and records each move in seat history. Sold seats forget the hold as their origin, so a later refund sends them to open sale. The hold row stays. Ticket-type counts resync. Cross-tenant hold id → 404 with no extra hint."
          }
        },
        {
          "name": "Delete a named house hold",
          "request": {
            "method": "DELETE",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId/house-holds/:holdId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId",
                "house-holds",
                ":holdId"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                },
                {
                  "key": "holdId",
                  "value": "{{holdId}}"
                }
              ]
            },
            "description": "ENG-1133 / ENG-1723. Releases the hold's seats like release, then removes the hold. Cross-tenant hold id → 404 with no extra hint."
          }
        },
        {
          "name": "Seat history",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId/seats/:seatId/history",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId",
                "seats",
                ":seatId",
                "history"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                },
                {
                  "key": "seatId",
                  "value": "{{seatId}}"
                }
              ]
            },
            "description": "ENG-1723. Every release of one reserved seat, newest first (max 200): when, why, from and to state, the house hold it went to, the off-sale reason and note, and who did it (null for automatic releases)."
          }
        },
        {
          "name": "Replace reserved-seat grid (upsert + delete available orphans)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId/seats:replace-grid",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId",
                "seats:replace-grid"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                }
              ]
            },
            "description": "ENG-730. Upserts the desired seat rows (same geometry rules as seats:import), then deletes available seats not in the new set. Held/sold/blocked seats outside the set reject the whole operation. Requires confirm_remove_available=true when any available seats would be removed.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"rows\": [\n    {\n      \"section_name\": \"string\",\n      \"row_label\": \"string\",\n      \"seat_number\": \"string\"\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Bulk-import seats for a reserved-seat event (idempotent)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId/seats:import",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId",
                "seats:import"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                }
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"rows\": [\n    {\n      \"section_name\": \"string\",\n      \"row_label\": \"string\",\n      \"seat_number\": \"string\"\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Apply the linked venue house to this event (ENG-720)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId/venue-house:apply",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId",
                "venue-house:apply"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                }
              ]
            },
            "description": "Copies tenant venue house geometry into this event (copy, not a live link). reserved_seat uses seat import (never downgrades sold/held). section_and_type upserts sections only. Clears seating_ready. General admission events are rejected. Tenant is resolved from the API key or staff JWT, never from the body."
          }
        },
        {
          "name": "Save event house geometry to the linked venue (ENG-720)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId/venue-house:save",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId",
                "venue-house:save"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                }
              ]
            },
            "description": "Writes this event's sections/seats into the linked venue house store (copy, not a live link). When venue.has_seating is already true, confirm_overwrite must be true. Tenant is resolved from the API key or staff JWT, never from the body.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"confirm_overwrite\": false\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Mark or clear event seating_ready (ENG-720 / ENG-649)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId/seating:ready",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId",
                "seating:ready"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                }
              ]
            },
            "description": "Seated layouts only. Marking ready requires inventory (reserved_seat: seats; section_and_type: sections). For reserved_seat, marking ready also syncs each ticket type inventory_total to the count of sellable seats on that type (blocked seats excluded). Clearing ready does not rewrite quantities. Publish/on_sale gates on seating_ready for those modes. General admission is rejected with layout_not_seated (hard floor). Tenant is resolved from the API key or staff JWT, never from the body.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"ready\": false\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Create a section for an event",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId/sections",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId",
                "sections"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                }
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"string\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Update a section",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId/sections/:sectionId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId",
                "sections",
                ":sectionId"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                },
                {
                  "key": "sectionId",
                  "value": "{{sectionId}}"
                }
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"string\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Delete a section (cascades to its seats)",
          "request": {
            "method": "DELETE",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId/sections/:sectionId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId",
                "sections",
                ":sectionId"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                },
                {
                  "key": "sectionId",
                  "value": "{{sectionId}}"
                }
              ]
            }
          }
        },
        {
          "name": "Create a draft event",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events"
              ]
            },
            "description": "M46c dual-auth: API key `catalog:write` or staff JWT `event.write` + x-tenant-id.",
            "body": {
              "mode": "raw",
              "raw": "null",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Event detail (API key: buyer EventDetail; staff JWT: admin Event row)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                }
              ]
            }
          }
        },
        {
          "name": "Update an event (records material changes once published)",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                }
              ]
            },
            "description": "ENG-1662: a date inside a series does not set its own buyer refund policy. refunds_enabled / refund_policy / refund_window_hours are rejected with 400 while the event has a production_id; the series value is written through onto every date instead. ENG-2408: `budget` sets a standalone event's costs (EventBudgetInput); a body with only `budget` needs `event_budget.manage` instead of event write, so finance may send it. When sent, the response carries `data.budget` (EventBudgetRead). The staff read (GET) carries `budget` too, masked per C2; an API key read never does.",
            "body": {
              "mode": "raw",
              "raw": "null",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Delete a draft event",
          "request": {
            "method": "DELETE",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                }
              ]
            }
          }
        },
        {
          "name": "Publish a draft event (draft → on_sale; idempotent)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId/publish",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId",
                "publish"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                }
              ]
            }
          }
        },
        {
          "name": "Pause ticket sales for an on-sale event (idempotent when already paused)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId/pause",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId",
                "pause"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                }
              ]
            }
          }
        },
        {
          "name": "Resume ticket sales for a paused event (paused → on_sale)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId/resume",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId",
                "resume"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                }
              ]
            }
          }
        },
        {
          "name": "List custom checkout questions for an event",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "x-api-key",
                "value": "{{tenantApiKey}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId/custom-questions",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId",
                "custom-questions"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                }
              ]
            }
          }
        },
        {
          "name": "Replace custom checkout questions for an event",
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "x-api-key",
                "value": "{{tenantApiKey}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId/custom-questions",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId",
                "custom-questions"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                }
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"questions\": [\n    {\n      \"prompt\": \"string\",\n      \"answer_kind\": \"short_text\",\n      \"is_required\": false,\n      \"grain\": \"per_order\",\n      \"options\": [\n        {\n          \"label\": null,\n          \"value\": null\n        }\n      ]\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Suggest venue addresses while typing",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tenants/:tenantId/venues/address-suggestions?q={{q}}&country={{country}}",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tenants",
                ":tenantId",
                "venues",
                "address-suggestions"
              ],
              "query": [
                {
                  "key": "q",
                  "value": "{{q}}"
                },
                {
                  "key": "country",
                  "value": "{{country}}"
                }
              ],
              "variable": [
                {
                  "key": "tenantId",
                  "value": "{{tenantId}}"
                }
              ]
            },
            "description": "Up to five street addresses matching what the organizer has typed, already split into the venue address columns. For display only: results come from Mapbox temporary geocoding and must not be stored; send the picked label to address-lookup before saving a venue. Queries under 3 characters return no suggestions. When address lookup is not configured or the provider fails, returns 200 with available: false so the caller can fall back to typing the parts. Needs event.write. Path tenantId must match the API key tenant. Rate limited per caller."
          }
        },
        {
          "name": "Look up the address picked for a venue",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tenants/:tenantId/venues/address-lookup",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tenants",
                ":tenantId",
                "venues",
                "address-lookup"
              ],
              "variable": [
                {
                  "key": "tenantId",
                  "value": "{{tenantId}}"
                }
              ]
            },
            "description": "Looks up one address (usually a label from address-suggestions) in Mapbox permanent mode and returns its parts and map coordinates, which may be stored. Pass them to POST /v1/tenants/{tenantId}/venues (latitude and longitude included) so the venue is not geocoded twice. Needs event.write. Path tenantId must match the API key tenant. Rate limited per caller.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"query\": \"string\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Finish a venue's missing address (ENG-1772)",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tenants/:tenantId/venues/:venueId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tenants",
                ":tenantId",
                "venues",
                ":venueId"
              ],
              "variable": [
                {
                  "key": "tenantId",
                  "value": "{{tenantId}}"
                },
                {
                  "key": "venueId",
                  "value": "{{venueId}}"
                }
              ]
            },
            "description": "Adds the street, city and other address parts to a venue that was created without them, so its events can publish (publish needs address_line1 and city). Fill-only: it sets parts that are empty and never changes or clears a part that is already set (409 venue_address_locked). Sending a part with the value it already has is fine. Only works while address_line1, city or timezone is still empty; the save must leave all three set, and once they are the address is locked. A venue with a street and city but no timezone can still add one. Blank strings are treated as null. When the venue has no map location yet, one is looked up from the address. Path tenantId must match the API key tenant.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"address_line1\": \"string\",\n  \"city\": \"string\",\n  \"region\": \"string\",\n  \"postal_code\": \"string\",\n  \"country\": \"string\",\n  \"timezone\": \"string\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Get venue house geometry (ENG-720)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tenants/:tenantId/venues/:venueId/house",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tenants",
                ":tenantId",
                "venues",
                ":venueId",
                "house"
              ],
              "variable": [
                {
                  "key": "tenantId",
                  "value": "{{tenantId}}"
                },
                {
                  "key": "venueId",
                  "value": "{{venueId}}"
                }
              ]
            },
            "description": "Tenant-scoped house copy (geometry only, not live event inventory). Path tenantId must match the API key tenant. Requires event.read. Sandbox: use your test tenant UUID, never a production tenant id."
          }
        },
        {
          "name": "Replace venue house geometry (ENG-720)",
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tenants/:tenantId/venues/:venueId/house",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tenants",
                ":tenantId",
                "venues",
                ":venueId",
                "house"
              ],
              "variable": [
                {
                  "key": "tenantId",
                  "value": "{{tenantId}}"
                },
                {
                  "key": "venueId",
                  "value": "{{venueId}}"
                }
              ]
            },
            "description": "Full replace of venue house sections/seats (copy store, not live event inventory). When has_seating is already true, confirm_overwrite must be true. Path tenantId must match the API key tenant.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"sections\": [\n    {\n      \"name\": \"string\"\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "List view stills for a reserved-seat event",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId/view-stills",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId",
                "view-stills"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                }
              ]
            },
            "description": "ENG-1153 — organizer list. Tenant from the API key. GA returns 422 layout_not_reserved_seat."
          }
        },
        {
          "name": "Host or link a view still",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId/view-stills",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId",
                "view-stills"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                }
              ]
            },
            "description": "ENG-1153 — multipart JPEG/PNG/WebP (≤5 MiB) stores a hosted still under event-covers/view-stills/. JSON { url, coverage_label? } links an https URL. Default coverage: Shared view for this section, not your exact chair. Missing stills never block pay.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"url\": \"https://example.com\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Update a view still coverage line",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId/view-stills/:stillId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId",
                "view-stills",
                ":stillId"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                },
                {
                  "key": "stillId",
                  "value": "{{stillId}}"
                }
              ]
            },
            "description": "ENG-1153 — coverage_label only, max 120. Other tenant or missing still is 404 with no extra hint.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"coverage_label\": \"string\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Delete a view still and clear assignments",
          "request": {
            "method": "DELETE",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId/view-stills/:stillId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId",
                "view-stills",
                ":stillId"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                },
                {
                  "key": "stillId",
                  "value": "{{stillId}}"
                }
              ]
            },
            "description": "ENG-1153 — clears seat and section FKs, then deletes the row. Other tenant 404 with no extra hint."
          }
        },
        {
          "name": "List productions for the tenant (ENG-1634)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/productions",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "productions"
              ]
            },
            "description": "Returns tenant productions for portfolio nesting (including empty series). ENG-1647 adds day_ticket_type_count and pass_count per production via two tenant-scoped batch queries (no N+1). M46c dual-auth: API key catalog:read or staff JWT event.read + x-tenant-id. Tenant never from body."
          }
        },
        {
          "name": "Create a production (ENG-138 minimal)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/productions",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "productions"
              ]
            },
            "description": "Creates a production parent so occurrences can be linked for pass tiers. M46c dual-auth: API key catalog:write or staff JWT event.write + x-tenant-id. Tenant never from body.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"title\": \"string\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Get a production by id (ENG-1615 / ENG-1660)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/productions/:productionId?include_drafts={{include_drafts}}",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "productions",
                ":productionId"
              ],
              "query": [
                {
                  "key": "include_drafts",
                  "value": "{{include_drafts}}"
                }
              ],
              "variable": [
                {
                  "key": "productionId",
                  "value": "{{productionId}}"
                }
              ]
            },
            "description": "Public series catalog for Partner/SDK and hosted shop: title, story, cover, included shows, and buyable day-ticket + pass types. Staff JWT still returns the production parent for series home wayfinding. M46c dual-auth: API key catalog:read or staff JWT event.read + x-tenant-id. Tenant never from body. Draft integration (opt-in): with include_drafts=true, the owning organizer's own API key also gets its draft shows and their types, so it can build and test before publishing; each type keeps its own sale window and reports on_sale false until its show is published. Without the parameter the read is unchanged. Another organizer's key and the hosted shop never see a draft; for them the parameter is ignored. ENG-3017: each show's day-ticket types report seats left exactly as that show's own GET /v1/events/{eventId}/tiers does: a type linked to a shared area carries `area_remaining` (the area's seats left, counted once across the types sharing it) and its `inventory_total` / `inventory_available` report that area; `section_name` and `location_note` are stamped. ENG-3303: on a show with a capacity, every day-ticket type also carries `show_remaining` and `show_capacity`, the one limit those types share; count it once when adding seats left. Pass types are unchanged. If the seats left cannot be read the request fails (500) rather than send a type unprojected."
          }
        },
        {
          "name": "Update production title/description/cover URL/discovery/house rules/who it is for/refund policy (ENG-1648, ENG-1660, ENG-1662, ENG-1663, ENG-1664)",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/productions/:productionId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "productions",
                ":productionId"
              ],
              "variable": [
                {
                  "key": "productionId",
                  "value": "{{productionId}}"
                }
              ]
            },
            "description": "Patches series parent presentation, marketplace visibility, optional House rules, and the Who it is for line. Tenant from API key / staff context. Never from body. Child shows cannot list on Discover. Saving a refund policy writes it through onto every date in the series; the per-date refund editor is refused while an event has a parent series (ENG-1662).",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"budget\": {\n    \"lines\": [\n      {\n        \"category\": \"artists_and_talent\",\n        \"amount_cents\": 0\n      }\n    ]\n  },\n  \"previous_production_id\": \"00000000-0000-0000-0000-000000000000\",\n  \"sales_goal_tickets\": 0,\n  \"sales_goal_cents\": 0,\n  \"sales_goal_currency\": \"string\",\n  \"tax_rate_bps\": 0,\n  \"tax_not_applicable\": false,\n  \"tax_apply_to_shows\": false,\n  \"organizer_message\": \"string\",\n  \"waitlist_join_mode\": \"off\",\n  \"walk_up_sales_enabled\": false,\n  \"cash_at_entry_enabled\": false,\n  \"cash_at_entry_grace_minutes\": 0,\n  \"cash_at_entry_max_inventory_pct\": 0,\n  \"entry_fulfillment_policy\": \"digital\",\n  \"entry_pickup_requires_scan\": false,\n  \"entry_pickup_required_before_admit\": false,\n  \"entry_pickup_id_check_required\": false,\n  \"entry_pickup_location_label\": \"string\",\n  \"entry_pickup_address\": \"string\",\n  \"entry_pickup_instructions\": \"string\",\n  \"entry_pickup_opens_at\": \"2030-01-01T00:00:00.000Z\",\n  \"entry_pickup_closes_at\": \"2030-01-01T00:00:00.000Z\",\n  \"entry_pickup_reminder_enabled\": false,\n  \"entry_re_entry_policy\": \"no_reentry\",\n  \"entry_re_entry_limit\": 0,\n  \"sales_start_at\": \"2030-01-01T00:00:00.000Z\",\n  \"sales_end_at\": \"2030-01-01T00:00:00.000Z\",\n  \"title\": \"string\",\n  \"description\": \"string\",\n  \"hero_image_url\": \"string\",\n  \"cover_crops\": {\n    \"listing\": {\n      \"focus_x\": 0,\n      \"focus_y\": 0,\n      \"zoom\": 0\n    },\n    \"page\": {\n      \"focus_x\": 0,\n      \"focus_y\": 0,\n      \"zoom\": 0\n    },\n    \"discover\": {\n      \"focus_x\": 0,\n      \"focus_y\": 0,\n      \"zoom\": 0\n    }\n  },\n  \"list_on_axyn_discovery\": false,\n  \"partner_embed_analytics_enabled\": false,\n  \"partner_commerce_pixel_enabled\": false,\n  \"house_rules\": \"string\",\n  \"getting_in_parking\": \"string\",\n  \"getting_in_access\": \"string\",\n  \"getting_in_arrival\": \"string\",\n  \"who_it_is_for\": \"string\",\n  \"attendee_details_mode\": \"off\",\n  \"minimum_age\": 0,\n  \"lineup_on_series_page\": false,\n  \"lineup_on_live_pass\": false,\n  \"lineup_series_page_reveal_at\": \"2030-01-01T00:00:00.000Z\",\n  \"lineup_live_pass_reveal_at\": \"2030-01-01T00:00:00.000Z\",\n  \"refunds_enabled\": false,\n  \"refund_policy\": \"none\",\n  \"refund_window_hours\": 0\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Preview what guests see of the series lineup",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "x-api-key",
                "value": "{{tenantApiKey}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/productions/:productionId/lineup-preview?surface={{surface}}&when={{when}}&pass_tier_id={{pass_tier_id}}",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "productions",
                ":productionId",
                "lineup-preview"
              ],
              "query": [
                {
                  "key": "surface",
                  "value": "{{surface}}"
                },
                {
                  "key": "when",
                  "value": "{{when}}"
                },
                {
                  "key": "pass_tier_id",
                  "value": "{{pass_tier_id}}"
                }
              ],
              "variable": [
                {
                  "key": "productionId",
                  "value": "{{productionId}}"
                }
              ]
            },
            "description": "Organizer only (catalog write scope). Reads only: nothing is saved, sent or issued. `series_page` returns the guest read of the series, exactly as `GET /v1/productions/{productionId}` sends it to a guest. `live_pass` returns a sample live pass for one pass type, built for no ticket: it carries no ticket, order, guest name, email or entry code. `when=after_reveal` reads the same surface at its scheduled reveal time, so the organizer sees the announced page before guests do; when the lineup already shows it is the same as `now`."
          }
        },
        {
          "name": "List the series checkout questions",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "x-api-key",
                "value": "{{tenantApiKey}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/productions/:productionId/custom-questions",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "productions",
                ":productionId",
                "custom-questions"
              ],
              "variable": [
                {
                  "key": "productionId",
                  "value": "{{productionId}}"
                }
              ]
            }
          }
        },
        {
          "name": "Replace the series checkout questions and copy them onto its programs",
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "x-api-key",
                "value": "{{tenantApiKey}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/productions/:productionId/custom-questions",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "productions",
                ":productionId",
                "custom-questions"
              ],
              "variable": [
                {
                  "key": "productionId",
                  "value": "{{productionId}}"
                }
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"questions\": [\n    {\n      \"prompt\": \"string\",\n      \"answer_kind\": \"short_text\",\n      \"is_required\": false,\n      \"grain\": \"per_order\",\n      \"options\": [\n        {\n          \"label\": null,\n          \"value\": null\n        }\n      ]\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "List sibling occurrences for a production (ENG-1558)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/productions/:productionId/events?include_drafts={{include_drafts}}",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "productions",
                ":productionId",
                "events"
              ],
              "query": [
                {
                  "key": "include_drafts",
                  "value": "{{include_drafts}}"
                }
              ],
              "variable": [
                {
                  "key": "productionId",
                  "value": "{{productionId}}"
                }
              ]
            },
            "description": "Returns tenant events linked to the production, ordered by starts_at. M46c dual-auth: API key catalog:read or staff JWT event.read + x-tenant-id. API key reads list on_sale and sold_out shows. With include_drafts=true they also list draft shows when the key belongs to the organizer that owns the series (draft integration, opt-in). Another organizer's key and the hosted shop never see a draft; for them the parameter is ignored."
          }
        },
        {
          "name": "Link an occurrence event to a production (ENG-138 minimal)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/productions/:productionId/events",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "productions",
                ":productionId",
                "events"
              ],
              "variable": [
                {
                  "key": "productionId",
                  "value": "{{productionId}}"
                }
              ]
            },
            "description": "Sets event.production_id for a tenant-owned event. Missing production or event collapses to opaque 404. The show loses its previous edition (`previous_event_id`) and every other event's link to it (ENG-2417 Q-A8). If removing the links to it fails, the show is still linked to the series, on its passes, and the answer is 500 `previous_edition_clear_failed`: send the same call again, or save the show, to finish.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"event_id\": \"00000000-0000-0000-0000-000000000000\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Upload production cover art (ENG-1648)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/productions/:productionId/cover",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "productions",
                ":productionId",
                "cover"
              ],
              "variable": [
                {
                  "key": "productionId",
                  "value": "{{productionId}}"
                }
              ]
            },
            "description": "Multipart JPEG/PNG/WebP (<=5 MiB) stores under event-covers using production id as the object path entity and writes production.hero_image_url. Same pipeline as event covers."
          }
        },
        {
          "name": "Read the claim-from-pass panel for one session",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId/claimable-session",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId",
                "claimable-session"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                }
              ]
            },
            "description": "Claim mode, capacity, window, price and the pass types that unlock this session."
          }
        },
        {
          "name": "Create or edit the claim-from-pass panel for one session",
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId/claimable-session",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId",
                "claimable-session"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                }
              ]
            },
            "description": "Safe while selling. The claim block is checked against the occurrence capacity ceiling, capacity may only shrink to claims already held, and dropping a pass type closes future claims without stripping claims already made.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"claim_mode\": \"must_claim\",\n  \"claim_capacity\": 0,\n  \"eligible_pass_tier_ids\": [\n    \"00000000-0000-0000-0000-000000000000\"\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Stop taking new claims on this session",
          "request": {
            "method": "DELETE",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId/claimable-session",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId",
                "claimable-session"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                }
              ]
            },
            "description": "Claims already held keep their place and keep admitting at the door."
          }
        },
        {
          "name": "List the sessions one pass type unlocks",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/tiers/:tierId/claimable-sessions",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                "tiers",
                ":tierId",
                "claimable-sessions"
              ],
              "variable": [
                {
                  "key": "tierId",
                  "value": "{{tierId}}"
                }
              ]
            },
            "description": "Read-only. Capacity and mode are edited on the session itself."
          }
        },
        {
          "name": "Set what one pass pays to claim a session",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/tiers/:tierId/claimable-sessions/:sessionId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                "tiers",
                ":tierId",
                "claimable-sessions",
                ":sessionId"
              ],
              "variable": [
                {
                  "key": "tierId",
                  "value": "{{tierId}}"
                },
                {
                  "key": "sessionId",
                  "value": "{{sessionId}}"
                }
              ]
            },
            "description": "price_cents null follows the session's own price; 0 is included with this pass. Claims already held keep the price they paid. Returns the pass's sessions.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"price_cents\": 0\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "List series discounts (codes and automatic) and the series' ticket types (ENG-1888; catalog:write or event.write).",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/productions/:productionId/coupons",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "productions",
                ":productionId",
                "coupons"
              ],
              "variable": [
                {
                  "key": "productionId",
                  "value": "{{productionId}}"
                }
              ]
            }
          }
        },
        {
          "name": "Create a series discount: a code unique across the series and its shows, or an automatic quantity discount that may cover passes (ENG-1888).",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/productions/:productionId/coupons",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "productions",
                ":productionId",
                "coupons"
              ],
              "variable": [
                {
                  "key": "productionId",
                  "value": "{{productionId}}"
                }
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"code\": \"string\",\n  \"percent_bps\": 0,\n  \"amount_cents\": 0,\n  \"apply_mode\": \"cart_ticket_subtotal\",\n  \"max_redemptions\": 0,\n  \"max_discounted_tickets\": 0,\n  \"starts_at\": \"2030-01-01T00:00:00.000Z\",\n  \"ends_at\": \"2030-01-01T00:00:00.000Z\",\n  \"redemption_mode\": \"code\",\n  \"display_name\": \"string\",\n  \"quantity_mode\": \"per_group\",\n  \"min_quantity\": 0,\n  \"group_price_cents\": 0,\n  \"tier_ids\": [\n    \"00000000-0000-0000-0000-000000000000\"\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        }
      ],
      "description": "Public catalog reads (tenant API key + catalog:read)."
    },
    {
      "name": "checkout",
      "item": [
        {
          "name": "Preview an order total without reserving inventory (HF-001)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/orders/preview-total",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "orders",
                "preview-total"
              ]
            },
            "description": "Computes the exact amount a buyer will pay for a candidate cart (subtotal + platform fee + processing fee = total) without creating an order or reserving inventory. The previewed total equals the committed total. payment_method is optional (defaults to card; it only affects fee resolution).",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"venue_id\": \"00000000-0000-0000-0000-000000000000\",\n  \"venue_event_id\": \"00000000-0000-0000-0000-000000000000\",\n  \"lines\": [\n    {\n      \"item_type\": \"ticket\",\n      \"quantity\": 0\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Create an order (reserve inventory)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/orders",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "orders"
              ]
            },
            "description": "Reserves a multi-line cart (tickets + add-ons, optional reserved seats) and, for card-like methods, starts a Stripe PaymentIntent. Idempotent on (tenant, user, Idempotency-Key). A later create for the same buyer and event reuses a matching unpaid hold or cancels leftover holds before reserving again. Required disclosure: the checkout that collects this buyer's details must show `Ticketing by AXYN · Privacy`, with `Privacy` linking to `https://axyn.events/legal/privacy` (see Required disclosure in the API description). When the event requires attendee details (`attendee_details_mode` is `required`), send `attendees` and show this notice beside the fields that collect them: `Add an email to send someone their pass. Without one, the pass stays with you. The organizer sees these names and emails.`",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"venue_id\": \"00000000-0000-0000-0000-000000000000\",\n  \"venue_event_id\": \"00000000-0000-0000-0000-000000000000\",\n  \"payment_method\": \"card\",\n  \"lines\": [\n    {\n      \"item_type\": \"ticket\",\n      \"quantity\": 0\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Reserve from a paid partner allocation (private link)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/orders/allocation",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "orders",
                "allocation"
              ]
            },
            "description": "ENG-1565 — reserves units from a named GA hold using the allocation token from a private link. The link is an extra gate in front of the ordinary checkout, never a substitute for one: the buyer still authenticates (guest sessions included), the tenant is resolved from venue_event_id and never from the token, and the order that comes out is the ordinary order with the ordinary timer, price, payment, ticket and scanner behaviour. Idempotent on (tenant, user, Idempotency-Key). Every way the token can fail — expired, rotated, released, exhausted, wrong tenant, wrong tier, or never valid — collapses to one allocation_unavailable 404 so the endpoint cannot be used to map another organizer’s inventory.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"venue_event_id\": \"00000000-0000-0000-0000-000000000000\",\n  \"allocation_token\": \"string\",\n  \"quantity\": 0,\n  \"payment_method\": \"card\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Start or resume payment for an order",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/orders/:orderId/payments/start",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "orders",
                ":orderId",
                "payments",
                "start"
              ],
              "variable": [
                {
                  "key": "orderId",
                  "value": "{{orderId}}"
                }
              ]
            },
            "description": "Returns the Stripe client secret for the order's PaymentIntent. Required disclosure: the card step must show `Ticketing by AXYN · Privacy`, with `Privacy` linking to `https://axyn.events/legal/privacy` (see Required disclosure in the API description)."
          }
        },
        {
          "name": "Synchronously verify an order's payment (HF-017)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/orders/:orderId/verify-payment",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "orders",
                ":orderId",
                "verify-payment"
              ],
              "variable": [
                {
                  "key": "orderId",
                  "value": "{{orderId}}"
                }
              ]
            },
            "description": "Returns a definitive paid/failed/pending status by reading Stripe live (paymentIntents.retrieve), reconciling it with the order, and never showing \"pending forever\". The success page calls this on return from Stripe and may poll it ~1/s up to 30s while a charge settles; the webhook reconciles thereafter. Idempotent on payment_intent_id."
          }
        },
        {
          "name": "Get an order's cash-at-entry pre-arrangement (D6.9)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/orders/:orderId/cash-arrangement",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "orders",
                ":orderId",
                "cash-arrangement"
              ],
              "variable": [
                {
                  "key": "orderId",
                  "value": "{{orderId}}"
                }
              ]
            },
            "description": "Returns the cash-at-entry pre-arrangement (amount the door collects + status) for a cash order. Owner or venue staff only. 404 for a non-cash order."
          }
        },
        {
          "name": "Mint fresh purchaser confirmation bearers",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/orders/:orderId/confirmation-bearers",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "orders",
                ":orderId",
                "confirmation-bearers"
              ],
              "variable": [
                {
                  "key": "orderId",
                  "value": "{{orderId}}"
                }
              ]
            },
            "description": "ENG-468 — returns fresh raw ticket-url bearer tokens for the purchaser's paid order cohort. Intended for hosted confirmation sessionStorage only; never put these in the confirmation URL. ENG-3387: also returns `passes`, each of the buyer's passes with its Live Pass link. Only the order's buyer may call it (403 otherwise), and only for a paid order (409 `order not paid`)."
          }
        },
        {
          "name": "Extend an unpaid checkout hold",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/orders/:orderId/extend-hold",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "orders",
                ":orderId",
                "extend-hold"
              ],
              "variable": [
                {
                  "key": "orderId",
                  "value": "{{orderId}}"
                }
              ]
            },
            "description": "WCAG 2.2.1 warn-and-extend for ENG-1577. Explicit buyer action bumps reservation_expires_at and expires_at by one current hold window (900s) and increments hold_extension_count, capped at 10. Does not re-acquire inventory; sold-out after the original hold still extends. Expired, paid, or cap-exhausted holds return 409."
          }
        },
        {
          "name": "Cancel an unpaid checkout hold",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/orders/:orderId/cancel",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "orders",
                ":orderId",
                "cancel"
              ],
              "variable": [
                {
                  "key": "orderId",
                  "value": "{{orderId}}"
                }
              ]
            },
            "description": "Releases a buyer-owned reserved or pending_payment order so a refresh or abandon cannot stack inventory holds. Already cancelled or expired orders return 200. Paid and other terminal statuses return 409."
          }
        },
        {
          "name": "Get an order with its tickets",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/orders/:orderId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "orders",
                ":orderId"
              ],
              "variable": [
                {
                  "key": "orderId",
                  "value": "{{orderId}}"
                }
              ]
            }
          }
        }
      ],
      "description": "Order creation, payment start, order read (Supabase JWT)."
    },
    {
      "name": "seats",
      "item": [
        {
          "name": "Hold reserved seats (TTL)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/seats/hold",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "seats",
                "hold"
              ]
            },
            "description": "All-or-nothing hold; idempotent re-hold by the same owner. Owner is typically the cart/order id. With a catalog:read API key the hold runs for the seats' organizer: the key tenant's own seats, or seats of ONE public (on_sale or sold_out) event of another organizer (the seat map that key can read). Seats spread over organizers or events, seats of a draft or cancelled event, and sandbox organizers on the hosted buyer surface return 404 seat_not_found.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"hold_owner\": \"00000000-0000-0000-0000-000000000000\",\n  \"seat_ids\": [\n    \"00000000-0000-0000-0000-000000000000\"\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Release held seats",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/seats/release",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "seats",
                "release"
              ]
            },
            "description": "Releases seats held by hold_owner. Organizer resolution is the same as POST /v1/seats/hold.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"hold_owner\": \"00000000-0000-0000-0000-000000000000\",\n  \"seat_ids\": [\n    \"00000000-0000-0000-0000-000000000000\"\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        }
      ],
      "description": "Reserved-seat holds (Supabase JWT)."
    },
    {
      "name": "tickets",
      "item": [
        {
          "name": "List the authenticated user's tickets",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/me/tickets",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "me",
                "tickets"
              ]
            }
          }
        }
      ],
      "description": "End-user ticket reads (Supabase JWT)."
    },
    {
      "name": "scanning",
      "item": [
        {
          "name": "Issue a scanner device token",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tickets/scanner-tokens",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tickets",
                "scanner-tokens"
              ]
            },
            "description": "Huddle staff JWT (organizer admin, event manager, or door lead) plus x-tenant-id. Hired scanners and walk-up sales receive 403. Returns the one-time token value once.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"venue_event_id\": \"00000000-0000-0000-0000-000000000000\",\n  \"venue_id\": \"00000000-0000-0000-0000-000000000000\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "List scanner tokens for an event",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tickets/scanner-tokens?event_id={{event_id}}&include_revoked={{include_revoked}}",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tickets",
                "scanner-tokens"
              ],
              "query": [
                {
                  "key": "event_id",
                  "value": "{{event_id}}"
                },
                {
                  "key": "include_revoked",
                  "value": "{{include_revoked}}"
                }
              ]
            }
          }
        },
        {
          "name": "Revoke a scanner token",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tickets/scanner-tokens/:tokenId/revoke",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tickets",
                "scanner-tokens",
                ":tokenId",
                "revoke"
              ],
              "variable": [
                {
                  "key": "tokenId",
                  "value": "{{tokenId}}"
                }
              ]
            }
          }
        },
        {
          "name": "Get or mint the active event scanner join code",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tickets/scanner-join-codes?event_id={{event_id}}",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tickets",
                "scanner-join-codes"
              ],
              "query": [
                {
                  "key": "event_id",
                  "value": "{{event_id}}"
                }
              ]
            },
            "description": "Huddle staff JWT (organizer admin, event manager, or door lead) plus x-tenant-id. Hired scanners and walk-up sales receive 403. Returns the one active 6-digit door join code for the event, minting it if missing. Unique per event, not per scanner. Share the digits outdoors (glare) and the QR indoors."
          }
        },
        {
          "name": "Rotate the event scanner join code",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tickets/scanner-join-codes/rotate",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tickets",
                "scanner-join-codes",
                "rotate"
              ]
            },
            "description": "Huddle staff JWT (organizer admin, event manager, or door lead) plus x-tenant-id. Hired scanners and walk-up sales receive 403. Revokes the current 6-digit code and mints a new one. Existing scn_ device tokens stay valid until expiry or revoke.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"event_id\": \"00000000-0000-0000-0000-000000000000\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Redeem a 6-digit scanner join code",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tickets/scanner-join-codes/redeem",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tickets",
                "scanner-join-codes",
                "redeem"
              ]
            },
            "description": "Public. Tenant and event come from the join-code row, never from the body. Possession of the 6-digit PIN mints a unique scn_ device token. Guessing is capped by a Postgres-backed per-IP budget shared across API replicas (10 attempts per minute and 30 per 15 minutes) plus a per-process limiter at the same ceiling. Each active code mints at most 40 devices. Rotate after the night; rotate does not revoke already-minted tokens.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"code\": \"string\",\n  \"join_payload\": \"string\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Read this device token's name and assigned lane",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "x-scanner-token",
                "value": "{{scannerToken}}"
              },
              {
                "key": "x-scanner-token",
                "value": "{{x-scanner-token}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tickets/scanner-tokens/me",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tickets",
                "scanner-tokens",
                "me"
              ]
            },
            "description": "Volunteer path. Auth is x-scanner-token. Returns label plus organizer-assigned lane so the device can adopt the huddle assignment without a second setup. Rate-limited to 40 calls per token per minute (door poll is every 5s)."
          }
        },
        {
          "name": "Set the scanner display name on this device token",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "x-scanner-token",
                "value": "{{scannerToken}}"
              },
              {
                "key": "x-scanner-token",
                "value": "{{x-scanner-token}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tickets/scanner-tokens/me",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tickets",
                "scanner-tokens",
                "me"
              ]
            },
            "description": "Volunteer path after join. Auth is x-scanner-token. Writes first + last name onto scanner_tokens.label.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"first_name\": \"string\",\n  \"last_name\": \"string\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "List joined scanners for an event",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tickets/scanner-roster?event_id={{event_id}}",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tickets",
                "scanner-roster"
              ],
              "query": [
                {
                  "key": "event_id",
                  "value": "{{event_id}}"
                }
              ]
            },
            "description": "Staff JWT plus `x-tenant-id` (or a partner API key). Roster of active scanner tokens (join-code devices and staff-minted tokens) with display names and organizer-assigned lanes. Tenant comes from the API key or `x-tenant-id`, not the JWT and not the body. ACL is the caller's `tenant_staff` scan grant."
          }
        },
        {
          "name": "Assign or clear a joined scanner's lane",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tickets/scanner-tokens/:tokenId/lane",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tickets",
                "scanner-tokens",
                ":tokenId",
                "lane"
              ],
              "variable": [
                {
                  "key": "tokenId",
                  "value": "{{tokenId}}"
                }
              ]
            },
            "description": "Staff JWT. Organizer override wins: assigning a lane clears that lane on other active tokens for the same event. Pass lane_id null to unassign. Lane ids are event-owned strings; an empty catalog leaves scanners unbound.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"lane_id\": \"string\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "List the door station catalog for an event",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/door-stations?event_id={{event_id}}",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "door-stations"
              ],
              "query": [
                {
                  "key": "event_id",
                  "value": "{{event_id}}"
                }
              ]
            },
            "description": "Staff JWT with door access to the event. Returns the event-owned lanes (stations) in organizer order, each with the ticket tiers it admits. lane_id is the key carried by scanner_tokens.assigned_lane_id and scanner_devices.lane_id."
          }
        },
        {
          "name": "Add a door station to the event catalog",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/door-stations",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "door-stations"
              ]
            },
            "description": "Staff JWT with door.station.manage on the event. lane_id is the immutable key doors bind to; name is the organizer label. Omitting admits_all_tiers infers it from admit_tier_ids (named tiers narrow the station, none admits everything). A station that admits nothing is rejected.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"event_id\": \"00000000-0000-0000-0000-000000000000\",\n  \"lane_id\": \"string\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "The door station this scanner token is standing at",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "x-scanner-token",
                "value": "{{scannerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/door-stations/me",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "door-stations",
                "me"
              ]
            },
            "description": "Scanner device token. Tenant and event come from the live scn_ row, never x-tenant-id. station is null when the token has no lane assigned or its lane is not in the catalog."
          }
        },
        {
          "name": "Rename a door station or change what it admits",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/door-stations/:stationId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "door-stations",
                ":stationId"
              ],
              "variable": [
                {
                  "key": "stationId",
                  "value": "{{stationId}}"
                }
              ]
            },
            "description": "Staff JWT with door.station.manage on the station’s event. lane_id is immutable — renaming the key would unbind every door standing there. admit_tier_ids replaces the stored set wholesale, and setting admits_all_tiers true on its own clears it; the merged state must still admit something, and a widening that also names tiers is rejected.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"string\",\n  \"sort_order\": 0,\n  \"is_active\": false,\n  \"admits_all_tiers\": false,\n  \"admit_tier_ids\": [\n    \"00000000-0000-0000-0000-000000000000\"\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Remove a door station from the catalog",
          "request": {
            "method": "DELETE",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/door-stations/:stationId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "door-stations",
                ":stationId"
              ],
              "variable": [
                {
                  "key": "stationId",
                  "value": "{{stationId}}"
                }
              ]
            },
            "description": "Staff JWT with door.station.manage on the station’s event. Fails closed with 409 while a live scanner token or an active registered device still carries that lane — deactivate (is_active false) is the in-event move."
          }
        },
        {
          "name": "Staff online scan",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tickets/scan",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tickets",
                "scan"
              ]
            },
            "description": "Staff/admin only. Business outcome returned in data.result_code with HTTP 200. When client_device_id names a device registered to a door station that does not admit the ticket's tier, the outcome is wrong_door and the ticket is left unused.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"qr_code\": \"string\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Manual ticket lookup (HF-023)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/scanner/manual-lookup",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "scanner",
                "manual-lookup"
              ]
            },
            "description": "Door staff find a ticket by typed buyer identifier (name / email / order id / order reference / ticket number) when a QR cannot be read. Scoped to one event; returns masked buyer info only. ENG-1603: also returns advance pay-at-door orders still awaiting cash (no tickets exist until the door collects) as pending_cash_orders. A cash-desk-only grant (cash_collector) receives pending_cash_orders and an empty matches.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"venue_event_id\": \"00000000-0000-0000-0000-000000000000\",\n  \"query\": \"string\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Manual admit override (HF-023/HF-026)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/scanner/manual-admit",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "scanner",
                "manual-admit"
              ]
            },
            "description": "Door staff admit a ticket verified via manual lookup (QR unreadable). Always written to the append-only scan audit with is_manual_admit=true and the override reason. Business outcome in data.result_code (HTTP 200).",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"venue_event_id\": \"00000000-0000-0000-0000-000000000000\",\n  \"ticket_id\": \"00000000-0000-0000-0000-000000000000\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Record badge handoff (ENG-1563)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/scanner/pickup",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "scanner",
                "pickup"
              ]
            },
            "description": "Staff with door.pickup record that a physical badge was handed over for one live badge pickup ticket. Idempotent on idempotency_key; one success per ticket across desks. Never remints the Live Pass. When the ticket was sold with pickup_requires_scan false, the handoff also checks the guest in through the audited manual-admit path (override reason \"Badge pickup counts as entry\"). The desk hours are the entry window, so an early pickup still checks the guest in; if the door refuses (refunded, voided, unpaid), nothing is handed over. id_checked is an attestation only; no ID data is stored.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"venue_event_id\": \"00000000-0000-0000-0000-000000000000\",\n  \"ticket_id\": \"00000000-0000-0000-0000-000000000000\",\n  \"idempotency_key\": \"string\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Register a scanning device (T-077 Path B)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/scanner/devices/register",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "scanner",
                "devices",
                "register"
              ]
            },
            "description": "Register a device against an event so it can scan when the event requires device registration. Idempotent on (event, device_id): re-registering refreshes lane/label and clears any prior revocation. On an event that has a wristband key a revoked registration is never cleared: the answer is 403 `device_revoked`.\n\nWristband key (optional `band_key` field, attested Android scanners only). Send `{ \"step\": \"challenge\" }` to register and receive a one-time challenge (valid 5 minutes). Generate an RSA key (2048 bits or more) with purpose WRAP_KEY only (a key that also has DECRYPT, SIGN or any other purpose is refused) in the phone's secure hardware using that challenge as the attestation challenge, then send `{ \"step\": \"deliver\", \"attestation_chain\": [...] }` with the key's certificate chain. The answer carries the event key as an Android `SecureKeyWrapper` that only that phone's hardware can import; the imported key can only AES-encrypt and expires at `expires_at`. Every delivery needs a new challenge and a new attestation.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"venue_event_id\": \"00000000-0000-0000-0000-000000000000\",\n  \"client_device_id\": \"string\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "List registered scanning devices (T-077 Path B)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/scanner/devices?venue_event_id={{venue_event_id}}&include_revoked={{include_revoked}}",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "scanner",
                "devices"
              ],
              "query": [
                {
                  "key": "venue_event_id",
                  "value": "{{venue_event_id}}"
                },
                {
                  "key": "include_revoked",
                  "value": "{{include_revoked}}"
                }
              ]
            },
            "description": "List devices registered for an event. Active only by default; pass include_revoked=true for the full registration audit."
          }
        },
        {
          "name": "Revoke a scanning device registration (T-077 Path B)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/scanner/devices/:registrationId/revoke",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "scanner",
                "devices",
                ":registrationId",
                "revoke"
              ],
              "variable": [
                {
                  "key": "registrationId",
                  "value": "{{registrationId}}"
                }
              ]
            },
            "description": "Soft-revoke a device registration (preserves audit). After revocation the device can no longer scan events that require device registration.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"venue_event_id\": \"00000000-0000-0000-0000-000000000000\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Scanner-device online validate",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "x-scanner-token",
                "value": "{{scannerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tickets/validate",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tickets",
                "validate"
              ]
            },
            "description": "Authenticated by x-scanner-token scoped to venue_event_id. Outcome in data.result_code (HTTP 200). A scanner token assigned to a door station that does not admit the ticket's tier returns wrong_door without consuming the ticket.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"qr_code\": \"string\",\n  \"venue_event_id\": \"00000000-0000-0000-0000-000000000000\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Offline scan manifest (query)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "x-scanner-token",
                "value": "{{scannerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tickets/scanner-manifest?event_id={{event_id}}",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tickets",
                "scanner-manifest"
              ],
              "query": [
                {
                  "key": "event_id",
                  "value": "{{event_id}}"
                }
              ]
            },
            "description": "Dual auth: volunteer `x-scanner-token`, or staff Bearer JWT + `x-tenant-id` with a scanner role and active event grant. Prefer staff JWT for operator Sync (ENG-613 option A)."
          }
        },
        {
          "name": "Offline scan manifest (path)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "x-scanner-token",
                "value": "{{scannerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tickets/manifest/:eventId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tickets",
                "manifest",
                ":eventId"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                }
              ]
            },
            "description": "Dual auth: volunteer `x-scanner-token`, or staff Bearer JWT + `x-tenant-id` with a scanner role and active event grant."
          }
        },
        {
          "name": "Sync offline scans (device token)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "x-scanner-token",
                "value": "{{scannerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tickets/sync-scans",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tickets",
                "sync-scans"
              ]
            },
            "description": "Batch of offline scans (max 500); each item is scoped to its venue_event_id by x-scanner-token.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"scans\": [\n    {\n      \"qr_code\": \"string\",\n      \"venue_event_id\": \"00000000-0000-0000-0000-000000000000\"\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Sync offline scans (staff JWT)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tickets/sync-scans-staff",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tickets",
                "sync-scans-staff"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"scans\": [\n    {\n      \"qr_code\": \"string\"\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Open a scanner dispute",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/scanner/disputes",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "scanner",
                "disputes"
              ]
            },
            "description": "A door-staff scanner opens a dispute when a ticket presented in person cannot be admitted (already-scanned, damaged QR, identity mismatch).",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"ticket_id\": \"00000000-0000-0000-0000-000000000000\",\n  \"reason_code\": \"string\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Resolve a scanner dispute",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/scanner/disputes/:disputeId/resolve",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "scanner",
                "disputes",
                ":disputeId",
                "resolve"
              ],
              "variable": [
                {
                  "key": "disputeId",
                  "value": "{{disputeId}}"
                }
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"resolution\": \"admit\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Sell a walk-up ticket at the door",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/scanner/walk-up-sale",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "scanner",
                "walk-up-sale"
              ]
            },
            "description": "ENG-246 — staff JWT sells against live shared inventory (same rpc_order_create_atomic as online checkout). Requires Idempotency-Key. Purchaser is the guest; staff JWT is the actor only. Cash sales return a cash_arrangement and complete via POST /v1/scanner/cash-collected.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"venue_id\": \"00000000-0000-0000-0000-000000000000\",\n  \"venue_event_id\": \"00000000-0000-0000-0000-000000000000\",\n  \"payment_method\": \"card\",\n  \"purchaser_name\": \"string\",\n  \"purchaser_email\": \"string\",\n  \"lines\": [\n    {\n      \"item_type\": \"ticket\",\n      \"quantity\": 0\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Record cash-at-entry collection at the door",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/scanner/cash-collected",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "scanner",
                "cash-collected"
              ]
            },
            "description": "M22c — flips the cash-at-entry arrangement from pending → collected once the door collects the expected amount.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"order_id\": \"00000000-0000-0000-0000-000000000000\",\n  \"amount_cents\": 0\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        }
      ],
      "description": "Scanner-token issuance, online/offline scan, manifest."
    },
    {
      "name": "connect",
      "item": [
        {
          "name": "Create a Stripe Connect onboarding link",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tenants/:tenantId/connect/onboarding-link",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tenants",
                ":tenantId",
                "connect",
                "onboarding-link"
              ],
              "variable": [
                {
                  "key": "tenantId",
                  "value": "{{tenantId}}"
                }
              ]
            },
            "description": "ENG-356: staff JWT + organizer_admin (or super_admin). Optional x-api-key must match path tenantId.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"return_url\": \"https://example.com\",\n  \"refresh_url\": \"https://example.com\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Get the tenant's Connect account status",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tenants/:tenantId/connect/account",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tenants",
                ":tenantId",
                "connect",
                "account"
              ],
              "variable": [
                {
                  "key": "tenantId",
                  "value": "{{tenantId}}"
                }
              ]
            },
            "description": "ENG-356: staff JWT + organizer_admin (or super_admin). Optional x-api-key must match path tenantId."
          }
        },
        {
          "name": "Get Stripe Connect payout schedule for a tenant",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tenants/:tenantId/connect/payout-schedule",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tenants",
                ":tenantId",
                "connect",
                "payout-schedule"
              ],
              "variable": [
                {
                  "key": "tenantId",
                  "value": "{{tenantId}}"
                }
              ]
            },
            "description": "ENG-598: staff JWT + settlement.read. Returns mirrored/live schedule (daily|weekly|monthly|manual). Instant payouts out of scope."
          }
        },
        {
          "name": "Update Stripe Connect payout schedule for a tenant",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tenants/:tenantId/connect/payout-schedule",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tenants",
                ":tenantId",
                "connect",
                "payout-schedule"
              ],
              "variable": [
                {
                  "key": "tenantId",
                  "value": "{{tenantId}}"
                }
              ]
            },
            "description": "ENG-598: staff JWT + settlement.payout_schedule.manage (organizer_admin). Updates via Stripe accounts.update; mirrors typed columns only after Stripe confirms. Instant payouts out of scope.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"interval\": \"daily\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Early payouts for a tenant (read-only)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tenants/:tenantId/connect/early-payouts?production_id={{production_id}}&event_id={{event_id}}",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tenants",
                ":tenantId",
                "connect",
                "early-payouts"
              ],
              "query": [
                {
                  "key": "production_id",
                  "value": "{{production_id}}"
                },
                {
                  "key": "event_id",
                  "value": "{{event_id}}"
                }
              ],
              "variable": [
                {
                  "key": "tenantId",
                  "value": "{{tenantId}}"
                }
              ]
            },
            "description": "Staff JWT + settlement.read on the path tenant. Per series (or standalone event) with money on the current Connect account: the hold % a platform super admin set (payout % + hold % = 100%), what was paid early, what is held until after the event, what was paid above what the unit now keeps, and the estimated next payment. `production_id` or `event_id` (a standalone event) keeps that unit only (ENG-2408 A5). Viewer-only roles get every amount as 0 with `viewer_masked: true`; the `has_*` flags say which lines apply (A6). Nothing here changes a payout; the hold is set only by platform staff."
          }
        }
      ],
      "description": "Stripe Connect onboarding for producers (organizer JWT + tenant_staff organizer_admin, or super_admin bypass; optional x-api-key must match path tenant)."
    },
    {
      "name": "webhooks",
      "item": [
        {
          "name": "Ethoca pre-chargeback alert receiver",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "x-ethoca-signature",
                "value": "{{x-ethoca-signature}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/webhooks/ethoca",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "webhooks",
                "ethoca"
              ]
            },
            "description": "M25: raw-body endpoint verified by an HMAC-SHA256 hex digest of the body in x-ethoca-signature. Never accepts an unsigned alert. A durable alert whose decision was deferred acks 200 with deferred: true (the prevention sweeper retries it); a non-durable ingest answers 503 so Ethoca retries.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"alert_id\": \"string\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Stripe webhook receiver",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Stripe-Signature",
                "value": "{{Stripe-Signature}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/webhooks/stripe",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "webhooks",
                "stripe"
              ]
            },
            "description": "Raw-body endpoint verified by the Stripe-Signature header. Handles payment_intent.succeeded/payment_failed/processing, charge.refunded, charge.dispute.*, account.updated.",
            "body": {
              "mode": "raw",
              "raw": "{}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Twilio message status callback",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "X-Twilio-Signature",
                "value": "{{X-Twilio-Signature}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/webhooks/twilio",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "webhooks",
                "twilio"
              ]
            },
            "description": "ENG-2869: form-encoded status callback for one text. The MessageSid is matched to a text row, the row binds the organizer, and the X-Twilio-Signature is checked with that organizer's sub-account (the AccountSid in the callback must be that sub-account). The row is then written from the provider's Message resource: status, error code, segments and price."
          }
        }
      ],
      "description": "Inbound Stripe webhook (signature-verified, no bearer)."
    },
    {
      "name": "buyer",
      "item": [
        {
          "name": "List the authenticated buyer follows (ENG-159)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/me/follows",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "me",
                "follows"
              ]
            },
            "description": "Returns venue/artist/organizer follows for the authenticated buyer (Supabase JWT)."
          }
        },
        {
          "name": "Create or update a buyer follow (ENG-159)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/me/follows",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "me",
                "follows"
              ]
            },
            "description": "Upserts a follow for venue|artist|organizer. Returns 201 on create and 200 on update.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"target_type\": \"venue\",\n  \"target_id\": \"00000000-0000-0000-0000-000000000000\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Delete a buyer follow (ENG-159)",
          "request": {
            "method": "DELETE",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/me/follows/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "me",
                "follows",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "{{id}}"
                }
              ]
            },
            "description": "Deletes a follow owned by the authenticated buyer."
          }
        },
        {
          "name": "Submit an NPS response for a ticket",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/me/nps-responses/:ticketId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "me",
                "nps-responses",
                ":ticketId"
              ],
              "variable": [
                {
                  "key": "ticketId",
                  "value": "{{ticketId}}"
                }
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"score\": 0\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Get recommended next events for the caller",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/me/next-event-recommendations",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "me",
                "next-event-recommendations"
              ]
            }
          }
        },
        {
          "name": "Update the caller's profile",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/me/profile",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "me",
                "profile"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"display_name\": \"string\",\n  \"phone\": \"string\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Bind guest-checkout orders to the caller's account",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/me/guest-orders/claim",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "me",
                "guest-orders",
                "claim"
              ]
            },
            "description": "M24-guest-claim — binds every cross-tenant ticket_orders row where purchaser_user_id IS NULL AND purchaser_email matches the JWT email."
          }
        },
        {
          "name": "Mint a live QR slot for an owned ticket",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/me/tickets/:ticketId/live-qr/mint",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "me",
                "tickets",
                ":ticketId",
                "live-qr",
                "mint"
              ],
              "variable": [
                {
                  "key": "ticketId",
                  "value": "{{ticketId}}"
                }
              ]
            },
            "description": "Mint a rotating live pass slot for a ticket the caller owns (buyer JWT). On an additional device the API may return 403 with error step_up_required and data.sid.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"device_key_hash\": \"string\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Extend / rotate a live QR slot for an owned ticket",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/me/tickets/:ticketId/live-qr/extend",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "me",
                "tickets",
                ":ticketId",
                "live-qr",
                "extend"
              ],
              "variable": [
                {
                  "key": "ticketId",
                  "value": "{{ticketId}}"
                }
              ]
            },
            "description": "Rotate the current live pass slot for an existing device session.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"device_key_hash\": \"string\",\n  \"sid\": \"00000000-0000-0000-0000-000000000000\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Confirm live QR device step-up for an owned ticket",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/me/tickets/:ticketId/live-qr/confirm-step-up",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "me",
                "tickets",
                ":ticketId",
                "live-qr",
                "confirm-step-up"
              ],
              "variable": [
                {
                  "key": "ticketId",
                  "value": "{{ticketId}}"
                }
              ]
            },
            "description": "Confirm a pending live pass device step-up after the holder opens the emailed confirm URL (`sid` + signed `confirm`). The 403 sid alone is not enough. Returns a minted slot on success.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"device_key_hash\": \"string\",\n  \"sid\": \"00000000-0000-0000-0000-000000000000\",\n  \"confirm\": \"string\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Resend live pass step-up email for an owned ticket",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/me/tickets/:ticketId/live-qr/resend-step-up",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "me",
                "tickets",
                ":ticketId",
                "live-qr",
                "resend-step-up"
              ],
              "variable": [
                {
                  "key": "ticketId",
                  "value": "{{ticketId}}"
                }
              ]
            },
            "description": "Resend the device confirmation email for a pending step-up session on a ticket the caller owns. Requires buyer JWT.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"device_key_hash\": \"string\",\n  \"sid\": \"00000000-0000-0000-0000-000000000000\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        }
      ],
      "description": "End-user (buyer) self-serve — Supabase JWT."
    },
    {
      "name": "notifications",
      "item": [
        {
          "name": "Get the caller's notification preferences",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/notification-preferences",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "notification-preferences"
              ]
            }
          }
        },
        {
          "name": "Upsert notification opt-outs and/or quiet-hours (partial)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/notification-preferences",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "notification-preferences"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"opt_outs\": [\n    \"string\"\n  ],\n  \"quiet_hours\": {\n    \"start_local\": \"string\",\n    \"end_local\": \"string\",\n    \"timezone\": \"string\"\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Replace notification opt-outs and/or quiet-hours (full)",
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/notification-preferences",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "notification-preferences"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"opt_outs\": [\n    \"string\"\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        }
      ],
      "description": "Buyer notification preferences (Supabase JWT)."
    },
    {
      "name": "transfers",
      "item": [
        {
          "name": "Create an outgoing ticket transfer offer",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tickets/:ticketId/transfer-offers",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tickets",
                ":ticketId",
                "transfer-offers"
              ],
              "variable": [
                {
                  "key": "ticketId",
                  "value": "{{ticketId}}"
                }
              ]
            },
            "description": "Issue a transfer offer for a ticket the buyer holds. Requires buyer JWT; a tenant API key is optional and, when sent, must match the ticket's tenant (the tenant is derived from the ticket, so first-party clients omit it). The JWT user must be the ticket's current holder (purchaser until a completed transfer, attendee when set); anyone else gets the same opaque 404 ticket_not_found as an unknown ticket. A dispute-held ticket or one with a pending / approved-not-processed refund answers 409 ticket_not_transferable with data.actual_status dispute_hold / refund_pending. Recipient claims via /v1/ticket-transfer-claims/{tokenOrShareCode}. Raw claim token is returned once on 201; idempotent replay returns empty token.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"recipient_email\": \"string\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Revoke a pending outgoing transfer offer",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tickets/:ticketId/transfer-offers/revoke",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tickets",
                ":ticketId",
                "transfer-offers",
                "revoke"
              ],
              "variable": [
                {
                  "key": "ticketId",
                  "value": "{{ticketId}}"
                }
              ]
            },
            "description": "Revoke the pending transfer offer for a ticket the buyer holds. Requires buyer JWT; a tenant API key is optional and, when sent, must match the ticket's tenant. Only the ticket's current holder may revoke; anyone else gets the opaque 404 ticket_transfer_offer_not_found. Optional reason.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"reason\": \"string\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Preview a transfer accept shell",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/v1/ticket-transfer-claims/:token",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "ticket-transfer-claims",
                ":token"
              ],
              "variable": [
                {
                  "key": "token",
                  "value": "{{token}}"
                }
              ]
            },
            "description": "Public accept-shell preview (event + venue brand). Possession of the transfer claim token or share code is the credential; no buyer JWT."
          }
        },
        {
          "name": "Claim an incoming ticket transfer",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/ticket-transfer-claims/:token",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "ticket-transfer-claims",
                ":token"
              ],
              "variable": [
                {
                  "key": "token",
                  "value": "{{token}}"
                }
              ]
            },
            "description": "Public guest claim. Possession of the transfer claim token or share code is the credential for the FIRST claim only. Optional guest_first_name / guest_last_name for Live Pass display. Both are required when the offer preview reports attendee_name_required (the event requires a name for every ticket, or the buyer named this ticket's holder at checkout); a claim without them is refused with 400 attendee_name_required and nothing is claimed. A name sent on a first claim replaces both parts of the previous holder's name (a part left out is cleared). First claim success includes pass_bearer for the recipient live pass. Reopening an already-claimed link is refused (409 ticket_transfer_offer_already_claimed, nothing reminted) unless it is the ticket's latest completed transfer on an active ticket; then the fresh pass is returned only when device_key_hash matches a Live Pass device bound after the claim, otherwise it is emailed to the recipient and pass_bearer is null (recovery_email_sent reports delivery).",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"guest_first_name\": \"string\",\n  \"guest_last_name\": \"string\",\n  \"device_key_hash\": \"string\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "List incoming transfer offers addressed to the caller",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/me/ticket-transfer-offers?status={{status}}",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "me",
                "ticket-transfer-offers"
              ],
              "query": [
                {
                  "key": "status",
                  "value": "{{status}}"
                }
              ]
            }
          }
        },
        {
          "name": "Issue a transfer offer from a ticket-url bearer",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/ticket-url/:token/transfer-offers",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "ticket-url",
                ":token",
                "transfer-offers"
              ],
              "variable": [
                {
                  "key": "token",
                  "value": "{{token}}"
                }
              ]
            },
            "description": "Guest Send a pass. Ticket-url bearer is view+door only. Issue requires device_key_hash of a confirmed Live Pass session, or returns 403 step_up_required with sid.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"recipient_email\": \"string\",\n  \"device_key_hash\": \"string\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Revoke a pending transfer offer from a ticket-url bearer",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/ticket-url/:token/transfer-offers/revoke",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "ticket-url",
                ":token",
                "transfer-offers",
                "revoke"
              ],
              "variable": [
                {
                  "key": "token",
                  "value": "{{token}}"
                }
              ]
            },
            "description": "Revoke a pending transfer offer using ticket-url holdership.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"reason\": \"string\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Resend a pending transfer offer email",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/ticket-url/:token/transfer-offers/resend",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "ticket-url",
                ":token",
                "transfer-offers",
                "resend"
              ],
              "variable": [
                {
                  "key": "token",
                  "value": "{{token}}"
                }
              ]
            },
            "description": "Resend transfer email for a pending offer identified by share_code. Same device_key_hash / step_up_required gate as issue. Revoke is not gated.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"share_code\": \"string\",\n  \"device_key_hash\": \"string\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        }
      ],
      "description": "Buyer-initiated ticket transfer offers + recipient claims."
    },
    {
      "name": "vouchers",
      "item": [
        {
          "name": "Redeem a voucher against an order",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/vouchers/redeem",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "vouchers",
                "redeem"
              ]
            },
            "description": "M28b — flips a voucher to terminal redeemed + binds it to the target order. applied_cents is what future checkout composition subtracts from what Stripe is charged.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"voucher_code\": \"string\",\n  \"order_id\": \"00000000-0000-0000-0000-000000000000\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Void an active voucher (organizer)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/vouchers/:voucherId/void",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "vouchers",
                ":voucherId",
                "void"
              ],
              "variable": [
                {
                  "key": "voucherId",
                  "value": "{{voucherId}}"
                }
              ]
            },
            "description": "M28b-void — organizer-staff terminal void of an active voucher. SINGLE writer of vouchers.status active → voided.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"reason\": \"string\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        }
      ],
      "description": "Voucher redemption + organizer void."
    },
    {
      "name": "federation",
      "item": [
        {
          "name": "Exchange a partner user token for an AXYN session",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/auth/federation/token-exchange",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "auth",
                "federation",
                "token-exchange"
              ]
            },
            "description": "Partner token exchange ([RFC 8693](https://www.rfc-editor.org/rfc/rfc8693)). A registered federation partner trades its own signed user token (a JWT) for an AXYN buyer session.\n\n- AXYN picks the partner from the token's `iss`, then verifies signature, issuer and audience against that partner's registered JWKS and audience.\n- A partner must be registered **and** named in this deployment's partner allowlist; a registered partner that is not allowlisted is refused like an unknown issuer.\n- The token must carry `sub` and `email` and must not be anonymous (`is_anonymous: true`).\n- The partner identity (`partner_id`, `sub`) is linked to one AXYN account: an existing account with the same email (`email_match`) or a new buyer account (`explicit_link`). Organizer and platform-admin accounts are never reachable this way (403).\n\nEvery partner uses this one contract; there is no partner-specific path. Accepts `application/json` or `application/x-www-form-urlencoded`.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"grant_type\": \"string\",\n  \"subject_token\": \"string\",\n  \"subject_token_type\": \"urn:ietf:params:oauth:token-type:jwt\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Deprecated alias of the partner token exchange",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "{{Authorization}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/auth/federation/seeat-to-axyn",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "auth",
                "federation",
                "seeat-to-axyn"
              ]
            },
            "description": "Deprecated. Same handler, partner registry, allowlist and response as `POST /v1/auth/federation/token-exchange`; the subject token is read from `Authorization: Bearer` instead of the body. Responses carry `Deprecation: true` and a `Link` to the successor. Removed once no deployed partner client calls it."
          }
        }
      ],
      "description": "Partner token exchange (RFC 8693): a registered, allowlisted partner trades its user token for an AXYN buyer session (no bearer)."
    },
    {
      "name": "public",
      "item": [
        {
          "name": "Open a summary email's unsubscribe link (ENG-2404)",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/v1/summary-emails/unsubscribe?t={{t}}",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "summary-emails",
                "unsubscribe"
              ],
              "query": [
                {
                  "key": "t",
                  "value": "{{t}}"
                }
              ]
            },
            "description": "Redirects to the web confirm page. Changes nothing: mail scanners open links, so only a POST turns the summary off."
          }
        },
        {
          "name": "Turn off one summary email (RFC 8058 one-click, ENG-2404)",
          "request": {
            "method": "POST",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/v1/summary-emails/unsubscribe?t={{t}}",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "summary-emails",
                "unsubscribe"
              ],
              "query": [
                {
                  "key": "t",
                  "value": "{{t}}"
                }
              ]
            },
            "description": "Sets the token's own subscription to Off; the member's other summaries and digest are unchanged. Mail clients post `List-Unsubscribe=One-Click` (form-encoded); the confirm page posts with no body. A bad or forged token answers 404 and changes nothing."
          }
        },
        {
          "name": "What a summary unsubscribe link covers (ENG-2404)",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/v1/summary-emails/unsubscribe/status?t={{t}}",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "summary-emails",
                "unsubscribe",
                "status"
              ],
              "query": [
                {
                  "key": "t",
                  "value": "{{t}}"
                }
              ]
            },
            "description": "For the confirm page: the event or series, the organizer and the current cadence. Changes nothing. A bad or forged token answers 404."
          }
        },
        {
          "name": "Open an AXYN email link (ENG-2563)",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/v1/email-links/:token",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "email-links",
                ":token"
              ],
              "variable": [
                {
                  "key": "token",
                  "value": "{{token}}"
                }
              ]
            },
            "description": "The link in an AXYN email. A fetch is logged as a raw hit and is never counted as a click: only the landing page's report counts (POST /v1/events/{eventId}/email-clicks). Nothing about the request (address, user agent, network) is read or stored. A visible link redirects to its page, carrying `axyn_click_token` only while landing-page reports are on; the hidden link answers 204; an unknown link redirects to the AXYN home page."
          }
        },
        {
          "name": "Report an AXYN email click token from the landing page (ENG-2563)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "x-api-key",
                "value": "{{tenantApiKey}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId/email-clicks",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId",
                "email-clicks"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                }
              ]
            },
            "description": "Sent by the landing page's browser code when the page opened from an AXYN email link. Tenant is derived from the event. An unknown token, another organizer's token and a hidden link's token count nothing; a reported token counts at most once. Every outcome answers 202, so a buyer never sees an error. Stores no IP, user agent or visitor id.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"token\": \"string\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Ingest a de-identified event view fact (ENG-500)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "x-api-key",
                "value": "{{tenantApiKey}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId/views",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId",
                "views"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                }
              ]
            },
            "description": "First-party Sales impressions beacon. Tenant is derived from the event. Optional tenant API key must match when present (ENG-635: not required for headless pixel). headless_api is rejected unless the event has partner_commerce_pixel_enabled set (ENG-623 commerce pixel). Every other surface (Web SDK embed, hosted shop) is rejected unless the event has partner_embed_analytics_enabled set (ENG-2175, default off). Catalog GET does not create facts. A program inside a series carries its series' switches, and its fact counts toward the series (ENG-2307).",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"session_key\": \"string\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Ingest a de-identified funnel fact for a series (ENG-2307)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "x-api-key",
                "value": "{{tenantApiKey}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/productions/:productionId/views",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "productions",
                ":productionId",
                "views"
              ],
              "variable": [
                {
                  "key": "productionId",
                  "value": "{{productionId}}"
                }
              ]
            },
            "description": "The series form of POST /v1/events/{eventId}/views: the same body, gates and errors, with the organizer's two opt-ins read from the series (partner_embed_analytics_enabled, partner_commerce_pixel_enabled; both default off). A series has its own checkout funnel; a program inside it has none of its own. Tenant is derived from the series. An unknown id, an event id and another organizer's series all return 404 series_not_found.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"session_key\": \"string\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Partner headless-checkout view pixel script (ENG-623 / ENG-635)",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/v1/commerce-pixel.js",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "commerce-pixel.js"
              ]
            },
            "description": "Static JS a partner installs on their ticket page via <script src>. No browser API key required (ENG-635). Never send secrets in page HTML. Never sends fetch(...) to /v1/events/{eventId}/views until axyn('consent', { analytics: true }). One command per funnel step: axyn('view' | 'tier_select' | 'cart' | 'checkout_start', { eventId }), or { seriesId } for a series and its passes (posted to /v1/productions/{productionId}/views), each sent once per session and event or series. Paid comes from orders, never the pixel. No email, name, phone, or full URL is ever read. See product/axyn/developer/partner-commerce-insights-privacy.md."
          }
        },
        {
          "name": "Public cancellation status for an event",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId/cancellation-status",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId",
                "cancellation-status"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                }
              ]
            },
            "description": "Credential-free status probe (rate-limited by IP) — surfaces \"cancelled\" without exposing the buyer's full order."
          }
        },
        {
          "name": "Public bearer-token ticket URL lookup",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/v1/ticket-url/:token",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "ticket-url",
                ":token"
              ],
              "variable": [
                {
                  "key": "token",
                  "value": "{{token}}"
                }
              ]
            },
            "description": "M17a — credential-free lookup: the 32-byte token IS the credential. Rate-limited per IP + token-prefix."
          }
        },
        {
          "name": "Download Apple Wallet .pkpass for a ticket URL credential",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/v1/ticket-url/:token/apple-pass",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "ticket-url",
                ":token",
                "apple-pass"
              ],
              "variable": [
                {
                  "key": "token",
                  "value": "{{token}}"
                }
              ]
            },
            "description": "ENG-213 — signed Apple Wallet event ticket (Pass shelf). Accepts pass share code or long bearer. No admit barcode; Live Pass URL is on the pass. Rate-limited. Opaque 404 on miss."
          }
        },
        {
          "name": "Mint a live QR slot for a bearer ticket URL",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/ticket-url/:token/live-qr/mint",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "ticket-url",
                ":token",
                "live-qr",
                "mint"
              ],
              "variable": [
                {
                  "key": "token",
                  "value": "{{token}}"
                }
              ]
            },
            "description": "Mint a rotating live pass slot for a guest ticket-url bearer. Rate-limited. On an additional device the API may return 403 with error step_up_required and data.sid; the purchaser then confirms via email.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"device_key_hash\": \"string\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Extend / rotate a live QR slot for a bearer ticket URL",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/ticket-url/:token/live-qr/extend",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "ticket-url",
                ":token",
                "live-qr",
                "extend"
              ],
              "variable": [
                {
                  "key": "token",
                  "value": "{{token}}"
                }
              ]
            },
            "description": "Rotate the current live pass slot for an existing device session.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"device_key_hash\": \"string\",\n  \"sid\": \"00000000-0000-0000-0000-000000000000\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Confirm live QR device step-up for a bearer ticket URL",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/ticket-url/:token/live-qr/confirm-step-up",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "ticket-url",
                ":token",
                "live-qr",
                "confirm-step-up"
              ],
              "variable": [
                {
                  "key": "token",
                  "value": "{{token}}"
                }
              ]
            },
            "description": "Confirm a pending live pass device step-up after the holder opens the emailed confirm URL (`sid` + signed `confirm`). The 403 sid alone is not enough. Returns a minted slot on success.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"device_key_hash\": \"string\",\n  \"sid\": \"00000000-0000-0000-0000-000000000000\",\n  \"confirm\": \"string\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Public bearer-token draft event preview",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/v1/event-previews/:token",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "event-previews",
                ":token"
              ],
              "variable": [
                {
                  "key": "token",
                  "value": "{{token}}"
                }
              ]
            },
            "description": "M13-draft-preview (OD2.5) — credential-free draft event preview. Returns the same shape as GET /v1/events/{eventId} wrapped with preview: true so the buyer UI can watermark + suppress checkout."
          }
        },
        {
          "name": "Resend live pass step-up email for a bearer ticket URL",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/ticket-url/:token/live-qr/resend-step-up",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "ticket-url",
                ":token",
                "live-qr",
                "resend-step-up"
              ],
              "variable": [
                {
                  "key": "token",
                  "value": "{{token}}"
                }
              ]
            },
            "description": "Resend the device confirmation email for a pending step-up session. Ticket-url bearer is the credential. Body requires device_key_hash and sid from the step_up_required response.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"device_key_hash\": \"string\",\n  \"sid\": \"00000000-0000-0000-0000-000000000000\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        }
      ],
      "description": "Credential-free public endpoints (bearer-token in path, or open intake with rate limits)."
    },
    {
      "name": "ticket-lifecycle",
      "item": [
        {
          "name": "Void a ticket (organizer)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tickets/:ticketId/void",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tickets",
                ":ticketId",
                "void"
              ],
              "variable": [
                {
                  "key": "ticketId",
                  "value": "{{ticketId}}"
                }
              ]
            },
            "description": "Organizer-side terminal void of an issued ticket. Idempotent. Restricted to {organizer_admin, event_manager}. ENG-1723: a paid ticket returns to inventory and its reserved seat is released in the same transaction; the response lists where each seat went.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"void_reason\": \"string\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Swap a paid ticket for an issued voucher (organizer)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tickets/:ticketId/voucher-swap",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tickets",
                ":ticketId",
                "voucher-swap"
              ],
              "variable": [
                {
                  "key": "ticketId",
                  "value": "{{ticketId}}"
                }
              ]
            },
            "description": "M28b — swap a paid ticket for an active voucher of matching face value. Single writer of ticket.status → voided + voucher issuance in one transaction.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"reason\": \"string\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Return an unused complimentary ticket to Held (organizer)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tenants/:tenantId/tickets/:ticketId/return-to-hold",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tenants",
                ":tenantId",
                "tickets",
                ":ticketId",
                "return-to-hold"
              ],
              "variable": [
                {
                  "key": "tenantId",
                  "value": "{{tenantId}}"
                },
                {
                  "key": "ticketId",
                  "value": "{{ticketId}}"
                }
              ]
            },
            "description": "Void a hold-issued unused comp and add that seat back to Remaining Held. Does not change generic ticket void. Paid, redeemed, and exchanged tickets are refused.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"return_reason\": \"string\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Preview seats a void frees",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tenants/:tenantId/tickets/:ticketId/seat-release-preview",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tenants",
                ":tenantId",
                "tickets",
                ":ticketId",
                "seat-release-preview"
              ],
              "variable": [
                {
                  "key": "tenantId",
                  "value": "{{tenantId}}"
                },
                {
                  "key": "ticketId",
                  "value": "{{ticketId}}"
                }
              ]
            },
            "description": "ENG-1723. Read-only. Each reserved seat voiding this ticket would free, its label and ticket type, and where it goes by default (same rule as the void). Nothing moves."
          }
        },
        {
          "name": "Preview seats a refund frees",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tenants/:tenantId/refund-requests/:requestId/seat-release-preview",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tenants",
                ":tenantId",
                "refund-requests",
                ":requestId",
                "seat-release-preview"
              ],
              "variable": [
                {
                  "key": "tenantId",
                  "value": "{{tenantId}}"
                },
                {
                  "key": "requestId",
                  "value": "{{requestId}}"
                }
              ]
            },
            "description": "ENG-1723. Read-only. Each reserved seat approving this refund request would free (its ticket, or the order's live tickets) and where it goes by default. A whole-order approve below the remaining amount refunds no tickets, so no seats move. Nothing moves."
          }
        },
        {
          "name": "Exchange a paid ticket for a comp on another tier (organizer)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tickets/:ticketId/comp-exchange",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tickets",
                ":ticketId",
                "comp-exchange"
              ],
              "variable": [
                {
                  "key": "ticketId",
                  "value": "{{ticketId}}"
                }
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"target_tier_id\": \"00000000-0000-0000-0000-000000000000\",\n  \"reason\": \"string\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Reissue a paid ticket (organizer)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tickets/:ticketId/reissue",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tickets",
                ":ticketId",
                "reissue"
              ],
              "variable": [
                {
                  "key": "ticketId",
                  "value": "{{ticketId}}"
                }
              ]
            },
            "description": "Void the source paid ticket and mint a replacement ticket on the target tier in one transaction. The response identifies the reissue resource and never returns a stored ticket QR.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"reissue_reason\": \"string\",\n  \"target_tier_id\": \"00000000-0000-0000-0000-000000000000\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Move a pass to another tier or another show of its series in place (organizer)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tickets/:ticketId/move-tier",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tickets",
                ":ticketId",
                "move-tier"
              ],
              "variable": [
                {
                  "key": "ticketId",
                  "value": "{{ticketId}}"
                }
              ]
            },
            "description": "Move a live pass to another tier without replacing it. The ticket keeps its id, ticket_number, qr_code and pass link, so the guest's existing link simply starts reading the new tier and nothing is re-sent. Tier inventory rebalances (source sold minus one, target sold plus one) and the change is recorded in ticket_tier_moves, because a tier-only update fires no status audit trigger. Refuses seated passes (ticket_is_seated), section-linked target tiers that draw on the area pool (target_tier_is_section_linked), non-active passes, and targets with no availability.\n\nChange show: when the target tier is on another show of the same series, at the same price and currency, the pass moves to that show (result_code `ticket_show_moved`). `ticket_ids` names other tickets of the same order and ticket type that move with it, in one transaction. Answers to the old show's questions move to the new show's question with the same wording. Refuses a started or closed show (`target_event_not_open`), another series (`target_event_not_in_series`), another price (`target_price_differs`), too few tickets left (`target_tier_short`), a full show (`target_show_full`), and tickets that were scanned, transferred, refunded or are being refunded (`ticket_not_movable`, `ticket_has_history`, `order_has_refund_request`). An event-scoped grant may move only onto a show it manages (403 `target_tier_outside_event_scope`). `notify_guest: true` emails the buyer the new day and time.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"target_tier_id\": \"00000000-0000-0000-0000-000000000000\",\n  \"move_reason\": \"string\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Retire a pass into the pass that replaced it (organizer)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tickets/:ticketId/supersede",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tickets",
                ":ticketId",
                "supersede"
              ],
              "variable": [
                {
                  "key": "ticketId",
                  "value": "{{ticketId}}"
                }
              ]
            },
            "description": "Void the source pass (when it is not already voided) and point it at into_ticket_id in one transaction, so the source pass keeps admitting the target at the door instead of being denied as revoked. Both passes must belong to the same tenant, the same event, and the same holder. Replaying the same pair echoes the existing pointer and changes nothing. A source ticket with a ticket-scoped refund request still open (pending, or approved and not yet executed) is refused with 409 and data.result_code ticket_refund_request_open (data.refund_request_id names it); decide the refund first. A voided source whose order already had an order-level refund approved is refused with 409 and data.result_code ticket_order_refunded when the target is on another order, since its share may already be back with the buyer. Refusals carry a human-readable error sentence.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"into_ticket_id\": \"00000000-0000-0000-0000-000000000000\",\n  \"supersede_reason\": \"string\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        }
      ],
      "description": "Organizer-driven ticket lifecycle (void, comp-exchange, reissue, voucher-swap)."
    },
    {
      "name": "refunds",
      "item": [
        {
          "name": "Refund chosen tickets of an order",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tenants/:tenantId/refund-requests",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tenants",
                ":tenantId",
                "refund-requests"
              ],
              "variable": [
                {
                  "key": "tenantId",
                  "value": "{{tenantId}}"
                }
              ]
            },
            "description": "ENG-3040. An owner or event manager refunds chosen tickets of an order. Each ticket becomes one refund request for the amount AXYN's voluntary refund rules give (fees kept), approved at once through the same step a buyer's request goes through; the refund worker then returns the money to how the buyer paid, or records a cash-at-the-door order as paid back in cash. A second call for a ticket already refunded reports it `refunded` again and moves no money. Seat fields as on the decision. Tenant comes from the path, never the body.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"order_id\": \"00000000-0000-0000-0000-000000000000\",\n  \"ticket_ids\": [\n    \"00000000-0000-0000-0000-000000000000\"\n  ],\n  \"reason\": \"string\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Approve or reject a refund request",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tenants/:tenantId/refund-requests/:requestId/decision",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tenants",
                ":tenantId",
                "refund-requests",
                ":requestId",
                "decision"
              ],
              "variable": [
                {
                  "key": "tenantId",
                  "value": "{{tenantId}}"
                },
                {
                  "key": "requestId",
                  "value": "{{requestId}}"
                }
              ]
            },
            "description": "M46o. Staff decide one pending buyer refund request. Approve may lower the amount; a whole-order approve below the remaining amount keeps the tickets valid. ENG-1723: on approve, the refunded tickets' reserved seats are released right after the money decision (seat fields as on void) and listed in `released_seats`. Tenant comes from the path, never the body.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"decision\": \"approve\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Preview refund eligibility for an order",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/me/orders/:orderId/refund-eligibility",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "me",
                "orders",
                ":orderId",
                "refund-eligibility"
              ],
              "variable": [
                {
                  "key": "orderId",
                  "value": "{{orderId}}"
                }
              ]
            }
          }
        },
        {
          "name": "Submit a refund request for one ticket or the whole order",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/me/refund-requests",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "me",
                "refund-requests"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"order_id\": \"00000000-0000-0000-0000-000000000000\",\n  \"reason\": \"string\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "List the caller's refund requests",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/me/refund-requests?status={{status}}&limit={{limit}}",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "me",
                "refund-requests"
              ],
              "query": [
                {
                  "key": "status",
                  "value": "{{status}}"
                },
                {
                  "key": "limit",
                  "value": "{{limit}}"
                }
              ]
            }
          }
        }
      ],
      "description": "Buyer refund requests + eligibility (Supabase JWT)."
    },
    {
      "name": "photos",
      "item": [
        {
          "name": "Register event photo URLs (staff JWT required for attribution; dual-auth gate)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId/photo-urls",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId",
                "photo-urls"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                }
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"content_type\": \"string\",\n  \"byte_size\": 0\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "List event photos the caller is entitled to view",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/me/event-photos/:eventId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "me",
                "event-photos",
                ":eventId"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                }
              ]
            }
          }
        },
        {
          "name": "Record buyer's consent decision for event photos",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/me/event-photos/:eventId/consent",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "me",
                "event-photos",
                ":eventId",
                "consent"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                }
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"consent\": false\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Request removal of a specific event photo",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/me/photo-removal-requests",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "me",
                "photo-removal-requests"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"event_id\": \"00000000-0000-0000-0000-000000000000\",\n  \"photo_id\": \"00000000-0000-0000-0000-000000000000\",\n  \"reason\": \"string\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        }
      ],
      "description": "Event photos: buyer views + organizer uploads + removal requests."
    },
    {
      "name": "consents",
      "item": [
        {
          "name": "Record buyer marketing consent for one tenant",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/me/marketing-consents",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "me",
                "marketing-consents"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"tenant_id\": \"00000000-0000-0000-0000-000000000000\",\n  \"consent\": false\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "List the caller's marketing consents",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/me/marketing-consents",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "me",
                "marketing-consents"
              ]
            }
          }
        },
        {
          "name": "Get cross-organizer recommendation consent",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/me/cross-organizer-consent",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "me",
                "cross-organizer-consent"
              ]
            }
          }
        },
        {
          "name": "Set cross-organizer recommendation consent",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/me/cross-organizer-consent",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "me",
                "cross-organizer-consent"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"grant\": false\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Get cross-organizer event recommendations",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/me/cross-organizer-recommendations",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "me",
                "cross-organizer-recommendations"
              ]
            }
          }
        }
      ],
      "description": "Marketing consent + cross-organizer recommendations (Supabase JWT)."
    },
    {
      "name": "event-lifecycle",
      "item": [
        {
          "name": "Upload an event cover image (API key or staff JWT + x-tenant-id)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId/cover",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId",
                "cover"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                }
              ]
            },
            "description": "ENG-501 — store a JPEG/PNG/WebP (≤5 MiB) in AXYN object storage and write event.hero_image_url in the same request. Magic-byte sniff; tenant from the API key / staff context. Headless partners with their own CDN may PATCH hero_image_url instead."
          }
        },
        {
          "name": "Issue a draft preview token (API key or staff JWT + x-tenant-id)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId/preview-tokens",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId",
                "preview-tokens"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                }
              ]
            },
            "description": "M13 (OD2.5) — issue a 32-byte bearer token that lets a non-account collaborator preview a draft event. Rate-limited on the public preview endpoint.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"expires_in_hours\": 0,\n  \"label\": \"string\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Revoke a draft-preview token",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId/preview-tokens/revoke",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId",
                "preview-tokens",
                "revoke"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                }
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"token_id\": \"00000000-0000-0000-0000-000000000000\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Cancel an event (staff JWT required for attribution; dual-auth gate)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId/cancel",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId",
                "cancel"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                }
              ]
            },
            "description": "M46h / T-136 — organizer force-majeure cancellation. Dual-auth gate: API key `catalog:write` or staff JWT `event.cancel` + `x-tenant-id`. Declaration still requires a staff JWT for `declared_by` attribution. Pins HF-028 SLA targets and flips event.status to cancelled.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"force_majeure_reason\": \"string\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "List terminal mass-refund dead-letter failures for an event",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId/mass-refund-failures?limit={{limit}}&offset={{offset}}",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId",
                "mass-refund-failures"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "{{limit}}"
                },
                {
                  "key": "offset",
                  "value": "{{offset}}"
                }
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                }
              ]
            },
            "description": "M46n — organizer read of `mass_refund_failures` for the event's latest cancellation. Dual-auth: API key `catalog:read` or staff JWT `event.read` + `x-tenant-id`. List filters to linked refund requests still `failed`; use POST …/retry (ENG-510) to requeue."
          }
        },
        {
          "name": "Requeue a terminal mass-refund failure for another Stripe attempt",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId/mass-refund-failures/:failureId/retry",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId",
                "mass-refund-failures",
                ":failureId",
                "retry"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                },
                {
                  "key": "failureId",
                  "value": "{{failureId}}"
                }
              ]
            },
            "description": "ENG-510 — flips the linked `ticket_refund_requests` row back to `approved` and reopens the cancellation refund drain when needed. Dual-auth: API key `catalog:write` or staff JWT `event.cancel` + `x-tenant-id`. Keeps the `mass_refund_failures` audit row."
          }
        },
        {
          "name": "Read the event listing gallery",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId/gallery",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId",
                "gallery"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                }
              ]
            },
            "description": "ENG-1667 — the listing mosaic (images plus allowlisted video) an organizer edits. A listing is a series or an independent event; a child show has no gallery of its own."
          }
        },
        {
          "name": "Replace the event listing gallery",
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId/gallery",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId",
                "gallery"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                }
              ]
            },
            "description": "ENG-1667 — replaces the whole gallery. Array order is the order guests see. Send an empty array to clear it. Up to 12 items. Every image_url must be one AXYN stored for this tenant.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"items\": [\n    {\n      \"kind\": \"image\"\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Upload one event listing gallery photo",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId/gallery/images",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId",
                "gallery",
                "images"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                }
              ]
            },
            "description": "ENG-1667 — store a JPEG/PNG/WebP (5 MiB or smaller, 4096 px or fewer on the long edge) and return its URL plus intrinsic size. Magic-byte sniff; the client Content-Type is ignored. Send the returned image_url back in the gallery PUT."
          }
        }
      ],
      "description": "Event cancellation + draft preview tokens (organizer surfaces)."
    },
    {
      "name": "estate-claims",
      "item": [
        {
          "name": "Submit a public estate claim on a deceased buyer's order",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/estate-claims",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "estate-claims"
              ]
            },
            "description": "M28f — D12.1 buyer death / estate handling. NO auth — the claimant is, by definition, NOT an AXYN account holder. Tenant is derived server-side from the order row.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"order_id\": \"00000000-0000-0000-0000-000000000000\",\n  \"claimant_name\": \"string\",\n  \"claimant_email\": \"string\",\n  \"claimant_relationship\": \"string\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        }
      ],
      "description": "Public estate-claim intake (D12.1 buyer death / estate handling)."
    },
    {
      "name": "account-recovery",
      "item": [
        {
          "name": "Submit a public account-recovery request",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/auth/account-recovery/request",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "auth",
                "account-recovery",
                "request"
              ]
            },
            "description": "M28g — D12.3 identity stolen / account compromised. NO auth — by definition the user whose credentials are compromised cannot present a valid JWT.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"recovery_email\": \"string\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        }
      ],
      "description": "Public account-recovery request intake (D12.3 identity stolen)."
    },
    {
      "name": "fraud-claims",
      "item": [
        {
          "name": "Submit a fraud claim for a ticket",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/fraud-claims",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "fraud-claims"
              ]
            },
            "description": "M28h — authenticated fraud-claim submission. Tenant is derived from the ticket row server-side; an unknown ticket collapses to opaque ticket_not_found.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"ticket_id\": \"00000000-0000-0000-0000-000000000000\",\n  \"description\": \"string\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        }
      ],
      "description": "Authenticated fraud-claim intake (D12.10 stolen ticket)."
    },
    {
      "name": "group-sales",
      "item": [
        {
          "name": "Submit an above-cap group-sales request",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/group-sales-requests",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "group-sales-requests"
              ]
            },
            "description": "M23-group-sales — public above-cap group-sales request intake (D3.3). Unauthenticated; no tenant API key. Tenant + venue_event derived server-side from `ticket_tier_id` (tier id is the credential). Idempotent on open `(ticket_tier_id, requester_email)` → `group_sales_request_already_submitted` (200).",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"ticket_tier_id\": \"00000000-0000-0000-0000-000000000000\",\n  \"requester_name\": \"string\",\n  \"requester_email\": \"string\",\n  \"quantity_desired\": 0\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        }
      ],
      "description": "Above-cap group-sales request intake (public)."
    },
    {
      "name": "upgrades",
      "item": [
        {
          "name": "List allowed upgrade paths for an event",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tenants/:tenantId/events/:eventId/tier-upgrade-paths",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tenants",
                ":tenantId",
                "events",
                ":eventId",
                "tier-upgrade-paths"
              ],
              "variable": [
                {
                  "key": "tenantId",
                  "value": "{{tenantId}}"
                },
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                }
              ]
            },
            "description": "ENG-813 / ENG-798. Empty list means buyer upgrades are off. Staff JWT with tier_upgrade_path.manage."
          }
        },
        {
          "name": "Allow a source type to upgrade into a target type",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tenants/:tenantId/events/:eventId/tier-upgrade-paths",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tenants",
                ":tenantId",
                "events",
                ":eventId",
                "tier-upgrade-paths"
              ],
              "variable": [
                {
                  "key": "tenantId",
                  "value": "{{tenantId}}"
                },
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                }
              ]
            },
            "description": "ENG-813 / ENG-798. source_tier_id and target_tier_id required. Optional upgrade_deadline_hours_before_event (0-8760).",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"source_tier_id\": \"00000000-0000-0000-0000-000000000000\",\n  \"target_tier_id\": \"00000000-0000-0000-0000-000000000000\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Remove an allowed upgrade path",
          "request": {
            "method": "DELETE",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tenants/:tenantId/events/:eventId/tier-upgrade-paths/:pathId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tenants",
                ":tenantId",
                "events",
                ":eventId",
                "tier-upgrade-paths",
                ":pathId"
              ],
              "variable": [
                {
                  "key": "tenantId",
                  "value": "{{tenantId}}"
                },
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                },
                {
                  "key": "pathId",
                  "value": "{{pathId}}"
                }
              ]
            },
            "description": "Blocks new buyer intents. Already-issued upgrade requests stay snapshot-immutable."
          }
        },
        {
          "name": "List event attendees",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tenants/:tenantId/attendees?event_id={{event_id}}&production_id={{production_id}}&upgraded={{upgraded}}",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tenants",
                ":tenantId",
                "attendees"
              ],
              "query": [
                {
                  "key": "event_id",
                  "value": "{{event_id}}"
                },
                {
                  "key": "production_id",
                  "value": "{{production_id}}"
                },
                {
                  "key": "upgraded",
                  "value": "{{upgraded}}"
                }
              ],
              "variable": [
                {
                  "key": "tenantId",
                  "value": "{{tenantId}}"
                }
              ]
            },
            "description": "ENG-813 / ENG-795 / ENG-1643. Provide event_id XOR production_id. event_id is This-show (hosted tickets plus passes that admit that night). production_id is the whole run: every ticket on an order sold under the series (ENG-2332), plus tickets with no order on its programs; a pass holder appears once. upgraded=true returns only passes that completed a self-serve upgrade. Rows include upgrade_from_tier_name, upgrade_to_tier_name, upgrade_delta_cents, upgraded_at, upgrade_paid_by. CSV export of the same columns is GET /v1/tenants/{tenantId}/exports/attendees."
          }
        },
        {
          "name": "Create a 72h guest upgrade link",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tenants/:tenantId/tickets/:ticketId/upgrade-invites",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tenants",
                ":tenantId",
                "tickets",
                ":ticketId",
                "upgrade-invites"
              ],
              "variable": [
                {
                  "key": "tenantId",
                  "value": "{{tenantId}}"
                },
                {
                  "key": "ticketId",
                  "value": "{{ticketId}}"
                }
              ]
            },
            "description": "ENG-801. Bound to ticket_id + tenant. Does not remint the Live Pass. Optional target_tier_id skips the picker. send_email emails the guest.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"target_tier_id\": \"00000000-0000-0000-0000-000000000000\",\n  \"send_email\": false\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Create a tier-upgrade intent for a ticket",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/me/tickets/:ticketId/upgrade-requests",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "me",
                "tickets",
                ":ticketId",
                "upgrade-requests"
              ],
              "variable": [
                {
                  "key": "ticketId",
                  "value": "{{ticketId}}"
                }
              ]
            },
            "description": "M24c — snapshots source total_paid + target tier price under row locks; substrate only, no Stripe charge.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"target_tier_id\": \"00000000-0000-0000-0000-000000000000\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Cancel an open tier-upgrade request",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/me/tickets/:ticketId/upgrade-requests/cancel",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "me",
                "tickets",
                ":ticketId",
                "upgrade-requests",
                "cancel"
              ],
              "variable": [
                {
                  "key": "ticketId",
                  "value": "{{ticketId}}"
                }
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"upgrade_request_id\": \"00000000-0000-0000-0000-000000000000\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Pay the all-in upgrade delta",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/me/tickets/:ticketId/upgrade-requests/:requestId/pay",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "me",
                "tickets",
                ":ticketId",
                "upgrade-requests",
                ":requestId",
                "pay"
              ],
              "variable": [
                {
                  "key": "ticketId",
                  "value": "{{ticketId}}"
                },
                {
                  "key": "requestId",
                  "value": "{{requestId}}"
                }
              ]
            },
            "description": "ENG-793 — creates a PaymentIntent for due_now = all_in(target) minus remaining_net. Webhook fulfill moves the same pass in place (ENG-811). Do not charge the face-only intent snapshot."
          }
        },
        {
          "name": "List all-in upgrade options for a ticket",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/me/tickets/:ticketId/upgrade-options",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "me",
                "tickets",
                ":ticketId",
                "upgrade-options"
              ],
              "variable": [
                {
                  "key": "ticketId",
                  "value": "{{ticketId}}"
                }
              ]
            },
            "description": "ENG-794 — eligible target types with perks and due_now_cents (all-in target minus remaining_net). Hide Upgrade when available is false."
          }
        },
        {
          "name": "List all-in upgrade options from a ticket-url bearer",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/v1/ticket-url/:token/upgrade-options",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "ticket-url",
                ":token",
                "upgrade-options"
              ],
              "variable": [
                {
                  "key": "token",
                  "value": "{{token}}"
                }
              ]
            },
            "description": "Guest upgrade quote. Ticket-url bearer proves holdership; no buyer JWT."
          }
        },
        {
          "name": "Issue a tier-upgrade intent from a ticket-url bearer",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/ticket-url/:token/upgrade-requests",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "ticket-url",
                ":token",
                "upgrade-requests"
              ],
              "variable": [
                {
                  "key": "token",
                  "value": "{{token}}"
                }
              ]
            },
            "description": "Guest upgrade issue. Ticket-url bearer proves holdership; no buyer JWT.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"target_tier_id\": \"00000000-0000-0000-0000-000000000000\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Cancel an open upgrade request from a ticket-url bearer",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/ticket-url/:token/upgrade-requests/cancel",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "ticket-url",
                ":token",
                "upgrade-requests",
                "cancel"
              ],
              "variable": [
                {
                  "key": "token",
                  "value": "{{token}}"
                }
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"cancel_reason\": \"string\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Pay the all-in upgrade delta from a ticket-url bearer",
          "request": {
            "method": "POST",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/v1/ticket-url/:token/upgrade-requests/:requestId/pay",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "ticket-url",
                ":token",
                "upgrade-requests",
                ":requestId",
                "pay"
              ],
              "variable": [
                {
                  "key": "token",
                  "value": "{{token}}"
                },
                {
                  "key": "requestId",
                  "value": "{{requestId}}"
                }
              ]
            },
            "description": "Guest upgrade pay. Returns Stripe client_secret and due_now_cents."
          }
        },
        {
          "name": "Read a staff upgrade invite",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/v1/upgrade-invites/:token",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "upgrade-invites",
                ":token"
              ],
              "variable": [
                {
                  "key": "token",
                  "value": "{{token}}"
                }
              ]
            },
            "description": "ENG-801 guest-first. 410 when expired. already_upgraded true means do not charge again."
          }
        },
        {
          "name": "Issue an upgrade from a staff invite",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/upgrade-invites/:token/upgrade-requests",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "upgrade-invites",
                ":token",
                "upgrade-requests"
              ],
              "variable": [
                {
                  "key": "token",
                  "value": "{{token}}"
                }
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"target_tier_id\": \"00000000-0000-0000-0000-000000000000\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Cancel an invite upgrade request",
          "request": {
            "method": "POST",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/v1/upgrade-invites/:token/upgrade-requests/cancel",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "upgrade-invites",
                ":token",
                "upgrade-requests",
                "cancel"
              ],
              "variable": [
                {
                  "key": "token",
                  "value": "{{token}}"
                }
              ]
            }
          }
        },
        {
          "name": "Start Stripe pay for an invite upgrade",
          "request": {
            "method": "POST",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/v1/upgrade-invites/:token/upgrade-requests/:requestId/pay",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "upgrade-invites",
                ":token",
                "upgrade-requests",
                ":requestId",
                "pay"
              ],
              "variable": [
                {
                  "key": "token",
                  "value": "{{token}}"
                },
                {
                  "key": "requestId",
                  "value": "{{requestId}}"
                }
              ]
            }
          }
        }
      ],
      "description": "Guest-first and signed-in ticket upgrades, plus organizer path CRUD. Same Live Pass URL after pay."
    },
    {
      "name": "accreditation",
      "item": [
        {
          "name": "Accreditation tab summary",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId/accreditation",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId",
                "accreditation"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                }
              ]
            },
            "description": "Enabled classes and applications awaiting a decision (pending + waitlisted). Drives tab visibility and its badge."
          }
        },
        {
          "name": "List accreditation classes",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId/accreditation-classes",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId",
                "accreditation-classes"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                }
              ]
            },
            "description": "Classes with form, counts, capacity and copyable apply link."
          }
        },
        {
          "name": "Create an accreditation class",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId/accreditation-classes",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId",
                "accreditation-classes"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                }
              ]
            },
            "description": "Binds a hidden ticket type. Result codes: tier_not_found, tier_not_hidden, hold_not_found, duplicate_class_name, class_limit_reached, invalid_*.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"ticket_tier_id\": \"00000000-0000-0000-0000-000000000000\",\n  \"name\": \"string\",\n  \"description\": \"string\",\n  \"enabled\": false,\n  \"applications_close_at\": \"2030-01-01T00:00:00.000Z\",\n  \"max_approved\": 0,\n  \"comp_hold_id\": \"00000000-0000-0000-0000-000000000000\",\n  \"questions\": [\n    {\n      \"prompt\": \"string\",\n      \"answer_kind\": \"short_text\"\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Get an accreditation class",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId/accreditation-classes/:classId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId",
                "accreditation-classes",
                ":classId"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                },
                {
                  "key": "classId",
                  "value": "{{classId}}"
                }
              ]
            }
          }
        },
        {
          "name": "Update an accreditation class",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId/accreditation-classes/:classId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId",
                "accreditation-classes",
                ":classId"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                },
                {
                  "key": "classId",
                  "value": "{{classId}}"
                }
              ]
            },
            "description": "Partial update. Closing or disabling stops new submits; open applications stay decidable. Result codes: tier_locked (a pass was issued), question_locked (answered question kind/options changed or removed).",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"ticket_tier_id\": \"00000000-0000-0000-0000-000000000000\",\n  \"name\": \"string\",\n  \"description\": \"string\",\n  \"enabled\": false,\n  \"applications_close_at\": \"2030-01-01T00:00:00.000Z\",\n  \"max_approved\": 0,\n  \"comp_hold_id\": \"00000000-0000-0000-0000-000000000000\",\n  \"questions\": [\n    {\n      \"prompt\": \"string\",\n      \"answer_kind\": \"short_text\"\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Delete an accreditation class",
          "request": {
            "method": "DELETE",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId/accreditation-classes/:classId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId",
                "accreditation-classes",
                ":classId"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                },
                {
                  "key": "classId",
                  "value": "{{classId}}"
                }
              ]
            },
            "description": "Only while nobody has applied (class_has_applications). Otherwise disable it."
          }
        },
        {
          "name": "Replace the apply link",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId/accreditation-classes/:classId/rotate-link",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId",
                "accreditation-classes",
                ":classId",
                "rotate-link"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                },
                {
                  "key": "classId",
                  "value": "{{classId}}"
                }
              ]
            },
            "description": "The old link stops accepting submits immediately. Existing applications are unaffected."
          }
        },
        {
          "name": "List applications",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId/accreditation-applications?class_id={{class_id}}&status={{status}}&q={{q}}&limit={{limit}}&cursor={{cursor}}",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId",
                "accreditation-applications"
              ],
              "query": [
                {
                  "key": "class_id",
                  "value": "{{class_id}}"
                },
                {
                  "key": "status",
                  "value": "{{status}}"
                },
                {
                  "key": "q",
                  "value": "{{q}}"
                },
                {
                  "key": "limit",
                  "value": "{{limit}}"
                },
                {
                  "key": "cursor",
                  "value": "{{cursor}}"
                }
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                }
              ]
            },
            "description": "Newest first, with answers. Cursor-paginated."
          }
        },
        {
          "name": "Export applications as CSV",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId/accreditation-applications/export?class_id={{class_id}}&status={{status}}&q={{q}}",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId",
                "accreditation-applications",
                "export"
              ],
              "query": [
                {
                  "key": "class_id",
                  "value": "{{class_id}}"
                },
                {
                  "key": "status",
                  "value": "{{status}}"
                },
                {
                  "key": "q",
                  "value": "{{q}}"
                }
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                }
              ]
            },
            "description": "Same filters as the list; one column per question. Cells that could run as spreadsheet formulas are quoted."
          }
        },
        {
          "name": "Approve, deny or waitlist many",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId/accreditation-applications/decisions",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId",
                "accreditation-applications",
                "decisions"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                }
              ]
            },
            "description": "Up to 100, applied in order, each on its own. Approvals past the class cap report class_capacity_reached.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"action\": \"approve\",\n  \"application_ids\": [\n    \"00000000-0000-0000-0000-000000000000\"\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Get an application",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId/accreditation-applications/:applicationId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId",
                "accreditation-applications",
                ":applicationId"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                },
                {
                  "key": "applicationId",
                  "value": "{{applicationId}}"
                }
              ]
            },
            "description": "Answers, internal notes and the decision trail."
          }
        },
        {
          "name": "Fix the applicant email",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId/accreditation-applications/:applicationId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId",
                "accreditation-applications",
                ":applicationId"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                },
                {
                  "key": "applicationId",
                  "value": "{{applicationId}}"
                }
              ]
            },
            "description": "Only while pending or waitlisted. The new address gets a fresh status link; old links stop working.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"applicant_email\": \"string\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Approve, deny, waitlist or revoke",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId/accreditation-applications/:applicationId/decision",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId",
                "accreditation-applications",
                ":applicationId",
                "decision"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                },
                {
                  "key": "applicationId",
                  "value": "{{applicationId}}"
                }
              ]
            },
            "description": "approve issues exactly one Live Pass (no payment, no coupon, no card check). deny/waitlist/revoke email the applicant. revoke voids the pass and needs a signed-in staff user (staff_user_required). Result codes: already_approved, not_decidable, not_approved, class_capacity_reached, insufficient_hold_balance, insufficient_inventory, tier_not_active (the class's ticket type was archived or turned off), applicant_erased, ticket_already_redeemed.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"action\": \"approve\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Add an internal note",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events/:eventId/accreditation-applications/:applicationId/notes",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events",
                ":eventId",
                "accreditation-applications",
                ":applicationId",
                "notes"
              ],
              "variable": [
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                },
                {
                  "key": "applicationId",
                  "value": "{{applicationId}}"
                }
              ]
            },
            "description": "Staff only. Never shown to the applicant.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"body\": \"string\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Accreditation tab summary",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/productions/:productionId/accreditation",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "productions",
                ":productionId",
                "accreditation"
              ],
              "variable": [
                {
                  "key": "productionId",
                  "value": "{{productionId}}"
                }
              ]
            },
            "description": "Enabled classes and applications awaiting a decision (pending + waitlisted). Drives tab visibility and its badge."
          }
        },
        {
          "name": "List accreditation classes",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/productions/:productionId/accreditation-classes",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "productions",
                ":productionId",
                "accreditation-classes"
              ],
              "variable": [
                {
                  "key": "productionId",
                  "value": "{{productionId}}"
                }
              ]
            },
            "description": "Classes with form, counts, capacity and copyable apply link."
          }
        },
        {
          "name": "Create an accreditation class",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/productions/:productionId/accreditation-classes",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "productions",
                ":productionId",
                "accreditation-classes"
              ],
              "variable": [
                {
                  "key": "productionId",
                  "value": "{{productionId}}"
                }
              ]
            },
            "description": "Binds a hidden ticket type. Result codes: tier_not_found, tier_not_hidden, hold_not_found, duplicate_class_name, class_limit_reached, invalid_*.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"ticket_tier_id\": \"00000000-0000-0000-0000-000000000000\",\n  \"name\": \"string\",\n  \"description\": \"string\",\n  \"enabled\": false,\n  \"applications_close_at\": \"2030-01-01T00:00:00.000Z\",\n  \"max_approved\": 0,\n  \"comp_hold_id\": \"00000000-0000-0000-0000-000000000000\",\n  \"questions\": [\n    {\n      \"prompt\": \"string\",\n      \"answer_kind\": \"short_text\"\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Get an accreditation class",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/productions/:productionId/accreditation-classes/:classId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "productions",
                ":productionId",
                "accreditation-classes",
                ":classId"
              ],
              "variable": [
                {
                  "key": "productionId",
                  "value": "{{productionId}}"
                },
                {
                  "key": "classId",
                  "value": "{{classId}}"
                }
              ]
            }
          }
        },
        {
          "name": "Update an accreditation class",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/productions/:productionId/accreditation-classes/:classId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "productions",
                ":productionId",
                "accreditation-classes",
                ":classId"
              ],
              "variable": [
                {
                  "key": "productionId",
                  "value": "{{productionId}}"
                },
                {
                  "key": "classId",
                  "value": "{{classId}}"
                }
              ]
            },
            "description": "Partial update. Closing or disabling stops new submits; open applications stay decidable. Result codes: tier_locked (a pass was issued), question_locked (answered question kind/options changed or removed).",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"ticket_tier_id\": \"00000000-0000-0000-0000-000000000000\",\n  \"name\": \"string\",\n  \"description\": \"string\",\n  \"enabled\": false,\n  \"applications_close_at\": \"2030-01-01T00:00:00.000Z\",\n  \"max_approved\": 0,\n  \"comp_hold_id\": \"00000000-0000-0000-0000-000000000000\",\n  \"questions\": [\n    {\n      \"prompt\": \"string\",\n      \"answer_kind\": \"short_text\"\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Delete an accreditation class",
          "request": {
            "method": "DELETE",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/productions/:productionId/accreditation-classes/:classId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "productions",
                ":productionId",
                "accreditation-classes",
                ":classId"
              ],
              "variable": [
                {
                  "key": "productionId",
                  "value": "{{productionId}}"
                },
                {
                  "key": "classId",
                  "value": "{{classId}}"
                }
              ]
            },
            "description": "Only while nobody has applied (class_has_applications). Otherwise disable it."
          }
        },
        {
          "name": "Replace the apply link",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/productions/:productionId/accreditation-classes/:classId/rotate-link",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "productions",
                ":productionId",
                "accreditation-classes",
                ":classId",
                "rotate-link"
              ],
              "variable": [
                {
                  "key": "productionId",
                  "value": "{{productionId}}"
                },
                {
                  "key": "classId",
                  "value": "{{classId}}"
                }
              ]
            },
            "description": "The old link stops accepting submits immediately. Existing applications are unaffected."
          }
        },
        {
          "name": "List applications",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/productions/:productionId/accreditation-applications?class_id={{class_id}}&status={{status}}&q={{q}}&limit={{limit}}&cursor={{cursor}}",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "productions",
                ":productionId",
                "accreditation-applications"
              ],
              "query": [
                {
                  "key": "class_id",
                  "value": "{{class_id}}"
                },
                {
                  "key": "status",
                  "value": "{{status}}"
                },
                {
                  "key": "q",
                  "value": "{{q}}"
                },
                {
                  "key": "limit",
                  "value": "{{limit}}"
                },
                {
                  "key": "cursor",
                  "value": "{{cursor}}"
                }
              ],
              "variable": [
                {
                  "key": "productionId",
                  "value": "{{productionId}}"
                }
              ]
            },
            "description": "Newest first, with answers. Cursor-paginated."
          }
        },
        {
          "name": "Export applications as CSV",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/productions/:productionId/accreditation-applications/export?class_id={{class_id}}&status={{status}}&q={{q}}",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "productions",
                ":productionId",
                "accreditation-applications",
                "export"
              ],
              "query": [
                {
                  "key": "class_id",
                  "value": "{{class_id}}"
                },
                {
                  "key": "status",
                  "value": "{{status}}"
                },
                {
                  "key": "q",
                  "value": "{{q}}"
                }
              ],
              "variable": [
                {
                  "key": "productionId",
                  "value": "{{productionId}}"
                }
              ]
            },
            "description": "Same filters as the list; one column per question. Cells that could run as spreadsheet formulas are quoted."
          }
        },
        {
          "name": "Approve, deny or waitlist many",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/productions/:productionId/accreditation-applications/decisions",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "productions",
                ":productionId",
                "accreditation-applications",
                "decisions"
              ],
              "variable": [
                {
                  "key": "productionId",
                  "value": "{{productionId}}"
                }
              ]
            },
            "description": "Up to 100, applied in order, each on its own. Approvals past the class cap report class_capacity_reached.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"action\": \"approve\",\n  \"application_ids\": [\n    \"00000000-0000-0000-0000-000000000000\"\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Get an application",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/productions/:productionId/accreditation-applications/:applicationId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "productions",
                ":productionId",
                "accreditation-applications",
                ":applicationId"
              ],
              "variable": [
                {
                  "key": "productionId",
                  "value": "{{productionId}}"
                },
                {
                  "key": "applicationId",
                  "value": "{{applicationId}}"
                }
              ]
            },
            "description": "Answers, internal notes and the decision trail."
          }
        },
        {
          "name": "Fix the applicant email",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/productions/:productionId/accreditation-applications/:applicationId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "productions",
                ":productionId",
                "accreditation-applications",
                ":applicationId"
              ],
              "variable": [
                {
                  "key": "productionId",
                  "value": "{{productionId}}"
                },
                {
                  "key": "applicationId",
                  "value": "{{applicationId}}"
                }
              ]
            },
            "description": "Only while pending or waitlisted. The new address gets a fresh status link; old links stop working.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"applicant_email\": \"string\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Approve, deny, waitlist or revoke",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/productions/:productionId/accreditation-applications/:applicationId/decision",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "productions",
                ":productionId",
                "accreditation-applications",
                ":applicationId",
                "decision"
              ],
              "variable": [
                {
                  "key": "productionId",
                  "value": "{{productionId}}"
                },
                {
                  "key": "applicationId",
                  "value": "{{applicationId}}"
                }
              ]
            },
            "description": "approve issues exactly one Live Pass (no payment, no coupon, no card check). deny/waitlist/revoke email the applicant. revoke voids the pass and needs a signed-in staff user (staff_user_required). Result codes: already_approved, not_decidable, not_approved, class_capacity_reached, insufficient_hold_balance, insufficient_inventory, tier_not_active (the class's ticket type was archived or turned off), applicant_erased, ticket_already_redeemed.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"action\": \"approve\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Add an internal note",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/productions/:productionId/accreditation-applications/:applicationId/notes",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "productions",
                ":productionId",
                "accreditation-applications",
                ":applicationId",
                "notes"
              ],
              "variable": [
                {
                  "key": "productionId",
                  "value": "{{productionId}}"
                },
                {
                  "key": "applicationId",
                  "value": "{{applicationId}}"
                }
              ]
            },
            "description": "Staff only. Never shown to the applicant.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"body\": \"string\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Apply form for a link",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/v1/accreditation/apply/:applyToken",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "accreditation",
                "apply",
                ":applyToken"
              ],
              "variable": [
                {
                  "key": "applyToken",
                  "value": "{{applyToken}}"
                }
              ]
            },
            "description": "No API key. The apply link is the credential. Unknown, rotated or foreign tokens (coupon codes, access codes, allocation links) are 404."
          }
        },
        {
          "name": "Submit an application",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/accreditation/apply/:applyToken/applications",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "accreditation",
                "apply",
                ":applyToken",
                "applications"
              ],
              "variable": [
                {
                  "key": "applyToken",
                  "value": "{{applyToken}}"
                }
              ]
            },
            "description": "No API key. Returns reference_code and a status_token (keep it; send it as X-Accreditation-Status-Token). A second submit by the same email while pending/waitlisted/approved returns already_submitted with the same reference and emails the status link to that address. Rate limited per IP and per email.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"applicant_name\": \"string\",\n  \"applicant_email\": \"string\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Application status",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Accreditation-Status-Token",
                "value": "{{X-Accreditation-Status-Token}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/accreditation/applications/:reference",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "accreditation",
                "applications",
                ":reference"
              ],
              "variable": [
                {
                  "key": "reference",
                  "value": "{{reference}}"
                }
              ]
            },
            "description": "Requires the status token header. Wrong token, wrong reference and missing application are the same 404."
          }
        },
        {
          "name": "Withdraw an application",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "X-Accreditation-Status-Token",
                "value": "{{X-Accreditation-Status-Token}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/accreditation/applications/:reference/withdraw",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "accreditation",
                "applications",
                ":reference",
                "withdraw"
              ],
              "variable": [
                {
                  "key": "reference",
                  "value": "{{reference}}"
                }
              ]
            },
            "description": "Pending or waitlisted only."
          }
        },
        {
          "name": "Email me my status link",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/accreditation/status-link",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "accreditation",
                "status-link"
              ]
            },
            "description": "Always 202 whether or not the address applied. The link goes only to the address on file. Send reference_code, or the apply_token of the class.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"applicant_email\": \"string\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        }
      ],
      "description": "ENG-1591 accreditation classes and applications"
    },
    {
      "name": "events",
      "item": [
        {
          "name": "List events for the authenticated tenant",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/events?status={{status}}&limit={{limit}}&offset={{offset}}",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "events"
              ],
              "query": [
                {
                  "key": "status",
                  "value": "{{status}}"
                },
                {
                  "key": "limit",
                  "value": "{{limit}}"
                },
                {
                  "key": "offset",
                  "value": "{{offset}}"
                }
              ]
            },
            "description": "M46c dual-auth: tenant API key with `catalog:read`, or staff JWT with `event.read` plus `x-tenant-id`. A tenant API key reads the buyer sale state, as on event detail and discovery: an on-sale event whose organizer's payment setup cannot take charges lists as `status: paused` with `sales_paused_reason`, and `status=on_sale` omits it. Staff JWT reads and filters the stored status."
          }
        }
      ]
    },
    {
      "name": "settlement",
      "item": [
        {
          "name": "Reconcile a Stripe payout batch to its orders",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tenants/:tenantId/settlement/payouts/:stripePayoutId/reconcile",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tenants",
                ":tenantId",
                "settlement",
                "payouts",
                ":stripePayoutId",
                "reconcile"
              ],
              "variable": [
                {
                  "key": "tenantId",
                  "value": "{{tenantId}}"
                },
                {
                  "key": "stripePayoutId",
                  "value": "{{stripePayoutId}}"
                }
              ]
            },
            "description": "ENG-221 T4: join connect_payout_charge_link (BalanceTransactions on payout.paid) to ticket_payments/orders vs payout amount. Tolerance documented as 1 cent. ENG-2751: one line per charge in the payout (an order's own charge, or a paid upgrade's own charge, found by its PaymentIntent), each read like a statement. `gross_cents` = everything the buyer was charged on that charge, tax included; `tax_cents`; `platform_fee_cents` = the AXYN fee Stripe took; `processing_fee_cents` = the card processing Stripe took; `refunds_cents` = refunds Stripe took out in this payout on that charge (a refund failure Stripe put back counts negative); `fee_refunds_cents` = AXYN fee Stripe returned in this payout; `adjustment_cents` = processing true-up (+ returned in this payout, - owed); ENG-2770: a refund or fee return whose charge paid out earlier gets a line with `charge_id` null, and one whose charge is no order of the tenant stays a `refunds` / `adjustments` composition line; `dispute_cents` / `dispute_fee_cents` = disputed money and dispute fees whose balance transactions this payout holds, net of reinstatements (an order whose charge paid out earlier gets a line with `charge_id` null); `net_cents` = gross - tax - platform fee - processing - refunds + fee refunds + adjustment - dispute - dispute fee. `axyn_*_cents` totals are the sums of the lines. `axyn_expected_payout_cents` = `axyn_net_cents` + `axyn_tax_cents`; `delta_cents` = payout - `axyn_expected_payout_cents`. ENG-2469: each line has `is_test` (AXYN marked the order as test); a test order stays in every line and total because its money is in the payout, and `axyn_test_orders_net_cents` is its share of `axyn_net_cents`."
          }
        },
        {
          "name": "CSV export of payout reconcile lines",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tenants/:tenantId/settlement/payouts/:stripePayoutId/reconcile.csv",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tenants",
                ":tenantId",
                "settlement",
                "payouts",
                ":stripePayoutId",
                "reconcile.csv"
              ],
              "variable": [
                {
                  "key": "tenantId",
                  "value": "{{tenantId}}"
                },
                {
                  "key": "stripePayoutId",
                  "value": "{{stripePayoutId}}"
                }
              ]
            },
            "description": "ENG-221 T4: CSV of the same lines as getTenantSettlementPayoutReconcile, with the same meanings. Columns in order: stripe_payout_id, order_id, charge_id, transfer_id, gross_cents, platform_fee_cents, processing_fee_cents, refunds_cents, net_cents, stripe_payout_amount_cents, delta_cents, within_tolerance, charge_cents, tax_cents, application_fee_cents, fee_refunds_cents, venue_fee_cents, adjustment_cents, dispute_cents, dispute_fee_cents, is_test (ENG-2469: true on an order AXYN marked as test). New columns are only ever appended."
          }
        },
        {
          "name": "Where the organizer's payout money is and when it reaches the bank",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tenants/:tenantId/settlement/payout-outlook?event_id={{event_id}}",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tenants",
                ":tenantId",
                "settlement",
                "payout-outlook"
              ],
              "query": [
                {
                  "key": "event_id",
                  "value": "{{event_id}}"
                }
              ],
              "variable": [
                {
                  "key": "tenantId",
                  "value": "{{tenantId}}"
                }
              ]
            },
            "description": "ENG-2357: staff JWT + settlement.read on the path tenant. Per series or standalone event: what is still in the Stripe balance, when the after-event payout job sends it (its own due date, waits and offsets), or why it waits. Approved tenants on Stripe's automatic schedule get the next payout day and the balance Stripe pays. Read-only. Viewer responses zero money fields and set viewer_masked. ENG-2376: on Stripe's schedule, available and pending come from one live Stripe balance read (5 s time limit, 60 s per-tenant cache); when Stripe errors or is slow, the stored balance snapshot answers with no clearing days. Each payout date carries its usual arrival (an estimate) or Stripe's own arrival_date. ENG-2375: event_id adds that event's own money as data.event."
          }
        },
        {
          "name": "Get Organizer Admin payout / settlement status",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tenants/:tenantId/settlement/payout-status",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tenants",
                ":tenantId",
                "settlement",
                "payout-status"
              ],
              "variable": [
                {
                  "key": "tenantId",
                  "value": "{{tenantId}}"
                }
              ]
            },
            "description": "ENG-221: staff JWT + settlement.read. Surfaces earned / in-transit / next / last / lifetime from Connect payout projections. Viewer responses zero money fields and set viewer_masked."
          }
        }
      ]
    },
    {
      "name": "on-sale-notify",
      "item": [
        {
          "name": "Ask to be emailed when a paused event is back on sale",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/on-sale-notify-requests",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "on-sale-notify-requests"
              ]
            },
            "description": "ENG-2257 — public, guest-first. Accepted only while buyers read the event as paused for organizer payout setup (`status: paused`, `sales_paused_reason: payout_not_ready`); every other state answers 409 `on_sale_notify_not_available`. Refused once the event's sales window has closed. The guest is emailed once when the event can be bought again (a ticket type inside its own sales window). New and repeat sign-ups answer the same 202. Rate-limited per IP + hashed email and per IP.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"event_id\": \"00000000-0000-0000-0000-000000000000\",\n  \"email\": \"string\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        }
      ]
    },
    {
      "name": "waitlist",
      "item": [
        {
          "name": "Join the sold-out GA waitlist",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/waitlist-joins",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "waitlist-joins"
              ]
            },
            "description": "ENG-1597 — public waitlist join. No payment or inventory hold. Whether the waitlist is open is the organizer's `event.waitlist_join_mode` (ENG-1598): `off` always refuses, `always` accepts while the sales window is open, and `sold_out` accepts only once no sellable units remain. An operational `paused` on the waitlist config refuses on top of that. Duplicate open ask returns already_joined (200).",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"venue_event_id\": \"00000000-0000-0000-0000-000000000000\",\n  \"ticket_tier_id\": \"00000000-0000-0000-0000-000000000000\",\n  \"email\": \"string\",\n  \"quantity\": 0\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Proof-gated waitlist status lookup",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/waitlist-status",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "waitlist-status"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"reference_id\": \"string\",\n  \"email\": \"string\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Resolve a waitlist claim token (no PaymentIntent)",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/v1/waitlist-claims/:token",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "waitlist-claims",
                ":token"
              ],
              "variable": [
                {
                  "key": "token",
                  "value": "{{token}}"
                }
              ]
            }
          }
        },
        {
          "name": "Bind purchaser and start Stripe checkout for a waitlist hold",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/waitlist-claims/:token/payments/start",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "waitlist-claims",
                ":token",
                "payments",
                "start"
              ],
              "variable": [
                {
                  "key": "token",
                  "value": "{{token}}"
                }
              ]
            }
          }
        },
        {
          "name": "Read waitlist config for an event",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tenants/:tenantId/events/:eventId/waitlist-config",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tenants",
                ":tenantId",
                "events",
                ":eventId",
                "waitlist-config"
              ],
              "variable": [
                {
                  "key": "tenantId",
                  "value": "{{tenantId}}"
                },
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                }
              ]
            },
            "description": "Read-only `join_mode` in the response echoes `event.waitlist_join_mode` (ENG-1598) so a client can tell whether guests may join without a second source of truth. It is changed on the event, not here; PATCH ignores it."
          }
        },
        {
          "name": "Update waitlist config for an event",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tenants/:tenantId/events/:eventId/waitlist-config",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tenants",
                ":tenantId",
                "events",
                ":eventId",
                "waitlist-config"
              ],
              "variable": [
                {
                  "key": "tenantId",
                  "value": "{{tenantId}}"
                },
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                }
              ]
            },
            "description": "Read-only `join_mode` in the response echoes `event.waitlist_join_mode` (ENG-1598) so a client can tell whether guests may join without a second source of truth. It is changed on the event, not here; PATCH ignores it.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"paused\": false,\n  \"mode\": \"manual\",\n  \"claim_ttl_seconds\": 0,\n  \"tier_bind_ids\": [\n    \"00000000-0000-0000-0000-000000000000\"\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "List waitlist entries for an event",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tenants/:tenantId/events/:eventId/waitlist-entries",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tenants",
                ":tenantId",
                "events",
                ":eventId",
                "waitlist-entries"
              ],
              "variable": [
                {
                  "key": "tenantId",
                  "value": "{{tenantId}}"
                },
                {
                  "key": "eventId",
                  "value": "{{eventId}}"
                }
              ]
            }
          }
        },
        {
          "name": "Create an idempotent waitlist offer with inventory soft-hold",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tenants/:tenantId/waitlist-entries/:entryId/offers",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tenants",
                ":tenantId",
                "waitlist-entries",
                ":entryId",
                "offers"
              ],
              "variable": [
                {
                  "key": "tenantId",
                  "value": "{{tenantId}}"
                },
                {
                  "key": "entryId",
                  "value": "{{entryId}}"
                }
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"kind\": \"exact_purchase\",\n  \"offered_tier_id\": \"00000000-0000-0000-0000-000000000000\",\n  \"quantity\": 0\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Remove a waitlist entry and release any hold",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tenants/:tenantId/waitlist-entries/:entryId/remove",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tenants",
                ":tenantId",
                "waitlist-entries",
                ":entryId",
                "remove"
              ],
              "variable": [
                {
                  "key": "tenantId",
                  "value": "{{tenantId}}"
                },
                {
                  "key": "entryId",
                  "value": "{{entryId}}"
                }
              ]
            }
          }
        }
      ]
    },
    {
      "name": "productions",
      "item": [
        {
          "name": "Read the series listing gallery",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/productions/:productionId/gallery",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "productions",
                ":productionId",
                "gallery"
              ],
              "variable": [
                {
                  "key": "productionId",
                  "value": "{{productionId}}"
                }
              ]
            },
            "description": "ENG-1667 — the listing mosaic (images plus allowlisted video) an organizer edits. A listing is a series or an independent event; a child show has no gallery of its own."
          }
        },
        {
          "name": "Replace the series listing gallery",
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/productions/:productionId/gallery",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "productions",
                ":productionId",
                "gallery"
              ],
              "variable": [
                {
                  "key": "productionId",
                  "value": "{{productionId}}"
                }
              ]
            },
            "description": "ENG-1667 — replaces the whole gallery. Array order is the order guests see. Send an empty array to clear it. Up to 12 items. Every image_url must be one AXYN stored for this tenant.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"items\": [\n    {\n      \"kind\": \"image\"\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Upload one series listing gallery photo",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{bearerToken}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/productions/:productionId/gallery/images",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "productions",
                ":productionId",
                "gallery",
                "images"
              ],
              "variable": [
                {
                  "key": "productionId",
                  "value": "{{productionId}}"
                }
              ]
            },
            "description": "ENG-1667 — store a JPEG/PNG/WebP (5 MiB or smaller, 4096 px or fewer on the long edge) and return its URL plus intrinsic size. Magic-byte sniff; the client Content-Type is ignored. Send the returned image_url back in the gallery PUT."
          }
        }
      ]
    },
    {
      "name": "claims",
      "item": [
        {
          "name": "List sessions this Live Pass can claim",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/v1/ticket-url/:token/claimable-sessions",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "ticket-url",
                ":token",
                "claimable-sessions"
              ],
              "variable": [
                {
                  "key": "token",
                  "value": "{{token}}"
                }
              ]
            },
            "description": "Ticket-url bearer proves holdership; no buyer JWT. Every miss is the same opaque 404."
          }
        },
        {
          "name": "Claim a session onto this Live Pass",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/ticket-url/:token/claims",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "ticket-url",
                ":token",
                "claims"
              ],
              "variable": [
                {
                  "key": "token",
                  "value": "{{token}}"
                }
              ]
            },
            "description": "Free claims land immediately. A paid claim reserves the seat and returns a Stripe client secret; the session attaches to the same Live Pass once the charge succeeds. No second QR is ever minted.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"claimable_session_id\": \"00000000-0000-0000-0000-000000000000\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Hand a claimed session back",
          "request": {
            "method": "DELETE",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/v1/ticket-url/:token/claims/:claimId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "ticket-url",
                ":token",
                "claims",
                ":claimId"
              ],
              "variable": [
                {
                  "key": "token",
                  "value": "{{token}}"
                },
                {
                  "key": "claimId",
                  "value": "{{claimId}}"
                }
              ]
            },
            "description": "Releases the seat while the organizer's release window is open. A paid claim is refunded first, and the session leaves this Live Pass."
          }
        }
      ]
    }
  ],
  "variable": [
    {
      "key": "baseUrl",
      "value": "http://localhost:4001"
    },
    {
      "key": "tenantApiKey",
      "value": ""
    },
    {
      "key": "bearerToken",
      "value": ""
    },
    {
      "key": "scannerToken",
      "value": ""
    },
    {
      "key": "Idempotency-Key",
      "value": ""
    }
  ]
}
