{ "openapi": "3.1.0", "info": { "title": "SeatLayer Server API", "version": "2026-08-31", "description": "SeatLayer public server-to-server seating and inventory API for Events, Performance Groups, and Fixed Renewable Seasons.", "contact": { "name": "SeatLayer support", "url": "https://seatlayer.io/contact/", "email": "hello@seatlayer.io" } }, "servers": [ { "url": "https://api.seatlayer.io" } ], "externalDocs": { "description": "SeatLayer developer documentation", "url": "https://docs.seatlayer.io/" }, "tags": [ { "name": "Health" }, { "name": "Charts" }, { "name": "Templates" }, { "name": "Events" }, { "name": "Inventory" }, { "name": "Reports" }, { "name": "Sales channels" }, { "name": "Buyer access" }, { "name": "Platform" }, { "name": "Webhooks" }, { "name": "Performance Groups" }, { "name": "Seasons" } ], "paths": { "/health/ready": { "get": { "operationId": "getReadiness", "summary": "Check API readiness and required dependencies", "tags": [ "Health" ], "externalDocs": { "url": "https://docs.seatlayer.io/start/going-live/" }, "security": [], "parameters": [ { "name": "deep", "description": "Set to 1 to include a deeper dependency probe.", "schema": { "type": "string", "enum": [ "1" ] }, "in": "query", "required": false } ], "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "readiness", "audience": "all", "limit": 30, "windowSeconds": 60, "bucket": "ip", "standardHeaders": false } ], "responses": { "200": { "description": "API and dependencies are ready or degraded.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReadinessReport" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per ip: 30 requests per 60 seconds, approximate.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "A required dependency is unavailable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReadinessReport" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } } } } }, "/v1/charts": { "get": { "operationId": "listCharts", "summary": "List charts in the account", "tags": [ "Charts" ], "externalDocs": { "url": "https://docs.seatlayer.io/designer/charts-and-objects/" }, "security": [ { "secretKey": [] } ], "parameters": [ { "name": "workspaceId", "description": "Active workspace id. Defaults to the caller workspace.", "schema": { "type": "string" }, "in": "query", "required": false }, { "name": "externalRef", "description": "Filter by the caller-owned external reference.", "schema": { "type": "string" }, "in": "query", "required": false }, { "name": "archived", "description": "Set to 1 for archived charts only.", "schema": { "type": "string", "enum": [ "1" ] }, "in": "query", "required": false }, { "name": "limit", "description": "Page size. Defaults to 100 and is capped at 200.", "schema": { "type": "integer", "minimum": 1, "maximum": 200 }, "in": "query", "required": false }, { "name": "cursor", "description": "Opaque cursor returned by the previous page.", "schema": { "type": "string" }, "in": "query", "required": false } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChartPage" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListChartsError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } } } }, "post": { "operationId": "createChart", "summary": "Create a chart", "tags": [ "Charts" ], "externalDocs": { "url": "https://docs.seatlayer.io/designer/charts-and-objects/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "header-replay", "x-seatlayer-automatic-retry": true, "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Stable key reused for retries of the same logical call.", "schema": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,128}$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChartCreateRequest" } } } }, "responses": { "201": { "description": "Chart created.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChartEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "400": { "description": "The request is malformed or misses a required value.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateChartError400" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateChartError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateChartError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateChartError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/charts/{chartId}": { "get": { "operationId": "retrieveChart", "summary": "Retrieve a chart and its document", "tags": [ "Charts" ], "externalDocs": { "url": "https://docs.seatlayer.io/designer/charts-and-objects/" }, "security": [ { "secretKey": [] } ], "parameters": [ { "name": "chartId", "in": "path", "required": true, "description": "Resource identifier.", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChartDocument" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetrieveChartError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } } } }, "put": { "operationId": "updateChart", "summary": "Replace a chart document (requires expectedUpdatedAt)", "tags": [ "Charts" ], "externalDocs": { "url": "https://docs.seatlayer.io/designer/charts-and-objects/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "unsupported", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "chartId", "in": "path", "required": true, "description": "Resource identifier.", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChartUpdateRequest" } } } }, "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChartSaveEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "400": { "description": "The request is malformed or misses a required value.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateChartError400" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateChartError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateChartError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateChartError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "413": { "description": "The request body exceeds the supported size.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateChartError413" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateChartError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } }, "delete": { "operationId": "deleteChart", "summary": "Delete a chart", "tags": [ "Charts" ], "externalDocs": { "url": "https://docs.seatlayer.io/designer/charts-and-objects/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "unsupported", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "chartId", "in": "path", "required": true, "description": "Resource identifier.", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeleteChartResult" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeleteChartError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeleteChartError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/charts/{chartId}/duplicate": { "post": { "operationId": "copyChart", "summary": "Copy a chart", "tags": [ "Charts" ], "externalDocs": { "url": "https://docs.seatlayer.io/designer/templates/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "header-replay", "x-seatlayer-automatic-retry": true, "parameters": [ { "name": "chartId", "in": "path", "required": true, "description": "Resource identifier.", "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Stable key reused for retries of the same logical call.", "schema": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,128}$" } } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChartCopyRequest" } } } }, "responses": { "201": { "description": "Chart copied.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChartEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "400": { "description": "The request is malformed or misses a required value.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CopyChartError400" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CopyChartError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CopyChartError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CopyChartError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CopyChartError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/charts/{chartId}/archive": { "post": { "operationId": "archiveChart", "summary": "Move a chart to the archive", "tags": [ "Charts" ], "externalDocs": { "url": "https://docs.seatlayer.io/designer/charts-and-objects/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "unsupported", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "chartId", "in": "path", "required": true, "description": "Resource identifier.", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChartEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ArchiveChartError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ArchiveChartError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/charts/{chartId}/unarchive": { "post": { "operationId": "unarchiveChart", "summary": "Restore a chart from the archive", "tags": [ "Charts" ], "externalDocs": { "url": "https://docs.seatlayer.io/designer/charts-and-objects/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "unsupported", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "chartId", "in": "path", "required": true, "description": "Resource identifier.", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChartEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnarchiveChartError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnarchiveChartError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/charts/{chartId}/publish": { "post": { "operationId": "publishChart", "summary": "Publish the chart draft so events can use it", "tags": [ "Charts" ], "externalDocs": { "url": "https://docs.seatlayer.io/designer/publishing-and-versioning/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "unsupported", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "chartId", "in": "path", "required": true, "description": "Resource identifier.", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublishChartResult" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublishChartError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublishChartError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublishChartError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublishChartError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/charts/{chartId}/panorama-manifests": { "post": { "operationId": "createPanoramaManifestJob", "summary": "Start a private panorama manifest ingest job for an exact chart draft revision", "tags": [ "Charts" ], "externalDocs": { "url": "https://docs.seatlayer.io/designer/charts-and-objects/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "unsupported", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "chartId", "in": "path", "required": true, "description": "chartId path parameter.", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PanoramaManifestCreateRequest" } } } }, "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "panorama-manifest-create", "audience": "secret-key", "limit": 10, "windowSeconds": 86400, "bucket": "org-chart", "standardHeaders": false } ], "responses": { "200": { "description": "An identical existing job was returned.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PanoramaManifestCreateResult" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "202": { "description": "Private processing job accepted.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PanoramaManifestCreateResult" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreatePanoramaManifestJobError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreatePanoramaManifestJobError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreatePanoramaManifestJobError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "413": { "description": "The request body exceeds the supported size.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreatePanoramaManifestJobError413" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreatePanoramaManifestJobError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per org-chart: 10 requests per 86400 seconds.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The service or one of its required dependencies is temporarily unavailable. The API can also be temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/CreatePanoramaManifestJobError503" }, { "$ref": "#/components/schemas/MaintenanceError" } ] } } } } } } }, "/v1/charts/{chartId}/panorama-manifests/{jobId}": { "get": { "operationId": "retrievePanoramaManifestJob", "summary": "Retrieve source-redacted panorama manifest processing status", "tags": [ "Charts" ], "externalDocs": { "url": "https://docs.seatlayer.io/designer/charts-and-objects/" }, "security": [ { "secretKey": [] } ], "parameters": [ { "name": "chartId", "in": "path", "required": true, "description": "chartId path parameter.", "schema": { "type": "string" } }, { "name": "jobId", "in": "path", "required": true, "description": "jobId path parameter.", "schema": { "type": "string" } } ], "x-seatlayer-response-cache": "no-store", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PanoramaManifestStatusResult" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetrievePanoramaManifestJobError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } } } } }, "/v1/templates/{templateId}/instantiate": { "post": { "operationId": "instantiateTemplate", "summary": "Instantiate a published template as a workspace chart draft", "tags": [ "Templates" ], "externalDocs": { "url": "https://docs.seatlayer.io/designer/templates/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "header-replay", "x-seatlayer-automatic-retry": true, "parameters": [ { "name": "templateId", "in": "path", "required": true, "description": "Published catalog template identifier.", "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Stable key reused for retries of the same logical call.", "schema": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,128}$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TemplateInstantiateRequest" } } } }, "responses": { "201": { "description": "Template instantiated as a draft chart.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChartEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "400": { "description": "The request is malformed or misses a required value.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InstantiateTemplateError400" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InstantiateTemplateError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InstantiateTemplateError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InstantiateTemplateError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "413": { "description": "The request body exceeds the supported size.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InstantiateTemplateError413" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InstantiateTemplateError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The service or one of its required dependencies is temporarily unavailable. The API can also be temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/InstantiateTemplateError503" }, { "$ref": "#/components/schemas/MaintenanceError" } ] } } } } } } }, "/v1/events": { "get": { "operationId": "listEvents", "summary": "List events", "tags": [ "Events" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/events/" }, "security": [ { "secretKey": [] } ], "parameters": [ { "name": "workspaceId", "description": "Active workspace id. Defaults to the caller workspace.", "schema": { "type": "string" }, "in": "query", "required": false }, { "name": "externalRef", "description": "Filter by the caller-owned external reference.", "schema": { "type": "string" }, "in": "query", "required": false }, { "name": "limit", "description": "Page size. Defaults to 100 and is capped at 200.", "schema": { "type": "integer", "minimum": 1, "maximum": 200 }, "in": "query", "required": false }, { "name": "cursor", "description": "Opaque cursor returned by the previous page.", "schema": { "type": "string" }, "in": "query", "required": false }, { "name": "counts", "description": "Set to 0 to omit inventory counts.", "schema": { "type": "string", "enum": [ "0" ] }, "in": "query", "required": false } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EventPage" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListEventsError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } } } }, "post": { "operationId": "createEvent", "summary": "Create an event from a published chart", "tags": [ "Events" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/events/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "header-replay", "x-seatlayer-automatic-retry": true, "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Stable key reused for retries of the same logical call.", "schema": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,128}$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EventCreateRequest" } } } }, "responses": { "201": { "description": "Event created.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EventEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "400": { "description": "The request is malformed or misses a required value.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateEventError400" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "402": { "description": "The account does not have enough credits for this operation.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateEventError402" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateEventError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateEventError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateEventError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateEventError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/events/{eventKey}/duplicate": { "post": { "operationId": "copyEvent", "summary": "Copy an event, its settings and optionally its blocks and channels", "tags": [ "Events" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/events/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "header-replay", "x-seatlayer-automatic-retry": true, "parameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Stable key reused for retries of the same logical call.", "schema": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,128}$" } } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EventCopyRequest" } } } }, "responses": { "201": { "description": "Event copied.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EventEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "400": { "description": "The request is malformed or misses a required value.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CopyEventError400" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "402": { "description": "The account does not have enough credits for this operation.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CopyEventError402" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CopyEventError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CopyEventError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CopyEventError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CopyEventError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/events/{eventKey}": { "get": { "operationId": "retrieveEvent", "summary": "Retrieve an event", "tags": [ "Events" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/events/" }, "security": [ { "secretKey": [] } ], "parameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EventDetail" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetrieveEventError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetrieveEventError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } } } }, "patch": { "operationId": "updateEvent", "summary": "Update event metadata", "tags": [ "Events" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/events/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "unsupported", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EventUpdateRequest" } } } }, "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EventEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "400": { "description": "The request is malformed or misses a required value.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateEventError400" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateEventError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateEventError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateEventError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateEventError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } }, "delete": { "operationId": "deleteEvent", "summary": "Delete an event", "tags": [ "Events" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/events/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "unsupported", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ok" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeleteEventError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeleteEventError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeleteEventError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/events/{eventKey}/event-configuration": { "get": { "operationId": "retrieveEventConfigurationBinding", "summary": "Retrieve an Event’s exact immutable configuration binding and audit history", "tags": [ "Events" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/events/" }, "security": [ { "secretKey": [] } ], "parameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "x-seatlayer-response-cache": "no-store", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EventConfigurationBinding" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetrieveEventConfigurationBindingError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetrieveEventConfigurationBindingError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The service or one of its required dependencies is temporarily unavailable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetrieveEventConfigurationBindingError503" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } } } }, "put": { "operationId": "updateEventConfigurationBinding", "summary": "Bind or detach an exact published Event configuration version", "tags": [ "Events" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/events/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "unsupported", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EventConfigurationBindingUpdateRequest" } } } }, "x-seatlayer-response-cache": "no-store", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EventConfigurationBinding" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateEventConfigurationBindingError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateEventConfigurationBindingError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateEventConfigurationBindingError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateEventConfigurationBindingError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The service or one of its required dependencies is temporarily unavailable. The API can also be temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/UpdateEventConfigurationBindingError503" }, { "$ref": "#/components/schemas/MaintenanceError" } ] } } } } } } }, "/v1/events/{eventKey}/poster": { "put": { "operationId": "updateEventPoster", "summary": "Upload the event poster used on share cards", "tags": [ "Events" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/events/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "unsupported", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "image/png": { "schema": { "$ref": "#/components/schemas/BinaryImage" } }, "image/jpeg": { "schema": { "$ref": "#/components/schemas/BinaryImage" } }, "image/webp": { "schema": { "$ref": "#/components/schemas/BinaryImage" } }, "application/octet-stream": { "schema": { "$ref": "#/components/schemas/BinaryImage" } } } }, "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EventEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "400": { "description": "The request is malformed or misses a required value.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateEventPosterError400" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateEventPosterError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateEventPosterError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "413": { "description": "The request body exceeds the supported size.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateEventPosterError413" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "415": { "description": "The request media type or bytes are unsupported.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateEventPosterError415" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateEventPosterError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } }, "delete": { "operationId": "deleteEventPoster", "summary": "Remove the event poster", "tags": [ "Events" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/events/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "unsupported", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EventEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeleteEventPosterError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeleteEventPosterError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/events/{eventKey}/update-chart": { "post": { "operationId": "updateEventChart", "summary": "Re-point a live event at the latest published chart", "tags": [ "Events" ], "externalDocs": { "url": "https://docs.seatlayer.io/designer/publishing-and-versioning/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "unsupported", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EventChartUpdateRequest" } } } }, "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EventChartUpdateResult" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateEventChartError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateEventChartError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateEventChartError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/events/{eventKey}/close": { "post": { "operationId": "closeEvent", "summary": "Close sales for an event", "tags": [ "Events" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/events/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "unsupported", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SalesAliasResult" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CloseEventError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CloseEventError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CloseEventError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/events/{eventKey}/reopen": { "post": { "operationId": "reopenEvent", "summary": "Reopen sales for an event", "tags": [ "Events" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/events/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "unsupported", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SalesAliasResult" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReopenEventError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReopenEventError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReopenEventError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/events/{eventKey}/archive": { "post": { "operationId": "archiveEvent", "summary": "Move an event to the archive", "tags": [ "Events" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/events/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "unsupported", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ArchiveEventResult" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ArchiveEventError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ArchiveEventError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ArchiveEventError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/events/{eventKey}/unarchive": { "post": { "operationId": "unarchiveEvent", "summary": "Restore an archived event with buyer sales still paused", "tags": [ "Events" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/events/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "unsupported", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnarchiveEventResult" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnarchiveEventError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnarchiveEventError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnarchiveEventError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/events/{eventKey}/releases": { "get": { "operationId": "listTicketReleases", "summary": "List ticket releases with live quota consumption", "tags": [ "Events" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/events/" }, "security": [ { "secretKey": [] } ], "parameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TicketReleaseList" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListTicketReleasesError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListTicketReleasesError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } } } }, "put": { "operationId": "updateTicketReleases", "summary": "Replace the ordered ticket-release list", "tags": [ "Events" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/events/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "unsupported", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TicketReleaseReplaceRequest" } } } }, "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TicketReleaseList" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateTicketReleasesError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateTicketReleasesError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateTicketReleasesError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/events/{eventKey}/releases/{releaseId}/close": { "post": { "operationId": "closeTicketRelease", "summary": "Close one ticket release immediately", "tags": [ "Events" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/events/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "unsupported", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } }, { "name": "releaseId", "in": "path", "required": true, "description": "Event-scoped ticket release identifier.", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TicketReleaseList" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CloseTicketReleaseError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CloseTicketReleaseError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/events/{eventKey}/hold": { "post": { "operationId": "holdObjects", "summary": "Hold objects for a buyer", "tags": [ "Inventory" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/holds/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "unsupported", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HoldRequest" } } } }, "x-seatlayer-rate-limits": [ { "policy": "server-inventory", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "201": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HoldResponse" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "400": { "description": "The request is malformed or misses a required value.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HoldObjectsError400" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HoldObjectsError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HoldObjectsError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HoldObjectsError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HoldObjectsError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/events/{eventKey}/extend": { "post": { "operationId": "extendHold", "summary": "Extend an active hold before it expires", "tags": [ "Inventory" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/holds/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "unsupported", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExtendHoldRequest" } } } }, "x-seatlayer-rate-limits": [ { "policy": "server-inventory", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExtendHoldResult" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "400": { "description": "The request is malformed or misses a required value.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExtendHoldError400" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExtendHoldError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExtendHoldError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExtendHoldError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/events/{eventKey}/best-available": { "post": { "operationId": "holdBestAvailable", "summary": "Pick and hold the best available objects", "tags": [ "Inventory" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/holds/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "unsupported", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BestAvailableRequest" } } } }, "x-seatlayer-rate-limits": [ { "policy": "server-inventory", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BestAvailableHoldResponse" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "400": { "description": "The request is malformed or misses a required value.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HoldBestAvailableError400" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HoldBestAvailableError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HoldBestAvailableError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HoldBestAvailableError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HoldBestAvailableError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/events/{eventKey}/best-available-block": { "post": { "operationId": "blockBestAvailable", "summary": "Pick and temporarily block the best available objects", "tags": [ "Inventory" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/holds/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "unsupported", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BestAvailableBlockRequest" } } } }, "x-seatlayer-rate-limits": [ { "policy": "server-inventory", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BestAvailableBlockResponse" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "400": { "description": "The request is malformed or misses a required value.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BlockBestAvailableError400" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BlockBestAvailableError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BlockBestAvailableError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BlockBestAvailableError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BlockBestAvailableError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/events/{eventKey}/best-available-book": { "post": { "operationId": "bookBestAvailable", "summary": "Pick and book the best available objects in one call", "tags": [ "Inventory" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/booking/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "unsupported", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BestAvailableBookRequest" } } } }, "x-seatlayer-rate-limits": [ { "policy": "server-inventory", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BestAvailableBookResponse" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "400": { "description": "The request is malformed or misses a required value.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BookBestAvailableError400" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BookBestAvailableError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BookBestAvailableError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BookBestAvailableError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BookBestAvailableError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/events/{eventKey}/holds/{holdId}": { "get": { "operationId": "retrieveHold", "summary": "Retrieve a hold with authoritative pricing", "tags": [ "Inventory" ], "externalDocs": { "url": "https://docs.seatlayer.io/integrations/ticketing-backend/" }, "security": [ { "secretKey": [] } ], "parameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } }, { "name": "holdId", "in": "path", "required": true, "description": "Opaque hold identifier returned by the Buyer SDK or hold API.", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HoldInspection" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetrieveHoldError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetrieveHoldError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetrieveHoldError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } } } } }, "/v1/events/{eventKey}/release": { "post": { "operationId": "releaseObjects", "summary": "Release held objects", "tags": [ "Inventory" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/holds/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "unsupported", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReleaseRequest" } } } }, "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReleaseResult" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "400": { "description": "The request is malformed or misses a required value.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReleaseObjectsError400" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReleaseObjectsError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReleaseObjectsError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReleaseObjectsError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/events/{eventKey}/book": { "post": { "operationId": "bookObjects", "summary": "Book objects, by hold id or by label", "tags": [ "Inventory" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/booking/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "domain-exact-booking-ref", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BookRequest" } } } }, "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BookResult" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "400": { "description": "The request is malformed or misses a required value.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BookObjectsError400" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BookObjectsError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BookObjectsError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BookObjectsError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/events/{eventKey}/box-book": { "post": { "operationId": "boxOfficeBookObjects", "summary": "Book objects directly without creating commerce artifacts", "tags": [ "Inventory" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/cancellations-and-box-office/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "domain-exact-booking-ref", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BoxOfficeBookRequest" } } } }, "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BookResult" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "400": { "description": "The request is malformed or misses a required value.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BoxOfficeBookObjectsError400" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BoxOfficeBookObjectsError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BoxOfficeBookObjectsError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BoxOfficeBookObjectsError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/events/{eventKey}/unbook": { "post": { "operationId": "unbookObjects", "summary": "Release previously booked objects", "tags": [ "Inventory" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/cancellations-and-box-office/" }, "security": [ { "secretKey": [] }, { "manageToken": [] } ], "x-seatlayer-idempotency": "unsupported", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnbookRequest" } } } }, "x-seatlayer-rate-limits": [ { "policy": "manage-session", "audience": "manage-session", "limit": 300, "windowSeconds": 60, "bucket": "manage-session-id", "standardHeaders": false } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnbookResult" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "400": { "description": "The request is malformed or misses a required value.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnbookObjectsError400" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing, invalid, or expired secret-key/manage-session bearer.", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/SecretKeyAuthError" }, { "$ref": "#/components/schemas/ManageSessionAuthError" } ] } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnbookObjectsError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnbookObjectsError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnbookObjectsError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "The manage-session bearer exceeded 300 requests per 60 seconds. Secret-key traffic uses its separately documented endpoint budgets.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/events/{eventKey}/block": { "post": { "operationId": "blockObjects", "summary": "Block objects from sale", "tags": [ "Inventory" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/blocking/" }, "security": [ { "secretKey": [] }, { "manageToken": [] } ], "x-seatlayer-idempotency": "unsupported", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BlockRequest" } } } }, "x-seatlayer-rate-limits": [ { "policy": "manage-session", "audience": "manage-session", "limit": 300, "windowSeconds": 60, "bucket": "manage-session-id", "standardHeaders": false } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BlockResult" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "400": { "description": "The request is malformed or misses a required value.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BlockObjectsError400" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing, invalid, or expired secret-key/manage-session bearer.", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/SecretKeyAuthError" }, { "$ref": "#/components/schemas/ManageSessionAuthError" } ] } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BlockObjectsError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BlockObjectsError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BlockObjectsError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "The manage-session bearer exceeded 300 requests per 60 seconds. Secret-key traffic uses its separately documented endpoint budgets.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/events/{eventKey}/unblock": { "post": { "operationId": "unblockObjects", "summary": "Unblock objects", "tags": [ "Inventory" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/blocking/" }, "security": [ { "secretKey": [] }, { "manageToken": [] } ], "x-seatlayer-idempotency": "unsupported", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LabelsRequest" } } } }, "x-seatlayer-rate-limits": [ { "policy": "manage-session", "audience": "manage-session", "limit": 300, "windowSeconds": 60, "bucket": "manage-session-id", "standardHeaders": false } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnblockResult" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "400": { "description": "The request is malformed or misses a required value.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnblockObjectsError400" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing, invalid, or expired secret-key/manage-session bearer.", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/SecretKeyAuthError" }, { "$ref": "#/components/schemas/ManageSessionAuthError" } ] } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnblockObjectsError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnblockObjectsError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "The manage-session bearer exceeded 300 requests per 60 seconds. Secret-key traffic uses its separately documented endpoint budgets.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/events/{eventKey}/unblock-all": { "post": { "operationId": "unblockAllObjects", "summary": "Unblock every blocked object in an event", "tags": [ "Inventory" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/blocking/" }, "security": [ { "secretKey": [] }, { "manageToken": [] } ], "x-seatlayer-idempotency": "unsupported", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "x-seatlayer-rate-limits": [ { "policy": "manage-session", "audience": "manage-session", "limit": 300, "windowSeconds": 60, "bucket": "manage-session-id", "standardHeaders": false } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnblockAllResult" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing, invalid, or expired secret-key/manage-session bearer.", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/SecretKeyAuthError" }, { "$ref": "#/components/schemas/ManageSessionAuthError" } ] } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnblockAllObjectsError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnblockAllObjectsError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "The manage-session bearer exceeded 300 requests per 60 seconds. Secret-key traffic uses its separately documented endpoint budgets.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/events/{eventKey}/actions/put-up-for-resale": { "put": { "operationId": "putUpForResale", "summary": "List booked objects for resale on this event", "tags": [ "Inventory" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/inventory/" }, "security": [ { "secretKey": [] }, { "manageToken": [] } ], "x-seatlayer-idempotency": "unsupported", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResaleListRequest" } } } }, "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "manage-session", "audience": "manage-session", "limit": 300, "windowSeconds": 60, "bucket": "manage-session-id", "standardHeaders": false } ], "responses": { "200": { "description": "The objects are on the resale market.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResaleListEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "400": { "description": "The request is malformed or misses a required value.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PutUpForResaleError400" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing, invalid, or expired secret-key/manage-session bearer.", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/SecretKeyAuthError" }, { "$ref": "#/components/schemas/ManageSessionAuthError" } ] } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PutUpForResaleError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PutUpForResaleError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PutUpForResaleError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PutUpForResaleError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "The manage-session bearer exceeded 300 requests per 60 seconds. Secret-key traffic uses its separately documented endpoint budgets.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/events/{eventKey}/actions/remove-from-resale": { "put": { "operationId": "removeFromResale", "summary": "Take objects off the resale market", "tags": [ "Inventory" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/inventory/" }, "security": [ { "secretKey": [] }, { "manageToken": [] } ], "x-seatlayer-idempotency": "unsupported", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResaleUnlistRequest" } } } }, "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "manage-session", "audience": "manage-session", "limit": 300, "windowSeconds": 60, "bucket": "manage-session-id", "standardHeaders": false } ], "responses": { "200": { "description": "The objects are off the resale market.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResaleUnlistEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "400": { "description": "The request is malformed or misses a required value.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RemoveFromResaleError400" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing, invalid, or expired secret-key/manage-session bearer.", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/SecretKeyAuthError" }, { "$ref": "#/components/schemas/ManageSessionAuthError" } ] } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RemoveFromResaleError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RemoveFromResaleError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RemoveFromResaleError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "The manage-session bearer exceeded 300 requests per 60 seconds. Secret-key traffic uses its separately documented endpoint budgets.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/events/{eventKey}/resale-listings": { "get": { "operationId": "listResaleListings", "summary": "List the objects currently on the resale market", "tags": [ "Inventory" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/inventory/" }, "security": [ { "secretKey": [] }, { "manageToken": [] } ], "parameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "manage-session", "audience": "manage-session", "limit": 300, "windowSeconds": 60, "bucket": "manage-session-id", "standardHeaders": false } ], "responses": { "200": { "description": "Objects currently on the resale market.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResaleListingList" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing, invalid, or expired secret-key/manage-session bearer.", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/SecretKeyAuthError" }, { "$ref": "#/components/schemas/ManageSessionAuthError" } ] } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListResaleListingsError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListResaleListingsError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "The manage-session bearer exceeded 300 requests per 60 seconds. Secret-key traffic uses its separately documented endpoint budgets.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } } } } }, "/v1/events/{eventKey}/resale-summary": { "get": { "operationId": "retrieveResaleSummary", "summary": "Count the resale market and the seats resold since a time", "tags": [ "Inventory" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/inventory/" }, "security": [ { "secretKey": [] }, { "manageToken": [] } ], "parameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } }, { "name": "since", "description": "Count seats resold at or after this time, in milliseconds since the epoch. Defaults to the last 24 hours.", "schema": { "type": "integer", "minimum": 0 }, "in": "query", "required": false } ], "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "manage-session", "audience": "manage-session", "limit": 300, "windowSeconds": 60, "bucket": "manage-session-id", "standardHeaders": false } ], "responses": { "200": { "description": "The resale market in numbers.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResaleSummary" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "400": { "description": "The request is malformed or misses a required value.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetrieveResaleSummaryError400" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing, invalid, or expired secret-key/manage-session bearer.", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/SecretKeyAuthError" }, { "$ref": "#/components/schemas/ManageSessionAuthError" } ] } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetrieveResaleSummaryError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetrieveResaleSummaryError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "The manage-session bearer exceeded 300 requests per 60 seconds. Secret-key traffic uses its separately documented endpoint budgets.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } } } } }, "/v1/events/{eventKey}/availability": { "get": { "operationId": "retrieveAvailability", "summary": "Read per-object availability", "tags": [ "Inventory" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/inventory/" }, "security": [ { "secretKey": [] }, { "manageToken": [] } ], "parameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "x-seatlayer-rate-limits": [ { "policy": "manage-session", "audience": "manage-session", "limit": 300, "windowSeconds": 60, "bucket": "manage-session-id", "standardHeaders": false } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AvailabilityEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing, invalid, or expired secret-key/manage-session bearer.", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/SecretKeyAuthError" }, { "$ref": "#/components/schemas/ManageSessionAuthError" } ] } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetrieveAvailabilityError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetrieveAvailabilityError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "The manage-session bearer exceeded 300 requests per 60 seconds. Secret-key traffic uses its separately documented endpoint budgets.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } } } }, "post": { "operationId": "updateAvailability", "summary": "Set per-object availability", "tags": [ "Inventory" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/inventory/" }, "security": [ { "secretKey": [] }, { "manageToken": [] } ], "x-seatlayer-idempotency": "unsupported", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AvailabilityUpdateRequest" } } } }, "x-seatlayer-rate-limits": [ { "policy": "manage-session", "audience": "manage-session", "limit": 300, "windowSeconds": 60, "bucket": "manage-session-id", "standardHeaders": false } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AvailabilityUpdateResult" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "400": { "description": "The request is malformed or misses a required value.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateAvailabilityError400" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing, invalid, or expired secret-key/manage-session bearer.", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/SecretKeyAuthError" }, { "$ref": "#/components/schemas/ManageSessionAuthError" } ] } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateAvailabilityError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateAvailabilityError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateAvailabilityError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "The manage-session bearer exceeded 300 requests per 60 seconds. Secret-key traffic uses its separately documented endpoint budgets.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/events/{eventKey}/hold-ttl": { "get": { "operationId": "retrieveHoldTtl", "summary": "Read the checkout window for an event", "tags": [ "Inventory" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/holds/" }, "security": [ { "secretKey": [] }, { "manageToken": [] } ], "parameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "x-seatlayer-rate-limits": [ { "policy": "manage-session", "audience": "manage-session", "limit": 300, "windowSeconds": 60, "bucket": "manage-session-id", "standardHeaders": false } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HoldTtlEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing, invalid, or expired secret-key/manage-session bearer.", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/SecretKeyAuthError" }, { "$ref": "#/components/schemas/ManageSessionAuthError" } ] } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetrieveHoldTtlError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetrieveHoldTtlError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "The manage-session bearer exceeded 300 requests per 60 seconds. Secret-key traffic uses its separately documented endpoint budgets.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } } } }, "post": { "operationId": "updateHoldTtl", "summary": "Set the checkout window for an event", "tags": [ "Inventory" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/holds/" }, "security": [ { "secretKey": [] }, { "manageToken": [] } ], "x-seatlayer-idempotency": "unsupported", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HoldTtlRequest" } } } }, "x-seatlayer-rate-limits": [ { "policy": "manage-session", "audience": "manage-session", "limit": 300, "windowSeconds": 60, "bucket": "manage-session-id", "standardHeaders": false } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HoldTtlUpdateResult" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "400": { "description": "The request is malformed or misses a required value.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateHoldTtlError400" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing, invalid, or expired secret-key/manage-session bearer.", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/SecretKeyAuthError" }, { "$ref": "#/components/schemas/ManageSessionAuthError" } ] } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateHoldTtlError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateHoldTtlError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "The manage-session bearer exceeded 300 requests per 60 seconds. Secret-key traffic uses its separately documented endpoint budgets.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/events/{eventKey}/bookings": { "get": { "operationId": "listInventoryBookings", "summary": "List inventory booking history by stable booking reference", "tags": [ "Reports" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/booking/" }, "security": [ { "secretKey": [] }, { "manageToken": [] } ], "parameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } }, { "name": "q", "description": "Search booking reference, label, or section.", "schema": { "type": "string", "maxLength": 120 }, "in": "query", "required": false }, { "name": "state", "description": "Filter lifecycle state.", "schema": { "type": "string", "enum": [ "booked", "partially_cancelled", "cancelled" ] }, "in": "query", "required": false }, { "name": "channel", "description": "Only bookings with seats from this sales channel id; `public` for seats sold with no channel.", "schema": { "type": "string", "maxLength": 128 }, "in": "query", "required": false }, { "name": "from", "description": "Booked at or after, epoch milliseconds.", "schema": { "type": "integer", "minimum": 0 }, "in": "query", "required": false }, { "name": "to", "description": "Booked before, epoch milliseconds.", "schema": { "type": "integer", "minimum": 0 }, "in": "query", "required": false }, { "name": "limit", "description": "Page size, capped at 200.", "schema": { "type": "integer", "minimum": 1, "maximum": 200 }, "in": "query", "required": false }, { "name": "cursor", "description": "Opaque cursor returned by the previous page.", "schema": { "type": "string" }, "in": "query", "required": false } ], "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "manage-session", "audience": "manage-session", "limit": 300, "windowSeconds": 60, "bucket": "manage-session-id", "standardHeaders": false } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InventoryBookingPage" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "400": { "description": "The request is malformed or misses a required value.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListInventoryBookingsError400" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing, invalid, or expired secret-key/manage-session bearer.", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/SecretKeyAuthError" }, { "$ref": "#/components/schemas/ManageSessionAuthError" } ] } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListInventoryBookingsError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListInventoryBookingsError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "The manage-session bearer exceeded 300 requests per 60 seconds. Secret-key traffic uses its separately documented endpoint budgets.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } } } } }, "/v1/events/{eventKey}/bookings/{bookingRef}": { "get": { "operationId": "retrieveInventoryBooking", "summary": "Retrieve one inventory booking and its lifecycle audit", "tags": [ "Reports" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/booking/" }, "security": [ { "secretKey": [] }, { "manageToken": [] } ], "parameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } }, { "name": "bookingRef", "in": "path", "required": true, "description": "Stable booking reference supplied by the integrating platform.", "schema": { "type": "string" } } ], "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "manage-session", "audience": "manage-session", "limit": 300, "windowSeconds": 60, "bucket": "manage-session-id", "standardHeaders": false } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InventoryBookingDetail" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing, invalid, or expired secret-key/manage-session bearer.", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/SecretKeyAuthError" }, { "$ref": "#/components/schemas/ManageSessionAuthError" } ] } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetrieveInventoryBookingError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetrieveInventoryBookingError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "The manage-session bearer exceeded 300 requests per 60 seconds. Secret-key traffic uses its separately documented endpoint budgets.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } } } } }, "/v1/events/{eventKey}/booking-changes": { "get": { "operationId": "listInventoryBookingChanges", "summary": "Incrementally reconcile booking and cancellation activity", "tags": [ "Reports" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/reports/" }, "security": [ { "secretKey": [] }, { "manageToken": [] } ], "parameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } }, { "name": "after", "description": "Exclusive activity checkpoint returned by a previous response.", "schema": { "type": "integer", "minimum": 0 }, "in": "query", "required": false }, { "name": "limit", "description": "Page size, capped at 200.", "schema": { "type": "integer", "minimum": 1, "maximum": 200 }, "in": "query", "required": false } ], "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "manage-session", "audience": "manage-session", "limit": 300, "windowSeconds": 60, "bucket": "manage-session-id", "standardHeaders": false } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InventoryBookingChangePage" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "400": { "description": "The request is malformed or misses a required value.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListInventoryBookingChangesError400" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing, invalid, or expired secret-key/manage-session bearer.", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/SecretKeyAuthError" }, { "$ref": "#/components/schemas/ManageSessionAuthError" } ] } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListInventoryBookingChangesError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListInventoryBookingChangesError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "The manage-session bearer exceeded 300 requests per 60 seconds. Secret-key traffic uses its separately documented endpoint budgets.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } } } } }, "/v1/events/{eventKey}/report": { "get": { "operationId": "retrieveEventReport", "summary": "Retrieve inventory status and configured booked value", "tags": [ "Reports" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/reports/" }, "security": [ { "secretKey": [] }, { "manageToken": [] } ], "parameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "x-seatlayer-rate-limits": [ { "policy": "manage-session", "audience": "manage-session", "limit": 300, "windowSeconds": 60, "bucket": "manage-session-id", "standardHeaders": false } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EventReportEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing, invalid, or expired secret-key/manage-session bearer.", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/SecretKeyAuthError" }, { "$ref": "#/components/schemas/ManageSessionAuthError" } ] } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetrieveEventReportError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetrieveEventReportError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "The manage-session bearer exceeded 300 requests per 60 seconds. Secret-key traffic uses its separately documented endpoint budgets.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } } } } }, "/v1/events/{eventKey}/log": { "get": { "operationId": "retrieveEventLog", "summary": "Retrieve the event audit log", "tags": [ "Reports" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/reports/" }, "security": [ { "secretKey": [] }, { "manageToken": [] } ], "parameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } }, { "name": "limit", "description": "Page size, capped at 200.", "schema": { "type": "integer", "minimum": 1, "maximum": 200 }, "in": "query", "required": false }, { "name": "before", "description": "Numeric log id cursor.", "schema": { "type": "integer", "minimum": 1 }, "in": "query", "required": false } ], "x-seatlayer-rate-limits": [ { "policy": "manage-session", "audience": "manage-session", "limit": 300, "windowSeconds": 60, "bucket": "manage-session-id", "standardHeaders": false } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EventLogPage" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing, invalid, or expired secret-key/manage-session bearer.", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/SecretKeyAuthError" }, { "$ref": "#/components/schemas/ManageSessionAuthError" } ] } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetrieveEventLogError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetrieveEventLogError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "The manage-session bearer exceeded 300 requests per 60 seconds. Secret-key traffic uses its separately documented endpoint budgets.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } } } } }, "/v1/events/{eventKey}/channels/report": { "get": { "operationId": "retrieveChannelReport", "summary": "Retrieve current allocation and booking attribution per sales channel", "tags": [ "Reports" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/reports/" }, "security": [ { "secretKey": [] }, { "manageToken": [] } ], "parameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "x-seatlayer-rate-limits": [ { "policy": "manage-session", "audience": "manage-session", "limit": 300, "windowSeconds": 60, "bucket": "manage-session-id", "standardHeaders": false } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChannelReportEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing, invalid, or expired secret-key/manage-session bearer.", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/SecretKeyAuthError" }, { "$ref": "#/components/schemas/ManageSessionAuthError" } ] } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetrieveChannelReportError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetrieveChannelReportError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "The manage-session bearer exceeded 300 requests per 60 seconds. Secret-key traffic uses its separately documented endpoint budgets.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } } } } }, "/v1/events/{eventKey}/channels": { "get": { "operationId": "listChannels", "summary": "List an event’s sales channels with current allocation counts", "tags": [ "Sales channels" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/channels/" }, "security": [ { "secretKey": [] }, { "manageToken": [] } ], "parameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } }, { "name": "includeArchived", "description": "Set to 1 or true to include archived channels.", "schema": { "type": "string", "enum": [ "1", "true" ] }, "in": "query", "required": false } ], "x-seatlayer-rate-limits": [ { "policy": "manage-session", "audience": "manage-session", "limit": 300, "windowSeconds": 60, "bucket": "manage-session-id", "standardHeaders": false } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChannelList" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing, invalid, or expired secret-key/manage-session bearer.", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/SecretKeyAuthError" }, { "$ref": "#/components/schemas/ManageSessionAuthError" } ] } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListChannelsError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListChannelsError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "The manage-session bearer exceeded 300 requests per 60 seconds. Secret-key traffic uses its separately documented endpoint budgets.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } } } }, "post": { "operationId": "createChannel", "summary": "Create a sales channel", "tags": [ "Sales channels" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/channels/" }, "security": [ { "secretKey": [] }, { "manageToken": [] } ], "x-seatlayer-idempotency": "unsupported", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChannelCreateRequest" } } } }, "x-seatlayer-rate-limits": [ { "policy": "manage-session", "audience": "manage-session", "limit": 300, "windowSeconds": 60, "bucket": "manage-session-id", "standardHeaders": false } ], "responses": { "201": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChannelMutationEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing, invalid, or expired secret-key/manage-session bearer.", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/SecretKeyAuthError" }, { "$ref": "#/components/schemas/ManageSessionAuthError" } ] } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateChannelError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateChannelError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateChannelError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateChannelError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "The manage-session bearer exceeded 300 requests per 60 seconds. Secret-key traffic uses its separately documented endpoint budgets.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/events/{eventKey}/channels/{channelId}": { "patch": { "operationId": "updateChannel", "summary": "Rename a sales channel, change its access method, or update category prices", "tags": [ "Sales channels" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/channels/" }, "security": [ { "secretKey": [] }, { "manageToken": [] } ], "x-seatlayer-idempotency": "unsupported", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } }, { "name": "channelId", "in": "path", "required": true, "description": "channelId path parameter.", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChannelUpdateRequest" } } } }, "x-seatlayer-rate-limits": [ { "policy": "manage-session", "audience": "manage-session", "limit": 300, "windowSeconds": 60, "bucket": "manage-session-id", "standardHeaders": false } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChannelMutationEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing, invalid, or expired secret-key/manage-session bearer.", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/SecretKeyAuthError" }, { "$ref": "#/components/schemas/ManageSessionAuthError" } ] } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateChannelError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateChannelError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateChannelError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateChannelError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "The manage-session bearer exceeded 300 requests per 60 seconds. Secret-key traffic uses its separately documented endpoint budgets.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/events/{eventKey}/channels/assignments": { "post": { "operationId": "updateChannelAssignments", "summary": "Move inventory between sales channels, versioned and non-destructive", "tags": [ "Sales channels" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/channels/" }, "security": [ { "secretKey": [] }, { "manageToken": [] } ], "x-seatlayer-idempotency": "unsupported", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChannelAssignmentRequest" } } } }, "x-seatlayer-rate-limits": [ { "policy": "manage-session", "audience": "manage-session", "limit": 300, "windowSeconds": 60, "bucket": "manage-session-id", "standardHeaders": false } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AssignmentResult" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing, invalid, or expired secret-key/manage-session bearer.", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/SecretKeyAuthError" }, { "$ref": "#/components/schemas/ManageSessionAuthError" } ] } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateChannelAssignmentsError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateChannelAssignmentsError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateChannelAssignmentsError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateChannelAssignmentsError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "The manage-session bearer exceeded 300 requests per 60 seconds. Secret-key traffic uses its separately documented endpoint budgets.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/events/{eventKey}/channels/allocation": { "get": { "operationId": "listChannelAllocation", "summary": "Page the label-to-channel allocation map", "tags": [ "Sales channels" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/channels/" }, "security": [ { "secretKey": [] }, { "manageToken": [] } ], "parameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } }, { "name": "afterLabel", "description": "Label cursor for the next page.", "schema": { "type": "string" }, "in": "query", "required": false }, { "name": "limit", "description": "Page size, capped at 5000.", "schema": { "type": "integer", "minimum": 1, "maximum": 5000 }, "in": "query", "required": false } ], "x-seatlayer-rate-limits": [ { "policy": "manage-session", "audience": "manage-session", "limit": 300, "windowSeconds": 60, "bucket": "manage-session-id", "standardHeaders": false } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChannelAllocationPage" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing, invalid, or expired secret-key/manage-session bearer.", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/SecretKeyAuthError" }, { "$ref": "#/components/schemas/ManageSessionAuthError" } ] } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListChannelAllocationError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListChannelAllocationError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "The manage-session bearer exceeded 300 requests per 60 seconds. Secret-key traffic uses its separately documented endpoint budgets.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } } } } }, "/v1/events/{eventKey}/channels/preview": { "get": { "operationId": "retrieveChannelAccessPreview", "summary": "Preview the seat projection a given channel scope would receive", "tags": [ "Sales channels" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/channels/" }, "security": [ { "secretKey": [] }, { "manageToken": [] } ], "parameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } }, { "name": "channelIds", "description": "Trusted-server inventory scope. Private allocation ids require matching channel access. Comma-separated, at most 20.", "schema": { "type": "string" }, "in": "query", "required": false }, { "name": "includePublic", "description": "Set to 1 or true to include Public sale.", "schema": { "type": "string", "enum": [ "1", "true" ] }, "in": "query", "required": false } ], "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "manage-session", "audience": "manage-session", "limit": 300, "windowSeconds": 60, "bucket": "manage-session-id", "standardHeaders": false } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChannelPreview" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing, invalid, or expired secret-key/manage-session bearer.", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/SecretKeyAuthError" }, { "$ref": "#/components/schemas/ManageSessionAuthError" } ] } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetrieveChannelAccessPreviewError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetrieveChannelAccessPreviewError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetrieveChannelAccessPreviewError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "The manage-session bearer exceeded 300 requests per 60 seconds. Secret-key traffic uses its separately documented endpoint budgets.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } } } } }, "/v1/events/{eventKey}/channels/{channelId}/pause": { "post": { "operationId": "pauseChannel", "summary": "Pause a sales channel (no new access, no new holds)", "tags": [ "Sales channels" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/channels/" }, "security": [ { "secretKey": [] }, { "manageToken": [] } ], "x-seatlayer-idempotency": "unsupported", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } }, { "name": "channelId", "in": "path", "required": true, "description": "channelId path parameter.", "schema": { "type": "string" } } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChannelReasonRequest" } } } }, "x-seatlayer-rate-limits": [ { "policy": "manage-session", "audience": "manage-session", "limit": 300, "windowSeconds": 60, "bucket": "manage-session-id", "standardHeaders": false } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChannelMutationEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing, invalid, or expired secret-key/manage-session bearer.", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/SecretKeyAuthError" }, { "$ref": "#/components/schemas/ManageSessionAuthError" } ] } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PauseChannelError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PauseChannelError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PauseChannelError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PauseChannelError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "The manage-session bearer exceeded 300 requests per 60 seconds. Secret-key traffic uses its separately documented endpoint budgets.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/events/{eventKey}/channels/{channelId}/unpause": { "post": { "operationId": "unpauseChannel", "summary": "Resume a paused sales channel", "tags": [ "Sales channels" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/channels/" }, "security": [ { "secretKey": [] }, { "manageToken": [] } ], "x-seatlayer-idempotency": "unsupported", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } }, { "name": "channelId", "in": "path", "required": true, "description": "channelId path parameter.", "schema": { "type": "string" } } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChannelReasonRequest" } } } }, "x-seatlayer-rate-limits": [ { "policy": "manage-session", "audience": "manage-session", "limit": 300, "windowSeconds": 60, "bucket": "manage-session-id", "standardHeaders": false } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChannelMutationEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing, invalid, or expired secret-key/manage-session bearer.", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/SecretKeyAuthError" }, { "$ref": "#/components/schemas/ManageSessionAuthError" } ] } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnpauseChannelError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnpauseChannelError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnpauseChannelError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnpauseChannelError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "The manage-session bearer exceeded 300 requests per 60 seconds. Secret-key traffic uses its separately documented endpoint budgets.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/events/{eventKey}/channels/{channelId}/archive": { "post": { "operationId": "archiveChannel", "summary": "Archive a sales channel, returning its inventory to a destination", "tags": [ "Sales channels" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/channels/" }, "security": [ { "secretKey": [] }, { "manageToken": [] } ], "x-seatlayer-idempotency": "unsupported", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } }, { "name": "channelId", "in": "path", "required": true, "description": "channelId path parameter.", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChannelArchiveRequest" } } } }, "x-seatlayer-rate-limits": [ { "policy": "manage-session", "audience": "manage-session", "limit": 300, "windowSeconds": 60, "bucket": "manage-session-id", "standardHeaders": false } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChannelArchiveResult" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing, invalid, or expired secret-key/manage-session bearer.", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/SecretKeyAuthError" }, { "$ref": "#/components/schemas/ManageSessionAuthError" } ] } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ArchiveChannelError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ArchiveChannelError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ArchiveChannelError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ArchiveChannelError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "The manage-session bearer exceeded 300 requests per 60 seconds. Secret-key traffic uses its separately documented endpoint budgets.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/events/{eventKey}/buyer-access-sessions": { "post": { "operationId": "createBuyerAccessSession", "summary": "Mint a short-lived buyer access session scoped to named channels", "tags": [ "Buyer access" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/buyer-access-sessions/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "unsupported-one-time-secret", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BuyerAccessSessionRequest" } } } }, "x-seatlayer-response-cache": "no-store", "responses": { "201": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BuyerAccessReveal" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateBuyerAccessSessionError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateBuyerAccessSessionError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateBuyerAccessSessionError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateBuyerAccessSessionError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } }, "get": { "operationId": "listBuyerAccessSessions", "summary": "List buyer access sessions with scope, state, and expiry (never the token)", "tags": [ "Buyer access" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/buyer-access-sessions/" }, "security": [ { "secretKey": [] } ], "parameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } }, { "name": "limit", "description": "Latest sessions to return, capped at 200. This endpoint is not cursor-paged.", "schema": { "type": "integer", "minimum": 1, "maximum": 200 }, "in": "query", "required": false } ], "x-seatlayer-response-cache": "no-store", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BuyerAccessSessionList" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListBuyerAccessSessionsError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } } } } }, "/v1/events/{eventKey}/buyer-access-sessions/{sessionId}": { "delete": { "operationId": "revokeBuyerAccessSession", "summary": "Revoke a buyer access session immediately", "tags": [ "Buyer access" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/buyer-access-sessions/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "unsupported", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } }, { "name": "sessionId", "in": "path", "required": true, "description": "Short-lived session identifier.", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BuyerAccessRevokeResult" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RevokeBuyerAccessSessionError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/events/{eventKey}/channels/{channelId}/access-links": { "post": { "operationId": "createAccessLink", "summary": "Create a hosted access link for a channel (capability revealed once)", "tags": [ "Buyer access" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/channels/" }, "security": [ { "secretKey": [] }, { "manageToken": [] } ], "x-seatlayer-idempotency": "unsupported-one-time-secret", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } }, { "name": "channelId", "in": "path", "required": true, "description": "channelId path parameter.", "schema": { "type": "string" } } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccessLinkCreateRequest" } } } }, "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "manage-session", "audience": "manage-session", "limit": 300, "windowSeconds": 60, "bucket": "manage-session-id", "standardHeaders": false } ], "responses": { "201": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccessLinkReveal" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing, invalid, or expired secret-key/manage-session bearer.", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/SecretKeyAuthError" }, { "$ref": "#/components/schemas/ManageSessionAuthError" } ] } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateAccessLinkError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateAccessLinkError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateAccessLinkError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateAccessLinkError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "The manage-session bearer exceeded 300 requests per 60 seconds. Secret-key traffic uses its separately documented endpoint budgets.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } }, "get": { "operationId": "listAccessLinks", "summary": "List a channel’s hosted access links (status only, never the capability)", "tags": [ "Buyer access" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/channels/" }, "security": [ { "secretKey": [] }, { "manageToken": [] } ], "parameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } }, { "name": "channelId", "in": "path", "required": true, "description": "channelId path parameter.", "schema": { "type": "string" } } ], "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "manage-session", "audience": "manage-session", "limit": 300, "windowSeconds": 60, "bucket": "manage-session-id", "standardHeaders": false } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccessLinkList" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing, invalid, or expired secret-key/manage-session bearer.", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/SecretKeyAuthError" }, { "$ref": "#/components/schemas/ManageSessionAuthError" } ] } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListAccessLinksError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListAccessLinksError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "The manage-session bearer exceeded 300 requests per 60 seconds. Secret-key traffic uses its separately documented endpoint budgets.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } } } } }, "/v1/events/{eventKey}/channels/{channelId}/access-links/{linkId}/rotate": { "post": { "operationId": "rotateAccessLink", "summary": "Rotate a hosted access link, issuing a replacement capability", "tags": [ "Buyer access" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/channels/" }, "security": [ { "secretKey": [] }, { "manageToken": [] } ], "x-seatlayer-idempotency": "unsupported-one-time-secret", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } }, { "name": "channelId", "in": "path", "required": true, "description": "channelId path parameter.", "schema": { "type": "string" } }, { "name": "linkId", "in": "path", "required": true, "description": "linkId path parameter.", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccessLinkRotateRequest" } } } }, "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "manage-session", "audience": "manage-session", "limit": 300, "windowSeconds": 60, "bucket": "manage-session-id", "standardHeaders": false } ], "responses": { "201": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccessLinkReveal" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing, invalid, or expired secret-key/manage-session bearer.", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/SecretKeyAuthError" }, { "$ref": "#/components/schemas/ManageSessionAuthError" } ] } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RotateAccessLinkError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RotateAccessLinkError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RotateAccessLinkError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RotateAccessLinkError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "The manage-session bearer exceeded 300 requests per 60 seconds. Secret-key traffic uses its separately documented endpoint budgets.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/events/{eventKey}/channels/{channelId}/access-links/{linkId}": { "delete": { "operationId": "revokeAccessLink", "summary": "Revoke a hosted access link, optionally ending active sessions", "tags": [ "Buyer access" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/channels/" }, "security": [ { "secretKey": [] }, { "manageToken": [] } ], "x-seatlayer-idempotency": "unsupported", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } }, { "name": "channelId", "in": "path", "required": true, "description": "channelId path parameter.", "schema": { "type": "string" } }, { "name": "linkId", "in": "path", "required": true, "description": "linkId path parameter.", "schema": { "type": "string" } }, { "name": "endActiveSessions", "description": "Set to 1 or true to revoke sessions minted by this link.", "schema": { "type": "string", "enum": [ "1", "true" ] }, "in": "query", "required": false }, { "name": "reason", "description": "Audit reason.", "schema": { "type": "string", "maxLength": 400 }, "in": "query", "required": false } ], "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "manage-session", "audience": "manage-session", "limit": 300, "windowSeconds": 60, "bucket": "manage-session-id", "standardHeaders": false } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccessLinkRevokeResult" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing, invalid, or expired secret-key/manage-session bearer.", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/SecretKeyAuthError" }, { "$ref": "#/components/schemas/ManageSessionAuthError" } ] } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RevokeAccessLinkError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RevokeAccessLinkError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RevokeAccessLinkError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "The manage-session bearer exceeded 300 requests per 60 seconds. Secret-key traffic uses its separately documented endpoint budgets.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/events/{eventKey}/manage-sessions": { "post": { "operationId": "createManageSession", "summary": "Mint an origin-bound manage-session token for the control room", "tags": [ "Platform" ], "externalDocs": { "url": "https://docs.seatlayer.io/platform/embed-sessions/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "unsupported-one-time-secret", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ManageSessionRequest" } } } }, "x-seatlayer-response-cache": "no-store", "responses": { "201": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ManageSessionReveal" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateManageSessionError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateManageSessionError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateManageSessionError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/events/{eventKey}/manage-sessions/{id}": { "delete": { "operationId": "revokeManageSession", "summary": "Revoke a manage-session token early", "tags": [ "Platform" ], "externalDocs": { "url": "https://docs.seatlayer.io/platform/embed-sessions/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "unsupported", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "description": "Resource identifier.", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ok" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RevokeManageSessionError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RevokeManageSessionError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/designer/sessions": { "post": { "operationId": "createDesignerSession", "summary": "Mint an origin-bound designer-session token", "tags": [ "Platform" ], "externalDocs": { "url": "https://docs.seatlayer.io/platform/embedded-designer/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "unsupported-one-time-secret", "x-seatlayer-automatic-retry": false, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DesignerSessionRequest" } } } }, "x-seatlayer-response-cache": "no-store", "responses": { "201": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DesignerSessionEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "400": { "description": "The request is malformed or misses a required value.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateDesignerSessionError400" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateDesignerSessionError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateDesignerSessionError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateDesignerSessionError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/designer/sessions/{id}": { "delete": { "operationId": "revokeDesignerSession", "summary": "Revoke a designer-session token early", "tags": [ "Platform" ], "externalDocs": { "url": "https://docs.seatlayer.io/platform/embedded-designer/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "unsupported", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Resource identifier.", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ok" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RevokeDesignerSessionError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RevokeDesignerSessionError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/webhooks": { "get": { "operationId": "listWebhooks", "summary": "List webhook subscriptions", "tags": [ "Webhooks" ], "externalDocs": { "url": "https://docs.seatlayer.io/webhooks/manage-subscriptions/" }, "security": [ { "secretKey": [] } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WebhookList" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } } } }, "post": { "operationId": "createWebhook", "summary": "Create a webhook subscription", "tags": [ "Webhooks" ], "externalDocs": { "url": "https://docs.seatlayer.io/webhooks/manage-subscriptions/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "unsupported-one-time-secret", "x-seatlayer-automatic-retry": false, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WebhookCreateRequest" } } } }, "x-seatlayer-response-cache": "no-store", "responses": { "201": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WebhookCreateEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateWebhookError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateWebhookError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/webhooks/{webhookId}": { "patch": { "operationId": "updateWebhook", "summary": "Update a webhook subscription", "tags": [ "Webhooks" ], "externalDocs": { "url": "https://docs.seatlayer.io/webhooks/manage-subscriptions/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "unsupported", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "webhookId", "in": "path", "required": true, "description": "Resource identifier.", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WebhookUpdateRequest" } } } }, "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WebhookEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateWebhookError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateWebhookError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateWebhookError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } }, "delete": { "operationId": "deleteWebhook", "summary": "Delete a webhook subscription", "tags": [ "Webhooks" ], "externalDocs": { "url": "https://docs.seatlayer.io/webhooks/manage-subscriptions/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "unsupported", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "webhookId", "in": "path", "required": true, "description": "Resource identifier.", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ok" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeleteWebhookError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeleteWebhookError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/webhooks/{id}/rotate-secret": { "post": { "operationId": "rotateWebhookSecret", "summary": "Rotate a webhook signing secret without replacing the subscription", "tags": [ "Webhooks" ], "externalDocs": { "url": "https://docs.seatlayer.io/webhooks/manage-subscriptions/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "unsupported-one-time-secret", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Resource identifier.", "schema": { "type": "string" } } ], "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WebhookRotateSecretEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RotateWebhookSecretError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RotateWebhookSecretError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/webhooks/{webhookId}/deliveries": { "get": { "operationId": "listWebhookDeliveries", "summary": "List recent deliveries for a webhook", "tags": [ "Webhooks" ], "externalDocs": { "url": "https://docs.seatlayer.io/webhooks/delivery-and-retries/" }, "security": [ { "secretKey": [] } ], "parameters": [ { "name": "webhookId", "in": "path", "required": true, "description": "Resource identifier.", "schema": { "type": "string" } }, { "name": "limit", "description": "Page size, capped at 50.", "schema": { "type": "integer", "minimum": 1, "maximum": 50 }, "in": "query", "required": false }, { "name": "status", "description": "Filter successful or failed deliveries.", "schema": { "type": "string", "enum": [ "ok", "failed" ] }, "in": "query", "required": false }, { "name": "before", "description": "Inclusive epoch-millisecond cursor.", "schema": { "type": "integer", "minimum": 1 }, "in": "query", "required": false } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WebhookDeliveryPage" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListWebhookDeliveriesError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } } } } }, "/v1/workspaces": { "get": { "operationId": "listWorkspaces", "summary": "List workspaces", "tags": [ "Platform" ], "externalDocs": { "url": "https://docs.seatlayer.io/platform/workspaces/" }, "security": [ { "secretKey": [] } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WorkspaceList" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } } } }, "post": { "operationId": "createWorkspace", "summary": "Create a workspace", "tags": [ "Platform" ], "externalDocs": { "url": "https://docs.seatlayer.io/platform/workspaces/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "header-replay", "x-seatlayer-automatic-retry": true, "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Stable key reused for retries of the same logical call.", "schema": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,128}$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WorkspaceCreateRequest" } } } }, "responses": { "201": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WorkspaceEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "400": { "description": "The request is malformed or misses a required value.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateWorkspaceError400" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateWorkspaceError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateWorkspaceError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateWorkspaceError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/workspaces/{workspaceId}": { "patch": { "operationId": "updateWorkspace", "summary": "Rename a workspace or set it active/disabled", "tags": [ "Platform" ], "externalDocs": { "url": "https://docs.seatlayer.io/platform/workspaces/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "unsupported", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "workspaceId", "in": "path", "required": true, "description": "Resource identifier.", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WorkspaceUpdateRequest" } } } }, "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WorkspaceEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateWorkspaceError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateWorkspaceError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateWorkspaceError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateWorkspaceError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } }, "get": { "operationId": "retrieveWorkspace", "summary": "Retrieve a workspace", "tags": [ "Platform" ], "externalDocs": { "url": "https://docs.seatlayer.io/platform/workspaces/" }, "security": [ { "secretKey": [] } ], "parameters": [ { "name": "workspaceId", "in": "path", "required": true, "description": "Resource identifier.", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WorkspaceEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetrieveWorkspaceError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } } } } }, "/v1/performance-groups": { "get": { "operationId": "listPerformanceGroups", "summary": "List multi-performance runs", "tags": [ "Performance Groups" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/performance-groups/" }, "security": [ { "secretKey": [] } ], "parameters": [ { "name": "workspaceId", "description": "Active workspace id. Defaults to the caller workspace.", "schema": { "type": "string" }, "in": "query", "required": false }, { "name": "externalRef", "description": "Filter by the caller-owned external reference.", "schema": { "type": "string" }, "in": "query", "required": false }, { "name": "state", "description": "Filter by the group lifecycle state.", "schema": { "type": "string", "enum": [ "draft", "active", "closing", "closed", "archived" ] }, "in": "query", "required": false }, { "name": "limit", "description": "Page size. Defaults to 100 and is capped at 200.", "schema": { "type": "integer", "minimum": 1, "maximum": 200 }, "in": "query", "required": false }, { "name": "cursor", "description": "Opaque cursor returned by the previous page.", "schema": { "type": "string" }, "in": "query", "required": false } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PerformanceGroupPage" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListPerformanceGroupsError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListPerformanceGroupsError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } } } }, "post": { "operationId": "createPerformanceGroup", "summary": "Create a multi-performance run", "tags": [ "Performance Groups" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/performance-groups/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "header-replay", "x-seatlayer-automatic-retry": true, "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Stable key reused for retries of the same logical call.", "schema": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,128}$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PerformanceGroupCreateRequest" } } } }, "responses": { "201": { "description": "Fixed performance run created as a draft.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PerformanceGroupEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "400": { "description": "The request is malformed or misses a required value.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreatePerformanceGroupError400" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreatePerformanceGroupError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreatePerformanceGroupError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreatePerformanceGroupError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreatePerformanceGroupError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/performance-groups/{performanceGroupKey}": { "get": { "operationId": "retrievePerformanceGroup", "summary": "Retrieve a multi-performance run", "tags": [ "Performance Groups" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/performance-groups/" }, "security": [ { "secretKey": [] } ], "parameters": [ { "name": "performanceGroupKey", "in": "path", "required": true, "description": "SeatLayer Performance Group key.", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PerformanceGroupEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetrievePerformanceGroupError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } } } }, "patch": { "operationId": "updatePerformanceGroup", "summary": "Update a performance run’s name and sales settings", "tags": [ "Performance Groups" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/performance-groups/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "unsupported", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "performanceGroupKey", "in": "path", "required": true, "description": "SeatLayer Performance Group key.", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PerformanceGroupUpdateRequest" } } } }, "x-seatlayer-response-cache": "no-store", "responses": { "200": { "description": "Performance run updated.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PerformanceGroupEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdatePerformanceGroupError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdatePerformanceGroupError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdatePerformanceGroupError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdatePerformanceGroupError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The service or one of its required dependencies is temporarily unavailable. The API can also be temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/UpdatePerformanceGroupError503" }, { "$ref": "#/components/schemas/MaintenanceError" } ] } } } } } }, "delete": { "operationId": "deletePerformanceGroup", "summary": "Delete an unused draft performance run", "tags": [ "Performance Groups" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/performance-groups/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "unsupported", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "performanceGroupKey", "in": "path", "required": true, "description": "SeatLayer Performance Group key.", "schema": { "type": "string" } } ], "x-seatlayer-response-cache": "no-store", "responses": { "204": { "description": "Draft Performance Group deleted.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeletePerformanceGroupError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeletePerformanceGroupError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeletePerformanceGroupError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/performance-groups/{performanceGroupKey}/activate": { "post": { "operationId": "activatePerformanceGroup", "summary": "Activate a performance run", "tags": [ "Performance Groups" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/performance-groups/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "unsupported", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "performanceGroupKey", "in": "path", "required": true, "description": "SeatLayer Performance Group key.", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PerformanceGroupLifecycleRequest" } } } }, "x-seatlayer-response-cache": "no-store", "responses": { "200": { "description": "Performance Group activated.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PerformanceGroupLifecycleEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "202": { "description": "Activation is in progress. Poll the response Location until the lifecycle operation is terminal.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Location": { "schema": { "type": "string", "format": "uri-reference" }, "description": "Relative URL to poll for the current operation state." }, "Retry-After": { "schema": { "type": "integer", "minimum": 1 }, "description": "Seconds to wait before polling the supplied Location." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PerformanceGroupLifecycleEnvelope" } } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ActivatePerformanceGroupError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ActivatePerformanceGroupError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ActivatePerformanceGroupError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ActivatePerformanceGroupError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The service or one of its required dependencies is temporarily unavailable. The API can also be temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ActivatePerformanceGroupError503" }, { "$ref": "#/components/schemas/MaintenanceError" } ] } } } } } } }, "/v1/performance-groups/{performanceGroupKey}/close": { "post": { "operationId": "closePerformanceGroup", "summary": "Close a performance run after active holds drain", "tags": [ "Performance Groups" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/performance-groups/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "unsupported", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "performanceGroupKey", "in": "path", "required": true, "description": "SeatLayer Performance Group key.", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PerformanceGroupLifecycleRequest" } } } }, "x-seatlayer-response-cache": "no-store", "responses": { "200": { "description": "Performance Group closed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PerformanceGroupLifecycleEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "202": { "description": "Closing is in progress. Poll the response Location until the lifecycle operation is terminal.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Location": { "schema": { "type": "string", "format": "uri-reference" }, "description": "Relative URL to poll for the current operation state." }, "Retry-After": { "schema": { "type": "integer", "minimum": 1 }, "description": "Seconds to wait before polling the supplied Location." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PerformanceGroupLifecycleEnvelope" } } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClosePerformanceGroupError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClosePerformanceGroupError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClosePerformanceGroupError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClosePerformanceGroupError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The service or one of its required dependencies is temporarily unavailable. The API can also be temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ClosePerformanceGroupError503" }, { "$ref": "#/components/schemas/MaintenanceError" } ] } } } } } } }, "/v1/performance-groups/{performanceGroupKey}/lifecycle/{operationId}": { "get": { "operationId": "retrievePerformanceGroupLifecycle", "summary": "Retrieve a performance run lifecycle operation", "tags": [ "Performance Groups" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/performance-groups/" }, "security": [ { "secretKey": [] } ], "parameters": [ { "name": "performanceGroupKey", "in": "path", "required": true, "description": "SeatLayer Performance Group key.", "schema": { "type": "string" } }, { "name": "operationId", "in": "path", "required": true, "description": "Opaque hold or lifecycle operation identifier.", "schema": { "type": "string" } } ], "x-seatlayer-response-cache": "no-store", "responses": { "200": { "description": "Lifecycle state. Non-terminal operations include Retry-After; poll this same URL after the stated delay.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "minimum": 1 }, "description": "Seconds to wait before polling the supplied Location." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PerformanceGroupLifecycleEnvelope" } } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetrievePerformanceGroupLifecycleError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetrievePerformanceGroupLifecycleError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The service or one of its required dependencies is temporarily unavailable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetrievePerformanceGroupLifecycleError503" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } } } } }, "/v1/performance-groups/{performanceGroupKey}/buyer-access-sessions": { "post": { "operationId": "createPerformanceGroupBuyerAccessSession", "summary": "Create a one-time group browser access token", "tags": [ "Performance Groups" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/performance-groups/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "unsupported-one-time-secret", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "performanceGroupKey", "in": "path", "required": true, "description": "SeatLayer Performance Group key.", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PerformanceGroupBuyerAccessSessionRequest" } } } }, "x-seatlayer-response-cache": "no-store", "responses": { "201": { "description": "One-time browser access token created.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PerformanceGroupBuyerAccessReveal" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreatePerformanceGroupBuyerAccessSessionError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreatePerformanceGroupBuyerAccessSessionError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreatePerformanceGroupBuyerAccessSessionError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreatePerformanceGroupBuyerAccessSessionError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } }, "get": { "operationId": "listPerformanceGroupBuyerAccessSessions", "summary": "List Performance Group browser session metadata", "tags": [ "Performance Groups" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/performance-groups/" }, "security": [ { "secretKey": [] } ], "parameters": [ { "name": "performanceGroupKey", "in": "path", "required": true, "description": "SeatLayer Performance Group key.", "schema": { "type": "string" } }, { "name": "limit", "description": "Latest session records to return, capped at 100. This endpoint is not cursor-paged.", "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "in": "query", "required": false } ], "x-seatlayer-response-cache": "no-store", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PerformanceGroupBuyerAccessSessionList" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListPerformanceGroupBuyerAccessSessionsError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } } } } }, "/v1/performance-groups/{performanceGroupKey}/buyer-access-sessions/{sessionId}": { "delete": { "operationId": "revokePerformanceGroupBuyerAccessSession", "summary": "Revoke a Performance Group browser session", "tags": [ "Performance Groups" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/performance-groups/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "unsupported", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "performanceGroupKey", "in": "path", "required": true, "description": "SeatLayer Performance Group key.", "schema": { "type": "string" } }, { "name": "sessionId", "in": "path", "required": true, "description": "Short-lived session identifier.", "schema": { "type": "string" } } ], "x-seatlayer-response-cache": "no-store", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PerformanceGroupBuyerAccessRevokeResult" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RevokePerformanceGroupBuyerAccessSessionError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/performance-groups/{performanceGroupKey}/holds/{operationId}": { "get": { "operationId": "retrievePerformanceGroupHold", "summary": "Inspect the trusted allocation of a group hold", "tags": [ "Performance Groups" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/performance-groups/" }, "security": [ { "secretKey": [] } ], "parameters": [ { "name": "performanceGroupKey", "in": "path", "required": true, "description": "SeatLayer Performance Group key.", "schema": { "type": "string" } }, { "name": "operationId", "in": "path", "required": true, "description": "Opaque hold or lifecycle operation identifier.", "schema": { "type": "string" } } ], "x-seatlayer-response-cache": "no-store", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PerformanceGroupHoldEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetrievePerformanceGroupHoldError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetrievePerformanceGroupHoldError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } } } } }, "/v1/performance-groups/{performanceGroupKey}/holds/{operationId}/book": { "post": { "operationId": "bookPerformanceGroupHold", "summary": "Book a paid Performance Group hold", "tags": [ "Performance Groups" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/performance-groups/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "domain-exact-booking-ref", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "performanceGroupKey", "in": "path", "required": true, "description": "SeatLayer Performance Group key.", "schema": { "type": "string" } }, { "name": "operationId", "in": "path", "required": true, "description": "Opaque hold or lifecycle operation identifier.", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PerformanceGroupBookRequest" } } } }, "x-seatlayer-response-cache": "no-store", "responses": { "200": { "description": "All group inventory was booked.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PerformanceGroupBookingEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "202": { "description": "Booking is in progress. Poll the response Location until the booking state is terminal.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Location": { "schema": { "type": "string", "format": "uri-reference" }, "description": "Relative URL to poll for the current operation state." }, "Retry-After": { "schema": { "type": "integer", "minimum": 1 }, "description": "Seconds to wait before polling the supplied Location." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PerformanceGroupBookingEnvelope" } } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BookPerformanceGroupHoldError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BookPerformanceGroupHoldError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BookPerformanceGroupHoldError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BookPerformanceGroupHoldError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/performance-groups/{performanceGroupKey}/bookings/{actionId}": { "get": { "operationId": "retrievePerformanceGroupBooking", "summary": "Retrieve a Performance Group booking action", "tags": [ "Performance Groups" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/performance-groups/" }, "security": [ { "secretKey": [] } ], "parameters": [ { "name": "performanceGroupKey", "in": "path", "required": true, "description": "SeatLayer Performance Group key.", "schema": { "type": "string" } }, { "name": "actionId", "in": "path", "required": true, "description": "Stable Performance Group booking action identifier.", "schema": { "type": "string" } } ], "x-seatlayer-response-cache": "no-store", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PerformanceGroupBookingEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetrievePerformanceGroupBookingError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } } } } }, "/v1/seasons": { "get": { "operationId": "listSeasons", "summary": "List Seasons in the workspace", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "parameters": [ { "name": "workspaceId", "description": "Active workspace id. Defaults to the caller workspace.", "schema": { "type": "string" }, "in": "query", "required": false }, { "name": "structureState", "description": "Filter by structural lifecycle state.", "schema": { "type": "string", "enum": [ "draft", "active", "closing", "closed", "archived" ] }, "in": "query", "required": false }, { "name": "limit", "description": "Page size. Defaults to 100 and is capped at 200.", "schema": { "type": "integer", "minimum": 1, "maximum": 200 }, "in": "query", "required": false }, { "name": "cursor", "description": "Opaque cursor returned by the previous page.", "schema": { "type": "string" }, "in": "query", "required": false } ], "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonPage" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListSeasonsError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListSeasonsError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } } } }, "post": { "operationId": "createSeason", "summary": "Create a draft Season catalogue", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "header-replay", "x-seatlayer-automatic-retry": true, "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Stable key reused for retries of the same logical call.", "schema": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,128}$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonCreateRequest" } } } }, "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "201": { "description": "Season created as a draft with sales closed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "400": { "description": "The request is malformed or misses a required value.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateSeasonError400" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateSeasonError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateSeasonError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateSeasonError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateSeasonError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The service or one of its required dependencies is temporarily unavailable. The API can also be temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/CreateSeasonError503" }, { "$ref": "#/components/schemas/MaintenanceError" } ] } } } } } } }, "/v1/seasons/validate": { "post": { "operationId": "validateSeason", "summary": "Preflight direct Events and active Performance Groups with exact remediation", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "unsupported", "x-seatlayer-automatic-retry": false, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonValidateRequest" } } } }, "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "Compatibility result with exact Event/field remediation.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonValidationEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidateSeasonError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidateSeasonError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidateSeasonError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/seasons/{seasonKey}": { "get": { "operationId": "retrieveSeason", "summary": "Retrieve a Season and its Plans", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetrieveSeasonError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } } } }, "patch": { "operationId": "updateSeason", "summary": "Rename a draft Season", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "header-replay", "x-seatlayer-automatic-retry": true, "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Stable key reused for retries of the same logical call.", "schema": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,128}$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonUpdateRequest" } } } }, "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "Draft Season updated.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "400": { "description": "The request is malformed or misses a required value.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateSeasonError400" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateSeasonError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateSeasonError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateSeasonError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateSeasonError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } }, "delete": { "operationId": "deleteSeason", "summary": "Discard an unused draft Season", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "header-replay", "x-seatlayer-automatic-retry": true, "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Stable key reused for retries of the same logical call.", "schema": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,128}$" } } ], "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "204": { "description": "Draft Season discarded.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeleteSeasonError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeleteSeasonError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeleteSeasonError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/seasons/{seasonKey}/activate": { "post": { "operationId": "activateSeason", "summary": "Activate Season structure without publishing a Plan or opening sales", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "domain-exact", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonLifecycleRequest" } } } }, "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "Season structure activated. Sales remain closed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonLifecycleEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "202": { "description": "Activation is durably accepted and awaiting recovery. Poll Location until terminal.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Location": { "schema": { "type": "string", "format": "uri-reference" }, "description": "Relative URL to poll for the current operation state." }, "Retry-After": { "schema": { "type": "integer", "minimum": 1 }, "description": "Seconds to wait before polling the supplied Location." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonLifecycleEnvelope" } } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ActivateSeasonError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ActivateSeasonError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ActivateSeasonError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ActivateSeasonError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/seasons/{seasonKey}/close": { "post": { "operationId": "closeSeason", "summary": "Close an active Season after sales are not open", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "domain-exact", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonLifecycleRequest" } } } }, "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "Season structure closed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonLifecycleEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "202": { "description": "Close is durably accepted and awaiting recovery. Poll Location until terminal.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Location": { "schema": { "type": "string", "format": "uri-reference" }, "description": "Relative URL to poll for the current operation state." }, "Retry-After": { "schema": { "type": "integer", "minimum": 1 }, "description": "Seconds to wait before polling the supplied Location." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonLifecycleEnvelope" } } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CloseSeasonError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CloseSeasonError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CloseSeasonError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CloseSeasonError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/seasons/{seasonKey}/archive": { "post": { "operationId": "archiveSeason", "summary": "Archive a closed Season while retaining recovery and audit", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "domain-exact", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonLifecycleRequest" } } } }, "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "Closed Season archived with recovery and audit retained.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonLifecycleEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "202": { "description": "Archive is durably accepted and awaiting recovery. Poll Location until terminal.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Location": { "schema": { "type": "string", "format": "uri-reference" }, "description": "Relative URL to poll for the current operation state." }, "Retry-After": { "schema": { "type": "integer", "minimum": 1 }, "description": "Seconds to wait before polling the supplied Location." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonLifecycleEnvelope" } } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ArchiveSeasonError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ArchiveSeasonError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ArchiveSeasonError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ArchiveSeasonError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/seasons/{seasonKey}/lifecycle/{operationId}": { "get": { "operationId": "retrieveSeasonLifecycle", "summary": "Retrieve a Season structure lifecycle operation", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } }, { "name": "operationId", "in": "path", "required": true, "description": "Opaque hold or lifecycle operation identifier.", "schema": { "type": "string" } } ], "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "Lifecycle state. A non-terminal response includes Retry-After.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "minimum": 1 }, "description": "Seconds to wait before polling the supplied Location." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonLifecycleEnvelope" } } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetrieveSeasonLifecycleError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } } } } }, "/v1/seasons/{seasonKey}/plans": { "post": { "operationId": "createSeasonPlan", "summary": "Add a draft Plan to a Season edition", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "header-replay", "x-seatlayer-automatic-retry": true, "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Stable key reused for retries of the same logical call.", "schema": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,128}$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonPlanCreateRequest" } } } }, "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "201": { "description": "Draft Season Plan created.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonPlanEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "400": { "description": "The request is malformed or misses a required value.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateSeasonPlanError400" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateSeasonPlanError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateSeasonPlanError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateSeasonPlanError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateSeasonPlanError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The service or one of its required dependencies is temporarily unavailable. The API can also be temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/CreateSeasonPlanError503" }, { "$ref": "#/components/schemas/MaintenanceError" } ] } } } } } } }, "/v1/seasons/{seasonKey}/plans/{planKey}": { "get": { "operationId": "retrieveSeasonPlan", "summary": "Retrieve a Season Plan", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } }, { "name": "planKey", "in": "path", "required": true, "description": "Season Plan key.", "schema": { "type": "string" } } ], "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonPlanEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetrieveSeasonPlanError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } } } }, "patch": { "operationId": "updateSeasonPlan", "summary": "Rename a draft package or change the performances it covers", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "header-replay", "x-seatlayer-automatic-retry": true, "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } }, { "name": "planKey", "in": "path", "required": true, "description": "Season Plan key.", "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Stable key reused for retries of the same logical call.", "schema": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,128}$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonPlanUpdateRequest" } } } }, "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "Draft package renamed or re-scoped.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonPackageEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "400": { "description": "The request is malformed or misses a required value.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateSeasonPlanError400" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateSeasonPlanError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateSeasonPlanError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateSeasonPlanError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateSeasonPlanError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } }, "delete": { "operationId": "deleteSeasonPlan", "summary": "Delete a draft package that is not the last one", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "header-replay", "x-seatlayer-automatic-retry": true, "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } }, { "name": "planKey", "in": "path", "required": true, "description": "Season Plan key.", "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Stable key reused for retries of the same logical call.", "schema": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,128}$" } } ], "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "204": { "description": "Draft package deleted.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "400": { "description": "The request is malformed or misses a required value.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeleteSeasonPlanError400" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeleteSeasonPlanError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeleteSeasonPlanError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeleteSeasonPlanError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeleteSeasonPlanError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/seasons/{seasonKey}/plans/{planKey}/publish": { "post": { "operationId": "publishSeasonPlan", "summary": "Publish an immutable Season Plan without opening sales", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "domain-exact", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } }, { "name": "planKey", "in": "path", "required": true, "description": "Season Plan key.", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonLifecycleRequest" } } } }, "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "Plan published. Sales remain closed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonPlanPublishEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "202": { "description": "Plan publication is durably accepted and awaiting recovery. Poll Location until terminal.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Location": { "schema": { "type": "string", "format": "uri-reference" }, "description": "Relative URL to poll for the current operation state." }, "Retry-After": { "schema": { "type": "integer", "minimum": 1 }, "description": "Seconds to wait before polling the supplied Location." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonPlanPublishEnvelope" } } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublishSeasonPlanError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublishSeasonPlanError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublishSeasonPlanError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublishSeasonPlanError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The service or one of its required dependencies is temporarily unavailable. The API can also be temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/PublishSeasonPlanError503" }, { "$ref": "#/components/schemas/MaintenanceError" } ] } } } } } } }, "/v1/seasons/{seasonKey}/plans/{planKey}/supersede": { "post": { "operationId": "supersedeSeasonPlan", "summary": "Supersede a published Season Plan", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "domain-exact", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } }, { "name": "planKey", "in": "path", "required": true, "description": "Season Plan key.", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonLifecycleRequest" } } } }, "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "Published Plan superseded.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonPlanPublishEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SupersedeSeasonPlanError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SupersedeSeasonPlanError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SupersedeSeasonPlanError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SupersedeSeasonPlanError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/seasons/{seasonKey}/sales/open": { "post": { "operationId": "openSeasonSales", "summary": "Open Season sales after rehearsal evidence exists", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "domain-exact", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonLifecycleRequest" } } } }, "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "Season sales opened. Audience remains embed_only. `warnings` names anything unproven, such as a missing checkout test, without blocking the sale.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonSalesOpenEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OpenSeasonSalesError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OpenSeasonSalesError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OpenSeasonSalesError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OpenSeasonSalesError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The service or one of its required dependencies is temporarily unavailable. The API can also be temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/OpenSeasonSalesError503" }, { "$ref": "#/components/schemas/MaintenanceError" } ] } } } } } } }, "/v1/seasons/{seasonKey}/sales/pause": { "post": { "operationId": "pauseSeasonSales", "summary": "Pause open Season sales", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "domain-exact", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonLifecycleRequest" } } } }, "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PauseSeasonSalesError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PauseSeasonSalesError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PauseSeasonSalesError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PauseSeasonSalesError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/seasons/{seasonKey}/sales/resume": { "post": { "operationId": "resumeSeasonSales", "summary": "Resume paused Season sales", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "domain-exact", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonLifecycleRequest" } } } }, "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "Paused Season sales resumed. `warnings` carries the same advisory readiness notes as open.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonSalesOpenEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResumeSeasonSalesError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResumeSeasonSalesError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResumeSeasonSalesError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResumeSeasonSalesError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The service or one of its required dependencies is temporarily unavailable. The API can also be temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ResumeSeasonSalesError503" }, { "$ref": "#/components/schemas/MaintenanceError" } ] } } } } } } }, "/v1/seasons/{seasonKey}/sales/end": { "post": { "operationId": "endSeasonSales", "summary": "End Season sales", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "domain-exact", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonLifecycleRequest" } } } }, "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EndSeasonSalesError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EndSeasonSalesError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EndSeasonSalesError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EndSeasonSalesError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/seasons/{seasonKey}/duplicate-to-live": { "post": { "operationId": "duplicateSeasonToLive", "summary": "Duplicate a test Season to new live identities with sales closed", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "header-replay", "x-seatlayer-automatic-retry": true, "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Stable key reused for retries of the same logical call.", "schema": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,128}$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonDuplicateRequest" } } } }, "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "201": { "description": "New live Season identities created with sales closed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "400": { "description": "The request is malformed or misses a required value.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DuplicateSeasonToLiveError400" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DuplicateSeasonToLiveError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DuplicateSeasonToLiveError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DuplicateSeasonToLiveError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DuplicateSeasonToLiveError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The service or one of its required dependencies is temporarily unavailable. The API can also be temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/DuplicateSeasonToLiveError503" }, { "$ref": "#/components/schemas/MaintenanceError" } ] } } } } } } }, "/v1/seasons/{seasonKey}/buyer-access-sessions": { "post": { "operationId": "createSeasonBuyerAccessSession", "summary": "Create a one-time Season browser access token", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "unsupported-one-time-secret", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonBuyerAccessSessionRequest" } } } }, "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "201": { "description": "One-time Season browser access token created.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonBuyerAccessReveal" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateSeasonBuyerAccessSessionError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateSeasonBuyerAccessSessionError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateSeasonBuyerAccessSessionError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateSeasonBuyerAccessSessionError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The service or one of its required dependencies is temporarily unavailable. The API can also be temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/CreateSeasonBuyerAccessSessionError503" }, { "$ref": "#/components/schemas/MaintenanceError" } ] } } } } } }, "get": { "operationId": "listSeasonBuyerAccessSessions", "summary": "List Season browser session metadata", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } }, { "name": "limit", "description": "Latest session records to return, capped at 100.", "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "in": "query", "required": false } ], "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonBuyerAccessSessionList" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListSeasonBuyerAccessSessionsError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } } } } }, "/v1/seasons/{seasonKey}/buyer-access-sessions/{sessionId}": { "delete": { "operationId": "revokeSeasonBuyerAccessSession", "summary": "Revoke a Season browser session", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "domain-exact", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } }, { "name": "sessionId", "in": "path", "required": true, "description": "Short-lived session identifier.", "schema": { "type": "string" } } ], "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonBuyerAccessRevokeResult" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RevokeSeasonBuyerAccessSessionError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/seasons/{seasonKey}/holds/{operationId}": { "get": { "operationId": "retrieveSeasonHold", "summary": "Inspect a Season allocation without commercial amounts", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } }, { "name": "operationId", "in": "path", "required": true, "description": "Opaque hold or lifecycle operation identifier.", "schema": { "type": "string" } } ], "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonHoldEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetrieveSeasonHoldError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } } } } }, "/v1/seasons/{seasonKey}/holds/{operationId}/book": { "post": { "operationId": "bookSeasonHold", "summary": "Book Season inventory after the host payment decision", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "domain-exact-booking-ref", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } }, { "name": "operationId", "in": "path", "required": true, "description": "Opaque hold or lifecycle operation identifier.", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonBookRequest" } } } }, "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "All Season inventory was booked.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonBookingEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "202": { "description": "Booking is durably accepted. Poll Location until the booking is terminal.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Location": { "schema": { "type": "string", "format": "uri-reference" }, "description": "Relative URL to poll for the current operation state." }, "Retry-After": { "schema": { "type": "integer", "minimum": 1 }, "description": "Seconds to wait before polling the supplied Location." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonBookingEnvelope" } } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BookSeasonHoldError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BookSeasonHoldError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BookSeasonHoldError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BookSeasonHoldError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/seasons/{seasonKey}/bookings/{actionId}": { "get": { "operationId": "retrieveSeasonBooking", "summary": "Retrieve a Season booking action", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } }, { "name": "actionId", "in": "path", "required": true, "description": "Stable Performance Group booking action identifier.", "schema": { "type": "string" } } ], "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonBookingEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetrieveSeasonBookingError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } } } } }, "/v1/seasons/{seasonKey}/bookings/{actionId}/cancel": { "post": { "operationId": "cancelSeasonBooking", "summary": "Cancel a Season booking with an explicit right disposition", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "domain-exact", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } }, { "name": "actionId", "in": "path", "required": true, "description": "Stable Performance Group booking action identifier.", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonCancelRequest" } } } }, "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "Season booking cancelled with an explicit right disposition.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonBookingEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "202": { "description": "Cancellation is durably accepted. Poll Location until the cancellation is terminal.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Location": { "schema": { "type": "string", "format": "uri-reference" }, "description": "Relative URL to poll for the current operation state." }, "Retry-After": { "schema": { "type": "integer", "minimum": 1 }, "description": "Seconds to wait before polling the supplied Location." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonBookingEnvelope" } } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CancelSeasonBookingError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CancelSeasonBookingError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CancelSeasonBookingError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CancelSeasonBookingError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/seasons/{seasonKey}/buyer-rehearsals/validate": { "post": { "operationId": "validateSeasonBuyerRehearsal", "summary": "Discover and validate retained buyer rehearsal evidence", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "domain-exact", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonBuyerRehearsalEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidateSeasonBuyerRehearsalError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidateSeasonBuyerRehearsalError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidateSeasonBuyerRehearsalError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidateSeasonBuyerRehearsalError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/seasons/{seasonKey}/imports": { "post": { "operationId": "createSeasonHolderImport", "summary": "Dry-run or commit an incumbent holder/right import", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "header-replay", "x-seatlayer-automatic-retry": true, "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Stable key reused for retries of the same logical call.", "schema": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,128}$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonHolderImportRequest" } } } }, "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "Dry-run or rejected import recorded; no rights created.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonHolderImportEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "201": { "description": "Incumbent holder import committed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonHolderImportEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "400": { "description": "The request is malformed or misses a required value.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateSeasonHolderImportError400" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateSeasonHolderImportError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateSeasonHolderImportError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateSeasonHolderImportError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateSeasonHolderImportError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/seasons/{seasonKey}/imports/from-season": { "post": { "operationId": "createSeasonHolderImportFromSeason", "summary": "Dry-run or commit renewal rights derived from a previous season's holders", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "header-replay", "x-seatlayer-automatic-retry": true, "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Stable key reused for retries of the same logical call.", "schema": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,128}$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonHolderImportFromSeasonRequest" } } } }, "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "Dry run: who would come across; nothing created.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonHolderImportFromSeasonEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "201": { "description": "Holders brought across; rejected rows reported.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonHolderImportFromSeasonEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "400": { "description": "The request is malformed or misses a required value.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateSeasonHolderImportFromSeasonError400" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateSeasonHolderImportFromSeasonError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateSeasonHolderImportFromSeasonError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateSeasonHolderImportFromSeasonError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateSeasonHolderImportFromSeasonError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/seasons/{seasonKey}/imports/{importId}": { "get": { "operationId": "retrieveSeasonHolderImport", "summary": "Retrieve an incumbent holder import", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } }, { "name": "importId", "in": "path", "required": true, "description": "Season incumbent-holder import identifier.", "schema": { "type": "string" } } ], "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonHolderImportEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetrieveSeasonHolderImportError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } } } } }, "/v1/seasons/{seasonKey}/renewal-offers": { "post": { "operationId": "createSeasonRenewalOffers", "summary": "Generate one renewal offer per eligible prior Contract", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "header-replay", "x-seatlayer-automatic-retry": true, "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Stable key reused for retries of the same logical call.", "schema": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,128}$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonRenewalOfferCreateRequest" } } } }, "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "201": { "description": "One offer per eligible prior Contract.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonRenewalOfferList" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "400": { "description": "The request is malformed or misses a required value.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateSeasonRenewalOffersError400" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateSeasonRenewalOffersError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateSeasonRenewalOffersError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateSeasonRenewalOffersError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateSeasonRenewalOffersError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } }, "get": { "operationId": "listSeasonRenewalOffers", "summary": "List Season renewal offers", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "Latest 100 renewal offers; truncated reports whether older offers exist.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonRenewalOfferList" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListSeasonRenewalOffersError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } } } } }, "/v1/seasons/{seasonKey}/renewal-offers/{offerId}": { "get": { "operationId": "retrieveSeasonRenewalOffer", "summary": "Retrieve a Season renewal offer", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } }, { "name": "offerId", "in": "path", "required": true, "description": "Season renewal offer identifier.", "schema": { "type": "string" } } ], "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonRenewalOfferEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetrieveSeasonRenewalOfferError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } } } } }, "/v1/seasons/{seasonKey}/renewal-offers/{offerId}/extend": { "post": { "operationId": "extendSeasonRenewalOffer", "summary": "Extend a non-terminal renewal offer deadline", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "domain-exact", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } }, { "name": "offerId", "in": "path", "required": true, "description": "Season renewal offer identifier.", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonRenewalOfferExtendRequest" } } } }, "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "Offer deadline extended.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonRenewalOfferEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExtendSeasonRenewalOfferError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExtendSeasonRenewalOfferError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExtendSeasonRenewalOfferError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/seasons/{seasonKey}/renewal-offers/{offerId}/inspect": { "get": { "operationId": "inspectSeasonRenewalOffer", "summary": "Inspect the exact Seat Right set and successor Plan of an offer", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } }, { "name": "offerId", "in": "path", "required": true, "description": "Season renewal offer identifier.", "schema": { "type": "string" } } ], "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonRenewalOfferEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InspectSeasonRenewalOfferError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } } } } }, "/v1/seasons/{seasonKey}/renewal-offers/{offerId}/commit": { "post": { "operationId": "commitSeasonRenewalOffer", "summary": "Commit a renewal offer after holder intent and host payment", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "domain-exact-booking-ref", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } }, { "name": "offerId", "in": "path", "required": true, "description": "Season renewal offer identifier.", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonRenewalOfferCommitRequest" } } } }, "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "Renewal committed to a host-confirmed Contract.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonRenewalOfferEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "202": { "description": "Renewal commit is durably accepted. Poll Location until the offer is terminal.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Location": { "schema": { "type": "string", "format": "uri-reference" }, "description": "Relative URL to poll for the current operation state." }, "Retry-After": { "schema": { "type": "integer", "minimum": 1 }, "description": "Seconds to wait before polling the supplied Location." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonRenewalOfferEnvelope" } } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommitSeasonRenewalOfferError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommitSeasonRenewalOfferError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommitSeasonRenewalOfferError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommitSeasonRenewalOfferError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/seasons/{seasonKey}/renewal-offers/{offerId}/decline": { "post": { "operationId": "declineSeasonRenewalOffer", "summary": "Decline a renewal offer and release the Seat Right set", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "domain-exact", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } }, { "name": "offerId", "in": "path", "required": true, "description": "Season renewal offer identifier.", "schema": { "type": "string" } } ], "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "Offer declined and Seat Rights released.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonRenewalOfferEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeclineSeasonRenewalOfferError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeclineSeasonRenewalOfferError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/seasons/{seasonKey}/renewal-offers/{offerId}/release": { "post": { "operationId": "releaseSeasonRenewalOffer", "summary": "Release a lapsed renewal offer into new-sale inventory", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "domain-exact", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } }, { "name": "offerId", "in": "path", "required": true, "description": "Season renewal offer identifier.", "schema": { "type": "string" } } ], "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "Lapsed offer released into new-sale inventory.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonRenewalOfferEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReleaseSeasonRenewalOfferError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReleaseSeasonRenewalOfferError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/seasons/{seasonKey}/performances": { "get": { "operationId": "listSeasonPerformances", "summary": "List Season performances and package membership in every lifecycle state", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "Catalogue schedule and package membership. Answers in every lifecycle state, including draft.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonPerformanceList" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListSeasonPerformancesError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } } } }, "post": { "operationId": "createSeasonPerformances", "summary": "Create performances inside a draft Season from a repeat rule", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "header-replay", "x-seatlayer-automatic-retry": true, "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Stable key reused for retries of the same logical call.", "schema": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,128}$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonPerformanceCreateRequest" } } } }, "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "201": { "description": "Performances created on the Season chart and attached to the chosen packages.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonPerformanceCreateEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "400": { "description": "The request is malformed or misses a required value.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateSeasonPerformancesError400" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "402": { "description": "The account does not have enough credits for this operation.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateSeasonPerformancesError402" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateSeasonPerformancesError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateSeasonPerformancesError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateSeasonPerformancesError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateSeasonPerformancesError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/seasons/{seasonKey}/performances/attach": { "post": { "operationId": "attachSeasonPerformances", "summary": "Attach existing Events to a draft Season and its packages", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "header-replay", "x-seatlayer-automatic-retry": true, "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Stable key reused for retries of the same logical call.", "schema": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,128}$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonPerformanceAttachRequest" } } } }, "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "Existing Events attached to the draft Season.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonPerformanceList" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "400": { "description": "The request is malformed or misses a required value.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AttachSeasonPerformancesError400" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AttachSeasonPerformancesError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AttachSeasonPerformancesError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AttachSeasonPerformancesError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AttachSeasonPerformancesError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/seasons/{seasonKey}/performances/{eventKey}": { "delete": { "operationId": "deleteSeasonPerformance", "summary": "Remove a performance from a draft Season and every package", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "header-replay", "x-seatlayer-automatic-retry": true, "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } }, { "name": "eventKey", "in": "path", "required": true, "description": "eventKey path parameter.", "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Stable key reused for retries of the same logical call.", "schema": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,128}$" } } ], "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "Performance removed from the draft Season.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonPerformanceList" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "400": { "description": "The request is malformed or misses a required value.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeleteSeasonPerformanceError400" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeleteSeasonPerformanceError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeleteSeasonPerformanceError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeleteSeasonPerformanceError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeleteSeasonPerformanceError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/seasons/{seasonKey}/publish": { "post": { "operationId": "publishSeason", "summary": "Activate the Season structure and publish every draft package in one retryable call", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "header-replay", "x-seatlayer-automatic-retry": true, "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Stable key reused for retries of the same logical call.", "schema": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,128}$" } } ], "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "Structure activated where needed and every draft package published. Safe to retry.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonPublishEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "400": { "description": "The request is malformed or misses a required value.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublishSeasonError400" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublishSeasonError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublishSeasonError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublishSeasonError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublishSeasonError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The service or one of its required dependencies is temporarily unavailable. The API can also be temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/PublishSeasonError503" }, { "$ref": "#/components/schemas/MaintenanceError" } ] } } } } } } }, "/v1/seasons/{seasonKey}/checkout-tests": { "post": { "operationId": "createSeasonCheckoutTest", "summary": "Run a server-side hold and release to prove the Season buyer path", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "header-replay", "x-seatlayer-automatic-retry": true, "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Stable key reused for retries of the same logical call.", "schema": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,128}$" } } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonCheckoutTestRequest" } } } }, "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "Checkout test completed. `status` says whether every step passed; nothing is ever booked.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonCheckoutTestEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "400": { "description": "The request is malformed or misses a required value.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateSeasonCheckoutTestError400" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateSeasonCheckoutTestError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateSeasonCheckoutTestError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateSeasonCheckoutTestError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateSeasonCheckoutTestError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } }, "get": { "operationId": "listSeasonCheckoutTests", "summary": "List recent Season checkout tests, newest first", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "Up to twenty checkout tests, newest first.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonCheckoutTestList" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListSeasonCheckoutTestsError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } } } } }, "/v1/seasons/{seasonKey}/plans/{planKey}/prices": { "put": { "operationId": "replaceSeasonPackagePrices", "summary": "Replace a package price table, per chart category, in minor units", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "header-replay", "x-seatlayer-automatic-retry": true, "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } }, { "name": "planKey", "in": "path", "required": true, "description": "Season Plan key.", "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Stable key reused for retries of the same logical call.", "schema": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,128}$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonPackagePricesRequest" } } } }, "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "Package price table replaced. Categories absent from the body stop being priced.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonPackagePricesEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "400": { "description": "The request is malformed or misses a required value.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReplaceSeasonPackagePricesError400" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReplaceSeasonPackagePricesError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReplaceSeasonPackagePricesError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReplaceSeasonPackagePricesError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/seasons/{seasonKey}/prices": { "get": { "operationId": "listSeasonPrices", "summary": "List every package price table for a Season", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "Every package and its priced categories.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonPriceList" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListSeasonPricesError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } } } } }, "/v1/seasons/{seasonKey}/plans/{planKey}/performances": { "post": { "operationId": "attachSeasonPlanPerformance", "summary": "Add a performance to a published package and extend its allocations", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "header-replay", "x-seatlayer-automatic-retry": true, "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } }, { "name": "planKey", "in": "path", "required": true, "description": "Season Plan key.", "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Stable key reused for retries of the same logical call.", "schema": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,128}$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonAttachPerformanceRequest" } } } }, "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "The performance joined the published package; extended allocations and unresolved conflicts are listed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonAmendmentPerformanceEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "400": { "description": "The request is malformed or misses a required value.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AttachSeasonPlanPerformanceError400" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AttachSeasonPlanPerformanceError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AttachSeasonPlanPerformanceError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AttachSeasonPlanPerformanceError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AttachSeasonPlanPerformanceError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/seasons/{seasonKey}/plans/{planKey}/performances/{eventKey}": { "delete": { "operationId": "deleteSeasonPlanPerformance", "summary": "Remove a performance from a published package and release its allocations", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "header-replay", "x-seatlayer-automatic-retry": true, "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } }, { "name": "planKey", "in": "path", "required": true, "description": "Season Plan key.", "schema": { "type": "string" } }, { "name": "eventKey", "in": "path", "required": true, "description": "eventKey path parameter.", "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Stable key reused for retries of the same logical call.", "schema": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,128}$" } } ], "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "The package no longer covers the performance; its allocations were released to that Event.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonRemovePerformanceEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "400": { "description": "The request is malformed or misses a required value.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeleteSeasonPlanPerformanceError400" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeleteSeasonPlanPerformanceError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeleteSeasonPlanPerformanceError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeleteSeasonPlanPerformanceError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeleteSeasonPlanPerformanceError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/seasons/{seasonKey}/performances/{eventKey}/past": { "post": { "operationId": "markSeasonPerformancePast", "summary": "Mark a performance past so it stops blocking new Season sales", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "header-replay", "x-seatlayer-automatic-retry": true, "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } }, { "name": "eventKey", "in": "path", "required": true, "description": "eventKey path parameter.", "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Stable key reused for retries of the same logical call.", "schema": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,128}$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonMarkPastRequest" } } } }, "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "The performance is past for Season purposes and no longer blocks a new sale.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonPerformanceList" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "400": { "description": "The request is malformed or misses a required value.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MarkSeasonPerformancePastError400" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MarkSeasonPerformancePastError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MarkSeasonPerformancePastError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MarkSeasonPerformancePastError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MarkSeasonPerformancePastError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/seasons/{seasonKey}/occurrences": { "get": { "operationId": "listSeasonOccurrences", "summary": "List Season occurrences with schedule and amendment state", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } }, { "name": "planActivationId", "description": "Published Plan activation to inspect. Required when multiple Plans are published.", "schema": { "type": "string", "minLength": 1, "maxLength": 160 }, "in": "query", "required": false } ], "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonOccurrenceList" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListSeasonOccurrencesError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListSeasonOccurrencesError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListSeasonOccurrencesError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } } } } }, "/v1/seasons/{seasonKey}/occurrences/{eventKey}/returns": { "post": { "operationId": "returnSeasonOccurrenceInventory", "summary": "Return one Season occurrence allocation to ordinary Event inventory", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "domain-exact", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } }, { "name": "eventKey", "in": "path", "required": true, "description": "eventKey path parameter.", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonOccurrenceReturnRequest" } } } }, "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "Occurrence inventory returned to ordinary Event sale.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonOccurrenceInventoryActionEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReturnSeasonOccurrenceInventoryError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReturnSeasonOccurrenceInventoryError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReturnSeasonOccurrenceInventoryError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReturnSeasonOccurrenceInventoryError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The service or one of its required dependencies is temporarily unavailable. The API can also be temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ReturnSeasonOccurrenceInventoryError503" }, { "$ref": "#/components/schemas/MaintenanceError" } ] } } } } } } }, "/v1/seasons/{seasonKey}/occurrences/{eventKey}/reclaims": { "post": { "operationId": "reclaimSeasonOccurrenceInventory", "summary": "Reclaim returned occurrence inventory while it is still free", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "domain-exact", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } }, { "name": "eventKey", "in": "path", "required": true, "description": "eventKey path parameter.", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonOccurrenceReclaimRequest" } } } }, "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "Returned occurrence inventory reclaimed by the Season holder.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonOccurrenceInventoryActionEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReclaimSeasonOccurrenceInventoryError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReclaimSeasonOccurrenceInventoryError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReclaimSeasonOccurrenceInventoryError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReclaimSeasonOccurrenceInventoryError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The service or one of its required dependencies is temporarily unavailable. The API can also be temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ReclaimSeasonOccurrenceInventoryError503" }, { "$ref": "#/components/schemas/MaintenanceError" } ] } } } } } } }, "/v1/seasons/{seasonKey}/amendments": { "post": { "operationId": "createSeasonAmendment", "summary": "Record an identity-preserving reschedule or an operator exception", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "header-replay", "x-seatlayer-automatic-retry": true, "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Stable key reused for retries of the same logical call.", "schema": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,128}$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonAmendmentRequest" } } } }, "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "201": { "description": "Amendment recorded. Published Plan membership is unchanged.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonAmendmentEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "400": { "description": "The request is malformed or misses a required value.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateSeasonAmendmentError400" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "The caller lacks authority or its credential mode conflicts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateSeasonAmendmentError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateSeasonAmendmentError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The request conflicts with current resource or inventory state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateSeasonAmendmentError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateSeasonAmendmentError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } }, "get": { "operationId": "listSeasonAmendments", "summary": "List Season amendments", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "Latest 100 amendments; truncated reports whether older amendments exist.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonAmendmentList" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListSeasonAmendmentsError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } } } } }, "/v1/seasons/{seasonKey}/amendments/{amendmentId}": { "get": { "operationId": "retrieveSeasonAmendment", "summary": "Retrieve a Season amendment", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } }, { "name": "amendmentId", "in": "path", "required": true, "description": "Season amendment identifier.", "schema": { "type": "string" } } ], "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonAmendmentEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetrieveSeasonAmendmentError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } } } } }, "/v1/seasons/{seasonKey}/reports": { "get": { "operationId": "retrieveSeasonReport", "summary": "Retrieve inventory, renewal, operation, and outbox totals", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonReportEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetrieveSeasonReportError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } } } } }, "/v1/seasons/{seasonKey}/operations": { "get": { "operationId": "listSeasonOperations", "summary": "List Season inventory operations including stuck work", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "Latest 50 operations; truncated reports whether older operations exist.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonOperationList" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListSeasonOperationsError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } } } } }, "/v1/seasons/{seasonKey}/support-lookups": { "get": { "operationId": "retrieveSeasonSupportLookup", "summary": "Look up a booking or holder reference without refund claims", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } }, { "name": "bookingRef", "description": "Opaque host booking reference.", "schema": { "type": "string" }, "in": "query", "required": false }, { "name": "holderRef", "description": "Opaque holder reference.", "schema": { "type": "string" }, "in": "query", "required": false } ], "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonSupportLookupEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetrieveSeasonSupportLookupError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The request is well formed but violates an operation rule.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetrieveSeasonSupportLookupError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } } } } }, "/v1/seasons/{seasonKey}/outbox": { "get": { "operationId": "listSeasonOutbox", "summary": "List the Season missed-event outbox", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "Latest 100 outbox occurrences; truncated reports whether older occurrences exist.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonOutboxList" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListSeasonOutboxError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } } } } }, "/v1/seasons/{seasonKey}/outbox/{occurrenceId}/replay": { "post": { "operationId": "replaySeasonOutbox", "summary": "Replay one Season outbox occurrence with the same payload", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "unsupported", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } }, { "name": "occurrenceId", "in": "path", "required": true, "description": "Season outbox occurrence identifier.", "schema": { "type": "string" } } ], "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "Outbox occurrence replayed with the original payload.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonOutboxReplayEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReplaySeasonOutboxError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/seasons/{seasonKey}/audit": { "get": { "operationId": "listSeasonAudit", "summary": "List the redacted Season support audit", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonAuditEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListSeasonAuditError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } } } } }, "/v1/seasons/{seasonKey}/export": { "get": { "operationId": "exportSeasonSupportSnapshot", "summary": "Export a bounded, versioned Season support snapshot", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonSupportExportEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such resource exists in the caller scope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExportSeasonSupportSnapshotError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } } } } }, "/v1/seasons/{seasonKey}/holders": { "get": { "operationId": "listSeasonHolders", "summary": "List season ticket holders, one page at a time", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } }, { "name": "q", "description": "Search by holder name, email, reference, order number or seat.", "schema": { "type": "string", "maxLength": 120 }, "in": "query", "required": false }, { "name": "status", "description": "Only these holders.", "schema": { "type": "string", "enum": [ "active", "cancelled", "renewal" ] }, "in": "query", "required": false }, { "name": "cursor", "description": "Opaque cursor returned by the previous page.", "schema": { "type": "string" }, "in": "query", "required": false }, { "name": "limit", "description": "Page size. Defaults to 50 and is capped at 100.", "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "in": "query", "required": false } ], "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "One page of holders. `totals` comes with the first page.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonHolderPage" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "400": { "description": "The status or cursor is not valid.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListSeasonHoldersError400" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "A publishable key was sent. These calls need a secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListSeasonHoldersError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such season, order or offer for this key and mode.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListSeasonHoldersError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } } } } }, "/v1/seasons/{seasonKey}/orders/{orderId}/refund": { "post": { "operationId": "refundSeasonOrder", "summary": "Refund a season order in full or in part through its payment provider", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "header-replay", "x-seatlayer-automatic-retry": true, "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } }, { "name": "orderId", "in": "path", "required": true, "description": "orderId path parameter.", "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Stable key reused for retries of the same logical call.", "schema": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,128}$" } } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonOrderRefundRequest" } } } }, "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "The payment provider confirmed the refund.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonOrderRefundEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "202": { "description": "The provider accepted the refund but has not confirmed it. Retry with the same Idempotency-Key to read its state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonOrderRefundEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "400": { "description": "The Idempotency-Key header is missing or not valid.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RefundSeasonOrderError400" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "A publishable key was sent. These calls need a secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RefundSeasonOrderError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such season, order or offer for this key and mode.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RefundSeasonOrderError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The order cannot be refunded as asked right now.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RefundSeasonOrderError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The amount is not a whole number above zero, or is more than is left.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RefundSeasonOrderError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "502": { "description": "The provider may have taken the refund; retry with the same Idempotency-Key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RefundSeasonOrderError502" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/seasons/{seasonKey}/orders/{orderId}/cancel": { "post": { "operationId": "cancelSeasonOrder", "summary": "Cancel a season order without moving money and release every date", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "header-replay", "x-seatlayer-automatic-retry": true, "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } }, { "name": "orderId", "in": "path", "required": true, "description": "orderId path parameter.", "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Stable key reused for retries of the same logical call.", "schema": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,128}$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonOrderCancelRequest" } } } }, "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "Order cancelled, every ticket void and every date released.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonOrderCancelEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "400": { "description": "The Idempotency-Key header is missing or not valid.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CancelSeasonOrderError400" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "A publishable key was sent. These calls need a secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CancelSeasonOrderError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such season, order or offer for this key and mode.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CancelSeasonOrderError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The order cannot be cancelled here right now.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CancelSeasonOrderError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "A reason, or a confirmation, is missing.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CancelSeasonOrderError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/seasons/{seasonKey}/orders/{orderId}/dates/{eventKey}/cancel": { "post": { "operationId": "cancelSeasonOrderDate", "summary": "Take back one date of a season order and put its seats back on sale", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "header-replay", "x-seatlayer-automatic-retry": true, "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } }, { "name": "orderId", "in": "path", "required": true, "description": "orderId path parameter.", "schema": { "type": "string" } }, { "name": "eventKey", "in": "path", "required": true, "description": "eventKey path parameter.", "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Stable key reused for retries of the same logical call.", "schema": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,128}$" } } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonOrderDateCancelRequest" } } } }, "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "The date's tickets are void and its seats are back on sale.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonOrderDateCancelEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "202": { "description": "The tickets are void and the seats are on their way back. Retry with the same Idempotency-Key.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "minimum": 1 }, "description": "Seconds to wait before polling the supplied Location." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonOrderDateCancelEnvelope" } } } }, "400": { "description": "The Idempotency-Key header is missing or not valid.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CancelSeasonOrderDateError400" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "A publishable key was sent. These calls need a secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CancelSeasonOrderDateError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such season, order or offer for this key and mode.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CancelSeasonOrderDateError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The order or the date cannot be taken back.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CancelSeasonOrderDateError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The action id or the date key is not valid.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CancelSeasonOrderDateError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/seasons/{seasonKey}/orders/{orderId}/resend": { "post": { "operationId": "resendSeasonOrderTickets", "summary": "Email a season order's tickets again", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "unsupported", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } }, { "name": "orderId", "in": "path", "required": true, "description": "orderId path parameter.", "schema": { "type": "string" } } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonOrderResendRequest" } } } }, "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "The tickets were emailed to `sentTo`.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonOrderResendEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "A publishable key was sent. These calls need a secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResendSeasonOrderTicketsError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such season, order or offer for this key and mode.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResendSeasonOrderTicketsError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "There are no live tickets to send, or no address to send them to.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResendSeasonOrderTicketsError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The email address is not valid.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResendSeasonOrderTicketsError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "502": { "description": "The email could not be sent.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResendSeasonOrderTicketsError502" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/seasons/{seasonKey}/renewal-hosted": { "get": { "operationId": "retrieveSeasonHostedRenewals", "summary": "Retrieve renewal links, payments and emails per offer", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "Link, payment and email state for each renewal offer.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonHostedRenewals" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "A publishable key was sent. These calls need a secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetrieveSeasonHostedRenewalsError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such season, order or offer for this key and mode.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetrieveSeasonHostedRenewalsError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } } } } }, "/v1/seasons/{seasonKey}/renewal-offers/{offerId}/link": { "post": { "operationId": "rotateSeasonRenewalOfferLink", "summary": "Make a new renewal link for one holder; the old link stops working", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "unsupported-one-time-secret", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } }, { "name": "offerId", "in": "path", "required": true, "description": "Season renewal offer identifier.", "schema": { "type": "string" } } ], "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "201": { "description": "A new renewal link. The previous link no longer works.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonRenewalLinkEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "A publishable key was sent. These calls need a secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RotateSeasonRenewalOfferLinkError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such season, order or offer for this key and mode.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RotateSeasonRenewalOfferLinkError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/seasons/{seasonKey}/renewal-offers/{offerId}/contact": { "post": { "operationId": "updateSeasonRenewalOfferContact", "summary": "Set the name and email a renewal offer is sent to", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "domain-exact", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } }, { "name": "offerId", "in": "path", "required": true, "description": "Season renewal offer identifier.", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonRenewalContactRequest" } } } }, "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "Contact saved. A new email turns the current link off.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonRenewalContactEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "A publishable key was sent. These calls need a secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateSeasonRenewalOfferContactError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such season, order or offer for this key and mode.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateSeasonRenewalOfferContactError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The email or name is not valid.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateSeasonRenewalOfferContactError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/seasons/{seasonKey}/renewal-notices": { "post": { "operationId": "createSeasonRenewalNotices", "summary": "Email renewal invitations now and reminders before the deadline", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "domain-exact", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonRenewalNoticesRequest" } } } }, "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "How many holders will get the emails, and how many have no address.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonRenewalNoticesEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "A publishable key was sent. These calls need a secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateSeasonRenewalNoticesError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such season, order or offer for this key and mode.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateSeasonRenewalNoticesError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The season does not use SeatLayer checkout; your own system emails holders.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateSeasonRenewalNoticesError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/seasons/{seasonKey}/renewal-offers/{offerId}/resend": { "post": { "operationId": "resendSeasonRenewalOffer", "summary": "Send one holder a new renewal invitation", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "x-seatlayer-idempotency": "unsupported", "x-seatlayer-automatic-retry": false, "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } }, { "name": "offerId", "in": "path", "required": true, "description": "Season renewal offer identifier.", "schema": { "type": "string" } } ], "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "202": { "description": "A new invitation is on its way. The old link no longer works.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ok" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "A publishable key was sent. These calls need a secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResendSeasonRenewalOfferError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such season, order or offer for this key and mode.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResendSeasonRenewalOfferError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "The offer is closed, or the season does not use SeatLayer checkout.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResendSeasonRenewalOfferError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "422": { "description": "The holder has no email address. Set one first.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResendSeasonRenewalOfferError422" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The API is temporarily read-only for maintenance.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer", "const": 1800 }, "description": "Seconds to wait." }, "X-Maintenance-Mode": { "schema": { "type": "string", "const": "read-only" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceError" } } } } } } }, "/v1/seasons/{seasonKey}/reports/sales": { "get": { "operationId": "retrieveSeasonSalesReport", "summary": "Retrieve season money, seats, holders and renewals as totals", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "Totals only. A section that could not be read is listed in `unavailable`.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonSalesReportEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "A publishable key was sent. These calls need a secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetrieveSeasonSalesReportError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such season, order or offer for this key and mode.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetrieveSeasonSalesReportError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } } } } }, "/v1/seasons/{seasonKey}/reports/seats": { "get": { "operationId": "retrieveSeasonSeatsReport", "summary": "Retrieve seats still free per package and per date", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "Seats free on every date of each package, and on each date.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonSeatsReportEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "A publishable key was sent. These calls need a secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetrieveSeasonSeatsReportError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such season, order or offer for this key and mode.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetrieveSeasonSeatsReportError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } } } } }, "/v1/seasons/{seasonKey}/reports/holders.csv": { "get": { "operationId": "exportSeasonHoldersCsv", "summary": "Download every season ticket holder as CSV", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } }, { "name": "q", "description": "Search by holder name, email, reference, order number or seat.", "schema": { "type": "string", "maxLength": 120 }, "in": "query", "required": false }, { "name": "status", "description": "Only these holders.", "schema": { "type": "string", "enum": [ "active", "cancelled", "renewal" ] }, "in": "query", "required": false } ], "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "The holders as CSV, 17 columns.", "content": { "text/csv": { "schema": { "$ref": "#/components/schemas/SeasonCsvDownload" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "400": { "description": "The status or search is not valid.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExportSeasonHoldersCsvError400" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "A publishable key was sent. These calls need a secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExportSeasonHoldersCsvError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such season, order or offer for this key and mode.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExportSeasonHoldersCsvError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "413": { "description": "More holders than one download can hold. Filter by status.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExportSeasonHoldersCsvError413" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "503": { "description": "The holder list cannot be read right now. Try again shortly.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExportSeasonHoldersCsvError503" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } } } } }, "/v1/seasons/{seasonKey}/reports/orders.csv": { "get": { "operationId": "exportSeasonOrdersCsv", "summary": "Download every season order SeatLayer took as CSV", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "Every order SeatLayer took for the season, as CSV.", "content": { "text/csv": { "schema": { "$ref": "#/components/schemas/SeasonCsvDownload" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "A publishable key was sent. These calls need a secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExportSeasonOrdersCsvError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such season, order or offer for this key and mode.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExportSeasonOrdersCsvError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "409": { "description": "Your own checkout sells this season, so SeatLayer has no orders for it.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExportSeasonOrdersCsvError409" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } } } } }, "/v1/seasons/{seasonKey}/seat-counts": { "get": { "operationId": "retrieveSeasonSeatCounts", "summary": "Retrieve season seats sold per package and per date", "tags": [ "Seasons" ], "externalDocs": { "url": "https://docs.seatlayer.io/server-api/seasons/" }, "security": [ { "secretKey": [] } ], "parameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "x-seatlayer-response-cache": "no-store", "x-seatlayer-rate-limits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "responses": { "200": { "description": "Season seats sold. `seats` is null when the figures cannot be read right now.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeasonSeatCountsEnvelope" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "401": { "description": "Missing or invalid secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretKeyAuthError" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "403": { "description": "A publishable key was sent. These calls need a secret key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetrieveSeasonSeatCountsError403" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "404": { "description": "No such season, order or offer for this key and mode.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetrieveSeasonSeatCountsError404" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } }, "429": { "description": "Rate limited per secret-key-id: 600 requests per 60 seconds.", "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." }, "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds to wait." }, "RateLimit-Limit": { "schema": { "type": "integer", "const": 600 } }, "RateLimit-Remaining": { "schema": { "type": "integer" } }, "RateLimit-Reset": { "schema": { "type": "integer" } }, "RateLimit-Policy": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "description": "Opaque request correlation id. Quote it in support requests." } } } } } } }, "components": { "securitySchemes": { "secretKey": { "type": "http", "scheme": "bearer", "bearerFormat": "sk_test_ or sk_live_", "description": "Server-only credential. Its live/test mode scopes event access." }, "manageToken": { "type": "http", "scheme": "bearer", "bearerFormat": "mse_", "description": "Short-lived event-scoped browser bearer. Available only on operations whose security lists it and bound to its HTTPS Origin." } }, "schemas": { "SeasonPerformanceList": { "type": "object", "properties": { "seasonKey": { "type": "string" }, "performances": { "type": "array", "items": { "type": "object", "properties": { "eventKey": { "type": "string" }, "name": { "type": "string" }, "startsAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "endsAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "timezone": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "venue": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "status": { "type": "string" }, "salesState": { "type": "string" }, "mode": { "type": "string", "enum": [ "live", "test" ] }, "past": { "type": "boolean" }, "packages": { "type": "array", "items": { "type": "object", "properties": { "planKey": { "type": "string" }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "published": { "type": "boolean" } }, "required": [ "planKey", "name", "published" ], "additionalProperties": {} } } }, "required": [ "eventKey", "name", "startsAt", "endsAt", "timezone", "venue", "status", "salesState", "mode", "past", "packages" ], "additionalProperties": {} } }, "packages": { "type": "array", "items": { "type": "object", "properties": { "planKey": { "type": "string" }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "published": { "type": "boolean" }, "performanceCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "planKey", "name", "published", "performanceCount" ], "additionalProperties": {} } } }, "required": [ "seasonKey", "performances", "packages" ], "additionalProperties": {} }, "SeasonAttachPerformanceRequest": { "type": "object", "properties": { "eventKey": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "eventKey" ], "additionalProperties": false }, "SeasonAmendmentPerformanceEnvelope": { "type": "object", "properties": { "seasonKey": { "type": "string" }, "performances": { "type": "array", "items": { "type": "object", "properties": { "eventKey": { "type": "string" }, "name": { "type": "string" }, "startsAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "endsAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "timezone": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "venue": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "status": { "type": "string" }, "salesState": { "type": "string" }, "mode": { "type": "string", "enum": [ "live", "test" ] }, "past": { "type": "boolean" }, "packages": { "type": "array", "items": { "type": "object", "properties": { "planKey": { "type": "string" }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "published": { "type": "boolean" } }, "required": [ "planKey", "name", "published" ], "additionalProperties": {} } } }, "required": [ "eventKey", "name", "startsAt", "endsAt", "timezone", "venue", "status", "salesState", "mode", "past", "packages" ], "additionalProperties": {} } }, "packages": { "type": "array", "items": { "type": "object", "properties": { "planKey": { "type": "string" }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "published": { "type": "boolean" }, "performanceCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "planKey", "name", "published", "performanceCount" ], "additionalProperties": {} } }, "extended": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "conflicts": { "type": "array", "items": { "type": "object", "properties": { "label": { "type": "string" }, "bookingRef": { "type": "string" }, "holderRef": { "type": "string" }, "reason": { "type": "string", "enum": [ "seat_taken", "seat_blocked", "seat_missing" ] } }, "required": [ "label", "bookingRef", "reason" ], "additionalProperties": {} } } }, "required": [ "seasonKey", "performances", "packages", "extended", "conflicts" ], "additionalProperties": {} }, "SeasonRemovePerformanceEnvelope": { "type": "object", "properties": { "seasonKey": { "type": "string" }, "performances": { "type": "array", "items": { "type": "object", "properties": { "eventKey": { "type": "string" }, "name": { "type": "string" }, "startsAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "endsAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "timezone": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "venue": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "status": { "type": "string" }, "salesState": { "type": "string" }, "mode": { "type": "string", "enum": [ "live", "test" ] }, "past": { "type": "boolean" }, "packages": { "type": "array", "items": { "type": "object", "properties": { "planKey": { "type": "string" }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "published": { "type": "boolean" } }, "required": [ "planKey", "name", "published" ], "additionalProperties": {} } } }, "required": [ "eventKey", "name", "startsAt", "endsAt", "timezone", "venue", "status", "salesState", "mode", "past", "packages" ], "additionalProperties": {} } }, "packages": { "type": "array", "items": { "type": "object", "properties": { "planKey": { "type": "string" }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "published": { "type": "boolean" }, "performanceCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "planKey", "name", "published", "performanceCount" ], "additionalProperties": {} } }, "released": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "seasonKey", "performances", "packages", "released" ], "additionalProperties": {} }, "SeasonMarkPastRequest": { "type": "object", "properties": { "force": { "type": "boolean" } }, "additionalProperties": false }, "SeasonPerformanceCreateRequest": { "type": "object", "properties": { "titlePattern": { "type": "string", "minLength": 1, "maxLength": 120 }, "firstStartsAt": { "type": "number" }, "timezone": { "type": "string", "minLength": 1, "maxLength": 64 }, "repeat": { "type": "string", "enum": [ "none", "daily", "weekly", "biweekly", "dates" ] }, "count": { "type": "integer", "minimum": 1, "maximum": 20 }, "dates": { "minItems": 1, "maxItems": 20, "type": "array", "items": { "type": "number" } }, "venue": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 200 }, { "type": "null" } ] }, "durationMinutes": { "anyOf": [ { "type": "integer", "minimum": 1, "maximum": 1440 }, { "type": "null" } ] }, "region": { "type": "string", "enum": [ "western-europe", "eastern-europe", "north-america-east", "north-america-west", "south-america", "asia-pacific", "northeast-asia", "southeast-asia", "oceania", "africa", "middle-east" ] }, "attachToPlanKeys": { "minItems": 1, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 160 } } }, "required": [ "titlePattern", "timezone", "repeat" ], "additionalProperties": false }, "SeasonPerformanceCreateEnvelope": { "type": "object", "properties": { "created": { "minItems": 1, "type": "array", "items": { "type": "object", "properties": { "eventKey": { "type": "string" }, "name": { "type": "string" }, "startsAt": { "type": "number" } }, "required": [ "eventKey", "name", "startsAt" ], "additionalProperties": {} } }, "seasonKey": { "type": "string" }, "performances": { "type": "array", "items": { "type": "object", "properties": { "eventKey": { "type": "string" }, "name": { "type": "string" }, "startsAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "endsAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "timezone": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "venue": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "status": { "type": "string" }, "salesState": { "type": "string" }, "mode": { "type": "string", "enum": [ "live", "test" ] }, "past": { "type": "boolean" }, "packages": { "type": "array", "items": { "type": "object", "properties": { "planKey": { "type": "string" }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "published": { "type": "boolean" } }, "required": [ "planKey", "name", "published" ], "additionalProperties": {} } } }, "required": [ "eventKey", "name", "startsAt", "endsAt", "timezone", "venue", "status", "salesState", "mode", "past", "packages" ], "additionalProperties": {} } }, "packages": { "type": "array", "items": { "type": "object", "properties": { "planKey": { "type": "string" }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "published": { "type": "boolean" }, "performanceCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "planKey", "name", "published", "performanceCount" ], "additionalProperties": {} } } }, "required": [ "created", "seasonKey", "performances", "packages" ], "additionalProperties": {} }, "SeasonPerformanceAttachRequest": { "type": "object", "properties": { "eventKeys": { "minItems": 1, "maxItems": 20, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 160 } }, "attachToPlanKeys": { "minItems": 1, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 160 } } }, "required": [ "eventKeys" ], "additionalProperties": false }, "SeasonPlanUpdateRequest": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 120 }, "eventKeys": { "minItems": 2, "maxItems": 20, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 160 } } }, "additionalProperties": false }, "SeasonPackageEnvelope": { "type": "object", "properties": { "package": { "type": "object", "properties": { "planKey": { "type": "string" }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "published": { "type": "boolean" }, "performanceCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "planKey", "name", "published", "performanceCount" ], "additionalProperties": {} }, "seasonKey": { "type": "string" }, "performances": { "type": "array", "items": { "type": "object", "properties": { "eventKey": { "type": "string" }, "name": { "type": "string" }, "startsAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "endsAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "timezone": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "venue": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "status": { "type": "string" }, "salesState": { "type": "string" }, "mode": { "type": "string", "enum": [ "live", "test" ] }, "past": { "type": "boolean" }, "packages": { "type": "array", "items": { "type": "object", "properties": { "planKey": { "type": "string" }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "published": { "type": "boolean" } }, "required": [ "planKey", "name", "published" ], "additionalProperties": {} } } }, "required": [ "eventKey", "name", "startsAt", "endsAt", "timezone", "venue", "status", "salesState", "mode", "past", "packages" ], "additionalProperties": {} } }, "packages": { "type": "array", "items": { "type": "object", "properties": { "planKey": { "type": "string" }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "published": { "type": "boolean" }, "performanceCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "planKey", "name", "published", "performanceCount" ], "additionalProperties": {} } } }, "required": [ "package", "seasonKey", "performances", "packages" ], "additionalProperties": {} }, "SeasonPublishEnvelope": { "type": "object", "properties": { "season": { "type": "object", "properties": { "key": { "type": "string" }, "name": { "type": "string" }, "structureState": { "type": "string", "enum": [ "draft", "active", "closing", "closed", "archived" ] }, "salesState": { "type": "string", "enum": [ "closed", "open", "paused", "ended" ] }, "revision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "key", "name", "structureState", "salesState", "revision" ], "additionalProperties": {} }, "packages": { "type": "array", "items": { "type": "object", "properties": { "planKey": { "type": "string" }, "name": { "type": "string" }, "published": { "type": "boolean", "const": true }, "activationId": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "planKey", "name", "published", "activationId" ], "additionalProperties": {} } } }, "required": [ "season", "packages" ], "additionalProperties": {} }, "SeasonSalesOpenEnvelope": { "type": "object", "properties": { "season": { "type": "object", "properties": { "key": { "type": "string" }, "name": { "type": "string" }, "structureState": { "type": "string", "enum": [ "draft", "active", "closing", "closed", "archived" ] }, "salesState": { "type": "string", "enum": [ "closed", "open", "paused", "ended" ] }, "revision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "key", "name", "structureState", "salesState", "revision" ], "additionalProperties": {} }, "warnings": { "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" } }, "required": [ "code", "message" ], "additionalProperties": {} } } }, "required": [ "season", "warnings" ], "additionalProperties": {} }, "SeasonCheckoutTestRequest": { "type": "object", "properties": { "planKey": { "type": "string", "minLength": 1, "maxLength": 160 }, "quantity": { "type": "integer", "minimum": 1, "maximum": 4 } }, "additionalProperties": false }, "SeasonCheckoutTestEnvelope": { "type": "object", "properties": { "test": { "type": "object", "properties": { "id": { "type": "string" }, "status": { "type": "string", "enum": [ "passed", "failed" ] }, "startedAt": { "type": "number" }, "finishedAt": { "type": "number" }, "planKey": { "type": "string" }, "seats": { "type": "array", "items": { "type": "string" } }, "steps": { "type": "array", "items": { "type": "object", "properties": { "step": { "type": "string", "enum": [ "session", "availability", "hold", "release" ] }, "ok": { "type": "boolean" }, "durationMs": { "type": "number" }, "message": { "type": "string" }, "detail": { "type": "string" } }, "required": [ "step", "ok", "durationMs" ], "additionalProperties": {} } } }, "required": [ "id", "status", "startedAt", "finishedAt", "planKey", "seats", "steps" ], "additionalProperties": {} } }, "required": [ "test" ], "additionalProperties": {} }, "SeasonCheckoutTestList": { "type": "object", "properties": { "tests": { "maxItems": 20, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "status": { "type": "string", "enum": [ "passed", "failed" ] }, "startedAt": { "type": "number" }, "finishedAt": { "type": "number" }, "planKey": { "type": "string" }, "seats": { "type": "array", "items": { "type": "string" } }, "steps": { "type": "array", "items": { "type": "object", "properties": { "step": { "type": "string", "enum": [ "session", "availability", "hold", "release" ] }, "ok": { "type": "boolean" }, "durationMs": { "type": "number" }, "message": { "type": "string" }, "detail": { "type": "string" } }, "required": [ "step", "ok", "durationMs" ], "additionalProperties": {} } } }, "required": [ "id", "status", "startedAt", "finishedAt", "planKey", "seats", "steps" ], "additionalProperties": {} } } }, "required": [ "tests" ], "additionalProperties": {} }, "SeasonPackagePricesRequest": { "type": "object", "properties": { "prices": { "maxItems": 200, "type": "array", "items": { "type": "object", "properties": { "categoryKey": { "type": "string", "minLength": 1, "maxLength": 120 }, "unitPrice": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "categoryKey", "unitPrice" ], "additionalProperties": false } }, "currency": { "type": "string", "minLength": 3, "maxLength": 3 } }, "required": [ "prices" ], "additionalProperties": false }, "SeasonPackagePricesEnvelope": { "type": "object", "properties": { "planKey": { "type": "string" }, "currency": { "type": "string" }, "prices": { "type": "array", "items": { "type": "object", "properties": { "categoryKey": { "type": "string" }, "unitPrice": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "categoryKey", "unitPrice" ], "additionalProperties": {} } } }, "required": [ "planKey", "currency", "prices" ], "additionalProperties": {} }, "SeasonPriceList": { "type": "object", "properties": { "seasonKey": { "type": "string" }, "currency": { "type": "string" }, "packages": { "type": "array", "items": { "type": "object", "properties": { "planKey": { "type": "string" }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "prices": { "type": "array", "items": { "type": "object", "properties": { "categoryKey": { "type": "string" }, "unitPrice": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "categoryKey", "unitPrice" ], "additionalProperties": {} } } }, "required": [ "planKey", "name", "prices" ], "additionalProperties": {} } } }, "required": [ "seasonKey", "currency", "packages" ], "additionalProperties": {} }, "Ok": { "type": "object", "properties": { "ok": { "type": "boolean", "const": true } }, "required": [ "ok" ], "additionalProperties": {} }, "Error": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" }, "message": { "type": "string" }, "requestId": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} }, "Labels": { "minItems": 1, "type": "array", "items": { "type": "string", "minLength": 1 } }, "BinaryImage": { "type": "string", "format": "binary", "contentEncoding": "binary", "description": "Raw PNG, JPEG, or WebP bytes; maximum 5 MiB." }, "ChartMeta": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "status": { "type": "string" }, "seats": { "type": "number" }, "updatedAt": { "type": "number" }, "hasThumbnail": { "type": "boolean" }, "issues": { "type": "number" }, "archivedAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "externalRef": { "type": "string" }, "workspaceId": { "type": "string" }, "publicationPolicy": { "type": "string" }, "sourceTemplate": { "type": "object", "properties": { "id": { "type": "string" }, "version": { "type": "number" }, "sha256": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "id", "version", "sha256" ], "additionalProperties": {} } }, "required": [ "id", "name", "status", "seats", "updatedAt", "hasThumbnail", "archivedAt", "workspaceId" ], "additionalProperties": {} }, "EventMeta": { "type": "object", "properties": { "key": { "type": "string" }, "name": { "type": "string" }, "chartId": { "type": "string" }, "status": { "type": "string" }, "salesState": { "type": "string" }, "salesRevision": { "type": "number" }, "salesPauseReason": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "salesChangedAt": { "description": "When sales last changed state (opened, paused, resumed or ended), epoch ms; null before the first change.", "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "seatTotal": { "type": "number" }, "provisioning": { "description": "Present only while a dashboard `async` create is still copying the chart pin and initializing inventory; `seatTotal` is the chart's seat count until then. Absent once provisioned and on every other event.", "type": "boolean", "const": true }, "createdAt": { "type": "number" }, "startsAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "doorsAt": { "description": "When the doors open, epoch ms, read in the event's `timezone`; null when not set.", "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "venue": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "mode": { "type": "string", "enum": [ "live", "test" ] }, "externalRef": { "type": "string" }, "workspaceId": { "type": "string" }, "currency": { "type": "string" }, "inventoryModelVersion": { "type": "number" }, "paymentGateway": { "anyOf": [ {}, { "type": "null" } ] }, "buyerCheckout": {}, "buyerCheckoutRevision": { "type": "number" }, "bookingMode": { "type": "string", "enum": [ "paid", "free" ] }, "maxTicketsPerOrder": { "anyOf": [ { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, { "type": "null" } ] }, "maxTicketsPerBuyer": { "anyOf": [ { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, { "type": "null" } ] }, "buyerSurface": {}, "buyerSurfaceRevision": { "type": "number" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "endsAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "timezone": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "locale": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "region": { "anyOf": [ { "type": "string", "enum": [ "western-europe", "eastern-europe", "north-america-east", "north-america-west", "south-america", "asia-pacific", "northeast-asia", "southeast-asia", "oceania", "africa", "middle-east" ] }, { "type": "null" } ] }, "posterPath": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "season": { "anyOf": [ { "type": "object", "properties": { "key": { "type": "string" }, "name": { "type": "string" } }, "required": [ "key", "name" ], "additionalProperties": {} }, { "type": "null" } ] }, "eventConfiguration": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string" }, "version": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "id", "version" ], "additionalProperties": {} }, { "type": "null" } ] }, "eventConfigurationRevision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "eventConfigurationChangedBy": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "eventConfigurationChangedAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "required": [ "key", "name", "chartId", "status", "salesState", "salesRevision", "salesPauseReason", "seatTotal", "createdAt", "startsAt", "venue", "mode", "workspaceId", "description", "endsAt", "timezone", "locale", "region", "posterPath" ], "additionalProperties": {} }, "EventCounts": { "type": "object", "properties": { "free": { "type": "number" }, "held": { "type": "number" }, "booked": { "type": "number" }, "blocked": { "type": "number" } }, "required": [ "free", "held", "booked", "blocked" ], "additionalProperties": {} }, "EventConfigurationRef": { "type": "object", "properties": { "id": { "type": "string" }, "version": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "id", "version" ], "additionalProperties": {} }, "EventConfigurationBindingAudit": { "type": "object", "properties": { "id": { "type": "string" }, "from": { "anyOf": [ { "$ref": "#/components/schemas/EventConfigurationRef" }, { "type": "null" } ] }, "to": { "anyOf": [ { "$ref": "#/components/schemas/EventConfigurationRef" }, { "type": "null" } ] }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "actor": { "type": "string" }, "createdAt": { "type": "number" } }, "required": [ "id", "from", "to", "revision", "actor", "createdAt" ], "additionalProperties": {} }, "TicketRelease": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^rel_[0-9a-f]{12}$" }, "position": { "type": "integer", "minimum": 1, "maximum": 12 }, "name": { "type": "string" }, "categoryKey": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "price": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "previousPrice": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "quota": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "startsAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "endsAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "action": { "type": "string", "enum": [ "buy", "apply", "invoice" ] }, "actionUrl": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "soldOutAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "consumed": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "remaining": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "id", "position", "name", "categoryKey", "price", "previousPrice", "quota", "startsAt", "endsAt", "action", "actionUrl", "soldOutAt" ], "additionalProperties": {} }, "Workspace": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "externalRef": { "type": "string" }, "status": { "type": "string", "enum": [ "active", "disabled" ] }, "isDefault": { "type": "boolean" }, "defaultRegion": { "anyOf": [ { "type": "string", "enum": [ "western-europe", "eastern-europe", "north-america-east", "north-america-west", "south-america", "asia-pacific", "northeast-asia", "southeast-asia", "oceania", "africa", "middle-east" ] }, { "type": "null" } ] }, "createdAt": { "type": "number" }, "updatedAt": { "type": "number" } }, "required": [ "id", "name", "status", "isDefault", "defaultRegion", "createdAt", "updatedAt" ], "additionalProperties": {} }, "WebhookSub": { "type": "object", "properties": { "id": { "type": "string" }, "url": { "type": "string" }, "events": { "type": "array", "items": { "type": "string", "enum": [ "seat.booked", "seat.released", "seat.blocked", "hold.expired", "hold.created", "hold.extended", "event.created", "event.soldout", "object.resale.listed", "object.resale.unlisted", "object.resale.sold", "season.structure.activated", "season.structure.closed", "season.structure.archived", "season.plan.published", "season.plan.superseded", "season.sales.opened", "season.sales.paused", "season.sales.ended", "season.hold.committed", "season.hold.released", "season.hold.expired", "season.booking.confirmed", "season.booking.cancelled", "season.booking.emergency_requested", "season.occurrence.returned", "season.occurrence.reclaimed", "season.renewal.offered", "season.renewal.intent_received", "season.renewal.renewed", "season.renewal.declined", "season.renewal.lapsed", "season.renewal.released", "season.operation.partial_terminal", "season.amendment.applied", "season.performance.added", "season.performance.removed", "season.performance.past", "season.order.paid", "season.order.refunded" ] } }, "disabled": { "type": "boolean" }, "lastStatus": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "lastAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "createdAt": { "type": "number" }, "mode": { "anyOf": [ { "type": "string", "enum": [ "live", "test" ] }, { "type": "null" } ] }, "environment": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "uptime7d": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "required": [ "id", "url", "events", "disabled", "lastStatus", "lastAt", "createdAt", "mode", "environment", "uptime7d" ], "additionalProperties": {} }, "WebhookDelivery": { "type": "object", "properties": { "id": { "type": "string" }, "at": { "type": "number" }, "event": { "type": "string", "enum": [ "seat.booked", "seat.released", "seat.blocked", "hold.expired", "hold.created", "hold.extended", "event.created", "event.soldout", "object.resale.listed", "object.resale.unlisted", "object.resale.sold", "season.structure.activated", "season.structure.closed", "season.structure.archived", "season.plan.published", "season.plan.superseded", "season.sales.opened", "season.sales.paused", "season.sales.ended", "season.hold.committed", "season.hold.released", "season.hold.expired", "season.booking.confirmed", "season.booking.cancelled", "season.booking.emergency_requested", "season.occurrence.returned", "season.occurrence.reclaimed", "season.renewal.offered", "season.renewal.intent_received", "season.renewal.renewed", "season.renewal.declined", "season.renewal.lapsed", "season.renewal.released", "season.operation.partial_terminal", "season.amendment.applied", "season.performance.added", "season.performance.removed", "season.performance.past", "season.order.paid", "season.order.refunded" ] }, "ref": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "status": { "type": "number" }, "attempt": { "type": "number" }, "maxAttempts": { "type": "number" }, "willRetry": { "type": "boolean" }, "occurrenceId": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "payload": { "anyOf": [ {}, { "type": "null" } ] }, "responseBody": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "errorMessage": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "id", "at", "event", "ref", "status", "attempt", "maxAttempts", "willRetry", "occurrenceId", "payload", "responseBody", "errorMessage" ], "additionalProperties": {} }, "ChannelRecord": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "color": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "marker": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "externalRef": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "state": { "type": "string", "enum": [ "active", "paused", "archived" ] }, "archiveDestination": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "accessIntent": { "type": "string", "enum": [ "none", "internal", "server", "hosted_link" ] }, "priceOverrides": { "type": "array", "items": { "$ref": "#/components/schemas/ChannelPriceOverride" } }, "pricingVersion": { "type": "number" }, "createdAt": { "type": "number" }, "updatedAt": { "type": "number" }, "archivedAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "required": [ "id", "name", "color", "marker", "externalRef", "state", "archiveDestination", "accessIntent", "priceOverrides", "pricingVersion", "createdAt", "updatedAt", "archivedAt" ], "additionalProperties": {} }, "ChannelPriceOverride": { "type": "object", "properties": { "categoryKey": { "type": "string" }, "tierId": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "price": { "type": "number" } }, "required": [ "categoryKey", "tierId", "price" ], "additionalProperties": {} }, "ChannelCounts": { "type": "object", "properties": { "allocated": { "type": "number" }, "free": { "type": "number" }, "held": { "type": "number" }, "booked": { "type": "number" }, "blocked": { "type": "number" }, "units": { "type": "number" }, "reserved": { "description": "Of `blocked`, the seats kept aside under a name (a reservation). Channel report only; absent when none.", "type": "number" } }, "required": [ "allocated", "free", "held", "booked", "blocked", "units" ], "additionalProperties": {} }, "ChannelWithCounts": { "allOf": [ { "$ref": "#/components/schemas/ChannelRecord" }, { "type": "object", "properties": { "counts": { "$ref": "#/components/schemas/ChannelCounts" }, "access": { "type": "object", "properties": { "intent": { "type": "string", "enum": [ "none", "internal", "server", "hosted_link" ] }, "hasActiveGrants": { "type": "boolean" }, "lastMintAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "required": [ "intent", "hasActiveGrants", "lastMintAt" ], "additionalProperties": {} } }, "required": [ "counts", "access" ], "additionalProperties": {} } ] }, "AccessLink": { "type": "object", "properties": { "id": { "type": "string" }, "channelId": { "type": "string" }, "label": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "includePublic": { "type": "boolean" }, "expiresAt": { "type": "number" }, "maxRedemptions": { "type": "number" }, "redemptions": { "type": "number" }, "maxQuantity": { "type": "number" }, "sessionTtlSeconds": { "type": "number" }, "state": { "type": "string", "enum": [ "active", "revoked", "rotated" ] }, "status": { "type": "string", "enum": [ "active", "revoked", "rotated", "expired", "exhausted" ] }, "createdAt": { "type": "number" }, "createdBy": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "revokedAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "lastRedeemedAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "rotatedFrom": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "rotatedTo": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "id", "channelId", "label", "includePublic", "expiresAt", "maxRedemptions", "redemptions", "maxQuantity", "sessionTtlSeconds", "state", "status", "createdAt", "createdBy", "revokedAt", "lastRedeemedAt", "rotatedFrom", "rotatedTo" ], "additionalProperties": {} }, "InventoryItem": { "type": "object", "properties": { "label": { "type": "string" }, "objectId": { "type": "string" }, "objectType": { "type": "string", "enum": [ "seat", "booth", "ga", "table" ] }, "categoryKey": { "type": "string" }, "tierId": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "unitPrice": { "type": "number" }, "currency": { "type": "string" }, "quantity": { "type": "number" }, "bookingMode": { "type": "string", "enum": [ "individual", "whole", "variable" ] }, "capacity": { "type": "number" }, "minOccupancy": { "type": "number" }, "maxOccupancy": { "type": "number" }, "channelId": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "channelPricingVersion": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "accessSource": { "type": "string", "enum": [ "public", "promoter", "partner", "hosted_link", "staff_override" ] }, "releaseId": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "label", "objectId", "objectType", "categoryKey", "tierId", "unitPrice", "currency" ], "additionalProperties": {} }, "InventoryBookingObject": { "type": "object", "properties": { "label": { "type": "string" }, "objectId": { "type": "string" }, "objectType": { "type": "string", "enum": [ "seat", "booth", "ga", "table" ] }, "categoryKey": { "type": "string" }, "categoryLabel": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "sectionId": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "sectionLabel": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "zoneId": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "tierId": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "releaseId": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "bookingMode": { "type": "string", "enum": [ "individual", "whole", "variable" ] }, "quantity": { "type": "number" }, "unitPrice": { "type": "number" }, "configuredValue": { "type": "number" }, "currency": { "type": "string" }, "channelId": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "channelExternalRef": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "source": { "type": "string" }, "state": { "type": "string", "enum": [ "booked", "cancelled" ] }, "bookedAt": { "type": "number" }, "cancelledAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "required": [ "label", "objectId", "objectType", "categoryKey", "sectionId", "sectionLabel", "zoneId", "tierId", "releaseId", "bookingMode", "quantity", "unitPrice", "configuredValue", "currency", "channelId", "channelExternalRef", "source", "state", "bookedAt", "cancelledAt" ], "additionalProperties": {} }, "InventoryBookingRecord": { "type": "object", "properties": { "eventKey": { "type": "string" }, "eventMode": { "type": "string", "enum": [ "live", "test" ] }, "bookingRef": { "type": "string" }, "state": { "type": "string", "enum": [ "booked", "partially_cancelled", "cancelled" ] }, "bookedAt": { "type": "number" }, "updatedAt": { "type": "number" }, "cancelledAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "source": { "type": "string" }, "bookedBy": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "lastActor": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "lastSource": { "type": "string" }, "labels": { "type": "array", "items": { "type": "string" } }, "objects": { "type": "array", "items": { "$ref": "#/components/schemas/InventoryBookingObject" } }, "quantity": { "type": "number" }, "activeQuantity": { "type": "number" }, "configuredValue": { "type": "number" }, "activeConfiguredValue": { "type": "number" }, "currency": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "eventKey", "eventMode", "bookingRef", "state", "bookedAt", "updatedAt", "cancelledAt", "source", "bookedBy", "lastActor", "lastSource", "labels", "objects", "quantity", "activeQuantity", "configuredValue", "activeConfiguredValue", "currency" ], "additionalProperties": {} }, "InventoryBookingActivity": { "type": "object", "properties": { "id": { "type": "number" }, "action": { "type": "string", "enum": [ "book", "replay", "partial_cancel", "cancel", "reconcile" ] }, "at": { "type": "number" }, "labels": { "type": "array", "items": { "type": "string" } }, "actor": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "source": { "type": "string" } }, "required": [ "id", "action", "at", "labels", "actor", "source" ], "additionalProperties": {} }, "EventReport": { "type": "object", "properties": { "byStatus": { "type": "object", "properties": { "free": { "type": "number" }, "held": { "type": "number" }, "booked": { "type": "number" }, "not_for_sale": { "type": "number" } }, "required": [ "free", "held", "booked", "not_for_sale" ], "additionalProperties": {} }, "byCategory": { "type": "array", "items": { "type": "object", "properties": { "category": { "type": "string" }, "total": { "type": "number" }, "free": { "type": "number" }, "held": { "type": "number" }, "booked": { "type": "number" }, "not_for_sale": { "type": "number" }, "bookedValue": { "type": "number" }, "bookedRevenue": { "type": "number" }, "reserved": { "description": "Of `not_for_sale`, the seats kept aside under a name (a reservation). Absent when none.", "type": "number" } }, "required": [ "category", "total", "free", "held", "booked", "not_for_sale", "bookedValue", "bookedRevenue" ], "additionalProperties": {} } }, "bySection": { "type": "array", "items": { "type": "object", "properties": { "sectionId": { "type": "string" }, "sectionLabel": { "type": "string" }, "zoneId": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "total": { "type": "number" }, "free": { "type": "number" }, "held": { "type": "number" }, "booked": { "type": "number" }, "not_for_sale": { "type": "number" }, "bookedValue": { "type": "number" }, "bookedRevenue": { "type": "number" }, "reserved": { "description": "Of `not_for_sale`, the seats kept aside under a name (a reservation). Absent when none.", "type": "number" } }, "required": [ "sectionId", "sectionLabel", "zoneId", "total", "free", "held", "booked", "not_for_sale", "bookedValue", "bookedRevenue" ], "additionalProperties": {} } }, "byAccessibility": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "wheelchair", "companion", "semi-ambulatory", "hearing", "cart", "sign-language", "plus-size", "lift-armrest" ] }, "label": { "type": "string" }, "total": { "type": "number" }, "free": { "type": "number" }, "held": { "type": "number" }, "booked": { "type": "number" }, "not_for_sale": { "type": "number" } }, "required": [ "type", "label", "total", "free", "held", "booked", "not_for_sale" ], "additionalProperties": {} } }, "byWheelchairProvision": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "seat-present", "no-seat" ] }, "label": { "type": "string" }, "total": { "type": "number" }, "free": { "type": "number" }, "held": { "type": "number" }, "booked": { "type": "number" }, "not_for_sale": { "type": "number" } }, "required": [ "type", "label", "total", "free", "held", "booked", "not_for_sale" ], "additionalProperties": {} } } }, "required": [ "byStatus", "byCategory", "bySection", "byAccessibility", "byWheelchairProvision" ], "additionalProperties": {} }, "EventLogEntry": { "type": "object", "properties": { "id": { "type": "number" }, "at": { "type": "number" }, "action": { "type": "string" }, "labels": { "type": "array", "items": { "type": "string" } }, "ref": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "id", "at", "action", "labels", "ref" ], "additionalProperties": {} }, "ChannelAttribution": { "type": "object", "properties": { "sold": { "type": "number" }, "units": { "type": "number" }, "bookedValue": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "revenue": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "required": [ "sold", "units", "bookedValue", "revenue" ], "additionalProperties": {} }, "ChannelReportRow": { "type": "object", "properties": { "channelId": { "type": "string" }, "name": { "type": "string" }, "externalRef": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "state": { "type": "string", "enum": [ "active", "paused", "archived" ] }, "allocation": { "$ref": "#/components/schemas/ChannelCounts" }, "attribution": { "$ref": "#/components/schemas/ChannelAttribution" }, "sellThrough": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "required": [ "channelId", "name", "externalRef", "state", "allocation", "attribution", "sellThrough" ], "additionalProperties": {} }, "ChannelReport": { "type": "object", "properties": { "assignmentVersion": { "type": "number" }, "includesBookedValue": { "type": "boolean" }, "includesRevenue": { "type": "boolean" }, "methodology": { "type": "object", "properties": { "allocation": { "type": "string" }, "attribution": { "type": "string" }, "sellThrough": { "type": "string" } }, "required": [ "allocation", "attribution", "sellThrough" ], "additionalProperties": {} }, "rows": { "type": "array", "items": { "$ref": "#/components/schemas/ChannelReportRow" } }, "totals": { "type": "object", "properties": { "allocated": { "type": "number" }, "free": { "type": "number" }, "held": { "type": "number" }, "booked": { "type": "number" }, "blocked": { "type": "number" }, "sold": { "type": "number" }, "bookedValue": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "revenue": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "required": [ "allocated", "free", "held", "booked", "blocked", "sold", "bookedValue", "revenue" ], "additionalProperties": {} } }, "required": [ "assignmentVersion", "includesBookedValue", "includesRevenue", "methodology", "rows", "totals" ], "additionalProperties": {} }, "AssignmentBuckets": { "type": "object", "properties": { "changedFromPublic": { "type": "object", "properties": { "count": { "type": "number" } }, "required": [ "count" ], "additionalProperties": {} }, "movedFromOtherChannel": { "type": "object", "properties": { "count": { "type": "number" }, "channels": { "type": "array", "items": { "type": "object", "properties": { "channelId": { "type": "string" }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "count": { "type": "number" } }, "required": [ "channelId", "name", "count" ], "additionalProperties": {} } } }, "required": [ "count", "channels" ], "additionalProperties": {} }, "alreadyInTarget": { "type": "object", "properties": { "count": { "type": "number" } }, "required": [ "count" ], "additionalProperties": {} }, "skippedHeld": { "type": "object", "properties": { "count": { "type": "number" }, "labels": { "type": "array", "items": { "type": "string" } }, "truncated": { "type": "boolean" } }, "required": [ "count", "labels", "truncated" ], "additionalProperties": {} }, "skippedBooked": { "type": "object", "properties": { "count": { "type": "number" }, "labels": { "type": "array", "items": { "type": "string" } }, "truncated": { "type": "boolean" } }, "required": [ "count", "labels", "truncated" ], "additionalProperties": {} }, "notFound": { "type": "object", "properties": { "count": { "type": "number" }, "labels": { "type": "array", "items": { "type": "string" } }, "truncated": { "type": "boolean" } }, "required": [ "count", "labels", "truncated" ], "additionalProperties": {} } }, "required": [ "changedFromPublic", "movedFromOtherChannel", "alreadyInTarget", "skippedHeld", "skippedBooked", "notFound" ], "additionalProperties": {} }, "BuyerAccessSession": { "type": "object", "properties": { "sessionId": { "type": "string" }, "channelIds": { "type": "array", "items": { "type": "string" } }, "includePublic": { "type": "boolean" }, "allowedOrigin": { "type": "string" }, "mode": { "type": "string", "enum": [ "live", "test" ] }, "expiresAt": { "type": "number" }, "maxQuantity": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "buyerRef": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "partnerRef": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "accessSource": { "type": "string", "enum": [ "public", "promoter", "partner", "hosted_link", "staff_override" ] }, "state": { "type": "string", "enum": [ "active", "revoked" ] }, "createdAt": { "type": "number" }, "revokedAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "accessLinkId": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "sessionId", "channelIds", "includePublic", "allowedOrigin", "mode", "expiresAt", "maxQuantity", "buyerRef", "partnerRef", "accessSource", "state", "createdAt", "revokedAt", "accessLinkId" ], "additionalProperties": {} }, "PerformanceGroup": { "type": "object", "properties": { "key": { "type": "string", "pattern": "^pg_[0-9a-f]{32}$" }, "kind": { "type": "string", "const": "performance_run" }, "name": { "type": "string" }, "externalRef": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "state": { "type": "string", "enum": [ "draft", "active", "closing", "closed", "archived" ] }, "revision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "workspaceId": { "type": "string" }, "mode": { "type": "string", "enum": [ "live", "test" ] }, "environment": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "chartId": { "type": "string" }, "sourceChartKey": { "type": "string" }, "inventoryModelVersion": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "inclusionMode": { "type": "string", "enum": [ "fixed", "flexible_dates" ] }, "selectionMode": { "type": "string", "enum": [ "same_seat", "per_performance" ] }, "audience": { "type": "string", "enum": [ "private", "unlisted", "public" ] }, "salesState": { "type": "string", "enum": [ "closed", "open", "paused" ] }, "checkoutMode": { "anyOf": [ { "type": "string", "enum": [ "seatlayer", "integrator" ] }, { "type": "null" } ] }, "currency": { "type": "string" }, "venue": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "timezone": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "performanceCount": { "type": "integer", "minimum": 2, "maximum": 12 }, "firstStartsAt": { "type": "number" }, "lastStartsAt": { "type": "number" }, "createdAt": { "type": "number" }, "updatedAt": { "type": "number" }, "activatedAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "closedAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "required": [ "key", "kind", "name", "externalRef", "state", "revision", "workspaceId", "mode", "environment", "chartId", "sourceChartKey", "inventoryModelVersion", "inclusionMode", "selectionMode", "audience", "salesState", "checkoutMode", "currency", "venue", "timezone", "performanceCount", "firstStartsAt", "lastStartsAt", "createdAt", "updatedAt", "activatedAt", "closedAt" ], "additionalProperties": {} }, "PerformanceGroupPerformance": { "type": "object", "properties": { "position": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "eventKey": { "type": "string" }, "name": { "type": "string" }, "startsAt": { "type": "number" }, "endsAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "venue": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "timezone": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "externalRef": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "salesState": { "type": "string" }, "status": { "type": "string" } }, "required": [ "position", "eventKey", "name", "startsAt", "endsAt", "venue", "timezone", "externalRef", "salesState", "status" ], "additionalProperties": {} }, "PerformanceGroupLifecycle": { "type": "object", "properties": { "operationId": { "type": "string" }, "kind": { "type": "string", "enum": [ "ACTIVATION", "CLOSE" ] }, "phase": { "type": "string", "enum": [ "activation_locking", "activation_registry", "activation_aborting", "active", "activation_failed", "close_registry", "close_draining", "close_finalize", "close_unlocking", "close_failed", "closed" ] }, "terminal": { "type": "boolean" }, "totalLocks": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "ackedLocks": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "remainingOperations": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "code": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "operationId", "kind", "phase", "terminal", "totalLocks", "ackedLocks", "remainingOperations", "code" ], "additionalProperties": {} }, "PerformanceGroupBuyerAccessSession": { "type": "object", "properties": { "sessionId": { "type": "string" }, "allowedOrigin": { "type": "string" }, "expiresAt": { "type": "number" }, "includePublic": { "type": "boolean" }, "maxQuantity": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "buyerRef": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "partnerRef": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "accessSource": { "type": "string", "enum": [ "promoter", "partner" ] }, "state": { "type": "string", "enum": [ "active", "revoked" ] }, "createdAt": { "type": "number" }, "revokedAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "required": [ "sessionId", "allowedOrigin", "expiresAt", "includePublic", "maxQuantity", "buyerRef", "partnerRef", "accessSource", "state", "createdAt", "revokedAt" ], "additionalProperties": {} }, "PerformanceGroupHold": { "type": "object", "properties": { "operationId": { "type": "string" }, "groupId": { "type": "string" }, "holdId": { "type": "string" }, "state": { "type": "string", "enum": [ "preparing", "commit_pending", "committed", "expire_pending", "expired", "booked", "abort_pending", "aborted" ] }, "decision": { "anyOf": [ { "type": "string", "enum": [ "commit", "abort" ] }, { "type": "null" } ] }, "active": { "type": "boolean" }, "expiresAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "createdAt": { "type": "number" }, "convergedAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "expiredAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "buyerSessionId": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "selectionMode": { "type": "string", "enum": [ "same_seat", "per_performance" ] }, "inclusionMode": { "type": "string", "enum": [ "fixed", "flexible_dates" ] }, "buyerRef": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "partnerRef": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "currency": { "type": "string" }, "groupRevision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "allocations": { "minItems": 1, "maxItems": 8, "type": "array", "items": { "type": "object", "properties": { "eventKey": { "type": "string" }, "name": { "type": "string" }, "startsAt": { "type": "number" }, "endsAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "configuredValue": { "type": "number" }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/InventoryItem" } } }, "required": [ "eventKey", "name", "startsAt", "endsAt", "configuredValue", "items" ], "additionalProperties": {} } } }, "required": [ "operationId", "groupId", "holdId", "state", "decision", "active", "expiresAt", "createdAt", "convergedAt", "expiredAt", "buyerSessionId", "selectionMode", "inclusionMode", "buyerRef", "partnerRef", "currency", "groupRevision", "allocations" ], "additionalProperties": {} }, "PerformanceGroupBooking": { "type": "object", "properties": { "bookActionId": { "type": "string" }, "operationId": { "type": "string" }, "groupId": { "type": "string" }, "bookingRef": { "type": "string" }, "state": { "type": "string", "enum": [ "book_pending", "booked", "book_failed" ] }, "createdAt": { "type": "number" }, "bookedAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "totalPerformances": { "type": "integer", "minimum": 1, "maximum": 8 }, "bookedPerformances": { "type": "integer", "minimum": 0, "maximum": 8 }, "nextRetryAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "attempts": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "lastError": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "bookActionId", "operationId", "groupId", "bookingRef", "state", "createdAt", "bookedAt", "totalPerformances", "bookedPerformances", "nextRetryAt", "attempts", "lastError" ], "additionalProperties": {} }, "Season": { "type": "object", "properties": { "key": { "type": "string", "pattern": "^sea_[0-9a-f]{32}$" }, "name": { "type": "string" }, "edition": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "workspaceId": { "type": "string" }, "mode": { "type": "string", "enum": [ "live", "test" ] }, "environment": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "chartId": { "type": "string" }, "sourceChartKey": { "type": "string" }, "sourceChartSha256": { "type": "string", "minLength": 64, "maxLength": 64 }, "currency": { "type": "string" }, "venue": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "timezone": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "audience": { "type": "string", "const": "embed_only" }, "revision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "structureState": { "type": "string", "enum": [ "draft", "active", "closing", "closed", "archived" ] }, "salesState": { "type": "string", "enum": [ "closed", "open", "paused", "ended" ] }, "occurrenceCount": { "type": "integer", "minimum": 2, "maximum": 100 }, "createdAt": { "type": "number" }, "updatedAt": { "type": "number" }, "activatedAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "closedAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "buyerRehearsalReady": { "type": "boolean" }, "checkoutTest": { "type": "object", "properties": { "lastPassedAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "lastStatus": { "anyOf": [ { "type": "string", "enum": [ "passed", "failed" ] }, { "type": "null" } ] } }, "required": [ "lastPassedAt", "lastStatus" ], "additionalProperties": {} } }, "required": [ "key", "name", "edition", "workspaceId", "mode", "environment", "chartId", "sourceChartKey", "sourceChartSha256", "currency", "venue", "timezone", "audience", "revision", "structureState", "salesState", "occurrenceCount", "createdAt", "updatedAt", "activatedAt", "closedAt", "buyerRehearsalReady" ], "additionalProperties": {} }, "SeasonPlan": { "type": "object", "properties": { "key": { "type": "string", "pattern": "^spl_[0-9a-f]{32}$" }, "name": { "type": "string" }, "publicationState": { "type": "string", "enum": [ "draft", "published", "superseded" ] }, "publishedRevision": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "activationId": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "channelPolicy": { "type": "string", "const": "exclude_restricted" }, "eventKeys": { "minItems": 2, "maxItems": 20, "type": "array", "items": { "type": "string" } }, "sourcePerformanceGroups": { "type": "array", "items": { "type": "object", "properties": { "key": { "type": "string" }, "activationId": { "type": "string" }, "memberSetSha256": { "type": "string", "minLength": 64, "maxLength": 64 }, "activationSpecSha256": { "type": "string", "minLength": 64, "maxLength": 64 }, "eventKeys": { "minItems": 2, "maxItems": 20, "type": "array", "items": { "type": "string" } } }, "required": [ "key", "activationId", "memberSetSha256", "activationSpecSha256", "eventKeys" ], "additionalProperties": {} } }, "createdAt": { "type": "number" }, "updatedAt": { "type": "number" }, "publishedAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "required": [ "key", "name", "publicationState", "publishedRevision", "activationId", "channelPolicy", "eventKeys", "sourcePerformanceGroups", "createdAt", "updatedAt", "publishedAt" ], "additionalProperties": {} }, "SeasonLifecycle": { "type": "object", "properties": { "operationId": { "type": "string" }, "kind": { "type": "string", "enum": [ "ACTIVATION", "CLOSE", "ARCHIVE", "PLAN_PUBLICATION" ] }, "phase": { "type": "string" }, "terminal": { "type": "boolean" } }, "required": [ "operationId", "kind", "phase", "terminal" ], "additionalProperties": {} }, "ChannelPreviewAudience": { "type": "object", "properties": { "channelIds": { "type": "array", "items": { "type": "string" } }, "includePublic": { "type": "boolean" } }, "required": [ "channelIds", "includePublic" ], "additionalProperties": {} }, "AvailabilityRule": { "oneOf": [ { "type": "object", "properties": { "mode": { "type": "string", "const": "hidden" }, "labels": { "type": "array", "items": { "type": "string" } } }, "required": [ "mode" ], "additionalProperties": false }, { "type": "object", "properties": { "mode": { "type": "string", "const": "closed" }, "labels": { "type": "array", "items": { "type": "string" } } }, "required": [ "mode" ], "additionalProperties": false }, { "type": "object", "properties": { "mode": { "type": "string", "const": "timed" }, "revealAt": { "type": "number" }, "labels": { "type": "array", "items": { "type": "string" } } }, "required": [ "mode", "revealAt" ], "additionalProperties": false }, { "type": "object", "properties": { "mode": { "type": "string", "const": "threshold" }, "thresholdPct": { "type": "number", "minimum": 0, "maximum": 100 }, "labels": { "type": "array", "items": { "type": "string" } } }, "required": [ "mode", "thresholdPct" ], "additionalProperties": false } ] }, "ReadinessReport": { "type": "object", "properties": { "state": { "type": "string", "enum": [ "healthy", "degraded", "unavailable" ] }, "version": { "type": "string" }, "checkedAt": { "type": "string" }, "mainDatabase": { "type": "string", "enum": [ "d1", "postgres" ] }, "dependencies": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "state": { "type": "string", "enum": [ "healthy", "degraded", "unavailable" ] }, "latencyMs": { "type": "number" }, "reason": { "type": "string" } }, "required": [ "name", "state", "latencyMs" ], "additionalProperties": {} } } }, "required": [ "state", "version", "checkedAt", "mainDatabase", "dependencies" ], "additionalProperties": {} }, "ChartPage": { "type": "object", "properties": { "charts": { "type": "array", "items": { "$ref": "#/components/schemas/ChartMeta" } }, "nextCursor": { "type": "string" } }, "required": [ "charts" ], "additionalProperties": {} }, "ChartEnvelope": { "type": "object", "properties": { "meta": { "$ref": "#/components/schemas/ChartMeta" } }, "required": [ "meta" ], "additionalProperties": {} }, "ChartSaveEnvelope": { "type": "object", "properties": { "meta": { "$ref": "#/components/schemas/ChartMeta" }, "publishBlockers": { "type": "object", "properties": { "count": { "type": "number" }, "codes": { "type": "array", "items": { "type": "string" } } }, "required": [ "count", "codes" ], "additionalProperties": {} } }, "required": [ "meta" ], "additionalProperties": {} }, "ChartDocument": { "type": "object", "properties": { "meta": { "$ref": "#/components/schemas/ChartMeta" }, "doc": { "anyOf": [ { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": {} }, { "type": "null" } ] }, "categorySeats": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "number" } } }, "required": [ "meta", "doc" ], "additionalProperties": {} }, "DeleteChartResult": { "type": "object", "properties": { "ok": { "type": "boolean", "const": true }, "cleanup": { "type": "object", "properties": { "referenceObjectsDeleted": { "type": "number" } }, "required": [ "referenceObjectsDeleted" ], "additionalProperties": {} } }, "required": [ "ok", "cleanup" ], "additionalProperties": {} }, "PublishChartResult": { "type": "object", "properties": { "meta": { "$ref": "#/components/schemas/ChartMeta" }, "refreshedEvents": { "type": "number" }, "eventsNeedingManualUpdate": { "type": "number" }, "manualUpdates": { "type": "array", "items": { "type": "object", "properties": { "key": { "type": "string" }, "name": { "type": "string" } }, "required": [ "key", "name" ], "additionalProperties": {} } }, "pricingReviews": { "type": "array", "items": { "type": "object", "properties": { "key": { "type": "string" }, "name": { "type": "string" }, "held": { "type": "number" }, "booked": { "type": "number" }, "revision": { "type": "number" }, "chartPriceSha": { "type": "string" } }, "required": [ "key", "name", "held", "booked", "revision", "chartPriceSha" ], "additionalProperties": {} } }, "linkedEvents": { "description": "Every linked event still on an older map. A publish never updates an event: choose per event with POST /v1/events/{key}/update-chart. `updatePath` says whether that update keeps nothing to review (safe) or preserves existing bookings, holds and blocks (reviewed); `reason` names an event that must be updated from its configuration or season instead. `refreshedEvents` is always 0.", "type": "array", "items": { "type": "object", "properties": { "key": { "type": "string" }, "name": { "type": "string" }, "startsAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "booked": { "type": "number" }, "held": { "type": "number" }, "blocked": { "type": "number" }, "updatePath": { "type": "string", "enum": [ "safe", "reviewed" ] }, "reason": { "type": "string", "enum": [ "configuration_bound", "group_locked" ] } }, "required": [ "key", "name", "startsAt", "booked", "held", "blocked", "updatePath" ], "additionalProperties": {} } } }, "required": [ "meta", "refreshedEvents", "eventsNeedingManualUpdate", "manualUpdates", "pricingReviews" ], "additionalProperties": {} }, "PanoramaManifestJob": { "type": "object", "properties": { "id": { "type": "string" }, "chartId": { "type": "string" }, "expectedUpdatedAt": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "manifestSha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "ingestSha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "format": { "type": "string", "enum": [ "csv", "json" ] }, "state": { "type": "string", "enum": [ "queued", "processing", "ready", "applied", "failed", "cancelled" ] }, "progress": { "type": "object", "properties": { "rows": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "ready": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "failed": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "rows", "ready", "failed" ], "additionalProperties": {} }, "attempts": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "errors": {}, "createdAt": { "type": "number" }, "updatedAt": { "type": "number" }, "retainUntil": { "type": "number" }, "appliedUpdatedAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "required": [ "id", "chartId", "expectedUpdatedAt", "manifestSha256", "ingestSha256", "format", "state", "progress", "attempts", "errors", "createdAt", "updatedAt", "retainUntil", "appliedUpdatedAt" ], "additionalProperties": {} }, "PanoramaManifestCreateResult": { "type": "object", "properties": { "job": { "$ref": "#/components/schemas/PanoramaManifestJob" }, "validation": {}, "deduplicated": { "type": "boolean" } }, "required": [ "job", "validation", "deduplicated" ], "additionalProperties": {} }, "PanoramaManifestStatusResult": { "type": "object", "properties": { "job": { "$ref": "#/components/schemas/PanoramaManifestJob" }, "rows": { "type": "array", "items": { "type": "object", "properties": { "rowNumber": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "scope": { "type": "string", "enum": [ "venue", "floor", "section", "row", "seat" ] }, "key": { "type": "string" }, "configuration": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string" }, "version": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "id", "version" ], "additionalProperties": {} }, { "type": "null" } ] }, "inputKind": { "type": "string", "enum": [ "url", "file" ] }, "state": { "type": "string", "enum": [ "pending", "processing", "ready", "failed" ] }, "attempts": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "master": { "anyOf": [ {}, { "type": "null" } ] }, "preview": { "anyOf": [ {}, { "type": "null" } ] }, "variants": { "type": "array", "items": {} }, "error": { "anyOf": [ { "type": "object", "properties": { "code": { "type": "string" }, "message": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "code", "message" ], "additionalProperties": {} }, { "type": "null" } ] } }, "required": [ "rowNumber", "scope", "key", "configuration", "inputKind", "state", "attempts", "master", "preview", "variants", "error" ], "additionalProperties": {} } } }, "required": [ "job", "rows" ], "additionalProperties": {} }, "EventPage": { "type": "object", "properties": { "events": { "type": "array", "items": { "allOf": [ { "$ref": "#/components/schemas/EventMeta" }, { "type": "object", "properties": { "sold": { "type": "number" }, "counts": { "$ref": "#/components/schemas/EventCounts" } }, "required": [ "sold" ], "additionalProperties": {} } ] } }, "nextCursor": { "type": "string" } }, "required": [ "events" ], "additionalProperties": {} }, "EventEnvelope": { "type": "object", "properties": { "meta": { "$ref": "#/components/schemas/EventMeta" }, "sectionStates": { "type": "object", "properties": { "hidden": { "type": "array", "items": { "type": "string" } }, "closed": { "type": "array", "items": { "type": "string" } }, "states": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "string", "enum": [ "open", "closed", "hidden" ] } } }, "required": [ "hidden", "closed", "states" ], "additionalProperties": {} } }, "required": [ "meta" ], "additionalProperties": {} }, "EventDetail": { "type": "object", "properties": { "meta": { "allOf": [ { "$ref": "#/components/schemas/EventMeta" }, { "type": "object", "properties": { "sold": { "type": "number" } }, "required": [ "sold" ], "additionalProperties": {} } ] }, "counts": { "$ref": "#/components/schemas/EventCounts" }, "holdTtlMs": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "chartUpdate": { "type": "object", "properties": { "behind": { "type": "boolean" }, "canAutoUpdate": { "type": "boolean" }, "chartVersionAt": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "behind", "canAutoUpdate" ], "additionalProperties": {} } }, "required": [ "meta", "counts", "holdTtlMs" ], "additionalProperties": {} }, "EventConfigurationBinding": { "type": "object", "properties": { "configuration": { "anyOf": [ { "$ref": "#/components/schemas/EventConfigurationRef" }, { "type": "null" } ] }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "changedBy": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "changedAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "audit": { "type": "array", "items": { "$ref": "#/components/schemas/EventConfigurationBindingAudit" } } }, "required": [ "configuration", "revision", "changedBy", "changedAt", "audit" ], "additionalProperties": {} }, "EventChartUpdateResult": { "type": "object", "properties": { "ok": { "type": "boolean" }, "updated": { "type": "boolean" }, "meta": { "$ref": "#/components/schemas/EventMeta" } }, "required": [ "ok", "updated", "meta" ], "additionalProperties": {} }, "SalesAliasResult": { "type": "object", "properties": { "status": { "type": "string" }, "state": { "type": "string" }, "revision": { "type": "number" }, "changed": { "type": "boolean" } }, "required": [ "status", "state", "revision", "changed" ], "additionalProperties": {} }, "ArchiveEventResult": { "type": "object", "properties": { "status": { "type": "string", "const": "archived" }, "changed": { "type": "boolean" } }, "required": [ "status", "changed" ], "additionalProperties": {} }, "UnarchiveEventResult": { "type": "object", "properties": { "status": { "type": "string", "const": "active" }, "state": { "type": "string", "enum": [ "setup", "testable", "live", "paused", "ended" ] }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "changed": { "type": "boolean", "const": true } }, "required": [ "status", "state", "revision", "changed" ], "additionalProperties": {} }, "TicketReleaseList": { "type": "object", "properties": { "releases": { "type": "array", "items": { "$ref": "#/components/schemas/TicketRelease" } } }, "required": [ "releases" ], "additionalProperties": {} }, "HoldResponse": { "type": "object", "properties": { "ok": { "type": "boolean", "const": true }, "holdId": { "type": "string" }, "expiresAt": { "type": "number" }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/InventoryItem" } } }, "required": [ "ok", "holdId", "expiresAt", "items" ], "additionalProperties": {} }, "ExtendHoldResult": { "type": "object", "properties": { "ok": { "type": "boolean", "const": true }, "holdId": { "type": "string" }, "expiresAt": { "type": "number" }, "extends": { "type": "number" } }, "required": [ "ok", "holdId", "expiresAt", "extends" ], "additionalProperties": {} }, "BestAvailableHoldResponse": { "type": "object", "properties": { "ok": { "type": "boolean", "const": true }, "holdId": { "type": "string" }, "expiresAt": { "type": "number" }, "labels": { "type": "array", "items": { "type": "string" } }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/InventoryItem" } }, "zoneId": { "type": "string" } }, "required": [ "ok", "holdId", "expiresAt", "labels", "items" ], "additionalProperties": {} }, "BestAvailableBlockResponse": { "type": "object", "properties": { "ok": { "type": "boolean", "const": true }, "labels": { "type": "array", "items": { "type": "string" } }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/InventoryItem" } }, "releaseAt": { "type": "number" }, "zoneId": { "type": "string" } }, "required": [ "ok", "labels", "items", "releaseAt" ], "additionalProperties": {} }, "BestAvailableBookResponse": { "type": "object", "properties": { "ok": { "type": "boolean", "const": true }, "labels": { "type": "array", "items": { "type": "string" } }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/InventoryItem" } }, "bookingRef": { "type": "string" }, "zoneId": { "type": "string" } }, "required": [ "ok", "labels", "items", "bookingRef" ], "additionalProperties": {} }, "HoldInspection": { "type": "object", "properties": { "holdId": { "type": "string" }, "status": { "type": "string", "enum": [ "active", "booked", "released", "expired" ] }, "expiresAt": { "type": "number" }, "bookingRef": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "eventKey": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "mode": { "type": "string", "enum": [ "live", "test" ] }, "externalRef": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "workspaceId": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/InventoryItem" } }, "accessSessionId": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "accessSource": { "type": "string", "enum": [ "public", "promoter", "partner", "hosted_link", "staff_override" ] }, "buyerRef": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "partnerRef": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "holdId", "status", "expiresAt", "bookingRef", "eventKey", "mode", "externalRef", "workspaceId", "items" ], "additionalProperties": {} }, "ReleaseResult": { "type": "object", "properties": { "ok": { "type": "boolean", "const": true }, "released": { "type": "array", "items": { "type": "string" } } }, "required": [ "ok", "released" ], "additionalProperties": {} }, "BookResult": { "type": "object", "properties": { "ok": { "type": "boolean", "const": true }, "booked": { "type": "array", "items": { "type": "string" } } }, "required": [ "ok", "booked" ], "additionalProperties": {} }, "UnbookResult": { "type": "object", "properties": { "ok": { "type": "boolean", "const": true }, "unbooked": { "type": "array", "items": { "type": "string" } }, "conflicts": { "type": "array", "items": {} } }, "required": [ "ok", "unbooked", "conflicts" ], "additionalProperties": {} }, "BlockResult": { "type": "object", "properties": { "ok": { "type": "boolean", "const": true }, "blocked": { "type": "array", "items": { "type": "string" } } }, "required": [ "ok", "blocked" ], "additionalProperties": {} }, "UnblockResult": { "type": "object", "properties": { "ok": { "type": "boolean", "const": true }, "unblocked": { "type": "array", "items": { "type": "string" } } }, "required": [ "ok", "unblocked" ], "additionalProperties": {} }, "UnblockAllResult": { "type": "object", "properties": { "ok": { "type": "boolean", "const": true }, "freed": { "type": "number" } }, "required": [ "ok", "freed" ], "additionalProperties": {} }, "AvailabilityEnvelope": { "type": "object", "properties": { "rules": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "$ref": "#/components/schemas/AvailabilityRule" } } }, "required": [ "rules" ], "additionalProperties": {} }, "ResaleListRequest": { "type": "object", "properties": { "objects": { "minItems": 1, "maxItems": 500, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 200 } }, "listingId": { "type": "string", "minLength": 1, "maxLength": 120 } }, "required": [ "objects" ], "additionalProperties": false }, "ResaleListEnvelope": { "type": "object", "properties": { "ok": { "type": "boolean", "const": true }, "listed": { "type": "array", "items": { "type": "string" } }, "listingId": { "type": "string" } }, "required": [ "ok", "listed", "listingId" ], "additionalProperties": {} }, "ResaleUnlistRequest": { "type": "object", "properties": { "objects": { "minItems": 1, "maxItems": 500, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 200 } } }, "required": [ "objects" ], "additionalProperties": false }, "ResaleUnlistEnvelope": { "type": "object", "properties": { "ok": { "type": "boolean", "const": true }, "unlisted": { "type": "array", "items": { "type": "string" } }, "listingIds": { "type": "array", "items": { "type": "string" } } }, "required": [ "ok", "unlisted", "listingIds" ], "additionalProperties": {} }, "ResaleListingList": { "type": "object", "properties": { "listings": { "type": "array", "items": { "type": "object", "properties": { "label": { "type": "string" }, "listingId": { "type": "string" }, "bookingRef": { "type": "string" }, "held": { "type": "boolean" } }, "required": [ "label", "listingId", "bookingRef", "held" ], "additionalProperties": {} } } }, "required": [ "listings" ], "additionalProperties": {} }, "ResaleSummary": { "type": "object", "properties": { "listed": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "listings": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "held": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "resold": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "since": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "listed", "listings", "held", "resold", "since" ], "additionalProperties": {} }, "AvailabilityUpdateResult": { "type": "object", "properties": { "ok": { "type": "boolean", "const": true }, "hidden": { "type": "array", "items": { "type": "string" } }, "rules": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "$ref": "#/components/schemas/AvailabilityRule" } } }, "required": [ "ok", "hidden", "rules" ], "additionalProperties": {} }, "HoldTtlEnvelope": { "type": "object", "properties": { "holdTtlMs": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "required": [ "holdTtlMs" ], "additionalProperties": {} }, "HoldTtlUpdateResult": { "type": "object", "properties": { "ok": { "type": "boolean", "const": true }, "holdTtlMs": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "required": [ "ok", "holdTtlMs" ], "additionalProperties": {} }, "InventoryBookingPage": { "type": "object", "properties": { "bookings": { "type": "array", "items": { "$ref": "#/components/schemas/InventoryBookingRecord" } }, "nextCursor": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "bookings", "nextCursor" ], "additionalProperties": {} }, "InventoryBookingDetail": { "type": "object", "properties": { "booking": { "$ref": "#/components/schemas/InventoryBookingRecord" }, "activity": { "type": "array", "items": { "$ref": "#/components/schemas/InventoryBookingActivity" } }, "activityTruncated": { "type": "boolean" } }, "required": [ "booking", "activity", "activityTruncated" ], "additionalProperties": {} }, "InventoryBookingChangePage": { "type": "object", "properties": { "changes": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "number" }, "action": { "type": "string", "enum": [ "book", "replay", "partial_cancel", "cancel", "reconcile" ] }, "at": { "type": "number" }, "labels": { "type": "array", "items": { "type": "string" } }, "actor": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "source": { "type": "string" }, "booking": { "$ref": "#/components/schemas/InventoryBookingRecord" } }, "required": [ "id", "action", "at", "labels", "actor", "source", "booking" ], "additionalProperties": {} } }, "nextAfter": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "checkpoint": { "type": "number" } }, "required": [ "changes", "nextAfter", "checkpoint" ], "additionalProperties": {} }, "EventReportEnvelope": { "type": "object", "properties": { "report": { "$ref": "#/components/schemas/EventReport" }, "event": { "$ref": "#/components/schemas/EventMeta" }, "categories": { "type": "array", "items": { "type": "object", "properties": { "key": { "type": "string" }, "label": { "type": "string" }, "color": { "type": "string" }, "price": { "type": "number" } }, "required": [ "key", "label", "color", "price" ], "additionalProperties": {} } } }, "required": [ "report", "event", "categories" ], "additionalProperties": {} }, "EventLogPage": { "type": "object", "properties": { "entries": { "type": "array", "items": { "$ref": "#/components/schemas/EventLogEntry" } }, "nextBefore": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "required": [ "entries", "nextBefore" ], "additionalProperties": {} }, "ChannelReportEnvelope": { "type": "object", "properties": { "report": { "$ref": "#/components/schemas/ChannelReport" }, "event": { "$ref": "#/components/schemas/EventMeta" } }, "required": [ "report", "event" ], "additionalProperties": {} }, "ChannelList": { "type": "object", "properties": { "assignmentVersion": { "type": "number" }, "publicSale": { "type": "object", "properties": { "id": { "type": "string", "const": "public" }, "name": { "type": "string" }, "state": { "type": "string", "const": "active" }, "counts": { "$ref": "#/components/schemas/ChannelCounts" } }, "required": [ "id", "name", "state", "counts" ], "additionalProperties": {} }, "channels": { "type": "array", "items": { "$ref": "#/components/schemas/ChannelWithCounts" } } }, "required": [ "assignmentVersion", "publicSale", "channels" ], "additionalProperties": {} }, "ChannelMutationEnvelope": { "type": "object", "properties": { "ok": { "type": "boolean", "const": true }, "channel": { "$ref": "#/components/schemas/ChannelRecord" }, "intentSwitch": {} }, "required": [ "ok", "channel" ], "additionalProperties": {} }, "AssignmentResult": { "type": "object", "properties": { "ok": { "type": "boolean", "const": true }, "targetChannelId": { "type": "string" }, "assignmentVersion": { "type": "number" }, "requested": { "type": "number" }, "applied": { "type": "number" }, "buckets": { "$ref": "#/components/schemas/AssignmentBuckets" } }, "required": [ "ok", "targetChannelId", "assignmentVersion", "requested", "applied", "buckets" ], "additionalProperties": {} }, "ChannelAllocationPage": { "type": "object", "properties": { "assignmentVersion": { "type": "number" }, "allocations": { "type": "array", "items": { "type": "object", "properties": { "label": { "type": "string" }, "channelId": { "type": "string" } }, "required": [ "label", "channelId" ], "additionalProperties": {} } }, "nextAfterLabel": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "assignmentVersion", "allocations", "nextAfterLabel" ], "additionalProperties": {} }, "ChannelPreview": { "oneOf": [ { "type": "object", "properties": { "ok": { "type": "boolean", "const": true }, "audience": { "$ref": "#/components/schemas/ChannelPreviewAudience" }, "available": { "type": "boolean", "const": true }, "seats": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "string", "enum": [ "free", "held", "booked", "blocked" ] } }, "hidden": { "type": "array", "items": { "type": "string" } }, "closed": { "type": "array", "items": { "type": "string" } }, "updatedAt": { "type": "number" }, "eligible": { "type": "array", "items": { "type": "string" } }, "counts": { "type": "object", "properties": { "eligible": { "type": "number" } }, "required": [ "eligible" ], "additionalProperties": {} }, "assignmentVersion": { "type": "number" } }, "required": [ "ok", "audience", "available", "seats", "hidden", "closed", "updatedAt", "eligible", "counts", "assignmentVersion" ], "additionalProperties": {} }, { "type": "object", "properties": { "ok": { "type": "boolean", "const": true }, "audience": { "$ref": "#/components/schemas/ChannelPreviewAudience" }, "available": { "type": "boolean", "const": false }, "unavailable": { "type": "array", "items": { "type": "object", "properties": { "channelId": { "type": "string" }, "state": { "type": "string", "enum": [ "paused", "archived", "not_found" ] } }, "required": [ "channelId", "state" ], "additionalProperties": {} } }, "assignmentVersion": { "type": "number" } }, "required": [ "ok", "audience", "available", "unavailable", "assignmentVersion" ], "additionalProperties": {} } ] }, "ChannelArchiveResult": { "type": "object", "properties": { "ok": { "type": "boolean", "const": true }, "channel": { "$ref": "#/components/schemas/ChannelRecord" }, "assignmentVersion": { "type": "number" }, "moved": { "type": "object", "properties": { "free": { "type": "number" }, "blocked": { "type": "number" }, "booked": { "type": "number" }, "units": { "type": "number" } }, "required": [ "free", "blocked", "booked", "units" ], "additionalProperties": {} }, "revokedSessions": { "type": "number" } }, "required": [ "ok", "channel", "assignmentVersion", "moved", "revokedSessions" ], "additionalProperties": {} }, "BuyerAccessReveal": { "type": "object", "properties": { "sessionId": { "type": "string" }, "token": { "type": "string" }, "expiresAt": { "type": "number" }, "eventKey": { "type": "string" }, "includePublic": { "type": "boolean" }, "maxQuantity": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "required": [ "sessionId", "token", "expiresAt", "eventKey", "includePublic", "maxQuantity" ], "additionalProperties": {} }, "BuyerAccessSessionList": { "type": "object", "properties": { "sessions": { "type": "array", "items": { "$ref": "#/components/schemas/BuyerAccessSession" } } }, "required": [ "sessions" ], "additionalProperties": {} }, "BuyerAccessRevokeResult": { "type": "object", "properties": { "ok": { "type": "boolean", "const": true }, "sessionId": { "type": "string" }, "grantVersion": { "type": "number" } }, "required": [ "ok", "sessionId", "grantVersion" ], "additionalProperties": {} }, "PerformanceGroupPage": { "type": "object", "properties": { "performanceGroups": { "type": "array", "items": { "$ref": "#/components/schemas/PerformanceGroup" } }, "nextCursor": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "performanceGroups", "nextCursor" ], "additionalProperties": {} }, "PerformanceGroupEnvelope": { "type": "object", "properties": { "performanceGroup": { "allOf": [ { "$ref": "#/components/schemas/PerformanceGroup" }, { "type": "object", "properties": { "performances": { "minItems": 2, "maxItems": 12, "type": "array", "items": { "$ref": "#/components/schemas/PerformanceGroupPerformance" } } }, "required": [ "performances" ], "additionalProperties": {} } ] } }, "required": [ "performanceGroup" ], "additionalProperties": {} }, "PerformanceGroupLifecycleEnvelope": { "type": "object", "properties": { "performanceGroup": { "allOf": [ { "$ref": "#/components/schemas/PerformanceGroup" }, { "type": "object", "properties": { "performances": { "minItems": 2, "maxItems": 12, "type": "array", "items": { "$ref": "#/components/schemas/PerformanceGroupPerformance" } } }, "required": [ "performances" ], "additionalProperties": {} } ] }, "lifecycleOperation": { "$ref": "#/components/schemas/PerformanceGroupLifecycle" }, "message": { "type": "string" } }, "required": [ "performanceGroup", "lifecycleOperation" ], "additionalProperties": {} }, "PerformanceGroupBuyerAccessReveal": { "allOf": [ { "$ref": "#/components/schemas/PerformanceGroupBuyerAccessSession" }, { "type": "object", "properties": { "token": { "type": "string" }, "performanceGroupKey": { "type": "string" } }, "required": [ "token", "performanceGroupKey" ], "additionalProperties": {} } ] }, "PerformanceGroupBuyerAccessSessionList": { "type": "object", "properties": { "sessions": { "type": "array", "items": { "$ref": "#/components/schemas/PerformanceGroupBuyerAccessSession" } } }, "required": [ "sessions" ], "additionalProperties": {} }, "PerformanceGroupBuyerAccessRevokeResult": { "type": "object", "properties": { "ok": { "type": "boolean", "const": true }, "sessionId": { "type": "string" } }, "required": [ "ok", "sessionId" ], "additionalProperties": {} }, "PerformanceGroupHoldEnvelope": { "type": "object", "properties": { "hold": { "$ref": "#/components/schemas/PerformanceGroupHold" } }, "required": [ "hold" ], "additionalProperties": {} }, "PerformanceGroupBookingEnvelope": { "type": "object", "properties": { "booking": { "$ref": "#/components/schemas/PerformanceGroupBooking" } }, "required": [ "booking" ], "additionalProperties": {} }, "SeasonPage": { "type": "object", "properties": { "seasons": { "type": "array", "items": { "allOf": [ { "$ref": "#/components/schemas/Season" }, { "type": "object", "properties": { "planCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "publishedPlanCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "planCount", "publishedPlanCount" ], "additionalProperties": {} } ] } }, "nextCursor": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "seasons", "nextCursor" ], "additionalProperties": {} }, "SeasonEnvelope": { "type": "object", "properties": { "season": { "allOf": [ { "$ref": "#/components/schemas/Season" }, { "type": "object", "properties": { "plans": { "type": "array", "items": { "$ref": "#/components/schemas/SeasonPlan" } } }, "required": [ "plans" ], "additionalProperties": {} } ] } }, "required": [ "season" ], "additionalProperties": {} }, "SeasonLifecycleEnvelope": { "type": "object", "properties": { "season": { "allOf": [ { "$ref": "#/components/schemas/Season" }, { "type": "object", "properties": { "plans": { "type": "array", "items": { "$ref": "#/components/schemas/SeasonPlan" } } }, "required": [ "plans" ], "additionalProperties": {} } ] }, "lifecycleOperation": { "$ref": "#/components/schemas/SeasonLifecycle" } }, "required": [ "season", "lifecycleOperation" ], "additionalProperties": {} }, "SeasonPlanEnvelope": { "type": "object", "properties": { "plan": { "$ref": "#/components/schemas/SeasonPlan" } }, "required": [ "plan" ], "additionalProperties": {} }, "SeasonPlanPublishEnvelope": { "type": "object", "properties": { "season": { "allOf": [ { "$ref": "#/components/schemas/Season" }, { "type": "object", "properties": { "plans": { "type": "array", "items": { "$ref": "#/components/schemas/SeasonPlan" } } }, "required": [ "plans" ], "additionalProperties": {} } ] }, "plan": { "$ref": "#/components/schemas/SeasonPlan" }, "lifecycleOperation": { "$ref": "#/components/schemas/SeasonLifecycle" } }, "required": [ "season", "plan" ], "additionalProperties": {} }, "SeasonValidationEnvelope": { "type": "object", "properties": { "valid": { "type": "boolean" }, "mode": { "type": "string", "enum": [ "live", "test" ] }, "eventKeys": { "maxItems": 20, "type": "array", "items": { "type": "string" } }, "occurrenceCount": { "type": "integer", "minimum": 0, "maximum": 20 }, "sourcePerformanceGroups": { "type": "array", "items": { "type": "object", "properties": { "key": { "type": "string" }, "activationId": { "type": "string" }, "memberSetSha256": { "type": "string", "minLength": 64, "maxLength": 64 }, "activationSpecSha256": { "type": "string", "minLength": 64, "maxLength": 64 }, "eventKeys": { "minItems": 2, "maxItems": 20, "type": "array", "items": { "type": "string" } } }, "required": [ "key", "activationId", "memberSetSha256", "activationSpecSha256", "eventKeys" ], "additionalProperties": {} } }, "issues": { "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "field": { "type": "string" }, "eventId": { "type": "string" }, "sourcePerformanceGroupKey": { "type": "string" }, "remediation": { "type": "string" } }, "required": [ "code", "message" ], "additionalProperties": {} } } }, "required": [ "valid", "mode", "eventKeys", "occurrenceCount", "sourcePerformanceGroups", "issues" ], "additionalProperties": {} }, "SeasonBuyerAccessSession": { "type": "object", "properties": { "sessionId": { "type": "string" }, "allowedOrigin": { "type": "string" }, "expiresAt": { "type": "number" }, "mode": { "type": "string", "enum": [ "live", "test" ] }, "environment": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "purpose": { "type": "string", "enum": [ "sale", "rehearsal" ] }, "includePublic": { "type": "boolean" }, "maxQuantity": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "buyerRef": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "planActivationId": { "type": "string" }, "state": { "type": "string", "enum": [ "active", "revoked" ] }, "createdAt": { "type": "number" }, "revokedAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "required": [ "sessionId", "allowedOrigin", "expiresAt", "mode", "environment", "purpose", "includePublic", "maxQuantity", "buyerRef", "planActivationId", "state", "createdAt", "revokedAt" ], "additionalProperties": {} }, "SeasonBuyerAccessReveal": { "type": "object", "properties": { "sessionId": { "type": "string" }, "token": { "type": "string" }, "expiresAt": { "type": "number" }, "seasonKey": { "type": "string" }, "mode": { "type": "string", "enum": [ "live", "test" ] }, "environment": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "purpose": { "type": "string", "enum": [ "sale", "rehearsal" ] }, "allowedOrigin": { "type": "string" }, "includePublic": { "type": "boolean" }, "maxQuantity": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "buyerRef": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "planActivationId": { "type": "string" }, "state": { "type": "string", "enum": [ "active", "revoked" ] }, "createdAt": { "type": "number" }, "revokedAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "required": [ "sessionId", "token", "expiresAt", "seasonKey", "mode", "environment", "purpose", "allowedOrigin", "includePublic", "maxQuantity", "buyerRef", "planActivationId", "state", "createdAt", "revokedAt" ], "additionalProperties": {} }, "SeasonBuyerAccessSessionList": { "type": "object", "properties": { "sessions": { "type": "array", "items": { "type": "object", "properties": { "sessionId": { "type": "string" }, "allowedOrigin": { "type": "string" }, "expiresAt": { "type": "number" }, "mode": { "type": "string", "enum": [ "live", "test" ] }, "environment": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "purpose": { "type": "string", "enum": [ "sale", "rehearsal" ] }, "includePublic": { "type": "boolean" }, "maxQuantity": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "buyerRef": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "planActivationId": { "type": "string" }, "state": { "type": "string", "enum": [ "active", "revoked" ] }, "createdAt": { "type": "number" }, "revokedAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "required": [ "sessionId", "allowedOrigin", "expiresAt", "mode", "environment", "purpose", "includePublic", "maxQuantity", "buyerRef", "planActivationId", "state", "createdAt", "revokedAt" ], "additionalProperties": {} } } }, "required": [ "sessions" ], "additionalProperties": {} }, "SeasonBuyerAccessRevokeResult": { "type": "object", "properties": { "ok": { "type": "boolean", "const": true }, "sessionId": { "type": "string" } }, "required": [ "ok", "sessionId" ], "additionalProperties": {} }, "SeasonBuyerRehearsalEnvelope": { "type": "object", "properties": { "season": { "allOf": [ { "$ref": "#/components/schemas/Season" }, { "type": "object", "properties": { "plans": { "type": "array", "items": { "$ref": "#/components/schemas/SeasonPlan" } } }, "required": [ "plans" ], "additionalProperties": {} } ] }, "rehearsal": { "type": "object", "properties": { "ready": { "type": "boolean", "const": true }, "holdOperationId": { "type": "string" }, "bookActionId": { "type": "string" }, "cancelActionId": { "type": "string" }, "subscriptionId": { "type": "string" }, "occurrenceIds": { "minItems": 3, "maxItems": 3, "type": "array", "items": { "type": "string" } }, "payloadSha256": { "minItems": 3, "maxItems": 3, "type": "array", "items": { "type": "string", "minLength": 64, "maxLength": 64 } }, "planActivationIds": { "minItems": 1, "type": "array", "items": { "type": "string" } }, "activationEvidence": { "minItems": 1, "type": "array", "items": { "type": "object", "properties": { "planActivationId": { "type": "string" }, "holdOperationId": { "type": "string" }, "bookActionId": { "type": "string" }, "cancelActionId": { "type": "string" }, "subscriptionId": { "type": "string" }, "occurrenceIds": { "minItems": 3, "maxItems": 3, "type": "array", "items": { "type": "string" } }, "payloadSha256": { "minItems": 3, "maxItems": 3, "type": "array", "items": { "type": "string", "minLength": 64, "maxLength": 64 } } }, "required": [ "planActivationId", "holdOperationId", "bookActionId", "cancelActionId", "subscriptionId", "occurrenceIds", "payloadSha256" ], "additionalProperties": {} } }, "verifiedAt": { "type": "number" } }, "required": [ "ready", "holdOperationId", "bookActionId", "cancelActionId", "subscriptionId", "occurrenceIds", "payloadSha256", "planActivationIds", "activationEvidence", "verifiedAt" ], "additionalProperties": {} } }, "required": [ "season", "rehearsal" ], "additionalProperties": {} }, "SeasonHoldEnvelope": { "type": "object", "properties": { "hold": { "type": "object", "properties": { "operationId": { "type": "string" }, "seasonKey": { "type": "string" }, "holdId": { "type": "string" }, "state": { "type": "string" }, "expiresAt": { "type": "number" }, "policy": { "type": "string", "const": "fixed_inclusion_same_seat" }, "bookingRef": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "pricingAuthority": { "type": "string", "const": "host" }, "authoritativeAmountIncluded": { "type": "boolean", "const": false }, "allocations": { "type": "array", "items": { "type": "object", "properties": { "eventKey": { "type": "string" }, "labels": { "type": "array", "items": { "type": "string" } }, "items": { "type": "array", "items": { "type": "object", "properties": { "label": { "type": "string" }, "objectId": { "type": "string" }, "objectType": { "type": "string" }, "categoryKey": { "type": "string" }, "tierId": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "quantity": { "type": "number" } }, "required": [ "label", "objectId", "objectType", "categoryKey", "tierId", "quantity" ], "additionalProperties": {} } } }, "required": [ "eventKey", "labels", "items" ], "additionalProperties": {} } } }, "required": [ "operationId", "seasonKey", "holdId", "state", "expiresAt", "policy", "bookingRef", "pricingAuthority", "authoritativeAmountIncluded", "allocations" ], "additionalProperties": {} } }, "required": [ "hold" ], "additionalProperties": {} }, "SeasonBookingEnvelope": { "type": "object", "properties": { "booking": { "type": "object", "properties": { "actionId": { "type": "string" }, "operationId": { "type": "string" }, "bookingRef": { "type": "string" }, "planActivationId": { "type": "string" }, "state": { "type": "string", "enum": [ "book_pending", "booked", "book_failed", "partial_terminal", "cancelled" ] }, "outcomes": { "type": "array", "items": { "type": "object", "properties": { "eventKey": { "type": "string" }, "state": { "type": "string", "enum": [ "pending", "booked", "failed" ] }, "code": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "eventKey", "state", "code" ], "additionalProperties": {} } }, "lastError": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "cancellation": { "anyOf": [ { "type": "object", "properties": { "cancelActionId": { "type": "string" }, "state": { "type": "string", "enum": [ "cancel_pending", "cancelled", "cancel_failed", "partial_terminal" ] }, "rightDisposition": { "type": "string", "enum": [ "preserve", "release" ] }, "outcomes": { "type": "array", "items": { "type": "object", "properties": { "eventKey": { "type": "string" }, "state": { "type": "string", "enum": [ "pending", "cancelled", "failed" ] }, "code": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "eventKey", "state", "code" ], "additionalProperties": {} } }, "lastError": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "cancelActionId", "state", "rightDisposition", "outcomes", "lastError" ], "additionalProperties": {} }, { "type": "null" } ] } }, "required": [ "actionId", "operationId", "bookingRef", "planActivationId", "state", "outcomes", "lastError", "cancellation" ], "additionalProperties": {} } }, "required": [ "booking" ], "additionalProperties": {} }, "SeasonOccurrenceInventoryActionEnvelope": { "type": "object", "properties": { "occurrenceInventoryAction": { "type": "object", "properties": { "actionId": { "type": "string" }, "returnActionId": { "type": "string" }, "eventKey": { "type": "string" }, "planActivationId": { "type": "string" }, "state": { "type": "string", "enum": [ "returned", "reclaimed" ] }, "labels": { "minItems": 1, "maxItems": 100, "type": "array", "items": { "type": "string" } } }, "required": [ "actionId", "returnActionId", "eventKey", "planActivationId", "state", "labels" ], "additionalProperties": {} } }, "required": [ "occurrenceInventoryAction" ], "additionalProperties": {} }, "SeasonHolderImportEnvelope": { "type": "object", "properties": { "import": { "type": "object", "properties": { "importId": { "type": "string" }, "dryRun": { "type": "boolean" }, "state": { "type": "string", "enum": [ "dry_run", "committed", "rejected" ] }, "successorPlanActivationId": { "type": "string" }, "acceptedCount": { "type": "number" }, "rejectedCount": { "type": "number" }, "rows": { "type": "array", "items": { "type": "object", "properties": { "rowId": { "type": "string" }, "decision": { "type": "string", "enum": [ "accepted", "invalid", "conflict" ] }, "errorCode": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "holderRef": { "type": "string" }, "priorPlanActivationId": { "type": "string" }, "priorContractRef": { "type": "string" }, "labels": { "type": "array", "items": { "type": "string" } }, "existingBookingRef": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "contractId": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "rightId": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "rowId", "decision", "errorCode", "holderRef", "priorPlanActivationId", "priorContractRef", "labels", "existingBookingRef", "contractId", "rightId" ], "additionalProperties": {} } }, "createdAt": { "type": "number" }, "committedAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "required": [ "importId", "dryRun", "state", "successorPlanActivationId", "acceptedCount", "rejectedCount", "rows", "createdAt", "committedAt" ], "additionalProperties": {} } }, "required": [ "import" ], "additionalProperties": {} }, "SeasonHolderImportFromSeasonEnvelope": { "type": "object", "properties": { "import": { "type": "object", "properties": { "sourceSeasonId": { "type": "string" }, "successorPlanActivationId": { "type": "string" }, "dryRun": { "type": "boolean" }, "holders": { "type": "number" }, "acceptedCount": { "type": "number" }, "alreadyImported": { "type": "number" }, "rejectedCount": { "type": "number" }, "withEmail": { "type": "number" }, "hosted": { "type": "number" }, "integrator": { "type": "number" }, "excluded": { "type": "object", "properties": { "refunded": { "type": "number" }, "rehearsal": { "type": "number" }, "tooManySeats": { "type": "number" }, "unusableRef": { "type": "number" } }, "required": [ "refunded", "rehearsal", "tooManySeats", "unusableRef" ], "additionalProperties": {} }, "importIds": { "type": "array", "items": { "type": "string" } }, "rejected": { "type": "array", "items": { "type": "object", "properties": { "holderRef": { "type": "string" }, "labels": { "type": "array", "items": { "type": "string" } }, "errorCode": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "holderRef", "labels", "errorCode" ], "additionalProperties": {} } }, "preview": { "type": "array", "items": { "type": "object", "properties": { "holderRef": { "type": "string" }, "holderName": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "hasEmail": { "type": "boolean" }, "labels": { "type": "array", "items": { "type": "string" } } }, "required": [ "holderRef", "holderName", "hasEmail", "labels" ], "additionalProperties": {} } } }, "required": [ "sourceSeasonId", "successorPlanActivationId", "dryRun", "holders", "acceptedCount", "alreadyImported", "rejectedCount", "withEmail", "hosted", "integrator", "excluded", "importIds", "rejected", "preview" ], "additionalProperties": {} } }, "required": [ "import" ], "additionalProperties": {} }, "SeasonRenewalOffer": { "type": "object", "properties": { "offerId": { "type": "string" }, "contractId": { "type": "string" }, "rightId": { "type": "string" }, "holderRef": { "type": "string" }, "successorPlanActivationId": { "type": "string" }, "labels": { "type": "array", "items": { "type": "string" } }, "state": { "type": "string", "enum": [ "offered", "intent_received", "committing", "renewed", "declined", "lapsed", "released", "partial_terminal" ] }, "deadlineAt": { "type": "number" }, "intentId": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "intentAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "commitActionId": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "orderRef": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "bookingRef": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "successorContractId": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "createdAt": { "type": "number" }, "updatedAt": { "type": "number" }, "commitOutcomes": { "type": "array", "items": { "type": "object", "properties": { "eventKey": { "type": "string" }, "state": { "type": "string", "enum": [ "pending", "committed", "failed" ] }, "code": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "eventKey", "state", "code" ], "additionalProperties": {} } } }, "required": [ "offerId", "contractId", "rightId", "holderRef", "successorPlanActivationId", "labels", "state", "deadlineAt", "intentId", "intentAt", "commitActionId", "orderRef", "bookingRef", "successorContractId", "createdAt", "updatedAt", "commitOutcomes" ], "additionalProperties": {} }, "SeasonRenewalOfferEnvelope": { "type": "object", "properties": { "offer": { "type": "object", "properties": { "offerId": { "type": "string" }, "contractId": { "type": "string" }, "rightId": { "type": "string" }, "holderRef": { "type": "string" }, "successorPlanActivationId": { "type": "string" }, "labels": { "type": "array", "items": { "type": "string" } }, "state": { "type": "string", "enum": [ "offered", "intent_received", "committing", "renewed", "declined", "lapsed", "released", "partial_terminal" ] }, "deadlineAt": { "type": "number" }, "intentId": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "intentAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "commitActionId": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "orderRef": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "bookingRef": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "successorContractId": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "createdAt": { "type": "number" }, "updatedAt": { "type": "number" }, "commitOutcomes": { "type": "array", "items": { "type": "object", "properties": { "eventKey": { "type": "string" }, "state": { "type": "string", "enum": [ "pending", "committed", "failed" ] }, "code": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "eventKey", "state", "code" ], "additionalProperties": {} } } }, "required": [ "offerId", "contractId", "rightId", "holderRef", "successorPlanActivationId", "labels", "state", "deadlineAt", "intentId", "intentAt", "commitActionId", "orderRef", "bookingRef", "successorContractId", "createdAt", "updatedAt", "commitOutcomes" ], "additionalProperties": {} } }, "required": [ "offer" ], "additionalProperties": {} }, "SeasonRenewalOfferList": { "type": "object", "properties": { "offers": { "type": "array", "items": { "type": "object", "properties": { "offerId": { "type": "string" }, "contractId": { "type": "string" }, "rightId": { "type": "string" }, "holderRef": { "type": "string" }, "successorPlanActivationId": { "type": "string" }, "labels": { "type": "array", "items": { "type": "string" } }, "state": { "type": "string", "enum": [ "offered", "intent_received", "committing", "renewed", "declined", "lapsed", "released", "partial_terminal" ] }, "deadlineAt": { "type": "number" }, "intentId": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "intentAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "commitActionId": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "orderRef": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "bookingRef": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "successorContractId": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "createdAt": { "type": "number" }, "updatedAt": { "type": "number" }, "commitOutcomes": { "type": "array", "items": { "type": "object", "properties": { "eventKey": { "type": "string" }, "state": { "type": "string", "enum": [ "pending", "committed", "failed" ] }, "code": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "eventKey", "state", "code" ], "additionalProperties": {} } } }, "required": [ "offerId", "contractId", "rightId", "holderRef", "successorPlanActivationId", "labels", "state", "deadlineAt", "intentId", "intentAt", "commitActionId", "orderRef", "bookingRef", "successorContractId", "createdAt", "updatedAt", "commitOutcomes" ], "additionalProperties": {} } }, "truncated": { "type": "boolean" } }, "required": [ "offers", "truncated" ], "additionalProperties": {} }, "AccessLinkReveal": { "type": "object", "properties": { "link": { "$ref": "#/components/schemas/AccessLink" }, "url": { "type": "string" }, "capability": { "type": "string" }, "revealedOnce": { "type": "boolean", "const": true }, "previous": { "$ref": "#/components/schemas/AccessLink" }, "endedSessions": { "type": "number" } }, "required": [ "link", "url", "capability", "revealedOnce" ], "additionalProperties": {} }, "AccessLinkList": { "type": "object", "properties": { "links": { "type": "array", "items": { "allOf": [ { "$ref": "#/components/schemas/AccessLink" }, { "type": "object", "properties": { "activeSessions": { "type": "number" } }, "required": [ "activeSessions" ], "additionalProperties": {} } ] } } }, "required": [ "links" ], "additionalProperties": {} }, "AccessLinkRevokeResult": { "type": "object", "properties": { "ok": { "type": "boolean", "const": true }, "link": { "$ref": "#/components/schemas/AccessLink" }, "endedSessions": { "type": "number" } }, "required": [ "ok", "link", "endedSessions" ], "additionalProperties": {} }, "ManageSessionReveal": { "type": "object", "properties": { "id": { "type": "string" }, "token": { "type": "string" }, "expiresAt": { "type": "number" }, "eventKey": { "type": "string" }, "allowedOrigin": { "type": "string" }, "capabilities": { "type": "array", "items": { "type": "string" } } }, "required": [ "id", "token", "expiresAt", "eventKey", "allowedOrigin", "capabilities" ], "additionalProperties": {} }, "DesignerSessionEnvelope": { "type": "object", "properties": { "session": { "type": "object", "properties": { "id": { "type": "string" }, "token": { "type": "string" }, "workspaceId": { "type": "string" }, "chartId": { "type": "string" }, "allowedOrigin": { "type": "string" }, "authority": { "type": "string", "enum": [ "read-only", "edit", "publish" ] }, "canEdit": { "type": "boolean" }, "canPublish": { "type": "boolean" }, "mode": { "type": "string", "enum": [ "normal", "safe" ] }, "safeModeOptions": { "type": "object", "properties": { "allowDeletingObjects": { "type": "boolean" }, "allowEditingAreaCapacity": { "type": "boolean" } }, "required": [ "allowDeletingObjects", "allowEditingAreaCapacity" ], "additionalProperties": false }, "featurePolicy": { "type": "object", "properties": { "version": { "type": "number", "const": 1 }, "allowedFeatures": { "type": "array", "items": { "type": "string" } }, "readOnlyFeatures": { "type": "array", "items": { "type": "string" } }, "digest": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "publishedObjectIds": { "type": "array", "items": { "type": "string" } } }, "required": [ "version", "allowedFeatures", "readOnlyFeatures", "digest", "publishedObjectIds" ], "additionalProperties": {} }, "expiresAt": { "type": "number" }, "designerUrl": { "type": "string" } }, "required": [ "id", "token", "workspaceId", "chartId", "allowedOrigin", "authority", "canEdit", "canPublish", "mode", "safeModeOptions", "featurePolicy", "expiresAt", "designerUrl" ], "additionalProperties": {} } }, "required": [ "session" ], "additionalProperties": {} }, "WebhookList": { "type": "object", "properties": { "subs": { "type": "array", "items": { "$ref": "#/components/schemas/WebhookSub" } } }, "required": [ "subs" ], "additionalProperties": {} }, "WebhookCreateEnvelope": { "type": "object", "properties": { "sub": { "$ref": "#/components/schemas/WebhookSub" }, "secret": { "type": "string" } }, "required": [ "sub", "secret" ], "additionalProperties": {} }, "WebhookRotateSecretEnvelope": { "type": "object", "properties": { "sub": { "$ref": "#/components/schemas/WebhookSub" }, "secret": { "type": "string" } }, "required": [ "sub", "secret" ], "additionalProperties": {} }, "WebhookEnvelope": { "type": "object", "properties": { "sub": { "$ref": "#/components/schemas/WebhookSub" } }, "required": [ "sub" ], "additionalProperties": {} }, "WebhookDeliveryPage": { "type": "object", "properties": { "deliveries": { "type": "array", "items": { "$ref": "#/components/schemas/WebhookDelivery" } }, "nextBefore": { "type": "number" } }, "required": [ "deliveries" ], "additionalProperties": {} }, "WorkspaceList": { "type": "object", "properties": { "workspaces": { "type": "array", "items": { "$ref": "#/components/schemas/Workspace" } } }, "required": [ "workspaces" ], "additionalProperties": {} }, "WorkspaceEnvelope": { "type": "object", "properties": { "workspace": { "$ref": "#/components/schemas/Workspace" } }, "required": [ "workspace" ], "additionalProperties": {} }, "ChartCreateRequest": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1 }, "doc": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": {} }, "externalRef": { "type": "string", "maxLength": 128 }, "workspaceId": { "type": "string" } }, "required": [ "name" ], "additionalProperties": false }, "ChartUpdateRequest": { "anyOf": [ { "type": "object", "properties": { "doc": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": {} }, "expectedUpdatedAt": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string" }, "issues": { "type": "number" }, "externalRef": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "doc", "expectedUpdatedAt" ], "additionalProperties": false }, { "type": "object", "properties": { "name": { "type": "string" }, "issues": { "type": "number" }, "externalRef": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false } ] }, "ChartCopyRequest": { "type": "object", "properties": { "name": { "type": "string" }, "externalRef": { "anyOf": [ { "type": "string", "maxLength": 128 }, { "type": "null" } ] }, "workspaceId": { "type": "string" } }, "additionalProperties": false }, "PanoramaManifestCreateRequest": { "type": "object", "properties": { "text": { "type": "string", "minLength": 1, "maxLength": 2097152 }, "format": { "type": "string", "enum": [ "csv", "json" ] }, "expectedUpdatedAt": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "text", "format", "expectedUpdatedAt" ], "additionalProperties": false }, "TemplateInstantiateRequest": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 160 }, "workspaceId": { "type": "string", "minLength": 1 }, "editedDoc": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": {} }, "version": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" } }, "additionalProperties": false }, "EventCreateRequest": { "type": "object", "properties": { "chartId": { "type": "string", "minLength": 1 }, "name": { "type": "string" }, "slug": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]{2,63}$" }, "startsAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "venue": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "externalRef": { "anyOf": [ { "type": "string", "maxLength": 128 }, { "type": "null" } ] }, "currency": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "endsAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "timezone": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "locale": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "posterAssetId": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "mode": { "type": "string", "enum": [ "live", "test" ] }, "region": { "type": "string", "enum": [ "western-europe", "eastern-europe", "north-america-east", "north-america-west", "south-america", "asia-pacific", "northeast-asia", "southeast-asia", "oceania", "africa", "middle-east" ] }, "bookingMode": { "description": "Dashboard sessions only. Ignored for secret-key callers: a server-created event is Platform inventory and is always paid.", "type": "string", "enum": [ "paid", "free" ] }, "buyerCheckout": { "description": "Dashboard sessions only. Ignored for secret-key callers, whose events always use integrator checkout.", "type": "string", "const": "seatlayer" }, "async": { "description": "Dashboard sessions only. Answer once the event row is durable and copy the chart pin and inventory behind the response; `meta.provisioning` is true until they land (typically ~2 s) and pin-reading routes answer `503 event_provisioning` with `Retry-After: 2`. Ignored for secret-key callers: a server-created event is provisioned in the request.", "type": "boolean", "const": true } }, "required": [ "chartId" ], "additionalProperties": false }, "EventCopyRequest": { "type": "object", "properties": { "name": { "type": "string" }, "slug": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]{2,63}$" }, "startsAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "copyBlocks": { "description": "Carry the organizer’s manually blocked seats. Default true.", "type": "boolean" }, "copyChannels": { "description": "Carry channels and their seat allocation — never their access links. Default false.", "type": "boolean" } }, "additionalProperties": false }, "EventUpdateRequest": { "anyOf": [ { "type": "object", "properties": { "name": { "type": "string" }, "startsAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "venue": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "externalRef": { "anyOf": [ { "type": "string", "maxLength": 128 }, { "type": "null" } ] }, "currency": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "endsAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "doorsAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "timezone": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "locale": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "sectionStates": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "string", "enum": [ "open", "closed", "hidden" ] } }, "maxTicketsPerOrder": { "anyOf": [ { "type": "integer", "minimum": 1, "maximum": 100 }, { "type": "null" } ] }, "maxTicketsPerBuyer": { "anyOf": [ { "type": "integer", "minimum": 1, "maximum": 1000 }, { "type": "null" } ] } }, "required": [ "name" ], "additionalProperties": false }, { "type": "object", "properties": { "name": { "type": "string" }, "startsAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "venue": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "externalRef": { "anyOf": [ { "type": "string", "maxLength": 128 }, { "type": "null" } ] }, "currency": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "endsAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "doorsAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "timezone": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "locale": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "sectionStates": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "string", "enum": [ "open", "closed", "hidden" ] } }, "maxTicketsPerOrder": { "anyOf": [ { "type": "integer", "minimum": 1, "maximum": 100 }, { "type": "null" } ] }, "maxTicketsPerBuyer": { "anyOf": [ { "type": "integer", "minimum": 1, "maximum": 1000 }, { "type": "null" } ] } }, "required": [ "startsAt" ], "additionalProperties": false }, { "type": "object", "properties": { "name": { "type": "string" }, "startsAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "venue": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "externalRef": { "anyOf": [ { "type": "string", "maxLength": 128 }, { "type": "null" } ] }, "currency": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "endsAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "doorsAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "timezone": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "locale": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "sectionStates": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "string", "enum": [ "open", "closed", "hidden" ] } }, "maxTicketsPerOrder": { "anyOf": [ { "type": "integer", "minimum": 1, "maximum": 100 }, { "type": "null" } ] }, "maxTicketsPerBuyer": { "anyOf": [ { "type": "integer", "minimum": 1, "maximum": 1000 }, { "type": "null" } ] } }, "required": [ "venue" ], "additionalProperties": false }, { "type": "object", "properties": { "name": { "type": "string" }, "startsAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "venue": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "externalRef": { "anyOf": [ { "type": "string", "maxLength": 128 }, { "type": "null" } ] }, "currency": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "endsAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "doorsAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "timezone": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "locale": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "sectionStates": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "string", "enum": [ "open", "closed", "hidden" ] } }, "maxTicketsPerOrder": { "anyOf": [ { "type": "integer", "minimum": 1, "maximum": 100 }, { "type": "null" } ] }, "maxTicketsPerBuyer": { "anyOf": [ { "type": "integer", "minimum": 1, "maximum": 1000 }, { "type": "null" } ] } }, "required": [ "externalRef" ], "additionalProperties": false }, { "type": "object", "properties": { "name": { "type": "string" }, "startsAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "venue": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "externalRef": { "anyOf": [ { "type": "string", "maxLength": 128 }, { "type": "null" } ] }, "currency": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "endsAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "doorsAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "timezone": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "locale": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "sectionStates": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "string", "enum": [ "open", "closed", "hidden" ] } }, "maxTicketsPerOrder": { "anyOf": [ { "type": "integer", "minimum": 1, "maximum": 100 }, { "type": "null" } ] }, "maxTicketsPerBuyer": { "anyOf": [ { "type": "integer", "minimum": 1, "maximum": 1000 }, { "type": "null" } ] } }, "required": [ "currency" ], "additionalProperties": false }, { "type": "object", "properties": { "name": { "type": "string" }, "startsAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "venue": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "externalRef": { "anyOf": [ { "type": "string", "maxLength": 128 }, { "type": "null" } ] }, "currency": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "endsAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "doorsAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "timezone": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "locale": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "sectionStates": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "string", "enum": [ "open", "closed", "hidden" ] } }, "maxTicketsPerOrder": { "anyOf": [ { "type": "integer", "minimum": 1, "maximum": 100 }, { "type": "null" } ] }, "maxTicketsPerBuyer": { "anyOf": [ { "type": "integer", "minimum": 1, "maximum": 1000 }, { "type": "null" } ] } }, "required": [ "description" ], "additionalProperties": false }, { "type": "object", "properties": { "name": { "type": "string" }, "startsAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "venue": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "externalRef": { "anyOf": [ { "type": "string", "maxLength": 128 }, { "type": "null" } ] }, "currency": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "endsAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "doorsAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "timezone": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "locale": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "sectionStates": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "string", "enum": [ "open", "closed", "hidden" ] } }, "maxTicketsPerOrder": { "anyOf": [ { "type": "integer", "minimum": 1, "maximum": 100 }, { "type": "null" } ] }, "maxTicketsPerBuyer": { "anyOf": [ { "type": "integer", "minimum": 1, "maximum": 1000 }, { "type": "null" } ] } }, "required": [ "endsAt" ], "additionalProperties": false }, { "type": "object", "properties": { "name": { "type": "string" }, "startsAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "venue": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "externalRef": { "anyOf": [ { "type": "string", "maxLength": 128 }, { "type": "null" } ] }, "currency": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "endsAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "doorsAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "timezone": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "locale": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "sectionStates": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "string", "enum": [ "open", "closed", "hidden" ] } }, "maxTicketsPerOrder": { "anyOf": [ { "type": "integer", "minimum": 1, "maximum": 100 }, { "type": "null" } ] }, "maxTicketsPerBuyer": { "anyOf": [ { "type": "integer", "minimum": 1, "maximum": 1000 }, { "type": "null" } ] } }, "required": [ "doorsAt" ], "additionalProperties": false }, { "type": "object", "properties": { "name": { "type": "string" }, "startsAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "venue": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "externalRef": { "anyOf": [ { "type": "string", "maxLength": 128 }, { "type": "null" } ] }, "currency": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "endsAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "doorsAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "timezone": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "locale": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "sectionStates": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "string", "enum": [ "open", "closed", "hidden" ] } }, "maxTicketsPerOrder": { "anyOf": [ { "type": "integer", "minimum": 1, "maximum": 100 }, { "type": "null" } ] }, "maxTicketsPerBuyer": { "anyOf": [ { "type": "integer", "minimum": 1, "maximum": 1000 }, { "type": "null" } ] } }, "required": [ "timezone" ], "additionalProperties": false }, { "type": "object", "properties": { "name": { "type": "string" }, "startsAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "venue": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "externalRef": { "anyOf": [ { "type": "string", "maxLength": 128 }, { "type": "null" } ] }, "currency": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "endsAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "doorsAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "timezone": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "locale": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "sectionStates": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "string", "enum": [ "open", "closed", "hidden" ] } }, "maxTicketsPerOrder": { "anyOf": [ { "type": "integer", "minimum": 1, "maximum": 100 }, { "type": "null" } ] }, "maxTicketsPerBuyer": { "anyOf": [ { "type": "integer", "minimum": 1, "maximum": 1000 }, { "type": "null" } ] } }, "required": [ "locale" ], "additionalProperties": false }, { "type": "object", "properties": { "name": { "type": "string" }, "startsAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "venue": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "externalRef": { "anyOf": [ { "type": "string", "maxLength": 128 }, { "type": "null" } ] }, "currency": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "endsAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "doorsAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "timezone": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "locale": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "sectionStates": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "string", "enum": [ "open", "closed", "hidden" ] } }, "maxTicketsPerOrder": { "anyOf": [ { "type": "integer", "minimum": 1, "maximum": 100 }, { "type": "null" } ] }, "maxTicketsPerBuyer": { "anyOf": [ { "type": "integer", "minimum": 1, "maximum": 1000 }, { "type": "null" } ] } }, "required": [ "sectionStates" ], "additionalProperties": false }, { "type": "object", "properties": { "name": { "type": "string" }, "startsAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "venue": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "externalRef": { "anyOf": [ { "type": "string", "maxLength": 128 }, { "type": "null" } ] }, "currency": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "endsAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "doorsAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "timezone": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "locale": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "sectionStates": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "string", "enum": [ "open", "closed", "hidden" ] } }, "maxTicketsPerOrder": { "anyOf": [ { "type": "integer", "minimum": 1, "maximum": 100 }, { "type": "null" } ] }, "maxTicketsPerBuyer": { "anyOf": [ { "type": "integer", "minimum": 1, "maximum": 1000 }, { "type": "null" } ] } }, "required": [ "maxTicketsPerOrder" ], "additionalProperties": false }, { "type": "object", "properties": { "name": { "type": "string" }, "startsAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "venue": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "externalRef": { "anyOf": [ { "type": "string", "maxLength": 128 }, { "type": "null" } ] }, "currency": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "endsAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "doorsAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "timezone": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "locale": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "sectionStates": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "string", "enum": [ "open", "closed", "hidden" ] } }, "maxTicketsPerOrder": { "anyOf": [ { "type": "integer", "minimum": 1, "maximum": 100 }, { "type": "null" } ] }, "maxTicketsPerBuyer": { "anyOf": [ { "type": "integer", "minimum": 1, "maximum": 1000 }, { "type": "null" } ] } }, "required": [ "maxTicketsPerBuyer" ], "additionalProperties": false } ] }, "EventConfigurationBindingUpdateRequest": { "type": "object", "properties": { "expectedRevision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "configuration": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 100 }, "version": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "id", "version" ], "additionalProperties": false }, { "type": "null" } ] } }, "required": [ "expectedRevision", "configuration" ], "additionalProperties": false }, "EventChartUpdateRequest": { "type": "object", "properties": { "acknowledgeDroppedAssignments": { "type": "boolean" }, "reason": { "type": "string" } }, "additionalProperties": false }, "TicketReleaseReplaceRequest": { "type": "object", "properties": { "releases": { "maxItems": 12, "type": "array", "items": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "string", "pattern": "^rel_[0-9a-f]{12}$" }, { "type": "null" } ] }, "name": { "type": "string", "minLength": 1, "maxLength": 60 }, "categoryKey": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160 }, { "type": "null" } ] }, "price": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "previousPrice": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 1000000 }, { "type": "null" } ] }, "quota": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "startsAt": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 4102444800000 }, { "type": "null" } ] }, "endsAt": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 4102444800000 }, { "type": "null" } ] }, "action": { "type": "string", "enum": [ "buy", "apply", "invoice" ] }, "actionUrl": { "anyOf": [ { "type": "string", "maxLength": 500, "pattern": "^https:\\/\\/" }, { "type": "null" } ] } }, "required": [ "name", "price" ], "additionalProperties": false } } }, "required": [ "releases" ], "additionalProperties": false }, "HoldSelection": { "type": "object", "properties": { "label": { "type": "string", "minLength": 1 }, "tierId": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "quantity": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "label" ], "additionalProperties": false }, "HoldRequest": { "anyOf": [ { "type": "object", "properties": { "ttlMs": { "type": "number", "exclusiveMinimum": 0, "maximum": 3600000 }, "replaceHoldId": { "type": "string" }, "channelIds": { "type": "array", "items": { "type": "string" } }, "ignoreChannelRestrictions": { "type": "boolean" }, "reason": { "type": "string" }, "labels": { "minItems": 1, "type": "array", "items": { "type": "string", "minLength": 1 } }, "selections": { "minItems": 1, "type": "array", "items": { "type": "object", "properties": { "label": { "type": "string", "minLength": 1 }, "tierId": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "quantity": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "label" ], "additionalProperties": false } } }, "required": [ "labels" ], "additionalProperties": false }, { "type": "object", "properties": { "ttlMs": { "type": "number", "exclusiveMinimum": 0, "maximum": 3600000 }, "replaceHoldId": { "type": "string" }, "channelIds": { "type": "array", "items": { "type": "string" } }, "ignoreChannelRestrictions": { "type": "boolean" }, "reason": { "type": "string" }, "labels": { "minItems": 1, "type": "array", "items": { "type": "string", "minLength": 1 } }, "selections": { "minItems": 1, "type": "array", "items": { "type": "object", "properties": { "label": { "type": "string", "minLength": 1 }, "tierId": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "quantity": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "label" ], "additionalProperties": false } } }, "required": [ "selections" ], "additionalProperties": false } ] }, "ExtendHoldRequest": { "type": "object", "properties": { "holdId": { "type": "string", "minLength": 1 }, "ttlMs": { "type": "number", "exclusiveMinimum": 0, "maximum": 3600000 }, "channelIds": { "type": "array", "items": { "type": "string" } }, "ignoreChannelRestrictions": { "type": "boolean" }, "reason": { "type": "string" } }, "required": [ "holdId" ], "additionalProperties": false }, "BestAvailableRequest": { "type": "object", "properties": { "qty": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "categoryKey": { "type": "string" }, "zoneId": { "type": "string", "maxLength": 160 }, "preferAisle": { "type": "boolean" }, "ttlMs": { "type": "number", "exclusiveMinimum": 0, "maximum": 3600000 }, "channelIds": { "type": "array", "items": { "type": "string" } }, "ignoreChannelRestrictions": { "type": "boolean" }, "reason": { "type": "string" } }, "required": [ "qty" ], "additionalProperties": false }, "BestAvailableBlockRequest": { "type": "object", "properties": { "qty": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "categoryKey": { "type": "string" }, "zoneId": { "type": "string", "maxLength": 160 }, "preferAisle": { "type": "boolean" }, "releaseAt": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "blockRef": { "type": "string", "minLength": 1, "maxLength": 160 }, "channelIds": { "type": "array", "items": { "type": "string" } }, "ignoreChannelRestrictions": { "type": "boolean" }, "reason": { "type": "string" } }, "required": [ "qty", "releaseAt", "blockRef" ], "additionalProperties": false }, "BestAvailableBookRequest": { "type": "object", "properties": { "qty": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "bookingRef": { "type": "string", "minLength": 1 }, "categoryKey": { "type": "string" }, "zoneId": { "type": "string", "maxLength": 160 }, "preferAisle": { "type": "boolean" }, "channelIds": { "type": "array", "items": { "type": "string" } }, "ignoreChannelRestrictions": { "type": "boolean" }, "reason": { "type": "string" } }, "required": [ "qty", "bookingRef" ], "additionalProperties": false }, "ReleaseRequest": { "type": "object", "properties": { "labels": { "minItems": 1, "type": "array", "items": { "type": "string", "minLength": 1 } }, "holdId": { "type": "string", "minLength": 1 } }, "required": [ "labels", "holdId" ], "additionalProperties": false }, "BookRequest": { "anyOf": [ { "type": "object", "properties": { "bookingRef": { "type": "string", "minLength": 1 }, "channelIds": { "type": "array", "items": { "type": "string" } }, "ignoreChannelRestrictions": { "type": "boolean" }, "reason": { "type": "string" }, "holdId": { "type": "string", "minLength": 1 }, "labels": { "minItems": 1, "type": "array", "items": { "type": "string", "minLength": 1 } } }, "required": [ "bookingRef", "holdId" ], "additionalProperties": false }, { "type": "object", "properties": { "bookingRef": { "type": "string", "minLength": 1 }, "channelIds": { "type": "array", "items": { "type": "string" } }, "ignoreChannelRestrictions": { "type": "boolean" }, "reason": { "type": "string" }, "blockRef": { "type": "string", "minLength": 1, "maxLength": 160 }, "labels": { "minItems": 1, "type": "array", "items": { "type": "string", "minLength": 1 } } }, "required": [ "bookingRef", "blockRef", "labels" ], "additionalProperties": false }, { "type": "object", "properties": { "bookingRef": { "type": "string", "minLength": 1 }, "channelIds": { "type": "array", "items": { "type": "string" } }, "ignoreChannelRestrictions": { "type": "boolean" }, "reason": { "type": "string" }, "holdId": { "type": "string" }, "labels": { "minItems": 1, "type": "array", "items": { "type": "string", "minLength": 1 } } }, "required": [ "bookingRef", "labels" ], "additionalProperties": false } ] }, "BoxOfficeBookRequest": { "type": "object", "properties": { "labels": { "minItems": 1, "type": "array", "items": { "type": "string", "minLength": 1 } }, "bookingRef": { "type": "string", "minLength": 1 } }, "required": [ "labels", "bookingRef" ], "additionalProperties": false }, "UnbookRequest": { "type": "object", "properties": { "labels": { "minItems": 1, "type": "array", "items": { "type": "string", "minLength": 1 } }, "bookingRef": { "type": "string", "minLength": 1 } }, "required": [ "labels", "bookingRef" ], "additionalProperties": false }, "BlockRequest": { "type": "object", "properties": { "labels": { "minItems": 1, "type": "array", "items": { "type": "string", "minLength": 1 } }, "releaseAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "reason": { "type": "string", "maxLength": 280 } }, "required": [ "labels" ], "additionalProperties": false }, "LabelsRequest": { "type": "object", "properties": { "labels": { "minItems": 1, "type": "array", "items": { "type": "string", "minLength": 1 } } }, "required": [ "labels" ], "additionalProperties": false }, "AvailabilityUpdateRequest": { "type": "object", "properties": { "rules": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "$ref": "#/components/schemas/AvailabilityRule" } } }, "required": [ "rules" ], "additionalProperties": false }, "HoldTtlRequest": { "type": "object", "properties": { "holdTtlMs": { "anyOf": [ { "type": "number", "exclusiveMinimum": 0 }, { "type": "null" } ] } }, "required": [ "holdTtlMs" ], "additionalProperties": false }, "ChannelCreateRequest": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1 }, "color": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "marker": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "externalRef": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "accessIntent": { "type": "string", "enum": [ "none", "internal", "server", "hosted_link" ] }, "reason": { "type": "string" } }, "required": [ "name" ], "additionalProperties": false }, "ChannelUpdateRequest": { "anyOf": [ { "type": "object", "properties": { "name": { "type": "string" }, "accessIntent": { "type": "string", "enum": [ "none", "internal", "server", "hosted_link" ] }, "priceOverrides": { "maxItems": 500, "type": "array", "items": { "$ref": "#/components/schemas/ChannelPriceOverride" } }, "expectedPricingVersion": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "acknowledgeLiveAccess": { "type": "boolean" }, "reason": { "type": "string" } }, "required": [ "name" ], "additionalProperties": false }, { "type": "object", "properties": { "name": { "type": "string" }, "accessIntent": { "type": "string", "enum": [ "none", "internal", "server", "hosted_link" ] }, "priceOverrides": { "maxItems": 500, "type": "array", "items": { "$ref": "#/components/schemas/ChannelPriceOverride" } }, "expectedPricingVersion": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "acknowledgeLiveAccess": { "type": "boolean" }, "reason": { "type": "string" } }, "required": [ "accessIntent" ], "additionalProperties": false }, { "type": "object", "properties": { "name": { "type": "string" }, "accessIntent": { "type": "string", "enum": [ "none", "internal", "server", "hosted_link" ] }, "priceOverrides": { "maxItems": 500, "type": "array", "items": { "$ref": "#/components/schemas/ChannelPriceOverride" } }, "expectedPricingVersion": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "acknowledgeLiveAccess": { "type": "boolean" }, "reason": { "type": "string" } }, "required": [ "priceOverrides", "expectedPricingVersion" ], "additionalProperties": false } ] }, "ChannelAssignmentRequest": { "type": "object", "properties": { "labels": { "minItems": 1, "maxItems": 5000, "type": "array", "items": { "type": "string", "minLength": 1 } }, "assignmentVersion": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "targetChannelId": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "reason": { "type": "string" } }, "required": [ "labels", "assignmentVersion" ], "additionalProperties": false }, "ChannelReasonRequest": { "type": "object", "properties": { "reason": { "type": "string" } }, "additionalProperties": false }, "ChannelArchiveRequest": { "type": "object", "properties": { "destination": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "reason": { "type": "string" } }, "required": [ "destination" ], "additionalProperties": false }, "BuyerAccessSessionRequest": { "type": "object", "properties": { "allowedOrigin": { "type": "string", "pattern": "^(?:https:\\/\\/[^/?#@\\s]+|http:\\/\\/(?:localhost|127\\.0\\.0\\.1)(?::\\d{1,5})?)\\/?$" }, "includePublic": { "type": "boolean" }, "channelIds": { "maxItems": 20, "type": "array", "items": { "type": "string" } }, "expiresInSeconds": { "type": "integer", "minimum": 60, "maximum": 43200 }, "maxQuantity": { "anyOf": [ { "type": "integer", "minimum": 1, "maximum": 100 }, { "type": "null" } ] }, "buyerRef": { "anyOf": [ { "type": "string", "maxLength": 120 }, { "type": "null" } ] }, "partnerRef": { "anyOf": [ { "type": "string", "maxLength": 120 }, { "type": "null" } ] }, "clientRequestId": { "anyOf": [ { "type": "string", "maxLength": 120 }, { "type": "null" } ] } }, "required": [ "allowedOrigin", "includePublic" ], "additionalProperties": false }, "PerformanceGroupCreateRequest": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 120 }, "externalRef": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 128 }, { "type": "null" } ] }, "eventKeys": { "minItems": 2, "maxItems": 12, "type": "array", "items": { "type": "string", "minLength": 1 } }, "inclusionMode": { "type": "string", "enum": [ "fixed", "flexible_dates" ] }, "selectionMode": { "type": "string", "enum": [ "same_seat", "per_performance" ] }, "audience": { "type": "string", "enum": [ "private", "unlisted", "public" ] }, "checkoutMode": { "anyOf": [ { "type": "string", "enum": [ "seatlayer", "integrator" ] }, { "type": "null" } ] } }, "required": [ "name", "eventKeys" ], "additionalProperties": false }, "PerformanceGroupUpdateRequest": { "type": "object", "properties": { "expectedRevision": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "name": { "type": "string", "minLength": 1, "maxLength": 120 }, "externalRef": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 128 }, { "type": "null" } ] }, "selectionMode": { "type": "string", "enum": [ "same_seat", "per_performance" ] }, "audience": { "type": "string", "enum": [ "private", "unlisted", "public" ] }, "salesState": { "type": "string", "enum": [ "closed", "open", "paused" ] }, "checkoutMode": { "anyOf": [ { "type": "string", "enum": [ "seatlayer", "integrator" ] }, { "type": "null" } ] } }, "required": [ "expectedRevision" ], "additionalProperties": false }, "PerformanceGroupLifecycleRequest": { "type": "object", "properties": { "expectedRevision": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "expectedRevision" ], "additionalProperties": false }, "PerformanceGroupBuyerAccessSessionRequest": { "type": "object", "properties": { "allowedOrigin": { "type": "string", "pattern": "^(?:https:\\/\\/[^/?#@\\s]+|http:\\/\\/(?:localhost|127\\.0\\.0\\.1)(?::\\d{1,5})?)\\/?$" }, "includePublic": { "type": "boolean" }, "channelIdsByEvent": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "array", "items": { "type": "string", "minLength": 1 } } }, "expiresInSeconds": { "type": "integer", "minimum": 60, "maximum": 43200 }, "maxQuantity": { "anyOf": [ { "type": "integer", "minimum": 1, "maximum": 100 }, { "type": "null" } ] }, "buyerRef": { "anyOf": [ { "type": "string", "maxLength": 120 }, { "type": "null" } ] }, "partnerRef": { "anyOf": [ { "type": "string", "maxLength": 120 }, { "type": "null" } ] } }, "required": [ "allowedOrigin", "includePublic" ], "additionalProperties": false }, "PerformanceGroupBookRequest": { "type": "object", "properties": { "bookActionId": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,160}$" }, "bookingRef": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,160}$" } }, "required": [ "bookActionId", "bookingRef" ], "additionalProperties": false }, "SeasonValidateRequest": { "anyOf": [ { "type": "object", "properties": { "eventKeys": { "minItems": 1, "maxItems": 20, "type": "array", "items": { "type": "string", "minLength": 1 } }, "sourcePerformanceGroupKeys": { "minItems": 1, "maxItems": 20, "type": "array", "items": { "type": "string", "minLength": 1 } }, "mode": { "type": "string", "enum": [ "live", "test" ] } }, "required": [ "eventKeys" ], "additionalProperties": false }, { "type": "object", "properties": { "eventKeys": { "minItems": 1, "maxItems": 20, "type": "array", "items": { "type": "string", "minLength": 1 } }, "sourcePerformanceGroupKeys": { "minItems": 1, "maxItems": 20, "type": "array", "items": { "type": "string", "minLength": 1 } }, "mode": { "type": "string", "enum": [ "live", "test" ] } }, "required": [ "sourcePerformanceGroupKeys" ], "additionalProperties": false } ] }, "SeasonCreateRequest": { "anyOf": [ { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 120 }, "edition": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 120 }, { "type": "null" } ] }, "eventKeys": { "minItems": 1, "maxItems": 20, "type": "array", "items": { "type": "string", "minLength": 1 } }, "sourcePerformanceGroupKeys": { "minItems": 1, "maxItems": 20, "type": "array", "items": { "type": "string", "minLength": 1 } }, "mode": { "type": "string", "enum": [ "live", "test" ] } }, "required": [ "name", "eventKeys" ], "additionalProperties": false }, { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 120 }, "edition": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 120 }, { "type": "null" } ] }, "eventKeys": { "minItems": 1, "maxItems": 20, "type": "array", "items": { "type": "string", "minLength": 1 } }, "sourcePerformanceGroupKeys": { "minItems": 1, "maxItems": 20, "type": "array", "items": { "type": "string", "minLength": 1 } }, "mode": { "type": "string", "enum": [ "live", "test" ] } }, "required": [ "name", "sourcePerformanceGroupKeys" ], "additionalProperties": false } ] }, "SeasonUpdateRequest": { "type": "object", "properties": { "expectedRevision": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "name": { "type": "string", "minLength": 1, "maxLength": 120 }, "edition": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 120 }, { "type": "null" } ] } }, "required": [ "expectedRevision" ], "additionalProperties": false }, "SeasonLifecycleRequest": { "type": "object", "properties": { "expectedRevision": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "expectedRevision" ], "additionalProperties": false }, "SeasonPlanCreateRequest": { "anyOf": [ { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 120 }, "eventKeys": { "minItems": 1, "maxItems": 20, "type": "array", "items": { "type": "string", "minLength": 1 } }, "sourcePerformanceGroupKeys": { "minItems": 1, "maxItems": 20, "type": "array", "items": { "type": "string", "minLength": 1 } } }, "required": [ "name", "eventKeys" ], "additionalProperties": false }, { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 120 }, "eventKeys": { "minItems": 1, "maxItems": 20, "type": "array", "items": { "type": "string", "minLength": 1 } }, "sourcePerformanceGroupKeys": { "minItems": 1, "maxItems": 20, "type": "array", "items": { "type": "string", "minLength": 1 } } }, "required": [ "name", "sourcePerformanceGroupKeys" ], "additionalProperties": false } ] }, "SeasonDuplicateRequest": { "type": "object", "properties": { "eventKeys": { "minItems": 2, "maxItems": 20, "type": "array", "items": { "type": "string", "minLength": 1 } }, "name": { "type": "string", "minLength": 1, "maxLength": 120 } }, "required": [ "eventKeys" ], "additionalProperties": false }, "SeasonBuyerAccessSessionRequest": { "type": "object", "properties": { "allowedOrigin": { "type": "string", "pattern": "^(?:https:\\/\\/[^/?#@\\s]+|http:\\/\\/(?:localhost|127\\.0\\.0\\.1)(?::\\d{1,5})?)\\/?$" }, "includePublic": { "type": "boolean", "const": true }, "planActivationId": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,160}$" }, "purpose": { "type": "string", "enum": [ "sale", "rehearsal" ] }, "expiresInSeconds": { "type": "integer", "minimum": 60, "maximum": 43200 }, "maxQuantity": { "anyOf": [ { "type": "integer", "minimum": 1, "maximum": 100 }, { "type": "null" } ] }, "buyerRef": { "anyOf": [ { "type": "string", "maxLength": 120 }, { "type": "null" } ] } }, "required": [ "allowedOrigin", "includePublic" ], "additionalProperties": false }, "SeasonBookRequest": { "type": "object", "properties": { "bookActionId": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,160}$" }, "bookingRef": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,160}$" } }, "required": [ "bookActionId", "bookingRef" ], "additionalProperties": false }, "SeasonCancelRequest": { "type": "object", "properties": { "cancelActionId": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,160}$" }, "bookingRef": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,160}$" }, "planActivationId": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,160}$" }, "rightDisposition": { "type": "string", "enum": [ "preserve", "release" ] } }, "required": [ "cancelActionId", "bookingRef", "planActivationId", "rightDisposition" ], "additionalProperties": false }, "SeasonOccurrenceReturnRequest": { "type": "object", "properties": { "actionId": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,160}$" }, "bookingRef": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,160}$" }, "planActivationId": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,160}$" }, "labels": { "minItems": 1, "maxItems": 100, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 160 } }, "source": { "anyOf": [ { "type": "object", "properties": { "bookingActionId": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,160}$" } }, "required": [ "bookingActionId" ], "additionalProperties": false }, { "type": "object", "properties": { "renewalOfferId": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,160}$" } }, "required": [ "renewalOfferId" ], "additionalProperties": false } ] } }, "required": [ "actionId", "bookingRef", "planActivationId", "labels", "source" ], "additionalProperties": false }, "SeasonOccurrenceReclaimRequest": { "type": "object", "properties": { "actionId": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,160}$" }, "returnActionId": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,160}$" }, "bookingRef": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,160}$" }, "planActivationId": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,160}$" }, "labels": { "minItems": 1, "maxItems": 100, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 160 } }, "source": { "anyOf": [ { "type": "object", "properties": { "bookingActionId": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,160}$" } }, "required": [ "bookingActionId" ], "additionalProperties": false }, { "type": "object", "properties": { "renewalOfferId": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,160}$" } }, "required": [ "renewalOfferId" ], "additionalProperties": false } ] } }, "required": [ "actionId", "returnActionId", "bookingRef", "planActivationId", "labels", "source" ], "additionalProperties": false }, "SeasonHolderImportRequest": { "type": "object", "properties": { "successorPlanActivationId": { "type": "string", "minLength": 1, "maxLength": 160 }, "dryRun": { "type": "boolean" }, "rows": { "minItems": 1, "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "rowId": { "type": "string", "minLength": 1, "maxLength": 160 }, "holderRef": { "type": "string", "minLength": 1, "maxLength": 160 }, "priorPlanActivationId": { "type": "string", "minLength": 1, "maxLength": 160 }, "priorContractRef": { "type": "string", "minLength": 1, "maxLength": 160 }, "labels": { "minItems": 1, "maxItems": 20, "type": "array", "items": { "type": "string", "minLength": 1 } }, "existingBookingRef": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160 }, { "type": "null" } ] }, "holderEmail": { "anyOf": [ { "type": "string", "maxLength": 320 }, { "type": "null" } ] }, "holderName": { "anyOf": [ { "type": "string", "maxLength": 120 }, { "type": "null" } ] } }, "required": [ "rowId", "holderRef", "priorPlanActivationId", "priorContractRef", "labels" ], "additionalProperties": false } } }, "required": [ "successorPlanActivationId", "rows" ], "additionalProperties": false }, "SeasonHolderImportFromSeasonRequest": { "type": "object", "properties": { "sourceSeasonId": { "type": "string", "minLength": 1, "maxLength": 160 }, "successorPlanActivationId": { "type": "string", "minLength": 1, "maxLength": 160 }, "dryRun": { "type": "boolean" } }, "required": [ "sourceSeasonId", "successorPlanActivationId" ], "additionalProperties": false }, "SeasonRenewalOfferCreateRequest": { "type": "object", "properties": { "successorPlanActivationId": { "type": "string", "minLength": 1, "maxLength": 160 }, "deadlineAt": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "contractIds": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 160 } } }, "required": [ "successorPlanActivationId", "deadlineAt" ], "additionalProperties": false }, "SeasonRenewalOfferExtendRequest": { "type": "object", "properties": { "deadlineAt": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "deadlineAt" ], "additionalProperties": false }, "SeasonRenewalOfferCommitRequest": { "type": "object", "properties": { "commitActionId": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,160}$" }, "orderRef": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,160}$" }, "bookingRef": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,160}$" }, "planActivationId": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,160}$" } }, "required": [ "commitActionId", "orderRef", "bookingRef", "planActivationId" ], "additionalProperties": false }, "SeasonAmendmentRequest": { "type": "object", "properties": { "eventKey": { "type": "string", "minLength": 1, "maxLength": 160 }, "kind": { "type": "string", "enum": [ "reschedule", "replace", "cancel_exception" ] }, "planActivationId": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,160}$" }, "startsAt": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "name": { "type": "string", "minLength": 1, "maxLength": 120 }, "eventKeys": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 160 } } }, "required": [ "eventKey", "kind" ], "additionalProperties": false }, "SeasonAmendmentEnvelope": { "type": "object", "properties": { "amendment": { "type": "object", "properties": { "amendmentId": { "type": "string" }, "eventKey": { "type": "string" }, "revision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "kind": { "type": "string", "enum": [ "reschedule", "replace", "cancel_exception" ] }, "classification": { "type": "string", "enum": [ "identity_preserving", "exception" ] }, "planActivationId": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "occurrenceSetSha256": { "type": "string" }, "before": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": {} }, "after": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": {} }, "state": { "type": "string", "enum": [ "applied", "exception" ] }, "contractOutcomes": { "type": "array", "items": { "type": "object", "properties": { "contractId": { "type": "string" }, "outcome": { "type": "string", "enum": [ "unchanged", "operator_exception" ] } }, "required": [ "contractId", "outcome" ], "additionalProperties": {} } }, "allocationOutcomes": { "type": "array", "items": { "type": "object", "properties": { "allocationId": { "type": "string" }, "eventKey": { "type": "string" }, "outcome": { "type": "string", "enum": [ "unchanged", "operator_exception" ] } }, "required": [ "allocationId", "eventKey", "outcome" ], "additionalProperties": {} } }, "createdAt": { "type": "number" } }, "required": [ "amendmentId", "eventKey", "revision", "kind", "classification", "planActivationId", "occurrenceSetSha256", "before", "after", "state", "contractOutcomes", "allocationOutcomes", "createdAt" ], "additionalProperties": {} } }, "required": [ "amendment" ], "additionalProperties": {} }, "SeasonAmendmentList": { "type": "object", "properties": { "amendments": { "type": "array", "items": { "type": "object", "properties": { "amendmentId": { "type": "string" }, "eventKey": { "type": "string" }, "revision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "kind": { "type": "string", "enum": [ "reschedule", "replace", "cancel_exception" ] }, "classification": { "type": "string", "enum": [ "identity_preserving", "exception" ] }, "planActivationId": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "occurrenceSetSha256": { "type": "string" }, "before": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": {} }, "after": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": {} }, "state": { "type": "string", "enum": [ "applied", "exception" ] }, "contractOutcomes": { "type": "array", "items": { "type": "object", "properties": { "contractId": { "type": "string" }, "outcome": { "type": "string", "enum": [ "unchanged", "operator_exception" ] } }, "required": [ "contractId", "outcome" ], "additionalProperties": {} } }, "allocationOutcomes": { "type": "array", "items": { "type": "object", "properties": { "allocationId": { "type": "string" }, "eventKey": { "type": "string" }, "outcome": { "type": "string", "enum": [ "unchanged", "operator_exception" ] } }, "required": [ "allocationId", "eventKey", "outcome" ], "additionalProperties": {} } }, "createdAt": { "type": "number" } }, "required": [ "amendmentId", "eventKey", "revision", "kind", "classification", "planActivationId", "occurrenceSetSha256", "before", "after", "state", "contractOutcomes", "allocationOutcomes", "createdAt" ], "additionalProperties": {} } }, "truncated": { "type": "boolean" } }, "required": [ "amendments", "truncated" ], "additionalProperties": {} }, "SeasonOccurrenceList": { "type": "object", "properties": { "planActivationId": { "type": "string" }, "occurrences": { "type": "array", "items": { "type": "object", "properties": { "eventKey": { "type": "string" }, "position": { "type": "number" }, "name": { "type": "string" }, "startsAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "venue": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "timezone": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "latestAmendment": { "anyOf": [ { "type": "object", "properties": { "amendmentId": { "type": "string" }, "kind": { "type": "string" }, "classification": { "type": "string" } }, "required": [ "amendmentId", "kind", "classification" ], "additionalProperties": {} }, { "type": "null" } ] } }, "required": [ "eventKey", "position", "name", "startsAt", "venue", "timezone", "latestAmendment" ], "additionalProperties": {} } } }, "required": [ "planActivationId", "occurrences" ], "additionalProperties": {} }, "SeasonReportEnvelope": { "type": "object", "properties": { "report": { "type": "object", "properties": { "seasonKey": { "type": "string" }, "generatedAt": { "type": "number" }, "authorities": { "type": "object", "properties": { "live": { "type": "string", "const": "season_do" }, "catalogue": { "type": "string", "const": "d1" } }, "required": [ "live", "catalogue" ], "additionalProperties": {} }, "inventory": { "type": "object", "properties": { "occurrenceCount": { "type": "number" }, "bookings": { "type": "number" }, "booked": { "type": "number" }, "cancelled": { "type": "number" } }, "required": [ "occurrenceCount", "bookings", "booked", "cancelled" ], "additionalProperties": {} }, "renewals": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "number" } }, "operations": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "number" } }, "allocations": { "type": "object", "properties": { "total": { "type": "number" }, "byState": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "number" } }, "bySource": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "number" } } }, "required": [ "total", "byState", "bySource" ], "additionalProperties": {} }, "stuckOperations": { "type": "number" }, "webhooks": { "type": "object", "properties": { "undelivered": { "type": "number" }, "delivered": { "type": "number" }, "deliveryDefinition": { "type": "string", "const": "at_least_one_receiver_2xx" }, "attempts": { "type": "number" }, "successfulAttempts": { "type": "number" }, "failedAttempts": { "type": "number" }, "lastEventName": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "undelivered", "delivered", "deliveryDefinition", "attempts", "successfulAttempts", "failedAttempts", "lastEventName" ], "additionalProperties": {} } }, "required": [ "seasonKey", "generatedAt", "authorities", "inventory", "renewals", "operations", "allocations", "stuckOperations", "webhooks" ], "additionalProperties": {} } }, "required": [ "report" ], "additionalProperties": {} }, "SeasonOperationList": { "type": "object", "properties": { "operations": { "type": "array", "items": { "type": "object", "properties": { "operationId": { "type": "string" }, "seasonId": { "type": "string" }, "holdId": { "type": "string" }, "state": { "type": "string" } }, "required": [ "operationId", "state" ], "additionalProperties": {} } }, "truncated": { "type": "boolean" } }, "required": [ "operations", "truncated" ], "additionalProperties": {} }, "SeasonSupportLookupEnvelope": { "type": "object", "properties": { "requestId": { "type": "string" }, "lookup": { "type": "object", "properties": { "bookingRef": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "holderRef": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "bookings": { "type": "array", "items": { "type": "object", "properties": { "actionId": { "type": "string" }, "bookingRef": { "type": "string" }, "state": { "type": "string" } }, "required": [ "actionId", "bookingRef", "state" ], "additionalProperties": {} } }, "offers": { "type": "array", "items": { "type": "object", "properties": { "offerId": { "type": "string" }, "holderRef": { "type": "string" }, "state": { "type": "string" } }, "required": [ "offerId", "holderRef", "state" ], "additionalProperties": {} } }, "contracts": { "type": "array", "items": { "type": "object", "properties": { "contractId": { "type": "string" }, "holderRef": { "type": "string" } }, "required": [ "contractId", "holderRef" ], "additionalProperties": {} } } }, "required": [ "bookingRef", "holderRef", "bookings", "offers", "contracts" ], "additionalProperties": {} } }, "required": [ "requestId", "lookup" ], "additionalProperties": {} }, "SeasonOutboxList": { "type": "object", "properties": { "outbox": { "type": "array", "items": { "type": "object", "properties": { "occurrenceId": { "type": "string" }, "eventName": { "type": "string" }, "payloadSha256": { "type": "string" }, "createdAt": { "type": "number" }, "deliveredAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "replayedAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "replayCount": { "type": "number" } }, "required": [ "occurrenceId", "eventName", "payloadSha256", "createdAt", "deliveredAt", "replayedAt", "replayCount" ], "additionalProperties": {} } }, "undelivered": { "type": "number" }, "truncated": { "type": "boolean" } }, "required": [ "outbox", "undelivered", "truncated" ], "additionalProperties": {} }, "SeasonOutboxReplayEnvelope": { "type": "object", "properties": { "occurrence": { "type": "object", "properties": { "occurrenceId": { "type": "string" }, "eventName": { "type": "string" }, "payloadSha256": { "type": "string" }, "replayCount": { "type": "number" }, "deliveredAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "replayedAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "required": [ "occurrenceId", "eventName", "payloadSha256", "replayCount", "deliveredAt", "replayedAt" ], "additionalProperties": {} } }, "required": [ "occurrence" ], "additionalProperties": {} }, "SeasonAuditEnvelope": { "type": "object", "properties": { "requestId": { "type": "string" }, "audit": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "action": { "type": "string" }, "actorKind": { "type": "string" }, "details": {}, "at": { "type": "number" } }, "required": [ "id", "action", "actorKind", "details", "at" ], "additionalProperties": {} } }, "truncated": { "type": "boolean" } }, "required": [ "requestId", "audit", "truncated" ], "additionalProperties": {} }, "SeasonSupportExportEnvelope": { "type": "object", "properties": { "requestId": { "type": "string" }, "export": { "type": "object", "properties": { "version": { "type": "string", "const": "season-support-export.v1" }, "exportedAt": { "type": "number" }, "season": { "type": "object", "properties": { "key": { "type": "string" }, "catalogueRevision": { "type": "number" }, "occurrenceSetSha256": { "type": "string" } }, "required": [ "key", "catalogueRevision", "occurrenceSetSha256" ], "additionalProperties": {} }, "plans": { "type": "array", "items": {} }, "amendments": { "type": "array", "items": {} }, "allocations": { "type": "array", "items": {} }, "report": {}, "audit": { "type": "array", "items": {} }, "truncated": { "type": "object", "properties": { "allocations": { "type": "boolean" }, "audit": { "type": "boolean" } }, "required": [ "allocations", "audit" ], "additionalProperties": {} } }, "required": [ "version", "exportedAt", "season", "plans", "amendments", "allocations", "report", "audit", "truncated" ], "additionalProperties": {} } }, "required": [ "requestId", "export" ], "additionalProperties": {} }, "SeasonHolder": { "type": "object", "properties": { "id": { "type": "string", "description": "Opaque, stable holder id." }, "kind": { "type": "string", "enum": [ "hosted", "integrator", "imported" ] }, "bookingRef": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "orderId": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "orderNumber": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "holderName": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "holderEmail": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "holderRef": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "labels": { "type": "array", "items": { "type": "string" } }, "packageName": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "packageId": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "The package's plan key (`spl_…`), as `plans[].key` in retrieveSeason." }, "dates": { "type": "array", "items": { "type": "object", "properties": { "eventKey": { "type": "string" }, "state": { "type": "string", "enum": [ "active", "cancelled", "problem" ] } }, "required": [ "eventKey", "state" ], "additionalProperties": {} } }, "datesTotal": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "datesActive": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "datesCancelled": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "paid": { "anyOf": [ { "type": "object", "properties": { "amountMinor": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "currency": { "type": "string" }, "refundedMinor": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 } }, "required": [ "amountMinor", "currency", "refundedMinor" ], "additionalProperties": {} }, { "type": "null" } ] }, "soldAtCounter": { "type": "boolean" }, "orderStatus": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "status": { "type": "string", "enum": [ "active", "partly_cancelled", "cancelled", "needs_review", "renewal_open", "renewed", "declined", "lapsed" ] }, "renewal": { "anyOf": [ { "type": "object", "properties": { "offerId": { "type": "string" }, "state": { "type": "string" }, "deadlineAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "required": [ "offerId", "state", "deadlineAt" ], "additionalProperties": {} }, { "type": "null" } ] }, "boughtAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "required": [ "id", "kind", "bookingRef", "orderId", "orderNumber", "holderName", "holderEmail", "holderRef", "labels", "packageName", "packageId", "dates", "datesTotal", "datesActive", "datesCancelled", "paid", "soldAtCounter", "orderStatus", "status", "renewal", "boughtAt" ], "additionalProperties": {} }, "SeasonHolderPage": { "type": "object", "properties": { "holders": { "type": "array", "items": { "$ref": "#/components/schemas/SeasonHolder" } }, "nextCursor": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "totals": { "description": "On the first page only.", "type": "object", "properties": { "holders": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "active": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "cancelled": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "imported": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 } }, "required": [ "holders", "active", "cancelled", "imported" ], "additionalProperties": {} } }, "required": [ "holders", "nextCursor" ], "additionalProperties": {} }, "SeasonOrderRefundRequest": { "type": "object", "properties": { "amountMinor": { "description": "Refund this much, in minor units. Leave it out to refund what is left.", "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "additionalProperties": false }, "SeasonOrderRefundEnvelope": { "type": "object", "properties": { "orderId": { "type": "string" }, "refundId": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "The SeatLayer refund (`rfo_…`). Null when a free order is cancelled instead." }, "amountMinor": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "currency": { "type": "string" }, "state": { "type": "string", "enum": [ "succeeded", "pending", "unknown", "cancelled" ] } }, "required": [ "orderId", "refundId", "amountMinor", "currency", "state" ], "additionalProperties": {} }, "SeasonOrderCancelRequest": { "type": "object", "properties": { "reason": { "type": "string", "enum": [ "lost_dispute", "refunded_elsewhere", "other" ] }, "note": { "type": "string", "maxLength": 500 }, "refundConfirmed": { "type": "boolean" }, "usedTicketsAcknowledged": { "type": "boolean" }, "notifyBuyer": { "type": "boolean" } }, "required": [ "reason" ], "additionalProperties": false }, "SeasonOrderCancelEnvelope": { "type": "object", "properties": { "receipt": { "type": "object", "properties": { "orderId": { "type": "string" }, "displayRef": { "type": "string" }, "status": { "type": "string", "const": "refunded" }, "currency": { "type": "string" }, "settledOutsideMinor": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "released": { "type": "array", "items": { "type": "string" } }, "seatsReleased": { "type": "boolean" }, "emailQueued": { "type": "boolean" }, "cancelledAt": { "type": "number" } }, "required": [ "orderId", "displayRef", "status", "currency", "settledOutsideMinor", "released", "seatsReleased", "emailQueued", "cancelledAt" ], "additionalProperties": {} } }, "required": [ "receipt" ], "additionalProperties": {} }, "SeasonOrderDateCancelRequest": { "type": "object", "properties": { "actionId": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,160}$" } }, "additionalProperties": false }, "SeasonOrderDateCancelEnvelope": { "type": "object", "properties": { "dateCancel": { "type": "object", "properties": { "eventKey": { "type": "string" }, "ticketsVoided": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "labels": { "type": "array", "items": { "type": "string" } }, "state": { "type": "string", "enum": [ "returned", "pending" ] } }, "required": [ "eventKey", "ticketsVoided", "labels", "state" ], "additionalProperties": {} } }, "required": [ "dateCancel" ], "additionalProperties": {} }, "SeasonOrderResendRequest": { "type": "object", "properties": { "email": { "type": "string", "maxLength": 320 } }, "additionalProperties": false }, "SeasonOrderResendEnvelope": { "type": "object", "properties": { "sentTo": { "type": "string" } }, "required": [ "sentTo" ], "additionalProperties": {} }, "SeasonHostedRenewals": { "type": "object", "properties": { "checkoutMode": { "anyOf": [ { "type": "string", "enum": [ "seatlayer", "server" ] }, { "type": "null" } ] }, "readiness": { "type": "object", "properties": { "ready": { "type": "boolean" }, "problem": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "ready", "problem" ], "additionalProperties": {} }, "holdersWithoutEmail": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "offers": { "type": "array", "items": { "type": "object", "properties": { "offerId": { "type": "string" }, "holderName": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "holderEmail": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "linkActiveSince": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "paymentActive": { "type": "boolean" }, "notices": { "type": "object", "properties": { "invitedAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "lastReminderAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "nextNoticeAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "nextNoticeKind": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "problem": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "invitedAt", "lastReminderAt", "nextNoticeAt", "nextNoticeKind", "problem" ], "additionalProperties": {} } }, "required": [ "offerId", "holderName", "holderEmail", "linkActiveSince", "paymentActive", "notices" ], "additionalProperties": {} } } }, "required": [ "checkoutMode", "readiness", "holdersWithoutEmail", "offers" ], "additionalProperties": {} }, "SeasonRenewalLinkEnvelope": { "type": "object", "properties": { "url": { "type": "string", "description": "Shown once. Making a new link turns this one off." } }, "required": [ "url" ], "additionalProperties": {} }, "SeasonRenewalContactRequest": { "type": "object", "properties": { "email": { "anyOf": [ { "type": "string", "maxLength": 320 }, { "type": "null" } ] }, "name": { "anyOf": [ { "type": "string", "maxLength": 120 }, { "type": "null" } ] } }, "additionalProperties": false }, "SeasonRenewalContactEnvelope": { "type": "object", "properties": { "contact": { "type": "object", "properties": { "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "email": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "name", "email" ], "additionalProperties": {} } }, "required": [ "contact" ], "additionalProperties": {} }, "SeasonRenewalNoticesRequest": { "type": "object", "properties": { "offerIds": { "maxItems": 500, "type": "array", "items": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,160}$" } } }, "additionalProperties": false }, "SeasonRenewalNoticesEnvelope": { "type": "object", "properties": { "scheduled": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "withoutEmail": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 } }, "required": [ "scheduled", "withoutEmail" ], "additionalProperties": {} }, "SeasonSalesReportEnvelope": { "type": "object", "properties": { "report": { "type": "object", "properties": { "season": { "type": "object", "properties": { "key": { "type": "string" }, "name": { "type": "string" }, "currency": { "type": "string" }, "mode": { "type": "string", "enum": [ "live", "test" ] }, "checkoutMode": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "timezone": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "key", "name", "currency", "mode", "checkoutMode", "timezone" ], "additionalProperties": {} }, "generatedAt": { "type": "number" }, "ownCheckout": { "type": "boolean" }, "money": { "anyOf": [ { "type": "object", "properties": { "rows": { "type": "array", "items": { "type": "object", "properties": { "packageId": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "The package's plan key (`spl_…`), as `plans[].key` in retrieveSeason." }, "packageName": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "channel": { "type": "string", "enum": [ "online", "box_office" ] }, "currency": { "type": "string" }, "orders": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "refundedOrders": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "seats": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "grossMinor": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "discountMinor": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "refundedMinor": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "netMinor": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 } }, "required": [ "packageId", "packageName", "channel", "currency", "orders", "refundedOrders", "seats", "grossMinor", "discountMinor", "refundedMinor", "netMinor" ], "additionalProperties": {} } } }, "required": [ "rows" ], "additionalProperties": {} }, { "type": "null" } ] }, "seats": { "anyOf": [ { "type": "object", "properties": { "sold": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "byPackage": { "type": "array", "items": { "type": "object", "properties": { "packageId": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "The package's plan key (`spl_…`), as `plans[].key` in retrieveSeason." }, "packageName": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "seats": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "holders": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 } }, "required": [ "packageId", "packageName", "seats", "holders" ], "additionalProperties": {} } }, "byDate": { "type": "array", "items": { "type": "object", "properties": { "eventKey": { "type": "string" }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "startsAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "timezone": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "seats": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "byPackage": { "type": "array", "items": { "type": "object", "properties": { "packageId": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "The package's plan key (`spl_…`), as `plans[].key` in retrieveSeason." }, "seats": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 } }, "required": [ "packageId", "seats" ], "additionalProperties": {} } } }, "required": [ "eventKey", "name", "startsAt", "timezone", "seats", "byPackage" ], "additionalProperties": {} } } }, "required": [ "sold", "byPackage", "byDate" ], "additionalProperties": {} }, { "type": "null" } ] }, "holders": { "anyOf": [ { "type": "object", "properties": { "total": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "active": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "cancelled": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "imported": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "importedRenewed": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "soldThroughSeatLayer": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "soldThroughYourCheckout": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "byStatus": { "type": "object", "properties": { "all": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "active": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "cancelled": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "renewal": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 } }, "required": [ "all", "active", "cancelled", "renewal" ], "additionalProperties": {} } }, "required": [ "total", "active", "cancelled", "imported", "importedRenewed", "soldThroughSeatLayer", "soldThroughYourCheckout", "byStatus" ], "additionalProperties": {} }, { "type": "null" } ] }, "renewals": { "anyOf": [ { "type": "object", "properties": { "offered": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "renewed": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "declined": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "lapsed": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "open": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "needsReview": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "rate": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "required": [ "offered", "renewed", "declined", "lapsed", "open", "needsReview", "rate" ], "additionalProperties": {} }, { "type": "null" } ] }, "downloadLimit": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "unavailable": { "type": "array", "items": { "type": "string", "enum": [ "seats", "holders", "renewals" ] } } }, "required": [ "season", "generatedAt", "ownCheckout", "money", "seats", "holders", "renewals", "downloadLimit", "unavailable" ], "additionalProperties": {} } }, "required": [ "report" ], "additionalProperties": {} }, "SeasonSeatsReportEnvelope": { "type": "object", "properties": { "seats": { "type": "object", "properties": { "packages": { "type": "array", "items": { "type": "object", "properties": { "packageId": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "The package's plan key (`spl_…`), as `plans[].key` in retrieveSeason." }, "packageName": { "type": "string" }, "datesLeft": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "state": { "type": "string", "enum": [ "ok", "no_dates_left", "chart_unavailable", "dates_differ" ] }, "freeEveryDate": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "notEveryDate": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "renewalHeld": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "required": [ "packageId", "packageName", "datesLeft", "state", "freeEveryDate", "notEveryDate", "renewalHeld" ], "additionalProperties": {} } }, "dates": { "type": "array", "items": { "type": "object", "properties": { "eventKey": { "type": "string" }, "free": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 } }, "required": [ "eventKey", "free" ], "additionalProperties": {} } } }, "required": [ "packages", "dates" ], "additionalProperties": {} } }, "required": [ "seats" ], "additionalProperties": {} }, "SeasonCsvDownload": { "type": "string", "description": "CSV text with a header row." }, "SeasonSeatCountsEnvelope": { "type": "object", "properties": { "seats": { "anyOf": [ { "type": "object", "properties": { "sold": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "byPackage": { "type": "array", "items": { "type": "object", "properties": { "packageId": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "The package's plan key (`spl_…`), as `plans[].key` in retrieveSeason." }, "packageName": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "seats": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "holders": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 } }, "required": [ "packageId", "packageName", "seats", "holders" ], "additionalProperties": {} } }, "byDate": { "type": "array", "items": { "type": "object", "properties": { "eventKey": { "type": "string" }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "startsAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "timezone": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "seats": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "byPackage": { "type": "array", "items": { "type": "object", "properties": { "packageId": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "The package's plan key (`spl_…`), as `plans[].key` in retrieveSeason." }, "seats": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 } }, "required": [ "packageId", "seats" ], "additionalProperties": {} } } }, "required": [ "eventKey", "name", "startsAt", "timezone", "seats", "byPackage" ], "additionalProperties": {} } } }, "required": [ "sold", "byPackage", "byDate" ], "additionalProperties": {} }, { "type": "null" } ] } }, "required": [ "seats" ], "additionalProperties": {} }, "AccessLinkCreateRequest": { "type": "object", "properties": { "label": { "anyOf": [ { "type": "string", "maxLength": 80 }, { "type": "null" } ] }, "includePublic": { "type": "boolean" }, "expiresAt": { "type": "number" }, "maxRedemptions": { "type": "integer", "minimum": 1, "maximum": 10000 }, "maxQuantity": { "type": "integer", "minimum": 1, "maximum": 100 }, "sessionTtlSeconds": { "type": "integer", "minimum": 60, "maximum": 43200 }, "reason": { "type": "string" } }, "additionalProperties": false }, "AccessLinkRotateRequest": { "type": "object", "properties": { "endActiveSessions": { "type": "boolean" }, "reason": { "type": "string" } }, "required": [ "endActiveSessions" ], "additionalProperties": false }, "ManageSessionRequest": { "type": "object", "properties": { "allowedOrigin": { "type": "string", "pattern": "^(?:https:\\/\\/[^/?#@\\s]+|http:\\/\\/(?:localhost|127\\.0\\.0\\.1)(?::\\d{1,5})?)\\/?$" }, "capabilities": { "minItems": 1, "type": "array", "items": { "type": "string", "enum": [ "event:view", "event:block", "event:categories:manage", "event:tables:manage", "event:cancel", "event:reports", "event:channels:view", "event:channels:manage", "event:orders:read", "event:refund", "event:tickets:send", "event:door:view", "event:door:checkin", "event:boxoffice" ] } }, "expiresInSeconds": { "type": "integer", "minimum": 300, "maximum": 14400 }, "workspaceId": { "type": "string" } }, "required": [ "allowedOrigin" ], "additionalProperties": false }, "DesignerSessionRequest": { "type": "object", "properties": { "workspaceId": { "type": "string", "minLength": 1 }, "chartId": { "type": "string", "minLength": 1 }, "allowedOrigin": { "type": "string", "pattern": "^(?:https:\\/\\/[^/?#@\\s]+|http:\\/\\/(?:localhost|127\\.0\\.0\\.1)(?::\\d{1,5})?)\\/?$" }, "authority": { "type": "string", "enum": [ "read-only", "edit", "publish" ] }, "canPublish": { "type": "boolean" }, "mode": { "type": "string", "enum": [ "normal", "safe" ] }, "safeModeOptions": { "type": "object", "properties": { "allowDeletingObjects": { "type": "boolean" }, "allowEditingAreaCapacity": { "type": "boolean" } }, "additionalProperties": false }, "features": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": {} }, "expiresInSeconds": { "type": "integer", "minimum": 300, "maximum": 14400 } }, "required": [ "workspaceId", "chartId", "allowedOrigin" ], "additionalProperties": false }, "WebhookCreateRequest": { "type": "object", "properties": { "url": { "type": "string", "pattern": "^https:\\/\\/" }, "events": { "minItems": 1, "type": "array", "items": { "type": "string", "enum": [ "seat.booked", "seat.released", "seat.blocked", "hold.expired", "hold.created", "hold.extended", "event.created", "event.soldout", "object.resale.listed", "object.resale.unlisted", "object.resale.sold", "season.structure.activated", "season.structure.closed", "season.structure.archived", "season.plan.published", "season.plan.superseded", "season.sales.opened", "season.sales.paused", "season.sales.ended", "season.hold.committed", "season.hold.released", "season.hold.expired", "season.booking.confirmed", "season.booking.cancelled", "season.booking.emergency_requested", "season.occurrence.returned", "season.occurrence.reclaimed", "season.renewal.offered", "season.renewal.intent_received", "season.renewal.renewed", "season.renewal.declined", "season.renewal.lapsed", "season.renewal.released", "season.operation.partial_terminal", "season.amendment.applied", "season.performance.added", "season.performance.removed", "season.performance.past", "season.order.paid", "season.order.refunded" ] } } }, "required": [ "url", "events" ], "additionalProperties": false }, "WebhookUpdateRequest": { "type": "object", "properties": { "url": { "type": "string", "pattern": "^https:\\/\\/" }, "events": { "minItems": 1, "type": "array", "items": { "type": "string", "enum": [ "seat.booked", "seat.released", "seat.blocked", "hold.expired", "hold.created", "hold.extended", "event.created", "event.soldout", "object.resale.listed", "object.resale.unlisted", "object.resale.sold", "season.structure.activated", "season.structure.closed", "season.structure.archived", "season.plan.published", "season.plan.superseded", "season.sales.opened", "season.sales.paused", "season.sales.ended", "season.hold.committed", "season.hold.released", "season.hold.expired", "season.booking.confirmed", "season.booking.cancelled", "season.booking.emergency_requested", "season.occurrence.returned", "season.occurrence.reclaimed", "season.renewal.offered", "season.renewal.intent_received", "season.renewal.renewed", "season.renewal.declined", "season.renewal.lapsed", "season.renewal.released", "season.operation.partial_terminal", "season.amendment.applied", "season.performance.added", "season.performance.removed", "season.performance.past", "season.order.paid", "season.order.refunded" ] } }, "disabled": { "type": "boolean" } }, "additionalProperties": false }, "WorkspaceCreateRequest": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 120 }, "externalRef": { "anyOf": [ { "type": "string", "maxLength": 128 }, { "type": "null" } ] }, "defaultRegion": { "anyOf": [ { "type": "string", "enum": [ "western-europe", "eastern-europe", "north-america-east", "north-america-west", "south-america", "asia-pacific", "northeast-asia", "southeast-asia", "oceania", "africa", "middle-east" ] }, { "type": "null" } ] } }, "required": [ "name" ], "additionalProperties": false }, "WorkspaceUpdateRequest": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 120 }, "externalRef": { "anyOf": [ { "type": "string", "maxLength": 128 }, { "type": "null" } ] }, "status": { "type": "string", "enum": [ "active", "disabled" ] }, "isDefault": { "type": "boolean", "const": true }, "defaultRegion": { "type": "string", "enum": [ "western-europe", "eastern-europe", "north-america-east", "north-america-west", "south-america", "asia-pacific", "northeast-asia", "southeast-asia", "oceania", "africa", "middle-east" ] } }, "additionalProperties": false }, "RateLimitError": { "type": "object", "properties": { "error": { "type": "string", "const": "rate_limited" }, "code": { "type": "string", "const": "rate_limited" }, "retryAfterSeconds": { "type": "integer", "minimum": 1 }, "requestId": { "type": "string" } }, "required": [ "error" ], "additionalProperties": true }, "MaintenanceError": { "type": "object", "properties": { "error": { "type": "string", "const": "maintenance_mode" }, "code": { "type": "string", "const": "maintenance_mode" }, "message": { "type": "string" }, "requestId": { "type": "string" } }, "required": [ "error", "code", "message" ], "additionalProperties": true }, "SecretKeyAuthError": { "type": "object", "properties": { "error": { "type": "string", "const": "unauthorized" }, "code": { "type": "string", "const": "bad_key" }, "requestId": { "type": "string" } }, "required": [ "error", "code" ], "additionalProperties": true }, "ManageSessionAuthError": { "type": "object", "properties": { "error": { "type": "string", "const": "unauthorized" }, "code": { "type": "string", "enum": [ "bad_manage_session", "manage_session_expired" ] }, "requestId": { "type": "string" } }, "required": [ "error", "code" ], "additionalProperties": true }, "ListChartsError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "workspace_not_found_or_disabled" ] } }, "required": [ "error" ] } ] }, "CreateChartError400": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "name_required", "invalid_idempotency_key" ] } }, "required": [ "error" ] } ] }, "CreateChartError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden" ] } }, "required": [ "error" ] } ] }, "CreateChartError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "idempotency_conflict", "idempotency_in_progress" ] } }, "required": [ "error" ] } ] }, "CreateChartError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "workspace_not_found_or_disabled", "invalid_chart" ] } }, "required": [ "error" ] } ] }, "RetrieveChartError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "UpdateChartError400": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "expectedUpdatedAt_required" ] } }, "required": [ "error" ] } ] }, "UpdateChartError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden", "edit_not_allowed", "feature_policy_violation" ] } }, "required": [ "error" ] } ] }, "UpdateChartError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found", "chart_not_found" ] } }, "required": [ "error" ] } ] }, "UpdateChartError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "conflict", "draft_snapshot_missing", "draft_snapshot_invalid", "safe_mode_violation", "published_snapshot_missing", "published_snapshot_invalid" ] } }, "required": [ "error" ] } ] }, "UpdateChartError413": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "chart_too_large" ] } }, "required": [ "error" ] } ] }, "UpdateChartError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_chart" ] } }, "required": [ "error" ] } ] }, "DeleteChartError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden" ] } }, "required": [ "error" ] } ] }, "DeleteChartError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "CopyChartError400": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_idempotency_key" ] } }, "required": [ "error" ] } ] }, "CopyChartError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden" ] } }, "required": [ "error" ] } ] }, "CopyChartError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "CopyChartError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "idempotency_conflict", "idempotency_in_progress" ] } }, "required": [ "error" ] } ] }, "CopyChartError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "workspace_not_found_or_disabled" ] } }, "required": [ "error" ] } ] }, "ArchiveChartError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden" ] } }, "required": [ "error" ] } ] }, "ArchiveChartError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "UnarchiveChartError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden" ] } }, "required": [ "error" ] } ] }, "UnarchiveChartError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "PublishChartError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden" ] } }, "required": [ "error" ] } ] }, "PublishChartError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "PublishChartError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "review_required", "conflict" ] } }, "required": [ "error" ] } ] }, "PublishChartError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "nothing_to_publish", "invalid_chart" ] } }, "required": [ "error" ] } ] }, "CreatePanoramaManifestJobError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden", "module_not_enabled" ] } }, "required": [ "error" ] } ] }, "CreatePanoramaManifestJobError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "chart_not_found" ] } }, "required": [ "error" ] } ] }, "CreatePanoramaManifestJobError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "chart_empty", "conflict" ] } }, "required": [ "error" ] } ] }, "CreatePanoramaManifestJobError413": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "manifest_too_large" ] } }, "required": [ "error" ] } ] }, "CreatePanoramaManifestJobError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_request", "manifest_invalid", "attachments_required", "attachments_unreferenced" ] } }, "required": [ "error" ] } ] }, "CreatePanoramaManifestJobError503": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "queue_unavailable" ] } }, "required": [ "error" ] } ] }, "RetrievePanoramaManifestJobError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "chart_not_found", "not_found" ] } }, "required": [ "error" ] } ] }, "InstantiateTemplateError400": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_request", "invalid_idempotency_key" ] } }, "required": [ "error" ] } ] }, "InstantiateTemplateError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden" ] } }, "required": [ "error" ] } ] }, "InstantiateTemplateError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "template_not_found" ] } }, "required": [ "error" ] } ] }, "InstantiateTemplateError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "template_version_mismatch", "idempotency_conflict", "idempotency_in_progress" ] } }, "required": [ "error" ] } ] }, "InstantiateTemplateError413": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "payload_too_large" ] } }, "required": [ "error" ] } ] }, "InstantiateTemplateError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_version", "invalid_chart", "unsafe_chart_asset", "workspace_not_found_or_disabled" ] } }, "required": [ "error" ] } ] }, "InstantiateTemplateError503": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "template_artifact_unavailable", "template_integrity_error" ] } }, "required": [ "error" ] } ] }, "ListEventsError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "workspace_not_found_or_disabled" ] } }, "required": [ "error" ] } ] }, "CreateEventError400": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "chartId_required", "invalid_idempotency_key" ] } }, "required": [ "error" ] } ] }, "CreateEventError402": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "insufficient_credits" ] } }, "required": [ "error" ] } ] }, "CreateEventError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden" ] } }, "required": [ "error" ] } ] }, "CreateEventError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "chart_not_found" ] } }, "required": [ "error" ] } ] }, "CreateEventError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "event_exists", "idempotency_conflict", "idempotency_in_progress" ] } }, "required": [ "error" ] } ] }, "CreateEventError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_currency", "invalid_slug", "invalid_region", "chart_not_published", "workspace_not_found_or_disabled", "invalid_description", "invalid_ends_at", "invalid_timezone", "invalid_locale", "ends_before_starts", "invalid_external_ref", "invalid_event_inventory" ] } }, "required": [ "error" ] } ] }, "CopyEventError400": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_idempotency_key" ] } }, "required": [ "error" ] } ] }, "CopyEventError402": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "insufficient_credits" ] } }, "required": [ "error" ] } ] }, "CopyEventError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden", "mode_mismatch" ] } }, "required": [ "error" ] } ] }, "CopyEventError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "CopyEventError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "event_exists", "idempotency_conflict", "idempotency_in_progress" ] } }, "required": [ "error" ] } ] }, "CopyEventError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_name", "invalid_slug", "invalid_starts_at", "invalid_copy_blocks", "invalid_copy_channels", "chart_unavailable", "workspace_not_found_or_disabled", "invalid_event_inventory", "inventory_limit_exceeded" ] } }, "required": [ "error" ] } ] }, "RetrieveEventError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "mode_mismatch" ] } }, "required": [ "error" ] } ] }, "RetrieveEventError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "RetrieveEventConfigurationBindingError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found", "version_not_found" ] } }, "required": [ "error" ] } ] }, "RetrieveEventConfigurationBindingError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "configuration_inventory_state_conflict", "configuration_inventory_seat_conflict" ] } }, "required": [ "error" ] } ] }, "RetrieveEventConfigurationBindingError503": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "configuration_artifact_unavailable", "configuration_artifact_integrity_error", "configuration_inventory_state_invalid", "configuration_inventory_state_conflict" ] } }, "required": [ "error" ] } ] }, "UpdateEventConfigurationBindingError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "module_not_enabled" ] } }, "required": [ "error" ] } ] }, "UpdateEventConfigurationBindingError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found", "version_not_found" ] } }, "required": [ "error" ] } ] }, "UpdateEventConfigurationBindingError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "event_not_editable", "configuration_binding_conflict", "version_not_published", "event_chart_provenance_missing", "incompatible_configuration", "configuration_binding_invalid", "configuration_inventory_state_conflict", "configuration_inventory_seat_conflict" ] } }, "required": [ "error" ] } ] }, "UpdateEventConfigurationBindingError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_request" ] } }, "required": [ "error" ] } ] }, "UpdateEventConfigurationBindingError503": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "configuration_artifact_unavailable", "configuration_artifact_integrity_error", "event_chart_unavailable", "configuration_inventory_state_invalid", "configuration_inventory_state_conflict", "configuration_inventory_commit_pending" ] } }, "required": [ "error" ] } ] }, "UpdateEventError400": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "nothing_to_update" ] } }, "required": [ "error" ] } ] }, "UpdateEventError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "mode_mismatch" ] } }, "required": [ "error" ] } ] }, "UpdateEventError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found", "chart_unavailable" ] } }, "required": [ "error" ] } ] }, "UpdateEventError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "performance_group_locked", "season_event_locked" ] } }, "required": [ "error" ] } ] }, "UpdateEventError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_section_states", "unknown_section", "invalid_section_state", "invalid_currency", "invalid_description", "invalid_ends_at", "invalid_timezone", "invalid_locale", "ends_before_starts" ] } }, "required": [ "error" ] } ] }, "DeleteEventError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "mode_mismatch" ] } }, "required": [ "error" ] } ] }, "DeleteEventError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "DeleteEventError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "performance_group_locked", "season_event_locked" ] } }, "required": [ "error" ] } ] }, "UpdateEventPosterError400": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "empty_body" ] } }, "required": [ "error" ] } ] }, "UpdateEventPosterError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "mode_mismatch", "forbidden" ] } }, "required": [ "error" ] } ] }, "UpdateEventPosterError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "UpdateEventPosterError413": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "image_too_large" ] } }, "required": [ "error" ] } ] }, "UpdateEventPosterError415": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "unsupported_image" ] } }, "required": [ "error" ] } ] }, "UpdateEventPosterError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "image_dimensions_unsupported" ] } }, "required": [ "error" ] } ] }, "DeleteEventPosterError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "mode_mismatch", "forbidden" ] } }, "required": [ "error" ] } ] }, "DeleteEventPosterError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found", "no_poster" ] } }, "required": [ "error" ] } ] }, "UpdateEventChartError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "mode_mismatch" ] } }, "required": [ "error" ] } ] }, "UpdateEventChartError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found", "chart_not_found", "chart_unavailable" ] } }, "required": [ "error" ] } ] }, "UpdateEventChartError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "event_not_mutable", "event_configuration_bound", "channel_assignment_would_drop", "season_inventory_locked", "seats_would_vanish", "order_edit_in_progress" ] } }, "required": [ "error" ] } ] }, "CloseEventError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "mode_mismatch" ] } }, "required": [ "error" ] } ] }, "CloseEventError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "CloseEventError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "event_not_mutable", "invalid_sales_transition", "sales_revision_conflict" ] } }, "required": [ "error" ] } ] }, "ReopenEventError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "mode_mismatch" ] } }, "required": [ "error" ] } ] }, "ReopenEventError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "ReopenEventError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "event_not_mutable", "invalid_sales_transition", "sales_not_ready", "sales_revision_conflict" ] } }, "required": [ "error" ] } ] }, "ArchiveEventError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "mode_mismatch" ] } }, "required": [ "error" ] } ] }, "ArchiveEventError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "ArchiveEventError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "event_not_mutable", "performance_group_locked", "season_event_locked" ] } }, "required": [ "error" ] } ] }, "UnarchiveEventError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "mode_mismatch" ] } }, "required": [ "error" ] } ] }, "UnarchiveEventError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "UnarchiveEventError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "event_not_archived", "sales_revision_conflict" ] } }, "required": [ "error" ] } ] }, "ListTicketReleasesError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "mode_mismatch" ] } }, "required": [ "error" ] } ] }, "ListTicketReleasesError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "UpdateTicketReleasesError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "mode_mismatch" ] } }, "required": [ "error" ] } ] }, "UpdateTicketReleasesError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "UpdateTicketReleasesError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_request", "unknown_field", "invalid_releases", "too_many_releases", "invalid_release", "invalid_release_id", "duplicate_release_id", "invalid_release_name", "invalid_release_category", "unknown_release_category", "release_category_has_tiers", "invalid_release_price", "invalid_previous_price", "invalid_release_quota", "invalid_release_window", "invalid_release_action", "action_url_not_allowed", "action_url_required", "invalid_action_url" ] } }, "required": [ "error" ] } ] }, "CloseTicketReleaseError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "mode_mismatch" ] } }, "required": [ "error" ] } ] }, "CloseTicketReleaseError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found", "release_not_found" ] } }, "required": [ "error" ] } ] }, "HoldObjectsError400": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "selections_required" ] } }, "required": [ "error" ] } ] }, "HoldObjectsError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "mode_mismatch", "channel_access_denied" ] } }, "required": [ "error" ] } ] }, "HoldObjectsError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "HoldObjectsError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "event_closed", "conflict" ] } }, "required": [ "error" ] } ] }, "HoldObjectsError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "hold_quantity_exceeded", "invalid_selection" ] } }, "required": [ "error" ] } ] }, "ExtendHoldError400": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "holdId_required" ] } }, "required": [ "error" ] } ] }, "ExtendHoldError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "mode_mismatch", "channel_access_denied" ] } }, "required": [ "error" ] } ] }, "ExtendHoldError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "ExtendHoldError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "cannot_extend", "order_edit_in_progress" ] } }, "required": [ "error" ] } ] }, "HoldBestAvailableError400": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "qty_required", "invalid_zone" ] } }, "required": [ "error" ] } ] }, "HoldBestAvailableError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "mode_mismatch", "channel_access_denied" ] } }, "required": [ "error" ] } ] }, "HoldBestAvailableError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found", "chart_unavailable" ] } }, "required": [ "error" ] } ] }, "HoldBestAvailableError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "event_closed", "conflict" ] } }, "required": [ "error" ] } ] }, "HoldBestAvailableError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "unknown_zone", "invalid_selection" ] } }, "required": [ "error" ] } ] }, "BlockBestAvailableError400": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "qty_required", "invalid_zone", "releaseAt_required", "blockRef_required" ] } }, "required": [ "error" ] } ] }, "BlockBestAvailableError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "mode_mismatch", "channel_access_denied" ] } }, "required": [ "error" ] } ] }, "BlockBestAvailableError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found", "chart_unavailable" ] } }, "required": [ "error" ] } ] }, "BlockBestAvailableError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "event_closed", "conflict" ] } }, "required": [ "error" ] } ] }, "BlockBestAvailableError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "unknown_zone", "invalid_selection" ] } }, "required": [ "error" ] } ] }, "BookBestAvailableError400": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "bookingRef_required", "qty_required", "invalid_zone" ] } }, "required": [ "error" ] } ] }, "BookBestAvailableError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "mode_mismatch", "channel_access_denied" ] } }, "required": [ "error" ] } ] }, "BookBestAvailableError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found", "chart_unavailable" ] } }, "required": [ "error" ] } ] }, "BookBestAvailableError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "event_closed", "conflict" ] } }, "required": [ "error" ] } ] }, "BookBestAvailableError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "unknown_zone", "invalid_selection" ] } }, "required": [ "error" ] } ] }, "RetrieveHoldError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "mode_mismatch", "channel_access_denied" ] } }, "required": [ "error" ] } ] }, "RetrieveHoldError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found", "hold_not_found" ] } }, "required": [ "error" ] } ] }, "RetrieveHoldError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "legacy_hold_requires_restart" ] } }, "required": [ "error" ] } ] }, "ReleaseObjectsError400": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "labels_and_holdId_required" ] } }, "required": [ "error" ] } ] }, "ReleaseObjectsError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "mode_mismatch" ] } }, "required": [ "error" ] } ] }, "ReleaseObjectsError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "ReleaseObjectsError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "order_edit_in_progress" ] } }, "required": [ "error" ] } ] }, "BookObjectsError400": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "hold_or_labels_and_bookingRef_required", "blockRef_invalid", "holdId_and_blockRef_mutually_exclusive" ] } }, "required": [ "error" ] } ] }, "BookObjectsError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "mode_mismatch", "channel_access_denied" ] } }, "required": [ "error" ] } ] }, "BookObjectsError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "BookObjectsError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "hold_not_active", "legacy_hold_requires_restart", "conflict" ] } }, "required": [ "error" ] } ] }, "BoxOfficeBookObjectsError400": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "labels_and_bookingRef_required" ] } }, "required": [ "error" ] } ] }, "BoxOfficeBookObjectsError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "mode_mismatch", "channel_access_denied", "forbidden" ] } }, "required": [ "error" ] } ] }, "BoxOfficeBookObjectsError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "BoxOfficeBookObjectsError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "conflict" ] } }, "required": [ "error" ] } ] }, "UnbookObjectsError400": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "labels_and_bookingRef_required" ] } }, "required": [ "error" ] } ] }, "UnbookObjectsError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "mode_mismatch", "forbidden" ] } }, "required": [ "error" ] } ] }, "UnbookObjectsError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "UnbookObjectsError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "booking_mismatch" ] } }, "required": [ "error" ] } ] }, "BlockObjectsError400": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "labels_required" ] } }, "required": [ "error" ] } ] }, "BlockObjectsError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "mode_mismatch", "forbidden" ] } }, "required": [ "error" ] } ] }, "BlockObjectsError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "BlockObjectsError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "conflict" ] } }, "required": [ "error" ] } ] }, "UnblockObjectsError400": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "labels_required" ] } }, "required": [ "error" ] } ] }, "UnblockObjectsError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "mode_mismatch", "forbidden" ] } }, "required": [ "error" ] } ] }, "UnblockObjectsError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "UnblockAllObjectsError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "mode_mismatch", "forbidden" ] } }, "required": [ "error" ] } ] }, "UnblockAllObjectsError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "PutUpForResaleError400": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "objects_required" ] } }, "required": [ "error" ] } ] }, "PutUpForResaleError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden", "mode_mismatch" ] } }, "required": [ "error" ] } ] }, "PutUpForResaleError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "PutUpForResaleError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_booked", "order_edit_in_progress", "resale_unsupported_on_seatlayer_checkout" ] } }, "required": [ "error" ] } ] }, "PutUpForResaleError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_listing_id" ] } }, "required": [ "error" ] } ] }, "RemoveFromResaleError400": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "objects_required" ] } }, "required": [ "error" ] } ] }, "RemoveFromResaleError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden", "mode_mismatch" ] } }, "required": [ "error" ] } ] }, "RemoveFromResaleError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "RemoveFromResaleError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "order_edit_in_progress" ] } }, "required": [ "error" ] } ] }, "ListResaleListingsError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden", "mode_mismatch" ] } }, "required": [ "error" ] } ] }, "ListResaleListingsError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "RetrieveResaleSummaryError400": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_since" ] } }, "required": [ "error" ] } ] }, "RetrieveResaleSummaryError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden", "mode_mismatch" ] } }, "required": [ "error" ] } ] }, "RetrieveResaleSummaryError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "RetrieveAvailabilityError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "mode_mismatch" ] } }, "required": [ "error" ] } ] }, "RetrieveAvailabilityError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "UpdateAvailabilityError400": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "rules_required" ] } }, "required": [ "error" ] } ] }, "UpdateAvailabilityError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "mode_mismatch", "forbidden" ] } }, "required": [ "error" ] } ] }, "UpdateAvailabilityError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found", "chart_unavailable" ] } }, "required": [ "error" ] } ] }, "UpdateAvailabilityError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_availability_rule" ] } }, "required": [ "error" ] } ] }, "RetrieveHoldTtlError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "mode_mismatch" ] } }, "required": [ "error" ] } ] }, "RetrieveHoldTtlError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "UpdateHoldTtlError400": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "holdTtlMs_required", "holdTtlMs_must_be_positive_number_or_null" ] } }, "required": [ "error" ] } ] }, "UpdateHoldTtlError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "mode_mismatch", "forbidden" ] } }, "required": [ "error" ] } ] }, "UpdateHoldTtlError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "ListInventoryBookingsError400": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_cursor", "invalid_booking_state", "invalid_booking_window" ] } }, "required": [ "error" ] } ] }, "ListInventoryBookingsError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "mode_mismatch" ] } }, "required": [ "error" ] } ] }, "ListInventoryBookingsError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "RetrieveInventoryBookingError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "mode_mismatch" ] } }, "required": [ "error" ] } ] }, "RetrieveInventoryBookingError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "ListInventoryBookingChangesError400": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_after" ] } }, "required": [ "error" ] } ] }, "ListInventoryBookingChangesError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "mode_mismatch" ] } }, "required": [ "error" ] } ] }, "ListInventoryBookingChangesError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "RetrieveEventReportError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "mode_mismatch", "forbidden" ] } }, "required": [ "error" ] } ] }, "RetrieveEventReportError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "RetrieveEventLogError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "mode_mismatch", "forbidden" ] } }, "required": [ "error" ] } ] }, "RetrieveEventLogError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "RetrieveChannelReportError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "mode_mismatch", "forbidden" ] } }, "required": [ "error" ] } ] }, "RetrieveChannelReportError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "ListChannelsError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "mode_mismatch", "forbidden" ] } }, "required": [ "error" ] } ] }, "ListChannelsError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "CreateChannelError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "mode_mismatch", "forbidden" ] } }, "required": [ "error" ] } ] }, "CreateChannelError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "CreateChannelError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "channel_name_taken" ] } }, "required": [ "error" ] } ] }, "CreateChannelError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "channel_name_required", "invalid_access_intent", "channel_request_invalid" ] } }, "required": [ "error" ] } ] }, "UpdateChannelError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "mode_mismatch", "forbidden" ] } }, "required": [ "error" ] } ] }, "UpdateChannelError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found", "chart_unavailable" ] } }, "required": [ "error" ] } ] }, "UpdateChannelError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "channel_name_taken", "channel_archived", "channel_access_intent_forbids", "channel_intent_switch_blocked", "channel_pricing_conflict" ] } }, "required": [ "error" ] } ] }, "UpdateChannelError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "channel_name_required", "invalid_access_intent", "invalid_channel_pricing", "channel_request_invalid" ] } }, "required": [ "error" ] } ] }, "UpdateChannelAssignmentsError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "mode_mismatch", "forbidden" ] } }, "required": [ "error" ] } ] }, "UpdateChannelAssignmentsError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "UpdateChannelAssignmentsError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "channel_archived", "channel_assignment_conflict", "channel_assignment_would_drop" ] } }, "required": [ "error" ] } ] }, "UpdateChannelAssignmentsError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "labels_required", "assignment_version_required", "invalid_channel_destination", "too_many_units", "channel_request_invalid" ] } }, "required": [ "error" ] } ] }, "ListChannelAllocationError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "mode_mismatch", "forbidden" ] } }, "required": [ "error" ] } ] }, "ListChannelAllocationError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "RetrieveChannelAccessPreviewError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "mode_mismatch", "forbidden" ] } }, "required": [ "error" ] } ] }, "RetrieveChannelAccessPreviewError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "RetrieveChannelAccessPreviewError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_channel_scope" ] } }, "required": [ "error" ] } ] }, "PauseChannelError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "mode_mismatch", "forbidden" ] } }, "required": [ "error" ] } ] }, "PauseChannelError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "PauseChannelError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "channel_archived" ] } }, "required": [ "error" ] } ] }, "PauseChannelError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "channel_state_invalid", "channel_request_invalid" ] } }, "required": [ "error" ] } ] }, "UnpauseChannelError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "mode_mismatch", "forbidden" ] } }, "required": [ "error" ] } ] }, "UnpauseChannelError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "UnpauseChannelError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "channel_archived" ] } }, "required": [ "error" ] } ] }, "UnpauseChannelError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "channel_state_invalid", "channel_request_invalid" ] } }, "required": [ "error" ] } ] }, "ArchiveChannelError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "mode_mismatch", "forbidden" ] } }, "required": [ "error" ] } ] }, "ArchiveChannelError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "ArchiveChannelError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "channel_archive_blocked_by_holds", "channel_archived", "order_edit_in_progress" ] } }, "required": [ "error" ] } ] }, "ArchiveChannelError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "destination_required", "invalid_channel_destination", "channel_request_invalid" ] } }, "required": [ "error" ] } ] }, "CreateBuyerAccessSessionError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "buyer_access_mode_mismatch" ] } }, "required": [ "error" ] } ] }, "CreateBuyerAccessSessionError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "CreateBuyerAccessSessionError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "channel_access_intent_forbids" ] } }, "required": [ "error" ] } ] }, "CreateBuyerAccessSessionError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_allowed_origin", "include_public_required", "invalid_channel_scope", "invalid_expiry", "invalid_max_quantity", "invalid_reference" ] } }, "required": [ "error" ] } ] }, "ListBuyerAccessSessionsError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "RevokeBuyerAccessSessionError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "CreateAccessLinkError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "mode_mismatch", "forbidden" ] } }, "required": [ "error" ] } ] }, "CreateAccessLinkError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "CreateAccessLinkError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "channel_unavailable", "channel_access_intent_forbids", "too_many_access_links" ] } }, "required": [ "error" ] } ] }, "CreateAccessLinkError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_expiry", "invalid_max_redemptions", "invalid_max_quantity", "invalid_session_ttl", "invalid_include_public", "invalid_label" ] } }, "required": [ "error" ] } ] }, "ListAccessLinksError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "mode_mismatch", "forbidden" ] } }, "required": [ "error" ] } ] }, "ListAccessLinksError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "RotateAccessLinkError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "mode_mismatch", "forbidden" ] } }, "required": [ "error" ] } ] }, "RotateAccessLinkError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "RotateAccessLinkError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "channel_unavailable", "channel_access_intent_forbids", "access_link_not_active" ] } }, "required": [ "error" ] } ] }, "RotateAccessLinkError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "end_active_sessions_required" ] } }, "required": [ "error" ] } ] }, "RevokeAccessLinkError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "mode_mismatch", "forbidden" ] } }, "required": [ "error" ] } ] }, "RevokeAccessLinkError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "RevokeAccessLinkError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "channel_unavailable", "access_link_not_active" ] } }, "required": [ "error" ] } ] }, "CreateManageSessionError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "mode_mismatch", "forbidden" ] } }, "required": [ "error" ] } ] }, "CreateManageSessionError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "CreateManageSessionError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_allowed_origin", "invalid_capabilities", "invalid_expiry" ] } }, "required": [ "error" ] } ] }, "RevokeManageSessionError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "mode_mismatch", "forbidden" ] } }, "required": [ "error" ] } ] }, "RevokeManageSessionError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "CreateDesignerSessionError400": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "workspaceId_and_chartId_required" ] } }, "required": [ "error" ] } ] }, "CreateDesignerSessionError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden" ] } }, "required": [ "error" ] } ] }, "CreateDesignerSessionError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "workspace_not_found_or_disabled", "chart_not_found" ] } }, "required": [ "error" ] } ] }, "CreateDesignerSessionError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_allowed_origin", "invalid_authority", "invalid_can_publish", "conflicting_authority", "invalid_designer_mode", "safe_mode_options_require_safe_mode", "invalid_safe_mode_options", "invalid_expiry", "invalid_features" ] } }, "required": [ "error" ] } ] }, "RevokeDesignerSessionError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden" ] } }, "required": [ "error" ] } ] }, "RevokeDesignerSessionError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "ListPerformanceGroupsError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "workspace_not_found_or_disabled" ] } }, "required": [ "error" ] } ] }, "ListPerformanceGroupsError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_state", "invalid_mode" ] } }, "required": [ "error" ] } ] }, "CreatePerformanceGroupError400": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_idempotency_key" ] } }, "required": [ "error" ] } ] }, "CreatePerformanceGroupError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden" ] } }, "required": [ "error" ] } ] }, "CreatePerformanceGroupError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "incompatible_performances" ] }, "code": { "type": "string", "enum": [ "event_not_found" ] } }, "required": [ "error" ] } ] }, "CreatePerformanceGroupError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "idempotency_conflict", "idempotency_in_progress", "event_already_grouped", "external_ref_exists", "incompatible_performances" ] }, "code": { "type": "string", "enum": [ "platform_event_required", "checkout_mode_mismatch", "event_unavailable", "workspace_mismatch", "mode_mismatch", "environment_mismatch", "chart_mismatch", "chart_unavailable", "chart_snapshot_mismatch", "inventory_model_mismatch", "unsupported_inventory", "currency_mismatch", "venue_mismatch", "timezone_mismatch" ] } }, "required": [ "error" ] } ] }, "CreatePerformanceGroupError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_name", "invalid_external_ref", "invalid_event_keys", "invalid_inclusion_mode", "invalid_selection_mode", "invalid_audience", "invalid_checkout_mode", "incompatible_performances" ] }, "code": { "type": "string", "enum": [ "invalid_event_count", "duplicate_event", "performance_time_required" ] } }, "required": [ "error" ] } ] }, "RetrievePerformanceGroupError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "UpdatePerformanceGroupError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden" ] } }, "required": [ "error" ] } ] }, "UpdatePerformanceGroupError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "UpdatePerformanceGroupError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "group_not_editable", "group_not_active", "checkout_mode_required", "group_has_holds", "revision_mismatch", "incompatible_performances" ] }, "code": { "type": "string", "enum": [ "checkout_mode_mismatch" ] } }, "required": [ "error" ] } ] }, "UpdatePerformanceGroupError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_expected_revision", "invalid_name", "invalid_external_ref", "invalid_selection_mode", "invalid_audience", "invalid_sales_state", "invalid_checkout_mode" ] } }, "required": [ "error" ] } ] }, "UpdatePerformanceGroupError503": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "lifecycle_unavailable" ] } }, "required": [ "error" ] } ] }, "DeletePerformanceGroupError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden" ] } }, "required": [ "error" ] } ] }, "DeletePerformanceGroupError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "DeletePerformanceGroupError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "group_not_draft" ] } }, "required": [ "error" ] } ] }, "ActivatePerformanceGroupError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden" ] } }, "required": [ "error" ] } ] }, "ActivatePerformanceGroupError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found", "group_not_found" ] } }, "required": [ "error" ] } ] }, "ActivatePerformanceGroupError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "group_not_draft", "group_not_active", "group_closing", "revision_mismatch", "activation_mismatch", "lifecycle_operation_mismatch", "event_lock_refused", "registry_mismatch", "activation_repair_required" ] } }, "required": [ "error" ] } ] }, "ActivatePerformanceGroupError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_expected_revision" ] } }, "required": [ "error" ] } ] }, "ActivatePerformanceGroupError503": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "recovery_pending", "lifecycle_unavailable" ] } }, "required": [ "error" ] } ] }, "ClosePerformanceGroupError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden" ] } }, "required": [ "error" ] } ] }, "ClosePerformanceGroupError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found", "group_not_found" ] } }, "required": [ "error" ] } ] }, "ClosePerformanceGroupError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "group_not_draft", "group_not_active", "group_closing", "revision_mismatch", "activation_mismatch", "lifecycle_operation_mismatch", "event_lock_refused", "registry_mismatch", "activation_repair_required" ] } }, "required": [ "error" ] } ] }, "ClosePerformanceGroupError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_expected_revision" ] } }, "required": [ "error" ] } ] }, "ClosePerformanceGroupError503": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "recovery_pending", "lifecycle_unavailable" ] } }, "required": [ "error" ] } ] }, "RetrievePerformanceGroupLifecycleError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found", "group_not_found" ] } }, "required": [ "error" ] } ] }, "RetrievePerformanceGroupLifecycleError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "group_not_draft", "group_not_active", "group_closing", "revision_mismatch", "activation_mismatch", "lifecycle_operation_mismatch", "event_lock_refused", "registry_mismatch", "activation_repair_required" ] } }, "required": [ "error" ] } ] }, "RetrievePerformanceGroupLifecycleError503": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "recovery_pending", "lifecycle_unavailable" ] } }, "required": [ "error" ] } ] }, "CreatePerformanceGroupBuyerAccessSessionError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden", "buyer_access_mode_mismatch" ] } }, "required": [ "error" ] } ] }, "CreatePerformanceGroupBuyerAccessSessionError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "CreatePerformanceGroupBuyerAccessSessionError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "performance_group_not_active", "channel_access_intent_forbids", "activation_mismatch", "member_set_mismatch" ] } }, "required": [ "error" ] } ] }, "CreatePerformanceGroupBuyerAccessSessionError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_allowed_origin", "include_public_required", "invalid_expiry", "invalid_max_quantity", "invalid_reference", "invalid_channel_scope" ] } }, "required": [ "error" ] } ] }, "ListPerformanceGroupBuyerAccessSessionsError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "RevokePerformanceGroupBuyerAccessSessionError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "RetrievePerformanceGroupHoldError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "RetrievePerformanceGroupHoldError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "performance_group_integrity_error" ] } }, "required": [ "error" ] } ] }, "BookPerformanceGroupHoldError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden" ] } }, "required": [ "error" ] } ] }, "BookPerformanceGroupHoldError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "BookPerformanceGroupHoldError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "hold_not_active", "book_operation_mismatch", "book_failed" ] } }, "required": [ "error" ] } ] }, "BookPerformanceGroupHoldError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_request" ] } }, "required": [ "error" ] } ] }, "RetrievePerformanceGroupBookingError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "ListSeasonsError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "workspace_not_found_or_disabled" ] } }, "required": [ "error" ] } ] }, "ListSeasonsError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_state", "invalid_mode" ] } }, "required": [ "error" ] } ] }, "ValidateSeasonError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden", "module_not_enabled", "module_required" ] } }, "required": [ "error" ] } ] }, "ValidateSeasonError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "workspace_not_found_or_disabled" ] } }, "required": [ "error" ] } ] }, "ValidateSeasonError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_selection" ] } }, "required": [ "error" ] } ] }, "CreateSeasonError400": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_idempotency_key" ] } }, "required": [ "error" ] } ] }, "CreateSeasonError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden", "module_not_enabled", "module_required" ] } }, "required": [ "error" ] } ] }, "CreateSeasonError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "event_not_found", "workspace_not_found_or_disabled" ] } }, "required": [ "error" ] } ] }, "CreateSeasonError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "idempotency_conflict", "idempotency_in_progress", "workspace_mismatch", "mode_mismatch", "chart_mismatch", "chart_unavailable", "currency_mismatch", "venue_mismatch", "timezone_mismatch" ] } }, "required": [ "error" ] } ] }, "CreateSeasonError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_name", "invalid_edition", "invalid_event_keys", "invalid_event_count", "channel_restricted_inventory", "unsupported_season_inventory" ] } }, "required": [ "error" ] } ] }, "CreateSeasonError503": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "channel_state_unavailable" ] } }, "required": [ "error" ] } ] }, "RetrieveSeasonError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found", "season_not_found" ] } }, "required": [ "error" ] } ] }, "UpdateSeasonError400": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_idempotency_key" ] } }, "required": [ "error" ] } ] }, "UpdateSeasonError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden" ] } }, "required": [ "error" ] } ] }, "UpdateSeasonError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found", "season_not_found" ] } }, "required": [ "error" ] } ] }, "UpdateSeasonError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_a_draft", "revision_mismatch", "idempotency_conflict", "idempotency_in_progress" ] } }, "required": [ "error" ] } ] }, "UpdateSeasonError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_name", "invalid_edition", "invalid_expected_revision" ] } }, "required": [ "error" ] } ] }, "DeleteSeasonError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden" ] } }, "required": [ "error" ] } ] }, "DeleteSeasonError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found", "season_not_found" ] } }, "required": [ "error" ] } ] }, "DeleteSeasonError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_a_draft" ] } }, "required": [ "error" ] } ] }, "ActivateSeasonError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden", "module_not_enabled", "module_required" ] } }, "required": [ "error" ] } ] }, "ActivateSeasonError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found", "season_not_found" ] } }, "required": [ "error" ] } ] }, "ActivateSeasonError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "revision_mismatch", "not_a_draft", "chart_mismatch", "chart_unavailable" ] } }, "required": [ "error" ] } ] }, "ActivateSeasonError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_expected_revision" ] } }, "required": [ "error" ] } ] }, "CloseSeasonError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden" ] } }, "required": [ "error" ] } ] }, "CloseSeasonError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found", "season_not_found" ] } }, "required": [ "error" ] } ] }, "CloseSeasonError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "revision_mismatch", "sales_open", "sales_not_ended", "not_active" ] } }, "required": [ "error" ] } ] }, "CloseSeasonError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_expected_revision" ] } }, "required": [ "error" ] } ] }, "ArchiveSeasonError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden" ] } }, "required": [ "error" ] } ] }, "ArchiveSeasonError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found", "season_not_found" ] } }, "required": [ "error" ] } ] }, "ArchiveSeasonError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_closed", "revision_mismatch", "lifecycle_transition_pending", "lifecycle_operation_mismatch" ] } }, "required": [ "error" ] } ] }, "ArchiveSeasonError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_expected_revision" ] } }, "required": [ "error" ] } ] }, "RetrieveSeasonLifecycleError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found", "season_not_found" ] } }, "required": [ "error" ] } ] }, "CreateSeasonPlanError400": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_idempotency_key" ] } }, "required": [ "error" ] } ] }, "CreateSeasonPlanError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden", "module_not_enabled", "module_required" ] } }, "required": [ "error" ] } ] }, "CreateSeasonPlanError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found", "season_not_found", "event_not_found" ] } }, "required": [ "error" ] } ] }, "CreateSeasonPlanError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_a_draft", "revision_mismatch", "duplicate_plan_name", "chart_mismatch", "chart_unavailable", "workspace_mismatch", "mode_mismatch", "currency_mismatch", "venue_mismatch", "timezone_mismatch", "environment_mismatch", "event_not_active", "source_group_not_found", "source_group_not_active", "source_group_changed", "direct_group_overlap", "source_group_overlap", "duplicate_event", "idempotency_conflict", "idempotency_in_progress" ] } }, "required": [ "error" ] } ] }, "CreateSeasonPlanError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_name", "invalid_event_keys", "invalid_event_count", "channel_restricted_inventory", "unsupported_season_inventory" ] } }, "required": [ "error" ] } ] }, "CreateSeasonPlanError503": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "channel_state_unavailable" ] } }, "required": [ "error" ] } ] }, "RetrieveSeasonPlanError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found", "season_not_found", "plan_not_found" ] } }, "required": [ "error" ] } ] }, "PublishSeasonPlanError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden", "module_not_enabled", "module_required" ] } }, "required": [ "error" ] } ] }, "PublishSeasonPlanError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found", "season_not_found", "plan_not_found" ] } }, "required": [ "error" ] } ] }, "PublishSeasonPlanError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_a_draft", "revision_mismatch", "chart_unavailable", "chart_mismatch", "season_not_active", "sales_not_ended" ] } }, "required": [ "error" ] } ] }, "PublishSeasonPlanError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_expected_revision", "channel_restricted_inventory", "unsupported_season_inventory" ] } }, "required": [ "error" ] } ] }, "PublishSeasonPlanError503": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "channel_state_unavailable" ] } }, "required": [ "error" ] } ] }, "SupersedeSeasonPlanError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden" ] } }, "required": [ "error" ] } ] }, "SupersedeSeasonPlanError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found", "season_not_found", "plan_not_found" ] } }, "required": [ "error" ] } ] }, "SupersedeSeasonPlanError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_published", "sales_not_ended", "revision_mismatch" ] } }, "required": [ "error" ] } ] }, "SupersedeSeasonPlanError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_expected_revision" ] } }, "required": [ "error" ] } ] }, "OpenSeasonSalesError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden", "module_not_enabled", "module_required" ] } }, "required": [ "error" ] } ] }, "OpenSeasonSalesError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found", "season_not_found" ] } }, "required": [ "error" ] } ] }, "OpenSeasonSalesError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "coupled_lifecycle", "invalid_transition", "revision_mismatch" ] } }, "required": [ "error" ] } ] }, "OpenSeasonSalesError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_expected_revision", "channel_restricted_inventory", "unsupported_season_inventory" ] } }, "required": [ "error" ] } ] }, "OpenSeasonSalesError503": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "channel_state_unavailable" ] } }, "required": [ "error" ] } ] }, "PauseSeasonSalesError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden" ] } }, "required": [ "error" ] } ] }, "PauseSeasonSalesError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found", "season_not_found" ] } }, "required": [ "error" ] } ] }, "PauseSeasonSalesError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_transition", "revision_mismatch" ] } }, "required": [ "error" ] } ] }, "PauseSeasonSalesError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_expected_revision" ] } }, "required": [ "error" ] } ] }, "ResumeSeasonSalesError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden", "module_not_enabled", "module_required" ] } }, "required": [ "error" ] } ] }, "ResumeSeasonSalesError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found", "season_not_found" ] } }, "required": [ "error" ] } ] }, "ResumeSeasonSalesError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "coupled_lifecycle", "invalid_transition", "revision_mismatch" ] } }, "required": [ "error" ] } ] }, "ResumeSeasonSalesError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_expected_revision", "channel_restricted_inventory", "unsupported_season_inventory" ] } }, "required": [ "error" ] } ] }, "ResumeSeasonSalesError503": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "channel_state_unavailable" ] } }, "required": [ "error" ] } ] }, "EndSeasonSalesError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden" ] } }, "required": [ "error" ] } ] }, "EndSeasonSalesError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found", "season_not_found" ] } }, "required": [ "error" ] } ] }, "EndSeasonSalesError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_transition", "revision_mismatch" ] } }, "required": [ "error" ] } ] }, "EndSeasonSalesError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_expected_revision" ] } }, "required": [ "error" ] } ] }, "DuplicateSeasonToLiveError400": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_idempotency_key" ] } }, "required": [ "error" ] } ] }, "DuplicateSeasonToLiveError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden", "module_not_enabled", "module_required" ] } }, "required": [ "error" ] } ] }, "DuplicateSeasonToLiveError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found", "season_not_found", "event_not_found" ] } }, "required": [ "error" ] } ] }, "DuplicateSeasonToLiveError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "test_season_required", "workspace_mismatch", "mode_mismatch", "chart_mismatch", "idempotency_conflict", "idempotency_in_progress" ] } }, "required": [ "error" ] } ] }, "DuplicateSeasonToLiveError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_name", "invalid_event_keys", "invalid_event_count", "channel_restricted_inventory", "unsupported_season_inventory" ] } }, "required": [ "error" ] } ] }, "DuplicateSeasonToLiveError503": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "channel_state_unavailable" ] } }, "required": [ "error" ] } ] }, "CreateSeasonBuyerAccessSessionError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden", "module_not_enabled" ] } }, "required": [ "error" ] } ] }, "CreateSeasonBuyerAccessSessionError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "CreateSeasonBuyerAccessSessionError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "season_not_active", "plan_not_published", "plan_selection_required", "chart_unavailable", "chart_mismatch", "channel_restricted_inventory", "unsupported_season_inventory" ] } }, "required": [ "error" ] } ] }, "CreateSeasonBuyerAccessSessionError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_allowed_origin", "include_public_required", "invalid_expiry", "invalid_max_quantity", "invalid_reference", "invalid_session_purpose", "invalid_plan_activation_id", "channel_authority_unsupported" ] } }, "required": [ "error" ] } ] }, "CreateSeasonBuyerAccessSessionError503": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "channel_state_unavailable" ] } }, "required": [ "error" ] } ] }, "ListSeasonBuyerAccessSessionsError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "RevokeSeasonBuyerAccessSessionError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "RetrieveSeasonHoldError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "BookSeasonHoldError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden" ] } }, "required": [ "error" ] } ] }, "BookSeasonHoldError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "BookSeasonHoldError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "hold_not_active", "book_operation_mismatch", "book_failed" ] } }, "required": [ "error" ] } ] }, "BookSeasonHoldError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_request" ] } }, "required": [ "error" ] } ] }, "RetrieveSeasonBookingError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "CancelSeasonBookingError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden" ] } }, "required": [ "error" ] } ] }, "CancelSeasonBookingError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "CancelSeasonBookingError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "booking_not_cancellable", "cancel_operation_mismatch", "active_occurrence_return", "hosted_order_use_refund" ] } }, "required": [ "error" ] } ] }, "CancelSeasonBookingError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_request", "right_disposition_required" ] } }, "required": [ "error" ] } ] }, "ValidateSeasonBuyerRehearsalError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden" ] } }, "required": [ "error" ] } ] }, "ValidateSeasonBuyerRehearsalError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "ValidateSeasonBuyerRehearsalError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "rehearsal_incomplete" ] } }, "required": [ "error" ] } ] }, "ValidateSeasonBuyerRehearsalError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_request" ] } }, "required": [ "error" ] } ] }, "CreateSeasonHolderImportError400": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_idempotency_key" ] } }, "required": [ "error" ] } ] }, "CreateSeasonHolderImportError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden", "module_not_enabled" ] } }, "required": [ "error" ] } ] }, "CreateSeasonHolderImportError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found", "season_not_found" ] } }, "required": [ "error" ] } ] }, "CreateSeasonHolderImportError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "season_not_active", "plan_not_published", "import_mismatch", "idempotency_conflict", "idempotency_in_progress" ] } }, "required": [ "error" ] } ] }, "CreateSeasonHolderImportError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_request", "invalid_rows", "invalid_row", "invalid_successor_plan", "unknown_seat", "duplicate_row_id", "invalid_holder_email", "invalid_holder_name" ] } }, "required": [ "error" ] } ] }, "CreateSeasonHolderImportFromSeasonError400": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_idempotency_key" ] } }, "required": [ "error" ] } ] }, "CreateSeasonHolderImportFromSeasonError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden", "module_not_enabled" ] } }, "required": [ "error" ] } ] }, "CreateSeasonHolderImportFromSeasonError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found", "season_not_found", "source_season_not_found" ] } }, "required": [ "error" ] } ] }, "CreateSeasonHolderImportFromSeasonError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "season_not_active", "plan_not_published", "source_too_large", "import_mismatch", "idempotency_conflict", "idempotency_in_progress" ] } }, "required": [ "error" ] } ] }, "CreateSeasonHolderImportFromSeasonError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_request", "invalid_source_season", "invalid_successor_plan", "invalid_rows" ] } }, "required": [ "error" ] } ] }, "RetrieveSeasonHolderImportError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "CreateSeasonRenewalOffersError400": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_idempotency_key" ] } }, "required": [ "error" ] } ] }, "CreateSeasonRenewalOffersError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden", "module_not_enabled" ] } }, "required": [ "error" ] } ] }, "CreateSeasonRenewalOffersError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "CreateSeasonRenewalOffersError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "season_not_active", "plan_not_published", "plan_selection_required", "offer_plan_mismatch", "idempotency_conflict", "idempotency_in_progress" ] } }, "required": [ "error" ] } ] }, "CreateSeasonRenewalOffersError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_successor_plan", "invalid_deadline" ] } }, "required": [ "error" ] } ] }, "ListSeasonRenewalOffersError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "RetrieveSeasonRenewalOfferError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "ExtendSeasonRenewalOfferError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "ExtendSeasonRenewalOfferError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "offer_terminal", "order_edit_in_progress" ] } }, "required": [ "error" ] } ] }, "ExtendSeasonRenewalOfferError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_deadline" ] } }, "required": [ "error" ] } ] }, "InspectSeasonRenewalOfferError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "CommitSeasonRenewalOfferError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden" ] } }, "required": [ "error" ] } ] }, "CommitSeasonRenewalOfferError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "CommitSeasonRenewalOfferError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "intent_required", "plan_activation_mismatch", "commit_mismatch", "plan_not_published", "payment_in_progress" ] } }, "required": [ "error" ] } ] }, "CommitSeasonRenewalOfferError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_request" ] } }, "required": [ "error" ] } ] }, "DeclineSeasonRenewalOfferError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "DeclineSeasonRenewalOfferError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "offer_terminal", "order_edit_in_progress", "payment_in_progress" ] } }, "required": [ "error" ] } ] }, "ReleaseSeasonRenewalOfferError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "ReleaseSeasonRenewalOfferError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "offer_not_lapsed", "order_edit_in_progress", "payment_in_progress" ] } }, "required": [ "error" ] } ] }, "ListSeasonPerformancesError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "CreateSeasonPerformancesError400": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_idempotency_key" ] } }, "required": [ "error" ] } ] }, "CreateSeasonPerformancesError402": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "insufficient_credits" ] } }, "required": [ "error" ] } ] }, "CreateSeasonPerformancesError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden", "module_not_enabled" ] } }, "required": [ "error" ] } ] }, "CreateSeasonPerformancesError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found", "event_not_found" ] } }, "required": [ "error" ] } ] }, "CreateSeasonPerformancesError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "season_not_draft", "chart_mismatch", "chart_unavailable", "revision_mismatch", "idempotency_conflict" ] } }, "required": [ "error" ] } ] }, "CreateSeasonPerformancesError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_title_pattern", "invalid_repeat", "invalid_timezone", "timezone_mismatch", "invalid_first_starts_at", "invalid_count", "invalid_dates", "invalid_venue", "invalid_duration", "invalid_region", "invalid_plan_keys", "too_many_performances", "incompatible_events" ] } }, "required": [ "error" ] } ] }, "AttachSeasonPerformancesError400": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_idempotency_key" ] } }, "required": [ "error" ] } ] }, "AttachSeasonPerformancesError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden", "module_not_enabled" ] } }, "required": [ "error" ] } ] }, "AttachSeasonPerformancesError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found", "event_not_found", "plan_not_found" ] } }, "required": [ "error" ] } ] }, "AttachSeasonPerformancesError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "season_not_draft", "plan_not_draft", "plan_source_group_locked", "revision_mismatch" ] } }, "required": [ "error" ] } ] }, "AttachSeasonPerformancesError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_event_keys", "invalid_plan_keys", "too_many_performances", "incompatible_events" ] } }, "required": [ "error" ] } ] }, "DeleteSeasonPerformanceError400": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_idempotency_key" ] } }, "required": [ "error" ] } ] }, "DeleteSeasonPerformanceError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden", "module_not_enabled" ] } }, "required": [ "error" ] } ] }, "DeleteSeasonPerformanceError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found", "event_not_found" ] } }, "required": [ "error" ] } ] }, "DeleteSeasonPerformanceError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "season_not_draft", "plan_not_draft", "plan_source_group_locked", "revision_mismatch" ] } }, "required": [ "error" ] } ] }, "DeleteSeasonPerformanceError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "too_few_performances" ] } }, "required": [ "error" ] } ] }, "UpdateSeasonPlanError400": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_idempotency_key" ] } }, "required": [ "error" ] } ] }, "UpdateSeasonPlanError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden", "module_not_enabled" ] } }, "required": [ "error" ] } ] }, "UpdateSeasonPlanError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found", "plan_not_found" ] } }, "required": [ "error" ] } ] }, "UpdateSeasonPlanError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "season_not_draft", "plan_not_draft", "plan_source_group_locked", "duplicate_plan_name", "duplicate_event", "revision_mismatch" ] } }, "required": [ "error" ] } ] }, "UpdateSeasonPlanError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_request", "invalid_name", "invalid_event_keys", "too_few_performances", "incompatible_events" ] } }, "required": [ "error" ] } ] }, "DeleteSeasonPlanError400": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_idempotency_key" ] } }, "required": [ "error" ] } ] }, "DeleteSeasonPlanError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden", "module_not_enabled" ] } }, "required": [ "error" ] } ] }, "DeleteSeasonPlanError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found", "plan_not_found" ] } }, "required": [ "error" ] } ] }, "DeleteSeasonPlanError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "season_not_draft", "plan_not_draft", "last_plan", "revision_mismatch" ] } }, "required": [ "error" ] } ] }, "DeleteSeasonPlanError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "too_few_performances" ] } }, "required": [ "error" ] } ] }, "PublishSeasonError400": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_idempotency_key" ] } }, "required": [ "error" ] } ] }, "PublishSeasonError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden", "module_not_enabled" ] } }, "required": [ "error" ] } ] }, "PublishSeasonError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found", "season_not_found", "plan_not_found" ] } }, "required": [ "error" ] } ] }, "PublishSeasonError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "too_few_performances", "publish_pending", "revision_mismatch", "source_group_changed", "chart_mismatch", "chart_unavailable" ] } }, "required": [ "error" ] } ] }, "PublishSeasonError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "channel_restricted_inventory" ] } }, "required": [ "error" ] } ] }, "PublishSeasonError503": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "channel_state_unavailable" ] } }, "required": [ "error" ] } ] }, "CreateSeasonCheckoutTestError400": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_idempotency_key" ] } }, "required": [ "error" ] } ] }, "CreateSeasonCheckoutTestError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden", "module_not_enabled" ] } }, "required": [ "error" ] } ] }, "CreateSeasonCheckoutTestError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found", "plan_not_found" ] } }, "required": [ "error" ] } ] }, "CreateSeasonCheckoutTestError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "season_not_active", "plan_not_published" ] } }, "required": [ "error" ] } ] }, "CreateSeasonCheckoutTestError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_plan_key", "invalid_quantity" ] } }, "required": [ "error" ] } ] }, "ListSeasonCheckoutTestsError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "ReplaceSeasonPackagePricesError400": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_idempotency_key" ] } }, "required": [ "error" ] } ] }, "ReplaceSeasonPackagePricesError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden", "module_not_enabled" ] } }, "required": [ "error" ] } ] }, "ReplaceSeasonPackagePricesError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found", "plan_not_found" ] } }, "required": [ "error" ] } ] }, "ReplaceSeasonPackagePricesError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_prices", "invalid_currency", "currency_mismatch", "invalid_category_key", "duplicate_category_key", "invalid_unit_price" ] } }, "required": [ "error" ] } ] }, "ListSeasonPricesError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "AttachSeasonPlanPerformanceError400": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_idempotency_key" ] } }, "required": [ "error" ] } ] }, "AttachSeasonPlanPerformanceError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden", "module_not_enabled" ] } }, "required": [ "error" ] } ] }, "AttachSeasonPlanPerformanceError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found", "plan_not_found", "event_not_found" ] } }, "required": [ "error" ] } ] }, "AttachSeasonPlanPerformanceError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "season_not_published", "plan_not_published", "revision_mismatch", "amendment_in_flight", "chart_mismatch", "chart_unavailable", "idempotency_conflict" ] } }, "required": [ "error" ] } ] }, "AttachSeasonPlanPerformanceError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_event_key", "incompatible_events", "too_many_performances" ] } }, "required": [ "error" ] } ] }, "DeleteSeasonPlanPerformanceError400": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_idempotency_key" ] } }, "required": [ "error" ] } ] }, "DeleteSeasonPlanPerformanceError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden", "module_not_enabled" ] } }, "required": [ "error" ] } ] }, "DeleteSeasonPlanPerformanceError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found", "plan_not_found" ] } }, "required": [ "error" ] } ] }, "DeleteSeasonPlanPerformanceError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "season_not_published", "plan_not_published", "revision_mismatch", "amendment_in_flight", "idempotency_conflict" ] } }, "required": [ "error" ] } ] }, "DeleteSeasonPlanPerformanceError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "too_few_performances" ] } }, "required": [ "error" ] } ] }, "MarkSeasonPerformancePastError400": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_idempotency_key" ] } }, "required": [ "error" ] } ] }, "MarkSeasonPerformancePastError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden", "module_not_enabled" ] } }, "required": [ "error" ] } ] }, "MarkSeasonPerformancePastError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found", "event_not_found" ] } }, "required": [ "error" ] } ] }, "MarkSeasonPerformancePastError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "season_not_published", "idempotency_conflict" ] } }, "required": [ "error" ] } ] }, "MarkSeasonPerformancePastError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_yet_past" ] } }, "required": [ "error" ] } ] }, "ListSeasonOccurrencesError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found", "season_not_found" ] } }, "required": [ "error" ] } ] }, "ListSeasonOccurrencesError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "plan_not_published", "plan_selection_required" ] } }, "required": [ "error" ] } ] }, "ListSeasonOccurrencesError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_plan_activation_id" ] } }, "required": [ "error" ] } ] }, "ReturnSeasonOccurrenceInventoryError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden", "module_not_enabled" ] } }, "required": [ "error" ] } ] }, "ReturnSeasonOccurrenceInventoryError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "ReturnSeasonOccurrenceInventoryError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "occurrence_action_mismatch", "request_mismatch", "source_not_active", "conflict", "hosted_order_use_date_cancel" ] } }, "required": [ "error" ] } ] }, "ReturnSeasonOccurrenceInventoryError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_request" ] } }, "required": [ "error" ] } ] }, "ReturnSeasonOccurrenceInventoryError503": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "participant_unavailable", "order_edit_in_progress" ] } }, "required": [ "error" ] } ] }, "ReclaimSeasonOccurrenceInventoryError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden", "module_not_enabled" ] } }, "required": [ "error" ] } ] }, "ReclaimSeasonOccurrenceInventoryError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "ReclaimSeasonOccurrenceInventoryError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "occurrence_action_mismatch", "request_mismatch", "source_not_active", "return_not_active", "conflict", "hosted_order_use_date_cancel" ] } }, "required": [ "error" ] } ] }, "ReclaimSeasonOccurrenceInventoryError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_request" ] } }, "required": [ "error" ] } ] }, "ReclaimSeasonOccurrenceInventoryError503": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "participant_unavailable", "order_edit_in_progress" ] } }, "required": [ "error" ] } ] }, "CreateSeasonAmendmentError400": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_idempotency_key" ] } }, "required": [ "error" ] } ] }, "CreateSeasonAmendmentError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden", "module_not_enabled" ] } }, "required": [ "error" ] } ] }, "CreateSeasonAmendmentError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found", "season_not_found", "occurrence_not_in_plan" ] } }, "required": [ "error" ] } ] }, "CreateSeasonAmendmentError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "occurrence_membership_immutable", "occurrence_shared_across_plans", "plan_not_published", "plan_selection_required", "inventory_identity_changed", "idempotency_conflict", "idempotency_in_progress" ] } }, "required": [ "error" ] } ] }, "CreateSeasonAmendmentError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_request", "invalid_kind", "invalid_plan_activation_id" ] } }, "required": [ "error" ] } ] }, "ListSeasonAmendmentsError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "RetrieveSeasonAmendmentError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "RetrieveSeasonReportError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "ListSeasonOperationsError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "RetrieveSeasonSupportLookupError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "RetrieveSeasonSupportLookupError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "lookup_ref_required" ] } }, "required": [ "error" ] } ] }, "ListSeasonOutboxError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "ReplaySeasonOutboxError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "ListSeasonAuditError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "ExportSeasonSupportSnapshotError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "ListSeasonHoldersError400": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_status", "invalid_cursor" ] } }, "required": [ "error" ] } ] }, "ListSeasonHoldersError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "publishable_key_not_allowed" ] } }, "required": [ "error" ] } ] }, "ListSeasonHoldersError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "RefundSeasonOrderError400": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "idempotency_key_required", "invalid_idempotency_key" ] } }, "required": [ "error" ] } ] }, "RefundSeasonOrderError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "publishable_key_not_allowed" ] } }, "required": [ "error" ] } ] }, "RefundSeasonOrderError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "RefundSeasonOrderError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_refundable", "already_refunded", "gateway_not_connected", "order_edit_in_progress", "refund_unavailable", "refund_failed", "idempotency_conflict", "idempotency_in_progress" ] } }, "required": [ "error" ] } ] }, "RefundSeasonOrderError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_amount" ] } }, "required": [ "error" ] } ] }, "RefundSeasonOrderError502": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "refund_recovery_required" ] } }, "required": [ "error" ] } ] }, "CancelSeasonOrderError400": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "idempotency_key_required", "invalid_idempotency_key" ] } }, "required": [ "error" ] } ] }, "CancelSeasonOrderError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "publishable_key_not_allowed" ] } }, "required": [ "error" ] } ] }, "CancelSeasonOrderError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "CancelSeasonOrderError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "box_office_order_use_dashboard", "not_online_order", "order_edit_in_progress", "refund_in_progress", "order_not_cancellable", "order_changed", "payment_method_unknown", "cancellation_reconciliation_required", "idempotency_conflict", "idempotency_in_progress" ] } }, "required": [ "error" ] } ] }, "CancelSeasonOrderError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_reason", "cancellation_reason_required", "used_tickets_acknowledgement_required", "external_refund_confirmation_required" ] } }, "required": [ "error" ] } ] }, "CancelSeasonOrderDateError400": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "idempotency_key_required", "invalid_idempotency_key" ] } }, "required": [ "error" ] } ] }, "CancelSeasonOrderDateError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "publishable_key_not_allowed" ] } }, "required": [ "error" ] } ] }, "CancelSeasonOrderDateError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "CancelSeasonOrderDateError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "order_not_active", "date_not_held", "date_already_used", "idempotency_conflict", "idempotency_in_progress" ] } }, "required": [ "error" ] } ] }, "CancelSeasonOrderDateError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_request" ] } }, "required": [ "error" ] } ] }, "ResendSeasonOrderTicketsError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "publishable_key_not_allowed" ] } }, "required": [ "error" ] } ] }, "ResendSeasonOrderTicketsError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "ResendSeasonOrderTicketsError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "no_tickets", "no_buyer_email", "order_edit_in_progress", "order_changed" ] } }, "required": [ "error" ] } ] }, "ResendSeasonOrderTicketsError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_email" ] } }, "required": [ "error" ] } ] }, "ResendSeasonOrderTicketsError502": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "resend_failed" ] } }, "required": [ "error" ] } ] }, "RetrieveSeasonHostedRenewalsError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "publishable_key_not_allowed" ] } }, "required": [ "error" ] } ] }, "RetrieveSeasonHostedRenewalsError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "RotateSeasonRenewalOfferLinkError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "publishable_key_not_allowed" ] } }, "required": [ "error" ] } ] }, "RotateSeasonRenewalOfferLinkError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "UpdateSeasonRenewalOfferContactError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "publishable_key_not_allowed" ] } }, "required": [ "error" ] } ] }, "UpdateSeasonRenewalOfferContactError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "UpdateSeasonRenewalOfferContactError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_holder_email", "invalid_holder_name" ] } }, "required": [ "error" ] } ] }, "CreateSeasonRenewalNoticesError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "publishable_key_not_allowed" ] } }, "required": [ "error" ] } ] }, "CreateSeasonRenewalNoticesError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "CreateSeasonRenewalNoticesError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "checkout_mode_not_seatlayer" ] } }, "required": [ "error" ] } ] }, "ResendSeasonRenewalOfferError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "publishable_key_not_allowed" ] } }, "required": [ "error" ] } ] }, "ResendSeasonRenewalOfferError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "ResendSeasonRenewalOfferError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "offer_not_open", "checkout_mode_not_seatlayer" ] } }, "required": [ "error" ] } ] }, "ResendSeasonRenewalOfferError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "holder_email_missing" ] } }, "required": [ "error" ] } ] }, "RetrieveSeasonSalesReportError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "publishable_key_not_allowed" ] } }, "required": [ "error" ] } ] }, "RetrieveSeasonSalesReportError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "RetrieveSeasonSeatsReportError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "publishable_key_not_allowed" ] } }, "required": [ "error" ] } ] }, "RetrieveSeasonSeatsReportError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "ExportSeasonHoldersCsvError400": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_status", "invalid_cursor" ] } }, "required": [ "error" ] } ] }, "ExportSeasonHoldersCsvError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "publishable_key_not_allowed" ] } }, "required": [ "error" ] } ] }, "ExportSeasonHoldersCsvError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "ExportSeasonHoldersCsvError413": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "download_too_large" ] } }, "required": [ "error" ] } ] }, "ExportSeasonHoldersCsvError503": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "holders_unavailable" ] } }, "required": [ "error" ] } ] }, "ExportSeasonOrdersCsvError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "publishable_key_not_allowed" ] } }, "required": [ "error" ] } ] }, "ExportSeasonOrdersCsvError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "ExportSeasonOrdersCsvError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "season_sold_elsewhere" ] } }, "required": [ "error" ] } ] }, "RetrieveSeasonSeatCountsError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "publishable_key_not_allowed" ] } }, "required": [ "error" ] } ] }, "RetrieveSeasonSeatCountsError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "CreateWebhookError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden" ] } }, "required": [ "error" ] } ] }, "CreateWebhookError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_url", "invalid_events", "invalid_mode", "invalid_environment" ] } }, "required": [ "error" ] } ] }, "UpdateWebhookError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden" ] } }, "required": [ "error" ] } ] }, "UpdateWebhookError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "UpdateWebhookError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_url", "invalid_events", "invalid_mode", "invalid_environment" ] } }, "required": [ "error" ] } ] }, "DeleteWebhookError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden" ] } }, "required": [ "error" ] } ] }, "DeleteWebhookError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "RotateWebhookSecretError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden" ] } }, "required": [ "error" ] } ] }, "RotateWebhookSecretError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "ListWebhookDeliveriesError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "CreateWorkspaceError400": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_idempotency_key" ] } }, "required": [ "error" ] } ] }, "CreateWorkspaceError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden" ] } }, "required": [ "error" ] } ] }, "CreateWorkspaceError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "external_ref_exists", "idempotency_conflict", "idempotency_in_progress" ] } }, "required": [ "error" ] } ] }, "CreateWorkspaceError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_name", "invalid_external_ref", "invalid_region" ] } }, "required": [ "error" ] } ] }, "UpdateWorkspaceError403": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "forbidden" ] } }, "required": [ "error" ] } ] }, "UpdateWorkspaceError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] }, "UpdateWorkspaceError409": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "default_workspace_required", "default_workspace_must_be_active", "external_ref_exists" ] } }, "required": [ "error" ] } ] }, "UpdateWorkspaceError422": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "invalid_name", "invalid_external_ref", "invalid_status", "invalid_default", "invalid_region" ] } }, "required": [ "error" ] } ] }, "RetrieveWorkspaceError404": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "not_found" ] } }, "required": [ "error" ] } ] } } } }