{ "schemaVersion": 2, "releaseTruth": { "sourceSnapshot": "mixed-release", "publishedArtifacts": "partially-verified", "note": "Published verification is explicit per SDK lane; consult each operation support cell before relying on a package release." }, "scope": { "operations": "stable-public-only" }, "counts": { "stablePublicOperations": 182 }, "operations": [ { "operationId": "getReadiness", "method": "GET", "path": "/health/ready", "summary": "Check API readiness and required dependencies", "tag": "Health", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "none" }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [], "queryParameters": [ { "name": "deep", "description": "Set to 1 to include a deeper dependency probe.", "schema": { "type": "string", "enum": [ "1" ] } } ] }, "success": { "primary": { "status": 200, "schema": "ReadinessReport", "description": "API and dependencies are ready or degraded." }, "alternates": [ { "status": 503, "schema": "ReadinessReport", "description": "A required dependency is unavailable." } ] }, "reliability": { "idempotency": "not-applicable", "automaticRetry": true, "retryClass": "transient-read", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "readiness", "audience": "all", "limit": 30, "windowSeconds": 60, "bucket": "ip", "standardHeaders": false } ], "errors": [ { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/start/going-live/", "url": "https://docs.seatlayer.io/start/going-live/" } }, { "operationId": "listCharts", "method": "GET", "path": "/v1/charts", "summary": "List charts in the account", "tag": "Charts", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [], "queryParameters": [ { "name": "workspaceId", "description": "Active workspace id. Defaults to the caller workspace.", "schema": { "type": "string" } }, { "name": "externalRef", "description": "Filter by the caller-owned external reference.", "schema": { "type": "string" } }, { "name": "archived", "description": "Set to 1 for archived charts only.", "schema": { "type": "string", "enum": [ "1" ] } }, { "name": "limit", "description": "Page size. Defaults to 100 and is capped at 200.", "schema": { "type": "integer", "minimum": 1, "maximum": 200 } }, { "name": "cursor", "description": "Opaque cursor returned by the previous page.", "schema": { "type": "string" } } ] }, "success": { "primary": { "status": 200, "schema": "ChartPage", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "not-applicable", "automaticRetry": true, "retryClass": "transient-read", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "workspace_not_found_or_disabled" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/designer/charts-and-objects/", "url": "https://docs.seatlayer.io/designer/charts-and-objects/" } }, { "operationId": "createChart", "method": "POST", "path": "/v1/charts", "summary": "Create a chart", "tag": "Charts", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": true, "schema": "ChartCreateRequest", "contentTypes": [ "application/json" ], "pathParameters": [], "queryParameters": [] }, "success": { "primary": { "status": 201, "schema": "ChartEnvelope", "description": "Chart created." }, "alternates": [] }, "reliability": { "idempotency": "header-replay", "automaticRetry": true, "retryClass": "exact-header-replay", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [], "errors": [ { "status": 400, "sources": [ "business" ], "codes": [ "name_required", "invalid_idempotency_key" ], "reasons": [], "descriptions": [ "The request is malformed or misses a required value." ] }, { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "idempotency_conflict", "idempotency_in_progress" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "workspace_not_found_or_disabled", "invalid_chart" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/designer/charts-and-objects/", "url": "https://docs.seatlayer.io/designer/charts-and-objects/" } }, { "operationId": "retrieveChart", "method": "GET", "path": "/v1/charts/{chartId}", "summary": "Retrieve a chart and its document", "tag": "Charts", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "name": "chartId", "in": "path", "required": true, "description": "Resource identifier.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "ChartDocument", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "not-applicable", "automaticRetry": true, "retryClass": "transient-read", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/designer/charts-and-objects/", "url": "https://docs.seatlayer.io/designer/charts-and-objects/" } }, { "operationId": "updateChart", "method": "PUT", "path": "/v1/charts/{chartId}", "summary": "Replace a chart document (requires expectedUpdatedAt)", "tag": "Charts", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": true, "schema": "ChartUpdateRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "name": "chartId", "in": "path", "required": true, "description": "Resource identifier.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "ChartSaveEnvelope", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "unsupported", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [], "errors": [ { "status": 400, "sources": [ "business" ], "codes": [ "expectedUpdatedAt_required" ], "reasons": [], "descriptions": [ "The request is malformed or misses a required value." ] }, { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden", "edit_not_allowed", "feature_policy_violation" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found", "chart_not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "conflict", "draft_snapshot_missing", "draft_snapshot_invalid", "safe_mode_violation", "published_snapshot_missing", "published_snapshot_invalid" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 413, "sources": [ "business" ], "codes": [ "chart_too_large" ], "reasons": [], "descriptions": [ "The request body exceeds the supported size." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "invalid_chart" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [ { "surface": "chart-semantic-audit", "actions": [ "chart.update" ], "when": "A semantic chart update is committed.", "visibility": "internal" } ] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/designer/charts-and-objects/", "url": "https://docs.seatlayer.io/designer/charts-and-objects/" } }, { "operationId": "deleteChart", "method": "DELETE", "path": "/v1/charts/{chartId}", "summary": "Delete a chart", "tag": "Charts", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "name": "chartId", "in": "path", "required": true, "description": "Resource identifier.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "DeleteChartResult", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "unsupported", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/designer/charts-and-objects/", "url": "https://docs.seatlayer.io/designer/charts-and-objects/" } }, { "operationId": "copyChart", "method": "POST", "path": "/v1/charts/{chartId}/duplicate", "summary": "Copy a chart", "tag": "Charts", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": false, "schema": "ChartCopyRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "name": "chartId", "in": "path", "required": true, "description": "Resource identifier.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 201, "schema": "ChartEnvelope", "description": "Chart copied." }, "alternates": [] }, "reliability": { "idempotency": "header-replay", "automaticRetry": true, "retryClass": "exact-header-replay", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [], "errors": [ { "status": 400, "sources": [ "business" ], "codes": [ "invalid_idempotency_key" ], "reasons": [], "descriptions": [ "The request is malformed or misses a required value." ] }, { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "idempotency_conflict", "idempotency_in_progress" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "workspace_not_found_or_disabled" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/designer/templates/", "url": "https://docs.seatlayer.io/designer/templates/" } }, { "operationId": "archiveChart", "method": "POST", "path": "/v1/charts/{chartId}/archive", "summary": "Move a chart to the archive", "tag": "Charts", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "name": "chartId", "in": "path", "required": true, "description": "Resource identifier.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "ChartEnvelope", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "unsupported", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/designer/charts-and-objects/", "url": "https://docs.seatlayer.io/designer/charts-and-objects/" } }, { "operationId": "unarchiveChart", "method": "POST", "path": "/v1/charts/{chartId}/unarchive", "summary": "Restore a chart from the archive", "tag": "Charts", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "name": "chartId", "in": "path", "required": true, "description": "Resource identifier.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "ChartEnvelope", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "unsupported", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/designer/charts-and-objects/", "url": "https://docs.seatlayer.io/designer/charts-and-objects/" } }, { "operationId": "publishChart", "method": "POST", "path": "/v1/charts/{chartId}/publish", "summary": "Publish the chart draft so events can use it", "tag": "Charts", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "name": "chartId", "in": "path", "required": true, "description": "Resource identifier.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "PublishChartResult", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "unsupported", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "review_required", "conflict" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "nothing_to_publish", "invalid_chart" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/designer/publishing-and-versioning/", "url": "https://docs.seatlayer.io/designer/publishing-and-versioning/" } }, { "operationId": "createPanoramaManifestJob", "method": "POST", "path": "/v1/charts/{chartId}/panorama-manifests", "summary": "Start a private panorama manifest ingest job for an exact chart draft revision", "tag": "Charts", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": true, "schema": "PanoramaManifestCreateRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "name": "chartId", "in": "path", "required": true, "description": "chartId path parameter.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 202, "schema": "PanoramaManifestCreateResult", "description": "Private processing job accepted." }, "alternates": [ { "status": 200, "schema": "PanoramaManifestCreateResult", "description": "An identical existing job was returned." } ] }, "reliability": { "idempotency": "unsupported", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [ { "policy": "panorama-manifest-create", "audience": "secret-key", "limit": 10, "windowSeconds": 86400, "bucket": "org-chart", "standardHeaders": false } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden", "module_not_enabled" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "chart_not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "chart_empty", "conflict" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 413, "sources": [ "business" ], "codes": [ "manifest_too_large" ], "reasons": [], "descriptions": [ "The request body exceeds the supported size." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "invalid_request", "manifest_invalid", "attachments_required", "attachments_unreferenced" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "business", "maintenance" ], "codes": [ "queue_unavailable", "maintenance_mode" ], "reasons": [], "descriptions": [ "The service or one of its required dependencies is temporarily unavailable.", "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" } }, "docs": { "path": "/designer/charts-and-objects/", "url": "https://docs.seatlayer.io/designer/charts-and-objects/" } }, { "operationId": "retrievePanoramaManifestJob", "method": "GET", "path": "/v1/charts/{chartId}/panorama-manifests/{jobId}", "summary": "Retrieve source-redacted panorama manifest processing status", "tag": "Charts", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "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" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "PanoramaManifestStatusResult", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "not-applicable", "automaticRetry": true, "retryClass": "transient-read", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "chart_not_found", "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" } }, "docs": { "path": "/designer/charts-and-objects/", "url": "https://docs.seatlayer.io/designer/charts-and-objects/" } }, { "operationId": "instantiateTemplate", "method": "POST", "path": "/v1/templates/{templateId}/instantiate", "summary": "Instantiate a published template as a workspace chart draft", "tag": "Templates", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": true, "schema": "TemplateInstantiateRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "name": "templateId", "in": "path", "required": true, "description": "Published catalog template identifier.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 201, "schema": "ChartEnvelope", "description": "Template instantiated as a draft chart." }, "alternates": [] }, "reliability": { "idempotency": "header-replay", "automaticRetry": true, "retryClass": "exact-header-replay", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [], "errors": [ { "status": 400, "sources": [ "business" ], "codes": [ "invalid_request", "invalid_idempotency_key" ], "reasons": [], "descriptions": [ "The request is malformed or misses a required value." ] }, { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "template_not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "template_version_mismatch", "idempotency_conflict", "idempotency_in_progress" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 413, "sources": [ "business" ], "codes": [ "payload_too_large" ], "reasons": [], "descriptions": [ "The request body exceeds the supported size." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "invalid_version", "invalid_chart", "unsafe_chart_asset", "workspace_not_found_or_disabled" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "business", "maintenance" ], "codes": [ "template_artifact_unavailable", "template_integrity_error", "maintenance_mode" ], "reasons": [], "descriptions": [ "The service or one of its required dependencies is temporarily unavailable.", "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/designer/templates/", "url": "https://docs.seatlayer.io/designer/templates/" } }, { "operationId": "listEvents", "method": "GET", "path": "/v1/events", "summary": "List events", "tag": "Events", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [], "queryParameters": [ { "name": "workspaceId", "description": "Active workspace id. Defaults to the caller workspace.", "schema": { "type": "string" } }, { "name": "externalRef", "description": "Filter by the caller-owned external reference.", "schema": { "type": "string" } }, { "name": "limit", "description": "Page size. Defaults to 100 and is capped at 200.", "schema": { "type": "integer", "minimum": 1, "maximum": 200 } }, { "name": "cursor", "description": "Opaque cursor returned by the previous page.", "schema": { "type": "string" } }, { "name": "counts", "description": "Set to 0 to omit inventory counts.", "schema": { "type": "string", "enum": [ "0" ] } } ] }, "success": { "primary": { "status": 200, "schema": "EventPage", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "not-applicable", "automaticRetry": true, "retryClass": "transient-read", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "workspace_not_found_or_disabled" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/events/", "url": "https://docs.seatlayer.io/server-api/events/" } }, { "operationId": "createEvent", "method": "POST", "path": "/v1/events", "summary": "Create an event from a published chart", "tag": "Events", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": true, "schema": "EventCreateRequest", "contentTypes": [ "application/json" ], "pathParameters": [], "queryParameters": [] }, "success": { "primary": { "status": 201, "schema": "EventEnvelope", "description": "Event created." }, "alternates": [] }, "reliability": { "idempotency": "header-replay", "automaticRetry": true, "retryClass": "exact-header-replay", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [], "errors": [ { "status": 400, "sources": [ "business" ], "codes": [ "chartId_required", "invalid_idempotency_key" ], "reasons": [], "descriptions": [ "The request is malformed or misses a required value." ] }, { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 402, "sources": [ "business" ], "codes": [ "insufficient_credits" ], "reasons": [], "descriptions": [ "The account does not have enough credits for this operation." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "chart_not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "event_exists", "idempotency_conflict", "idempotency_in_progress" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "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" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [ { "event": "event.created", "when": "After event materialization succeeds." } ], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/events/", "url": "https://docs.seatlayer.io/server-api/events/" } }, { "operationId": "copyEvent", "method": "POST", "path": "/v1/events/{eventKey}/duplicate", "summary": "Copy an event, its settings and optionally its blocks and channels", "tag": "Events", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": false, "schema": "EventCopyRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 201, "schema": "EventEnvelope", "description": "Event copied." }, "alternates": [] }, "reliability": { "idempotency": "header-replay", "automaticRetry": true, "retryClass": "exact-header-replay", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [], "errors": [ { "status": 400, "sources": [ "business" ], "codes": [ "invalid_idempotency_key" ], "reasons": [], "descriptions": [ "The request is malformed or misses a required value." ] }, { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 402, "sources": [ "business" ], "codes": [ "insufficient_credits" ], "reasons": [], "descriptions": [ "The account does not have enough credits for this operation." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden", "mode_mismatch" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "event_exists", "idempotency_conflict", "idempotency_in_progress" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "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" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [ { "event": "event.created", "when": "After the copy is materialized." } ], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/events/", "url": "https://docs.seatlayer.io/server-api/events/" } }, { "operationId": "retrieveEvent", "method": "GET", "path": "/v1/events/{eventKey}", "summary": "Retrieve an event", "tag": "Events", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "EventDetail", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "not-applicable", "automaticRetry": true, "retryClass": "transient-read", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "mode_mismatch" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/events/", "url": "https://docs.seatlayer.io/server-api/events/" } }, { "operationId": "retrieveEventConfigurationBinding", "method": "GET", "path": "/v1/events/{eventKey}/event-configuration", "summary": "Retrieve an Event’s exact immutable configuration binding and audit history", "tag": "Events", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "EventConfigurationBinding", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "not-applicable", "automaticRetry": true, "retryClass": "transient-read", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found", "version_not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "configuration_inventory_state_conflict", "configuration_inventory_seat_conflict" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "business" ], "codes": [ "configuration_artifact_unavailable", "configuration_artifact_integrity_error", "configuration_inventory_state_invalid", "configuration_inventory_state_conflict" ], "reasons": [], "descriptions": [ "The service or one of its required dependencies is temporarily unavailable." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/events/", "url": "https://docs.seatlayer.io/server-api/events/" } }, { "operationId": "updateEventConfigurationBinding", "method": "PUT", "path": "/v1/events/{eventKey}/event-configuration", "summary": "Bind or detach an exact published Event configuration version", "tag": "Events", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": true, "schema": "EventConfigurationBindingUpdateRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "EventConfigurationBinding", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "unsupported", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "module_not_enabled" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found", "version_not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "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" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "invalid_request" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "business", "maintenance" ], "codes": [ "configuration_artifact_unavailable", "configuration_artifact_integrity_error", "event_chart_unavailable", "configuration_inventory_state_invalid", "configuration_inventory_state_conflict", "configuration_inventory_commit_pending", "maintenance_mode" ], "reasons": [], "descriptions": [ "The service or one of its required dependencies is temporarily unavailable.", "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [ { "event": "seat.blocked", "when": "New configuration-owned production kills remove free seats from sale." }, { "event": "seat.released", "when": "Superseded configuration-owned kills return to sale unless another block owner remains." } ], "audit": [ { "surface": "event-configuration-binding-audit", "actions": [ "attach", "replace", "detach" ], "when": "The exact immutable Event configuration binding changes.", "visibility": "public-api" }, { "surface": "event-log", "actions": [ "configuration-kill-initialized", "configuration-kill-prepared", "configuration-kill-committed", "configuration-kill-aborted" ], "when": "A successful state change is applied.", "visibility": "public-api" } ] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/events/", "url": "https://docs.seatlayer.io/server-api/events/" } }, { "operationId": "updateEvent", "method": "PATCH", "path": "/v1/events/{eventKey}", "summary": "Update event metadata", "tag": "Events", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": true, "schema": "EventUpdateRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "EventEnvelope", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "unsupported", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [], "errors": [ { "status": 400, "sources": [ "business" ], "codes": [ "nothing_to_update" ], "reasons": [], "descriptions": [ "The request is malformed or misses a required value." ] }, { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "mode_mismatch" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found", "chart_unavailable" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "performance_group_locked", "season_event_locked" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "invalid_section_states", "unknown_section", "invalid_section_state", "invalid_currency", "invalid_description", "invalid_ends_at", "invalid_timezone", "invalid_locale", "ends_before_starts" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [ { "surface": "event-log", "actions": [ "section-states" ], "when": "The optional sectionStates map changes event availability.", "visibility": "public-api" } ] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/events/", "url": "https://docs.seatlayer.io/server-api/events/" } }, { "operationId": "deleteEvent", "method": "DELETE", "path": "/v1/events/{eventKey}", "summary": "Delete an event", "tag": "Events", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "Ok", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "unsupported", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "mode_mismatch" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "performance_group_locked", "season_event_locked" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/events/", "url": "https://docs.seatlayer.io/server-api/events/" } }, { "operationId": "updateEventPoster", "method": "PUT", "path": "/v1/events/{eventKey}/poster", "summary": "Upload the event poster used on share cards", "tag": "Events", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "binary", "required": true, "schema": "BinaryImage", "contentTypes": [ "image/png", "image/jpeg", "image/webp", "application/octet-stream" ], "pathParameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "EventEnvelope", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "unsupported", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [], "errors": [ { "status": 400, "sources": [ "business" ], "codes": [ "empty_body" ], "reasons": [], "descriptions": [ "The request is malformed or misses a required value." ] }, { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "mode_mismatch", "forbidden" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 413, "sources": [ "business" ], "codes": [ "image_too_large" ], "reasons": [], "descriptions": [ "The request body exceeds the supported size." ] }, { "status": 415, "sources": [ "business" ], "codes": [ "unsupported_image" ], "reasons": [], "descriptions": [ "The request media type or bytes are unsupported." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "image_dimensions_unsupported" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/events/", "url": "https://docs.seatlayer.io/server-api/events/" } }, { "operationId": "deleteEventPoster", "method": "DELETE", "path": "/v1/events/{eventKey}/poster", "summary": "Remove the event poster", "tag": "Events", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "EventEnvelope", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "unsupported", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "mode_mismatch", "forbidden" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found", "no_poster" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/events/", "url": "https://docs.seatlayer.io/server-api/events/" } }, { "operationId": "updateEventChart", "method": "POST", "path": "/v1/events/{eventKey}/update-chart", "summary": "Re-point a live event at the latest published chart", "tag": "Events", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": false, "schema": "EventChartUpdateRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "EventChartUpdateResult", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "unsupported", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "mode_mismatch" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found", "chart_not_found", "chart_unavailable" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "event_not_mutable", "event_configuration_bound", "channel_assignment_would_drop", "season_inventory_locked", "seats_would_vanish", "order_edit_in_progress" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [ { "surface": "event-log", "actions": [ "chart-update" ], "when": "A successful state change is applied.", "visibility": "public-api" } ] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/designer/publishing-and-versioning/", "url": "https://docs.seatlayer.io/designer/publishing-and-versioning/" } }, { "operationId": "closeEvent", "method": "POST", "path": "/v1/events/{eventKey}/close", "summary": "Close sales for an event", "tag": "Events", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "SalesAliasResult", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "unsupported", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "mode_mismatch" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "event_not_mutable", "invalid_sales_transition", "sales_revision_conflict" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [ { "surface": "sales-transition-audit", "actions": [ "live->paused" ], "when": "The sales state changes.", "visibility": "internal" } ] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/events/", "url": "https://docs.seatlayer.io/server-api/events/" } }, { "operationId": "reopenEvent", "method": "POST", "path": "/v1/events/{eventKey}/reopen", "summary": "Reopen sales for an event", "tag": "Events", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "SalesAliasResult", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "unsupported", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "mode_mismatch" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "event_not_mutable", "invalid_sales_transition", "sales_not_ready", "sales_revision_conflict" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [ { "surface": "sales-transition-audit", "actions": [ "paused->live" ], "when": "The sales state changes.", "visibility": "internal" } ] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/events/", "url": "https://docs.seatlayer.io/server-api/events/" } }, { "operationId": "archiveEvent", "method": "POST", "path": "/v1/events/{eventKey}/archive", "summary": "Move an event to the archive", "tag": "Events", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "ArchiveEventResult", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "unsupported", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "mode_mismatch" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "event_not_mutable", "performance_group_locked", "season_event_locked" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/events/", "url": "https://docs.seatlayer.io/server-api/events/" } }, { "operationId": "unarchiveEvent", "method": "POST", "path": "/v1/events/{eventKey}/unarchive", "summary": "Restore an archived event with buyer sales still paused", "tag": "Events", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "UnarchiveEventResult", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "unsupported", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "mode_mismatch" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "event_not_archived", "sales_revision_conflict" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [ { "surface": "sales-transition-audit", "actions": [ "live->paused" ], "when": "A legacy live event is restored from the archive.", "visibility": "internal" } ] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/events/", "url": "https://docs.seatlayer.io/server-api/events/" } }, { "operationId": "listTicketReleases", "method": "GET", "path": "/v1/events/{eventKey}/releases", "summary": "List ticket releases with live quota consumption", "tag": "Events", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "TicketReleaseList", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "not-applicable", "automaticRetry": true, "retryClass": "transient-read", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "mode_mismatch" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/events/", "url": "https://docs.seatlayer.io/server-api/events/" } }, { "operationId": "updateTicketReleases", "method": "PUT", "path": "/v1/events/{eventKey}/releases", "summary": "Replace the ordered ticket-release list", "tag": "Events", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": true, "schema": "TicketReleaseReplaceRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "TicketReleaseList", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "unsupported", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "mode_mismatch" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "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" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/events/", "url": "https://docs.seatlayer.io/server-api/events/" } }, { "operationId": "closeTicketRelease", "method": "POST", "path": "/v1/events/{eventKey}/releases/{releaseId}/close", "summary": "Close one ticket release immediately", "tag": "Events", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "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" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "TicketReleaseList", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "unsupported", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "mode_mismatch" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found", "release_not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/events/", "url": "https://docs.seatlayer.io/server-api/events/" } }, { "operationId": "holdObjects", "method": "POST", "path": "/v1/events/{eventKey}/hold", "summary": "Hold objects for a buyer", "tag": "Inventory", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": true, "schema": "HoldRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 201, "schema": "HoldResponse", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "unsupported", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [ { "policy": "server-inventory", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 400, "sources": [ "business" ], "codes": [ "selections_required" ], "reasons": [], "descriptions": [ "The request is malformed or misses a required value." ] }, { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "mode_mismatch", "channel_access_denied" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "event_closed", "conflict" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "hold_quantity_exceeded", "invalid_selection" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [ { "event": "hold.created", "when": "A hold is created or replaces another hold." }, { "event": "seat.released", "when": "A replacement removes labels from the prior hold." } ], "audit": [ { "surface": "event-log", "actions": [ "hold", "hold.replace" ], "when": "A successful state change is applied.", "visibility": "public-api" } ] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/holds/", "url": "https://docs.seatlayer.io/server-api/holds/" } }, { "operationId": "extendHold", "method": "POST", "path": "/v1/events/{eventKey}/extend", "summary": "Extend an active hold before it expires", "tag": "Inventory", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": true, "schema": "ExtendHoldRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "ExtendHoldResult", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "unsupported", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [ { "policy": "server-inventory", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 400, "sources": [ "business" ], "codes": [ "holdId_required" ], "reasons": [], "descriptions": [ "The request is malformed or misses a required value." ] }, { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "mode_mismatch", "channel_access_denied" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "cannot_extend", "order_edit_in_progress" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [ { "event": "hold.extended", "when": "An active hold expiry is extended." } ], "audit": [ { "surface": "event-log", "actions": [ "hold.extend" ], "when": "A successful state change is applied.", "visibility": "public-api" } ] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/holds/", "url": "https://docs.seatlayer.io/server-api/holds/" } }, { "operationId": "holdBestAvailable", "method": "POST", "path": "/v1/events/{eventKey}/best-available", "summary": "Pick and hold the best available objects", "tag": "Inventory", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": true, "schema": "BestAvailableRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "BestAvailableHoldResponse", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "unsupported", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [ { "policy": "server-inventory", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 400, "sources": [ "business" ], "codes": [ "qty_required", "invalid_zone" ], "reasons": [], "descriptions": [ "The request is malformed or misses a required value." ] }, { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "mode_mismatch", "channel_access_denied" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found", "chart_unavailable" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "event_closed", "conflict" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "unknown_zone", "invalid_selection" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [ { "event": "hold.created", "when": "The selected best-available objects are held." } ], "audit": [ { "surface": "event-log", "actions": [ "hold" ], "when": "A successful state change is applied.", "visibility": "public-api" } ] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/holds/", "url": "https://docs.seatlayer.io/server-api/holds/" } }, { "operationId": "blockBestAvailable", "method": "POST", "path": "/v1/events/{eventKey}/best-available-block", "summary": "Pick and temporarily block the best available objects", "tag": "Inventory", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": true, "schema": "BestAvailableBlockRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "BestAvailableBlockResponse", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "unsupported", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [ { "policy": "server-inventory", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 400, "sources": [ "business" ], "codes": [ "qty_required", "invalid_zone", "releaseAt_required", "blockRef_required" ], "reasons": [], "descriptions": [ "The request is malformed or misses a required value." ] }, { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "mode_mismatch", "channel_access_denied" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found", "chart_unavailable" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "event_closed", "conflict" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "unknown_zone", "invalid_selection" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [ { "event": "seat.blocked", "when": "The selected best-available objects are temporarily blocked." } ], "audit": [ { "surface": "event-log", "actions": [ "block" ], "when": "A successful state change is applied.", "visibility": "public-api" } ] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/holds/", "url": "https://docs.seatlayer.io/server-api/holds/" } }, { "operationId": "bookBestAvailable", "method": "POST", "path": "/v1/events/{eventKey}/best-available-book", "summary": "Pick and book the best available objects in one call", "tag": "Inventory", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": true, "schema": "BestAvailableBookRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "BestAvailableBookResponse", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "unsupported", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [ { "policy": "server-inventory", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 400, "sources": [ "business" ], "codes": [ "bookingRef_required", "qty_required", "invalid_zone" ], "reasons": [], "descriptions": [ "The request is malformed or misses a required value." ] }, { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "mode_mismatch", "channel_access_denied" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found", "chart_unavailable" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "event_closed", "conflict" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "unknown_zone", "invalid_selection" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [ { "event": "seat.booked", "when": "The selected best-available objects are booked." }, { "event": "event.soldout", "when": "The booking consumes the last free inventory, once per event." } ], "audit": [ { "surface": "event-log", "actions": [ "book" ], "when": "A successful state change is applied.", "visibility": "public-api" }, { "surface": "inventory-booking-lifecycle", "actions": [ "book" ], "when": "A booking lifecycle write or exact replay is recorded.", "visibility": "public-api" } ] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/booking/", "url": "https://docs.seatlayer.io/server-api/booking/" } }, { "operationId": "retrieveHold", "method": "GET", "path": "/v1/events/{eventKey}/holds/{holdId}", "summary": "Retrieve a hold with authoritative pricing", "tag": "Inventory", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "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" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "HoldInspection", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "not-applicable", "automaticRetry": true, "retryClass": "transient-read", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "mode_mismatch", "channel_access_denied" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found", "hold_not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "legacy_hold_requires_restart" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/integrations/ticketing-backend/", "url": "https://docs.seatlayer.io/integrations/ticketing-backend/" } }, { "operationId": "releaseObjects", "method": "POST", "path": "/v1/events/{eventKey}/release", "summary": "Release held objects", "tag": "Inventory", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": true, "schema": "ReleaseRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "ReleaseResult", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "unsupported", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [], "errors": [ { "status": 400, "sources": [ "business" ], "codes": [ "labels_and_holdId_required" ], "reasons": [], "descriptions": [ "The request is malformed or misses a required value." ] }, { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "mode_mismatch" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "order_edit_in_progress" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [ { "event": "seat.released", "when": "Held objects are returned to free inventory." } ], "audit": [ { "surface": "event-log", "actions": [ "release" ], "when": "A successful state change is applied.", "visibility": "public-api" } ] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/holds/", "url": "https://docs.seatlayer.io/server-api/holds/" } }, { "operationId": "bookObjects", "method": "POST", "path": "/v1/events/{eventKey}/book", "summary": "Book objects, by hold id or by label", "tag": "Inventory", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": true, "schema": "BookRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "BookResult", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "domain-exact-booking-ref", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [], "errors": [ { "status": 400, "sources": [ "business" ], "codes": [ "hold_or_labels_and_bookingRef_required", "blockRef_invalid", "holdId_and_blockRef_mutually_exclusive" ], "reasons": [], "descriptions": [ "The request is malformed or misses a required value." ] }, { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "mode_mismatch", "channel_access_denied" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "hold_not_active", "legacy_hold_requires_restart", "conflict" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [ { "event": "seat.booked", "when": "Objects are newly booked." }, { "event": "event.soldout", "when": "The booking consumes the last free inventory, once per event." } ], "audit": [ { "surface": "event-log", "actions": [ "book" ], "when": "A successful state change is applied.", "visibility": "public-api" }, { "surface": "inventory-booking-lifecycle", "actions": [ "book", "replay" ], "when": "A booking lifecycle write or exact replay is recorded.", "visibility": "public-api" } ] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/booking/", "url": "https://docs.seatlayer.io/server-api/booking/" } }, { "operationId": "boxOfficeBookObjects", "method": "POST", "path": "/v1/events/{eventKey}/box-book", "summary": "Book objects directly without creating commerce artifacts", "tag": "Inventory", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": true, "schema": "BoxOfficeBookRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "BookResult", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "domain-exact-booking-ref", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [], "errors": [ { "status": 400, "sources": [ "business" ], "codes": [ "labels_and_bookingRef_required" ], "reasons": [], "descriptions": [ "The request is malformed or misses a required value." ] }, { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "mode_mismatch", "channel_access_denied", "forbidden" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "conflict" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [ { "event": "seat.booked", "when": "Objects are newly booked." }, { "event": "event.soldout", "when": "The booking consumes the last free inventory, once per event." } ], "audit": [ { "surface": "event-log", "actions": [ "book" ], "when": "A successful state change is applied.", "visibility": "public-api" }, { "surface": "inventory-booking-lifecycle", "actions": [ "book", "replay" ], "when": "A booking lifecycle write or exact replay is recorded.", "visibility": "public-api" } ] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/cancellations-and-box-office/", "url": "https://docs.seatlayer.io/server-api/cancellations-and-box-office/" } }, { "operationId": "unbookObjects", "method": "POST", "path": "/v1/events/{eventKey}/unbook", "summary": "Release previously booked objects", "tag": "Inventory", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": true, "tokenPrefix": "mse_", "anyOf": [ [ "event:cancel" ] ] } }, "request": { "kind": "json", "required": true, "schema": "UnbookRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "UnbookResult", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "unsupported", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [ { "policy": "manage-session", "audience": "manage-session", "limit": 300, "windowSeconds": 60, "bucket": "manage-session-id", "standardHeaders": false } ], "errors": [ { "status": 400, "sources": [ "business" ], "codes": [ "labels_and_bookingRef_required" ], "reasons": [], "descriptions": [ "The request is malformed or misses a required value." ] }, { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key", "bad_manage_session", "manage_session_expired" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "mode_mismatch", "forbidden" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "booking_mismatch" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [ { "event": "seat.released", "when": "Booked objects are returned to free inventory." } ], "audit": [ { "surface": "event-log", "actions": [ "unbook" ], "when": "A successful state change is applied.", "visibility": "public-api" }, { "surface": "inventory-booking-lifecycle", "actions": [ "partial_cancel", "cancel" ], "when": "A booking lifecycle write or exact replay is recorded.", "visibility": "public-api" } ] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/cancellations-and-box-office/", "url": "https://docs.seatlayer.io/server-api/cancellations-and-box-office/" } }, { "operationId": "blockObjects", "method": "POST", "path": "/v1/events/{eventKey}/block", "summary": "Block objects from sale", "tag": "Inventory", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": true, "tokenPrefix": "mse_", "anyOf": [ [ "event:block" ] ] } }, "request": { "kind": "json", "required": true, "schema": "BlockRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "BlockResult", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "unsupported", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [ { "policy": "manage-session", "audience": "manage-session", "limit": 300, "windowSeconds": 60, "bucket": "manage-session-id", "standardHeaders": false } ], "errors": [ { "status": 400, "sources": [ "business" ], "codes": [ "labels_required" ], "reasons": [], "descriptions": [ "The request is malformed or misses a required value." ] }, { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key", "bad_manage_session", "manage_session_expired" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "mode_mismatch", "forbidden" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "conflict" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [ { "event": "seat.blocked", "when": "Free objects are successfully blocked." } ], "audit": [ { "surface": "event-log", "actions": [ "block" ], "when": "A successful state change is applied.", "visibility": "public-api" } ] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/blocking/", "url": "https://docs.seatlayer.io/server-api/blocking/" } }, { "operationId": "unblockObjects", "method": "POST", "path": "/v1/events/{eventKey}/unblock", "summary": "Unblock objects", "tag": "Inventory", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": true, "tokenPrefix": "mse_", "anyOf": [ [ "event:block" ] ] } }, "request": { "kind": "json", "required": true, "schema": "LabelsRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "UnblockResult", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "unsupported", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [ { "policy": "manage-session", "audience": "manage-session", "limit": 300, "windowSeconds": 60, "bucket": "manage-session-id", "standardHeaders": false } ], "errors": [ { "status": 400, "sources": [ "business" ], "codes": [ "labels_required" ], "reasons": [], "descriptions": [ "The request is malformed or misses a required value." ] }, { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key", "bad_manage_session", "manage_session_expired" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "mode_mismatch", "forbidden" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [ { "event": "seat.released", "when": "Blocked objects are returned to free inventory." } ], "audit": [ { "surface": "event-log", "actions": [ "unblock" ], "when": "A successful state change is applied.", "visibility": "public-api" } ] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/blocking/", "url": "https://docs.seatlayer.io/server-api/blocking/" } }, { "operationId": "unblockAllObjects", "method": "POST", "path": "/v1/events/{eventKey}/unblock-all", "summary": "Unblock every blocked object in an event", "tag": "Inventory", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": true, "tokenPrefix": "mse_", "anyOf": [ [ "event:block" ] ] } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "UnblockAllResult", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "unsupported", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [ { "policy": "manage-session", "audience": "manage-session", "limit": 300, "windowSeconds": 60, "bucket": "manage-session-id", "standardHeaders": false } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key", "bad_manage_session", "manage_session_expired" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "mode_mismatch", "forbidden" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [ { "event": "seat.released", "when": "One or more blocked objects are returned to free inventory." } ], "audit": [ { "surface": "event-log", "actions": [ "unblock" ], "when": "A successful state change is applied.", "visibility": "public-api" } ] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/blocking/", "url": "https://docs.seatlayer.io/server-api/blocking/" } }, { "operationId": "putUpForResale", "method": "PUT", "path": "/v1/events/{eventKey}/actions/put-up-for-resale", "summary": "List booked objects for resale on this event", "tag": "Inventory", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": true, "tokenPrefix": "mse_", "anyOf": [ [ "event:block" ] ] } }, "request": { "kind": "json", "required": true, "schema": "ResaleListRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "ResaleListEnvelope", "description": "The objects are on the resale market." }, "alternates": [] }, "reliability": { "idempotency": "unsupported", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [ { "policy": "manage-session", "audience": "manage-session", "limit": 300, "windowSeconds": 60, "bucket": "manage-session-id", "standardHeaders": false } ], "errors": [ { "status": 400, "sources": [ "business" ], "codes": [ "objects_required" ], "reasons": [], "descriptions": [ "The request is malformed or misses a required value." ] }, { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key", "bad_manage_session", "manage_session_expired" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden", "mode_mismatch" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "not_booked", "order_edit_in_progress", "resale_unsupported_on_seatlayer_checkout" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "invalid_listing_id" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [ { "event": "object.resale.listed", "when": "Once per call, with every object it listed." } ], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/inventory/", "url": "https://docs.seatlayer.io/server-api/inventory/" } }, { "operationId": "removeFromResale", "method": "PUT", "path": "/v1/events/{eventKey}/actions/remove-from-resale", "summary": "Take objects off the resale market", "tag": "Inventory", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": true, "tokenPrefix": "mse_", "anyOf": [ [ "event:block" ] ] } }, "request": { "kind": "json", "required": true, "schema": "ResaleUnlistRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "ResaleUnlistEnvelope", "description": "The objects are off the resale market." }, "alternates": [] }, "reliability": { "idempotency": "unsupported", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [ { "policy": "manage-session", "audience": "manage-session", "limit": 300, "windowSeconds": 60, "bucket": "manage-session-id", "standardHeaders": false } ], "errors": [ { "status": 400, "sources": [ "business" ], "codes": [ "objects_required" ], "reasons": [], "descriptions": [ "The request is malformed or misses a required value." ] }, { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key", "bad_manage_session", "manage_session_expired" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden", "mode_mismatch" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "order_edit_in_progress" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [ { "event": "object.resale.unlisted", "when": "Once per call, when anything was actually unlisted." } ], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/inventory/", "url": "https://docs.seatlayer.io/server-api/inventory/" } }, { "operationId": "listResaleListings", "method": "GET", "path": "/v1/events/{eventKey}/resale-listings", "summary": "List the objects currently on the resale market", "tag": "Inventory", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": true, "tokenPrefix": "mse_", "anyOf": [ [ "event:view" ] ] } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "ResaleListingList", "description": "Objects currently on the resale market." }, "alternates": [] }, "reliability": { "idempotency": "not-applicable", "automaticRetry": true, "retryClass": "transient-read", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "manage-session", "audience": "manage-session", "limit": 300, "windowSeconds": 60, "bucket": "manage-session-id", "standardHeaders": false } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key", "bad_manage_session", "manage_session_expired" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden", "mode_mismatch" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/inventory/", "url": "https://docs.seatlayer.io/server-api/inventory/" } }, { "operationId": "retrieveResaleSummary", "method": "GET", "path": "/v1/events/{eventKey}/resale-summary", "summary": "Count the resale market and the seats resold since a time", "tag": "Inventory", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": true, "tokenPrefix": "mse_", "anyOf": [ [ "event:view" ] ] } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "queryParameters": [ { "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 } } ] }, "success": { "primary": { "status": 200, "schema": "ResaleSummary", "description": "The resale market in numbers." }, "alternates": [] }, "reliability": { "idempotency": "not-applicable", "automaticRetry": true, "retryClass": "transient-read", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "manage-session", "audience": "manage-session", "limit": 300, "windowSeconds": 60, "bucket": "manage-session-id", "standardHeaders": false } ], "errors": [ { "status": 400, "sources": [ "business" ], "codes": [ "invalid_since" ], "reasons": [], "descriptions": [ "The request is malformed or misses a required value." ] }, { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key", "bad_manage_session", "manage_session_expired" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden", "mode_mismatch" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/inventory/", "url": "https://docs.seatlayer.io/server-api/inventory/" } }, { "operationId": "retrieveAvailability", "method": "GET", "path": "/v1/events/{eventKey}/availability", "summary": "Read per-object availability", "tag": "Inventory", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": true, "tokenPrefix": "mse_", "anyOf": [ [ "event:view" ] ] } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "AvailabilityEnvelope", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "not-applicable", "automaticRetry": true, "retryClass": "transient-read", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "manage-session", "audience": "manage-session", "limit": 300, "windowSeconds": 60, "bucket": "manage-session-id", "standardHeaders": false } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key", "bad_manage_session", "manage_session_expired" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "mode_mismatch" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/inventory/", "url": "https://docs.seatlayer.io/server-api/inventory/" } }, { "operationId": "updateAvailability", "method": "POST", "path": "/v1/events/{eventKey}/availability", "summary": "Set per-object availability", "tag": "Inventory", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": true, "tokenPrefix": "mse_", "anyOf": [ [ "event:block" ] ] } }, "request": { "kind": "json", "required": true, "schema": "AvailabilityUpdateRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "AvailabilityUpdateResult", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "unsupported", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [ { "policy": "manage-session", "audience": "manage-session", "limit": 300, "windowSeconds": 60, "bucket": "manage-session-id", "standardHeaders": false } ], "errors": [ { "status": 400, "sources": [ "business" ], "codes": [ "rules_required" ], "reasons": [], "descriptions": [ "The request is malformed or misses a required value." ] }, { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key", "bad_manage_session", "manage_session_expired" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "mode_mismatch", "forbidden" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found", "chart_unavailable" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "invalid_availability_rule" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [ { "surface": "event-log", "actions": [ "availability", "reveal" ], "when": "A successful state change is applied.", "visibility": "public-api" } ] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/inventory/", "url": "https://docs.seatlayer.io/server-api/inventory/" } }, { "operationId": "retrieveHoldTtl", "method": "GET", "path": "/v1/events/{eventKey}/hold-ttl", "summary": "Read the checkout window for an event", "tag": "Inventory", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": true, "tokenPrefix": "mse_", "anyOf": [ [ "event:view" ] ] } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "HoldTtlEnvelope", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "not-applicable", "automaticRetry": true, "retryClass": "transient-read", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "manage-session", "audience": "manage-session", "limit": 300, "windowSeconds": 60, "bucket": "manage-session-id", "standardHeaders": false } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key", "bad_manage_session", "manage_session_expired" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "mode_mismatch" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/holds/", "url": "https://docs.seatlayer.io/server-api/holds/" } }, { "operationId": "updateHoldTtl", "method": "POST", "path": "/v1/events/{eventKey}/hold-ttl", "summary": "Set the checkout window for an event", "tag": "Inventory", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": true, "tokenPrefix": "mse_", "anyOf": [ [ "event:block" ] ] } }, "request": { "kind": "json", "required": true, "schema": "HoldTtlRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "HoldTtlUpdateResult", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "unsupported", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [ { "policy": "manage-session", "audience": "manage-session", "limit": 300, "windowSeconds": 60, "bucket": "manage-session-id", "standardHeaders": false } ], "errors": [ { "status": 400, "sources": [ "business" ], "codes": [ "holdTtlMs_required", "holdTtlMs_must_be_positive_number_or_null" ], "reasons": [], "descriptions": [ "The request is malformed or misses a required value." ] }, { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key", "bad_manage_session", "manage_session_expired" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "mode_mismatch", "forbidden" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/holds/", "url": "https://docs.seatlayer.io/server-api/holds/" } }, { "operationId": "listInventoryBookings", "method": "GET", "path": "/v1/events/{eventKey}/bookings", "summary": "List inventory booking history by stable booking reference", "tag": "Reports", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": true, "tokenPrefix": "mse_", "anyOf": [ [ "event:view" ], [ "event:reports" ] ] } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "queryParameters": [ { "name": "q", "description": "Search booking reference, label, or section.", "schema": { "type": "string", "maxLength": 120 } }, { "name": "state", "description": "Filter lifecycle state.", "schema": { "type": "string", "enum": [ "booked", "partially_cancelled", "cancelled" ] } }, { "name": "channel", "description": "Only bookings with seats from this sales channel id; `public` for seats sold with no channel.", "schema": { "type": "string", "maxLength": 128 } }, { "name": "from", "description": "Booked at or after, epoch milliseconds.", "schema": { "type": "integer", "minimum": 0 } }, { "name": "to", "description": "Booked before, epoch milliseconds.", "schema": { "type": "integer", "minimum": 0 } }, { "name": "limit", "description": "Page size, capped at 200.", "schema": { "type": "integer", "minimum": 1, "maximum": 200 } }, { "name": "cursor", "description": "Opaque cursor returned by the previous page.", "schema": { "type": "string" } } ] }, "success": { "primary": { "status": 200, "schema": "InventoryBookingPage", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "not-applicable", "automaticRetry": true, "retryClass": "transient-read", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "manage-session", "audience": "manage-session", "limit": 300, "windowSeconds": 60, "bucket": "manage-session-id", "standardHeaders": false } ], "errors": [ { "status": 400, "sources": [ "business" ], "codes": [ "invalid_cursor", "invalid_booking_state", "invalid_booking_window" ], "reasons": [], "descriptions": [ "The request is malformed or misses a required value." ] }, { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key", "bad_manage_session", "manage_session_expired" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "mode_mismatch" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/booking/", "url": "https://docs.seatlayer.io/server-api/booking/" } }, { "operationId": "retrieveInventoryBooking", "method": "GET", "path": "/v1/events/{eventKey}/bookings/{bookingRef}", "summary": "Retrieve one inventory booking and its lifecycle audit", "tag": "Reports", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": true, "tokenPrefix": "mse_", "anyOf": [ [ "event:view" ], [ "event:reports" ] ] } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "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" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "InventoryBookingDetail", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "not-applicable", "automaticRetry": true, "retryClass": "transient-read", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "manage-session", "audience": "manage-session", "limit": 300, "windowSeconds": 60, "bucket": "manage-session-id", "standardHeaders": false } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key", "bad_manage_session", "manage_session_expired" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "mode_mismatch" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/booking/", "url": "https://docs.seatlayer.io/server-api/booking/" } }, { "operationId": "listInventoryBookingChanges", "method": "GET", "path": "/v1/events/{eventKey}/booking-changes", "summary": "Incrementally reconcile booking and cancellation activity", "tag": "Reports", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": true, "tokenPrefix": "mse_", "anyOf": [ [ "event:view" ], [ "event:reports" ] ] } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "queryParameters": [ { "name": "after", "description": "Exclusive activity checkpoint returned by a previous response.", "schema": { "type": "integer", "minimum": 0 } }, { "name": "limit", "description": "Page size, capped at 200.", "schema": { "type": "integer", "minimum": 1, "maximum": 200 } } ] }, "success": { "primary": { "status": 200, "schema": "InventoryBookingChangePage", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "not-applicable", "automaticRetry": true, "retryClass": "transient-read", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "manage-session", "audience": "manage-session", "limit": 300, "windowSeconds": 60, "bucket": "manage-session-id", "standardHeaders": false } ], "errors": [ { "status": 400, "sources": [ "business" ], "codes": [ "invalid_after" ], "reasons": [], "descriptions": [ "The request is malformed or misses a required value." ] }, { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key", "bad_manage_session", "manage_session_expired" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "mode_mismatch" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/reports/", "url": "https://docs.seatlayer.io/server-api/reports/" } }, { "operationId": "retrieveEventReport", "method": "GET", "path": "/v1/events/{eventKey}/report", "summary": "Retrieve inventory status and configured booked value", "tag": "Reports", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": true, "tokenPrefix": "mse_", "anyOf": [ [ "event:reports" ] ] } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "EventReportEnvelope", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "not-applicable", "automaticRetry": true, "retryClass": "transient-read", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "manage-session", "audience": "manage-session", "limit": 300, "windowSeconds": 60, "bucket": "manage-session-id", "standardHeaders": false } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key", "bad_manage_session", "manage_session_expired" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "mode_mismatch", "forbidden" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/reports/", "url": "https://docs.seatlayer.io/server-api/reports/" } }, { "operationId": "retrieveEventLog", "method": "GET", "path": "/v1/events/{eventKey}/log", "summary": "Retrieve the event audit log", "tag": "Reports", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": true, "tokenPrefix": "mse_", "anyOf": [ [ "event:reports" ] ] } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "queryParameters": [ { "name": "limit", "description": "Page size, capped at 200.", "schema": { "type": "integer", "minimum": 1, "maximum": 200 } }, { "name": "before", "description": "Numeric log id cursor.", "schema": { "type": "integer", "minimum": 1 } } ] }, "success": { "primary": { "status": 200, "schema": "EventLogPage", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "not-applicable", "automaticRetry": true, "retryClass": "transient-read", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "manage-session", "audience": "manage-session", "limit": 300, "windowSeconds": 60, "bucket": "manage-session-id", "standardHeaders": false } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key", "bad_manage_session", "manage_session_expired" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "mode_mismatch", "forbidden" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/reports/", "url": "https://docs.seatlayer.io/server-api/reports/" } }, { "operationId": "retrieveChannelReport", "method": "GET", "path": "/v1/events/{eventKey}/channels/report", "summary": "Retrieve current allocation and booking attribution per sales channel", "tag": "Reports", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": true, "tokenPrefix": "mse_", "anyOf": [ [ "event:channels:view" ] ], "conditional": [ { "capability": "event:reports", "effect": "Includes configured booked-value fields in the channel report." } ] } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "ChannelReportEnvelope", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "not-applicable", "automaticRetry": true, "retryClass": "transient-read", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "manage-session", "audience": "manage-session", "limit": 300, "windowSeconds": 60, "bucket": "manage-session-id", "standardHeaders": false } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key", "bad_manage_session", "manage_session_expired" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "mode_mismatch", "forbidden" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/reports/", "url": "https://docs.seatlayer.io/server-api/reports/" } }, { "operationId": "listChannels", "method": "GET", "path": "/v1/events/{eventKey}/channels", "summary": "List an event’s sales channels with current allocation counts", "tag": "Sales channels", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": true, "tokenPrefix": "mse_", "anyOf": [ [ "event:channels:view" ] ] } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "queryParameters": [ { "name": "includeArchived", "description": "Set to 1 or true to include archived channels.", "schema": { "type": "string", "enum": [ "1", "true" ] } } ] }, "success": { "primary": { "status": 200, "schema": "ChannelList", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "not-applicable", "automaticRetry": true, "retryClass": "transient-read", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "manage-session", "audience": "manage-session", "limit": 300, "windowSeconds": 60, "bucket": "manage-session-id", "standardHeaders": false } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key", "bad_manage_session", "manage_session_expired" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "mode_mismatch", "forbidden" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/channels/", "url": "https://docs.seatlayer.io/server-api/channels/" } }, { "operationId": "createChannel", "method": "POST", "path": "/v1/events/{eventKey}/channels", "summary": "Create a sales channel", "tag": "Sales channels", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": true, "tokenPrefix": "mse_", "anyOf": [ [ "event:channels:manage" ] ] } }, "request": { "kind": "json", "required": true, "schema": "ChannelCreateRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 201, "schema": "ChannelMutationEnvelope", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "unsupported", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [ { "policy": "manage-session", "audience": "manage-session", "limit": 300, "windowSeconds": 60, "bucket": "manage-session-id", "standardHeaders": false } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key", "bad_manage_session", "manage_session_expired" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "mode_mismatch", "forbidden" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "channel_name_taken" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "channel_name_required", "invalid_access_intent", "channel_request_invalid" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [ { "surface": "channel-audit", "actions": [ "channel.create" ], "when": "A successful channel or hosted-link lifecycle change is applied.", "visibility": "excluded-organizer-surface" }, { "surface": "event-log", "actions": [ "channel.create" ], "when": "A successful state change is applied.", "visibility": "public-api" } ] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/channels/", "url": "https://docs.seatlayer.io/server-api/channels/" } }, { "operationId": "updateChannel", "method": "PATCH", "path": "/v1/events/{eventKey}/channels/{channelId}", "summary": "Rename a sales channel, change its access method, or update category prices", "tag": "Sales channels", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": true, "tokenPrefix": "mse_", "anyOf": [ [ "event:channels:manage" ] ] } }, "request": { "kind": "json", "required": true, "schema": "ChannelUpdateRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "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" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "ChannelMutationEnvelope", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "unsupported", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [ { "policy": "manage-session", "audience": "manage-session", "limit": 300, "windowSeconds": 60, "bucket": "manage-session-id", "standardHeaders": false } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key", "bad_manage_session", "manage_session_expired" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "mode_mismatch", "forbidden" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found", "chart_unavailable" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "channel_name_taken", "channel_archived", "channel_access_intent_forbids", "channel_intent_switch_blocked", "channel_pricing_conflict" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "channel_name_required", "invalid_access_intent", "invalid_channel_pricing", "channel_request_invalid" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [ { "surface": "channel-audit", "actions": [ "channel.rename", "channel.access_intent" ], "when": "A successful channel or hosted-link lifecycle change is applied.", "visibility": "excluded-organizer-surface" }, { "surface": "event-log", "actions": [ "channel.rename", "channel.access_intent" ], "when": "A successful state change is applied.", "visibility": "public-api" } ] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/channels/", "url": "https://docs.seatlayer.io/server-api/channels/" } }, { "operationId": "updateChannelAssignments", "method": "POST", "path": "/v1/events/{eventKey}/channels/assignments", "summary": "Move inventory between sales channels, versioned and non-destructive", "tag": "Sales channels", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": true, "tokenPrefix": "mse_", "anyOf": [ [ "event:channels:manage" ] ] } }, "request": { "kind": "json", "required": true, "schema": "ChannelAssignmentRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "AssignmentResult", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "unsupported", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [ { "policy": "manage-session", "audience": "manage-session", "limit": 300, "windowSeconds": 60, "bucket": "manage-session-id", "standardHeaders": false } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key", "bad_manage_session", "manage_session_expired" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "mode_mismatch", "forbidden" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "channel_archived", "channel_assignment_conflict", "channel_assignment_would_drop" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "labels_required", "assignment_version_required", "invalid_channel_destination", "too_many_units", "channel_request_invalid" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [ { "surface": "channel-audit", "actions": [ "channel.assign" ], "when": "A successful channel or hosted-link lifecycle change is applied.", "visibility": "excluded-organizer-surface" }, { "surface": "event-log", "actions": [ "channel.assign" ], "when": "A successful state change is applied.", "visibility": "public-api" } ] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/channels/", "url": "https://docs.seatlayer.io/server-api/channels/" } }, { "operationId": "listChannelAllocation", "method": "GET", "path": "/v1/events/{eventKey}/channels/allocation", "summary": "Page the label-to-channel allocation map", "tag": "Sales channels", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": true, "tokenPrefix": "mse_", "anyOf": [ [ "event:channels:view" ] ] } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "queryParameters": [ { "name": "afterLabel", "description": "Label cursor for the next page.", "schema": { "type": "string" } }, { "name": "limit", "description": "Page size, capped at 5000.", "schema": { "type": "integer", "minimum": 1, "maximum": 5000 } } ] }, "success": { "primary": { "status": 200, "schema": "ChannelAllocationPage", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "not-applicable", "automaticRetry": true, "retryClass": "transient-read", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "manage-session", "audience": "manage-session", "limit": 300, "windowSeconds": 60, "bucket": "manage-session-id", "standardHeaders": false } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key", "bad_manage_session", "manage_session_expired" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "mode_mismatch", "forbidden" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/channels/", "url": "https://docs.seatlayer.io/server-api/channels/" } }, { "operationId": "retrieveChannelAccessPreview", "method": "GET", "path": "/v1/events/{eventKey}/channels/preview", "summary": "Preview the seat projection a given channel scope would receive", "tag": "Sales channels", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": true, "tokenPrefix": "mse_", "anyOf": [ [ "event:channels:view" ] ] } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "queryParameters": [ { "name": "channelIds", "description": "Trusted-server inventory scope. Private allocation ids require matching channel access. Comma-separated, at most 20.", "schema": { "type": "string" } }, { "name": "includePublic", "description": "Set to 1 or true to include Public sale.", "schema": { "type": "string", "enum": [ "1", "true" ] } } ] }, "success": { "primary": { "status": 200, "schema": "ChannelPreview", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "not-applicable", "automaticRetry": true, "retryClass": "transient-read", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "manage-session", "audience": "manage-session", "limit": 300, "windowSeconds": 60, "bucket": "manage-session-id", "standardHeaders": false } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key", "bad_manage_session", "manage_session_expired" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "mode_mismatch", "forbidden" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "invalid_channel_scope" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/channels/", "url": "https://docs.seatlayer.io/server-api/channels/" } }, { "operationId": "pauseChannel", "method": "POST", "path": "/v1/events/{eventKey}/channels/{channelId}/pause", "summary": "Pause a sales channel (no new access, no new holds)", "tag": "Sales channels", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": true, "tokenPrefix": "mse_", "anyOf": [ [ "event:channels:manage" ] ] } }, "request": { "kind": "json", "required": false, "schema": "ChannelReasonRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "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" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "ChannelMutationEnvelope", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "unsupported", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [ { "policy": "manage-session", "audience": "manage-session", "limit": 300, "windowSeconds": 60, "bucket": "manage-session-id", "standardHeaders": false } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key", "bad_manage_session", "manage_session_expired" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "mode_mismatch", "forbidden" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "channel_archived" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "channel_state_invalid", "channel_request_invalid" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [ { "surface": "channel-audit", "actions": [ "channel.pause" ], "when": "A successful channel or hosted-link lifecycle change is applied.", "visibility": "excluded-organizer-surface" }, { "surface": "event-log", "actions": [ "channel.pause" ], "when": "A successful state change is applied.", "visibility": "public-api" } ] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/channels/", "url": "https://docs.seatlayer.io/server-api/channels/" } }, { "operationId": "unpauseChannel", "method": "POST", "path": "/v1/events/{eventKey}/channels/{channelId}/unpause", "summary": "Resume a paused sales channel", "tag": "Sales channels", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": true, "tokenPrefix": "mse_", "anyOf": [ [ "event:channels:manage" ] ] } }, "request": { "kind": "json", "required": false, "schema": "ChannelReasonRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "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" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "ChannelMutationEnvelope", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "unsupported", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [ { "policy": "manage-session", "audience": "manage-session", "limit": 300, "windowSeconds": 60, "bucket": "manage-session-id", "standardHeaders": false } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key", "bad_manage_session", "manage_session_expired" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "mode_mismatch", "forbidden" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "channel_archived" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "channel_state_invalid", "channel_request_invalid" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [ { "surface": "channel-audit", "actions": [ "channel.unpause" ], "when": "A successful channel or hosted-link lifecycle change is applied.", "visibility": "excluded-organizer-surface" }, { "surface": "event-log", "actions": [ "channel.unpause" ], "when": "A successful state change is applied.", "visibility": "public-api" } ] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/channels/", "url": "https://docs.seatlayer.io/server-api/channels/" } }, { "operationId": "archiveChannel", "method": "POST", "path": "/v1/events/{eventKey}/channels/{channelId}/archive", "summary": "Archive a sales channel, returning its inventory to a destination", "tag": "Sales channels", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": true, "tokenPrefix": "mse_", "anyOf": [ [ "event:channels:manage" ] ] } }, "request": { "kind": "json", "required": true, "schema": "ChannelArchiveRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "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" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "ChannelArchiveResult", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "unsupported", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [ { "policy": "manage-session", "audience": "manage-session", "limit": 300, "windowSeconds": 60, "bucket": "manage-session-id", "standardHeaders": false } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key", "bad_manage_session", "manage_session_expired" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "mode_mismatch", "forbidden" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "channel_archive_blocked_by_holds", "channel_archived", "order_edit_in_progress" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "destination_required", "invalid_channel_destination", "channel_request_invalid" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [ { "surface": "channel-audit", "actions": [ "channel.archive" ], "when": "A successful channel or hosted-link lifecycle change is applied.", "visibility": "excluded-organizer-surface" }, { "surface": "event-log", "actions": [ "channel.archive" ], "when": "A successful state change is applied.", "visibility": "public-api" } ] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/channels/", "url": "https://docs.seatlayer.io/server-api/channels/" } }, { "operationId": "createBuyerAccessSession", "method": "POST", "path": "/v1/events/{eventKey}/buyer-access-sessions", "summary": "Mint a short-lived buyer access session scoped to named channels", "tag": "Buyer access", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": true, "schema": "BuyerAccessSessionRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 201, "schema": "BuyerAccessReveal", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "unsupported-one-time-secret", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "buyer_access_mode_mismatch" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "channel_access_intent_forbids" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "invalid_allowed_origin", "include_public_required", "invalid_channel_scope", "invalid_expiry", "invalid_max_quantity", "invalid_reference" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/buyer-access-sessions/", "url": "https://docs.seatlayer.io/server-api/buyer-access-sessions/" } }, { "operationId": "listBuyerAccessSessions", "method": "GET", "path": "/v1/events/{eventKey}/buyer-access-sessions", "summary": "List buyer access sessions with scope, state, and expiry (never the token)", "tag": "Buyer access", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "queryParameters": [ { "name": "limit", "description": "Latest sessions to return, capped at 200. This endpoint is not cursor-paged.", "schema": { "type": "integer", "minimum": 1, "maximum": 200 } } ] }, "success": { "primary": { "status": 200, "schema": "BuyerAccessSessionList", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "not-applicable", "automaticRetry": true, "retryClass": "transient-read", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/buyer-access-sessions/", "url": "https://docs.seatlayer.io/server-api/buyer-access-sessions/" } }, { "operationId": "revokeBuyerAccessSession", "method": "DELETE", "path": "/v1/events/{eventKey}/buyer-access-sessions/{sessionId}", "summary": "Revoke a buyer access session immediately", "tag": "Buyer access", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "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" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "BuyerAccessRevokeResult", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "unsupported", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/buyer-access-sessions/", "url": "https://docs.seatlayer.io/server-api/buyer-access-sessions/" } }, { "operationId": "createAccessLink", "method": "POST", "path": "/v1/events/{eventKey}/channels/{channelId}/access-links", "summary": "Create a hosted access link for a channel (capability revealed once)", "tag": "Buyer access", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": true, "tokenPrefix": "mse_", "anyOf": [ [ "event:channels:manage" ] ] } }, "request": { "kind": "json", "required": false, "schema": "AccessLinkCreateRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "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" } } ], "queryParameters": [] }, "success": { "primary": { "status": 201, "schema": "AccessLinkReveal", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "unsupported-one-time-secret", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [ { "policy": "manage-session", "audience": "manage-session", "limit": 300, "windowSeconds": 60, "bucket": "manage-session-id", "standardHeaders": false } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key", "bad_manage_session", "manage_session_expired" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "mode_mismatch", "forbidden" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "channel_unavailable", "channel_access_intent_forbids", "too_many_access_links" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "invalid_expiry", "invalid_max_redemptions", "invalid_max_quantity", "invalid_session_ttl", "invalid_include_public", "invalid_label" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [ { "surface": "channel-audit", "actions": [ "access_link.create" ], "when": "A successful channel or hosted-link lifecycle change is applied.", "visibility": "excluded-organizer-surface" } ] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/channels/", "url": "https://docs.seatlayer.io/server-api/channels/" } }, { "operationId": "listAccessLinks", "method": "GET", "path": "/v1/events/{eventKey}/channels/{channelId}/access-links", "summary": "List a channel’s hosted access links (status only, never the capability)", "tag": "Buyer access", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": true, "tokenPrefix": "mse_", "anyOf": [ [ "event:channels:view" ] ] } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "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" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "AccessLinkList", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "not-applicable", "automaticRetry": true, "retryClass": "transient-read", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "manage-session", "audience": "manage-session", "limit": 300, "windowSeconds": 60, "bucket": "manage-session-id", "standardHeaders": false } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key", "bad_manage_session", "manage_session_expired" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "mode_mismatch", "forbidden" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/channels/", "url": "https://docs.seatlayer.io/server-api/channels/" } }, { "operationId": "rotateAccessLink", "method": "POST", "path": "/v1/events/{eventKey}/channels/{channelId}/access-links/{linkId}/rotate", "summary": "Rotate a hosted access link, issuing a replacement capability", "tag": "Buyer access", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": true, "tokenPrefix": "mse_", "anyOf": [ [ "event:channels:manage" ] ] } }, "request": { "kind": "json", "required": true, "schema": "AccessLinkRotateRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "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" } } ], "queryParameters": [] }, "success": { "primary": { "status": 201, "schema": "AccessLinkReveal", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "unsupported-one-time-secret", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [ { "policy": "manage-session", "audience": "manage-session", "limit": 300, "windowSeconds": 60, "bucket": "manage-session-id", "standardHeaders": false } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key", "bad_manage_session", "manage_session_expired" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "mode_mismatch", "forbidden" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "channel_unavailable", "channel_access_intent_forbids", "access_link_not_active" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "end_active_sessions_required" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [ { "surface": "channel-audit", "actions": [ "access_link.rotate", "access_link.rotate_out" ], "when": "A successful channel or hosted-link lifecycle change is applied.", "visibility": "excluded-organizer-surface" } ] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/channels/", "url": "https://docs.seatlayer.io/server-api/channels/" } }, { "operationId": "revokeAccessLink", "method": "DELETE", "path": "/v1/events/{eventKey}/channels/{channelId}/access-links/{linkId}", "summary": "Revoke a hosted access link, optionally ending active sessions", "tag": "Buyer access", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": true, "tokenPrefix": "mse_", "anyOf": [ [ "event:channels:manage" ] ] } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "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" } } ], "queryParameters": [ { "name": "endActiveSessions", "description": "Set to 1 or true to revoke sessions minted by this link.", "schema": { "type": "string", "enum": [ "1", "true" ] } }, { "name": "reason", "description": "Audit reason.", "schema": { "type": "string", "maxLength": 400 } } ] }, "success": { "primary": { "status": 200, "schema": "AccessLinkRevokeResult", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "unsupported", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [ { "policy": "manage-session", "audience": "manage-session", "limit": 300, "windowSeconds": 60, "bucket": "manage-session-id", "standardHeaders": false } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key", "bad_manage_session", "manage_session_expired" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "mode_mismatch", "forbidden" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "channel_unavailable", "access_link_not_active" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [ { "surface": "channel-audit", "actions": [ "access_link.revoke" ], "when": "A successful channel or hosted-link lifecycle change is applied.", "visibility": "excluded-organizer-surface" } ] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/channels/", "url": "https://docs.seatlayer.io/server-api/channels/" } }, { "operationId": "createManageSession", "method": "POST", "path": "/v1/events/{eventKey}/manage-sessions", "summary": "Mint an origin-bound manage-session token for the control room", "tag": "Platform", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": true, "schema": "ManageSessionRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "name": "eventKey", "in": "path", "required": true, "description": "SeatLayer event key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 201, "schema": "ManageSessionReveal", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "unsupported-one-time-secret", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "mode_mismatch", "forbidden" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "invalid_allowed_origin", "invalid_capabilities", "invalid_expiry" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/platform/embed-sessions/", "url": "https://docs.seatlayer.io/platform/embed-sessions/" } }, { "operationId": "revokeManageSession", "method": "DELETE", "path": "/v1/events/{eventKey}/manage-sessions/{id}", "summary": "Revoke a manage-session token early", "tag": "Platform", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "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" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "Ok", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "unsupported", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "mode_mismatch", "forbidden" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/platform/embed-sessions/", "url": "https://docs.seatlayer.io/platform/embed-sessions/" } }, { "operationId": "createDesignerSession", "method": "POST", "path": "/v1/designer/sessions", "summary": "Mint an origin-bound designer-session token", "tag": "Platform", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": true, "schema": "DesignerSessionRequest", "contentTypes": [ "application/json" ], "pathParameters": [], "queryParameters": [] }, "success": { "primary": { "status": 201, "schema": "DesignerSessionEnvelope", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "unsupported-one-time-secret", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [], "errors": [ { "status": 400, "sources": [ "business" ], "codes": [ "workspaceId_and_chartId_required" ], "reasons": [], "descriptions": [ "The request is malformed or misses a required value." ] }, { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "workspace_not_found_or_disabled", "chart_not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "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" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/platform/embedded-designer/", "url": "https://docs.seatlayer.io/platform/embedded-designer/" } }, { "operationId": "revokeDesignerSession", "method": "DELETE", "path": "/v1/designer/sessions/{id}", "summary": "Revoke a designer-session token early", "tag": "Platform", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "name": "id", "in": "path", "required": true, "description": "Resource identifier.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "Ok", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "unsupported", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/platform/embedded-designer/", "url": "https://docs.seatlayer.io/platform/embedded-designer/" } }, { "operationId": "listWebhooks", "method": "GET", "path": "/v1/webhooks", "summary": "List webhook subscriptions", "tag": "Webhooks", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "WebhookList", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "not-applicable", "automaticRetry": true, "retryClass": "transient-read", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "python": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" } }, "docs": { "path": "/webhooks/manage-subscriptions/", "url": "https://docs.seatlayer.io/webhooks/manage-subscriptions/" } }, { "operationId": "createWebhook", "method": "POST", "path": "/v1/webhooks", "summary": "Create a webhook subscription", "tag": "Webhooks", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": true, "schema": "WebhookCreateRequest", "contentTypes": [ "application/json" ], "pathParameters": [], "queryParameters": [] }, "success": { "primary": { "status": 201, "schema": "WebhookCreateEnvelope", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "unsupported-one-time-secret", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "invalid_url", "invalid_events", "invalid_mode", "invalid_environment" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "python": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" } }, "docs": { "path": "/webhooks/manage-subscriptions/", "url": "https://docs.seatlayer.io/webhooks/manage-subscriptions/" } }, { "operationId": "updateWebhook", "method": "PATCH", "path": "/v1/webhooks/{webhookId}", "summary": "Update a webhook subscription", "tag": "Webhooks", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": true, "schema": "WebhookUpdateRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "name": "webhookId", "in": "path", "required": true, "description": "Resource identifier.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "WebhookEnvelope", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "unsupported", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "invalid_url", "invalid_events", "invalid_mode", "invalid_environment" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "python": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" } }, "docs": { "path": "/webhooks/manage-subscriptions/", "url": "https://docs.seatlayer.io/webhooks/manage-subscriptions/" } }, { "operationId": "deleteWebhook", "method": "DELETE", "path": "/v1/webhooks/{webhookId}", "summary": "Delete a webhook subscription", "tag": "Webhooks", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "name": "webhookId", "in": "path", "required": true, "description": "Resource identifier.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "Ok", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "unsupported", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/webhooks/manage-subscriptions/", "url": "https://docs.seatlayer.io/webhooks/manage-subscriptions/" } }, { "operationId": "rotateWebhookSecret", "method": "POST", "path": "/v1/webhooks/{id}/rotate-secret", "summary": "Rotate a webhook signing secret without replacing the subscription", "tag": "Webhooks", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "name": "id", "in": "path", "required": true, "description": "Resource identifier.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "WebhookRotateSecretEnvelope", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "unsupported-one-time-secret", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "python": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" } }, "docs": { "path": "/webhooks/manage-subscriptions/", "url": "https://docs.seatlayer.io/webhooks/manage-subscriptions/" } }, { "operationId": "listWebhookDeliveries", "method": "GET", "path": "/v1/webhooks/{webhookId}/deliveries", "summary": "List recent deliveries for a webhook", "tag": "Webhooks", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "name": "webhookId", "in": "path", "required": true, "description": "Resource identifier.", "schema": { "type": "string" } } ], "queryParameters": [ { "name": "limit", "description": "Page size, capped at 50.", "schema": { "type": "integer", "minimum": 1, "maximum": 50 } }, { "name": "status", "description": "Filter successful or failed deliveries.", "schema": { "type": "string", "enum": [ "ok", "failed" ] } }, { "name": "before", "description": "Inclusive epoch-millisecond cursor.", "schema": { "type": "integer", "minimum": 1 } } ] }, "success": { "primary": { "status": 200, "schema": "WebhookDeliveryPage", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "not-applicable", "automaticRetry": true, "retryClass": "transient-read", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "python": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" } }, "docs": { "path": "/webhooks/delivery-and-retries/", "url": "https://docs.seatlayer.io/webhooks/delivery-and-retries/" } }, { "operationId": "listWorkspaces", "method": "GET", "path": "/v1/workspaces", "summary": "List workspaces", "tag": "Platform", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "WorkspaceList", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "not-applicable", "automaticRetry": true, "retryClass": "transient-read", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/platform/workspaces/", "url": "https://docs.seatlayer.io/platform/workspaces/" } }, { "operationId": "createWorkspace", "method": "POST", "path": "/v1/workspaces", "summary": "Create a workspace", "tag": "Platform", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": true, "schema": "WorkspaceCreateRequest", "contentTypes": [ "application/json" ], "pathParameters": [], "queryParameters": [] }, "success": { "primary": { "status": 201, "schema": "WorkspaceEnvelope", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "header-replay", "automaticRetry": true, "retryClass": "exact-header-replay", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [], "errors": [ { "status": 400, "sources": [ "business" ], "codes": [ "invalid_idempotency_key" ], "reasons": [], "descriptions": [ "The request is malformed or misses a required value." ] }, { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "external_ref_exists", "idempotency_conflict", "idempotency_in_progress" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "invalid_name", "invalid_external_ref", "invalid_region" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/platform/workspaces/", "url": "https://docs.seatlayer.io/platform/workspaces/" } }, { "operationId": "updateWorkspace", "method": "PATCH", "path": "/v1/workspaces/{workspaceId}", "summary": "Rename a workspace or set it active/disabled", "tag": "Platform", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": true, "schema": "WorkspaceUpdateRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "name": "workspaceId", "in": "path", "required": true, "description": "Resource identifier.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "WorkspaceEnvelope", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "unsupported", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "default_workspace_required", "default_workspace_must_be_active", "external_ref_exists" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "invalid_name", "invalid_external_ref", "invalid_status", "invalid_default", "invalid_region" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/platform/workspaces/", "url": "https://docs.seatlayer.io/platform/workspaces/" } }, { "operationId": "retrieveWorkspace", "method": "GET", "path": "/v1/workspaces/{workspaceId}", "summary": "Retrieve a workspace", "tag": "Platform", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "name": "workspaceId", "in": "path", "required": true, "description": "Resource identifier.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "WorkspaceEnvelope", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "not-applicable", "automaticRetry": true, "retryClass": "transient-read", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/platform/workspaces/", "url": "https://docs.seatlayer.io/platform/workspaces/" } }, { "operationId": "listPerformanceGroups", "method": "GET", "path": "/v1/performance-groups", "summary": "List multi-performance runs", "tag": "Performance Groups", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [], "queryParameters": [ { "name": "workspaceId", "description": "Active workspace id. Defaults to the caller workspace.", "schema": { "type": "string" } }, { "name": "externalRef", "description": "Filter by the caller-owned external reference.", "schema": { "type": "string" } }, { "name": "state", "description": "Filter by the group lifecycle state.", "schema": { "type": "string", "enum": [ "draft", "active", "closing", "closed", "archived" ] } }, { "name": "limit", "description": "Page size. Defaults to 100 and is capped at 200.", "schema": { "type": "integer", "minimum": 1, "maximum": 200 } }, { "name": "cursor", "description": "Opaque cursor returned by the previous page.", "schema": { "type": "string" } } ] }, "success": { "primary": { "status": 200, "schema": "PerformanceGroupPage", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "not-applicable", "automaticRetry": true, "retryClass": "transient-read", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "workspace_not_found_or_disabled" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "invalid_state", "invalid_mode" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/performance-groups/", "url": "https://docs.seatlayer.io/server-api/performance-groups/" } }, { "operationId": "createPerformanceGroup", "method": "POST", "path": "/v1/performance-groups", "summary": "Create a multi-performance run", "tag": "Performance Groups", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": true, "schema": "PerformanceGroupCreateRequest", "contentTypes": [ "application/json" ], "pathParameters": [], "queryParameters": [] }, "success": { "primary": { "status": 201, "schema": "PerformanceGroupEnvelope", "description": "Fixed performance run created as a draft." }, "alternates": [] }, "reliability": { "idempotency": "header-replay", "automaticRetry": true, "retryClass": "exact-header-replay", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [], "errors": [ { "status": 400, "sources": [ "business" ], "codes": [ "invalid_idempotency_key" ], "reasons": [], "descriptions": [ "The request is malformed or misses a required value." ] }, { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "incompatible_performances" ], "reasons": [ "event_not_found" ], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "idempotency_conflict", "idempotency_in_progress", "event_already_grouped", "external_ref_exists", "incompatible_performances" ], "reasons": [ "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" ], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "invalid_name", "invalid_external_ref", "invalid_event_keys", "invalid_inclusion_mode", "invalid_selection_mode", "invalid_audience", "invalid_checkout_mode", "incompatible_performances" ], "reasons": [ "invalid_event_count", "duplicate_event", "performance_time_required" ], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/performance-groups/", "url": "https://docs.seatlayer.io/server-api/performance-groups/" } }, { "operationId": "retrievePerformanceGroup", "method": "GET", "path": "/v1/performance-groups/{performanceGroupKey}", "summary": "Retrieve a multi-performance run", "tag": "Performance Groups", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "name": "performanceGroupKey", "in": "path", "required": true, "description": "SeatLayer Performance Group key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "PerformanceGroupEnvelope", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "not-applicable", "automaticRetry": true, "retryClass": "transient-read", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/performance-groups/", "url": "https://docs.seatlayer.io/server-api/performance-groups/" } }, { "operationId": "updatePerformanceGroup", "method": "PATCH", "path": "/v1/performance-groups/{performanceGroupKey}", "summary": "Update a performance run’s name and sales settings", "tag": "Performance Groups", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": true, "schema": "PerformanceGroupUpdateRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "name": "performanceGroupKey", "in": "path", "required": true, "description": "SeatLayer Performance Group key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "PerformanceGroupEnvelope", "description": "Performance run updated." }, "alternates": [] }, "reliability": { "idempotency": "unsupported", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "group_not_editable", "group_not_active", "checkout_mode_required", "group_has_holds", "revision_mismatch", "incompatible_performances" ], "reasons": [ "checkout_mode_mismatch" ], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "invalid_expected_revision", "invalid_name", "invalid_external_ref", "invalid_selection_mode", "invalid_audience", "invalid_sales_state", "invalid_checkout_mode" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "business", "maintenance" ], "codes": [ "lifecycle_unavailable", "maintenance_mode" ], "reasons": [], "descriptions": [ "The service or one of its required dependencies is temporarily unavailable.", "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/performance-groups/", "url": "https://docs.seatlayer.io/server-api/performance-groups/" } }, { "operationId": "deletePerformanceGroup", "method": "DELETE", "path": "/v1/performance-groups/{performanceGroupKey}", "summary": "Delete an unused draft performance run", "tag": "Performance Groups", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "name": "performanceGroupKey", "in": "path", "required": true, "description": "SeatLayer Performance Group key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 204, "description": "Draft Performance Group deleted." }, "alternates": [] }, "reliability": { "idempotency": "unsupported", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "group_not_draft" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/performance-groups/", "url": "https://docs.seatlayer.io/server-api/performance-groups/" } }, { "operationId": "activatePerformanceGroup", "method": "POST", "path": "/v1/performance-groups/{performanceGroupKey}/activate", "summary": "Activate a performance run", "tag": "Performance Groups", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": true, "schema": "PerformanceGroupLifecycleRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "name": "performanceGroupKey", "in": "path", "required": true, "description": "SeatLayer Performance Group key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "PerformanceGroupLifecycleEnvelope", "description": "Performance Group activated." }, "alternates": [ { "status": 202, "schema": "PerformanceGroupLifecycleEnvelope", "description": "Activation is in progress. Poll the response Location until the lifecycle operation is terminal.", "headers": [ "Location", "Retry-After" ] } ] }, "reliability": { "idempotency": "unsupported", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found", "group_not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "group_not_draft", "group_not_active", "group_closing", "revision_mismatch", "activation_mismatch", "lifecycle_operation_mismatch", "event_lock_refused", "registry_mismatch", "activation_repair_required" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "invalid_expected_revision" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "business", "maintenance" ], "codes": [ "recovery_pending", "lifecycle_unavailable", "maintenance_mode" ], "reasons": [], "descriptions": [ "The service or one of its required dependencies is temporarily unavailable.", "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/performance-groups/", "url": "https://docs.seatlayer.io/server-api/performance-groups/" } }, { "operationId": "closePerformanceGroup", "method": "POST", "path": "/v1/performance-groups/{performanceGroupKey}/close", "summary": "Close a performance run after active holds drain", "tag": "Performance Groups", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": true, "schema": "PerformanceGroupLifecycleRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "name": "performanceGroupKey", "in": "path", "required": true, "description": "SeatLayer Performance Group key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "PerformanceGroupLifecycleEnvelope", "description": "Performance Group closed." }, "alternates": [ { "status": 202, "schema": "PerformanceGroupLifecycleEnvelope", "description": "Closing is in progress. Poll the response Location until the lifecycle operation is terminal.", "headers": [ "Location", "Retry-After" ] } ] }, "reliability": { "idempotency": "unsupported", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found", "group_not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "group_not_draft", "group_not_active", "group_closing", "revision_mismatch", "activation_mismatch", "lifecycle_operation_mismatch", "event_lock_refused", "registry_mismatch", "activation_repair_required" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "invalid_expected_revision" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "business", "maintenance" ], "codes": [ "recovery_pending", "lifecycle_unavailable", "maintenance_mode" ], "reasons": [], "descriptions": [ "The service or one of its required dependencies is temporarily unavailable.", "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/performance-groups/", "url": "https://docs.seatlayer.io/server-api/performance-groups/" } }, { "operationId": "retrievePerformanceGroupLifecycle", "method": "GET", "path": "/v1/performance-groups/{performanceGroupKey}/lifecycle/{operationId}", "summary": "Retrieve a performance run lifecycle operation", "tag": "Performance Groups", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "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" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "PerformanceGroupLifecycleEnvelope", "description": "Lifecycle state. Non-terminal operations include Retry-After; poll this same URL after the stated delay.", "headers": [ "Retry-After" ] }, "alternates": [] }, "reliability": { "idempotency": "not-applicable", "automaticRetry": true, "retryClass": "transient-read", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found", "group_not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "group_not_draft", "group_not_active", "group_closing", "revision_mismatch", "activation_mismatch", "lifecycle_operation_mismatch", "event_lock_refused", "registry_mismatch", "activation_repair_required" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "business" ], "codes": [ "recovery_pending", "lifecycle_unavailable" ], "reasons": [], "descriptions": [ "The service or one of its required dependencies is temporarily unavailable." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/performance-groups/", "url": "https://docs.seatlayer.io/server-api/performance-groups/" } }, { "operationId": "createPerformanceGroupBuyerAccessSession", "method": "POST", "path": "/v1/performance-groups/{performanceGroupKey}/buyer-access-sessions", "summary": "Create a one-time group browser access token", "tag": "Performance Groups", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": true, "schema": "PerformanceGroupBuyerAccessSessionRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "name": "performanceGroupKey", "in": "path", "required": true, "description": "SeatLayer Performance Group key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 201, "schema": "PerformanceGroupBuyerAccessReveal", "description": "One-time browser access token created." }, "alternates": [] }, "reliability": { "idempotency": "unsupported-one-time-secret", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden", "buyer_access_mode_mismatch" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "performance_group_not_active", "channel_access_intent_forbids", "activation_mismatch", "member_set_mismatch" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "invalid_allowed_origin", "include_public_required", "invalid_expiry", "invalid_max_quantity", "invalid_reference", "invalid_channel_scope" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/performance-groups/", "url": "https://docs.seatlayer.io/server-api/performance-groups/" } }, { "operationId": "listPerformanceGroupBuyerAccessSessions", "method": "GET", "path": "/v1/performance-groups/{performanceGroupKey}/buyer-access-sessions", "summary": "List Performance Group browser session metadata", "tag": "Performance Groups", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "name": "performanceGroupKey", "in": "path", "required": true, "description": "SeatLayer Performance Group key.", "schema": { "type": "string" } } ], "queryParameters": [ { "name": "limit", "description": "Latest session records to return, capped at 100. This endpoint is not cursor-paged.", "schema": { "type": "integer", "minimum": 1, "maximum": 100 } } ] }, "success": { "primary": { "status": 200, "schema": "PerformanceGroupBuyerAccessSessionList", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "not-applicable", "automaticRetry": true, "retryClass": "transient-read", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/performance-groups/", "url": "https://docs.seatlayer.io/server-api/performance-groups/" } }, { "operationId": "revokePerformanceGroupBuyerAccessSession", "method": "DELETE", "path": "/v1/performance-groups/{performanceGroupKey}/buyer-access-sessions/{sessionId}", "summary": "Revoke a Performance Group browser session", "tag": "Performance Groups", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "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" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "PerformanceGroupBuyerAccessRevokeResult", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "unsupported", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/performance-groups/", "url": "https://docs.seatlayer.io/server-api/performance-groups/" } }, { "operationId": "retrievePerformanceGroupHold", "method": "GET", "path": "/v1/performance-groups/{performanceGroupKey}/holds/{operationId}", "summary": "Inspect the trusted allocation of a group hold", "tag": "Performance Groups", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "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" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "PerformanceGroupHoldEnvelope", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "not-applicable", "automaticRetry": true, "retryClass": "transient-read", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "performance_group_integrity_error" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/performance-groups/", "url": "https://docs.seatlayer.io/server-api/performance-groups/" } }, { "operationId": "bookPerformanceGroupHold", "method": "POST", "path": "/v1/performance-groups/{performanceGroupKey}/holds/{operationId}/book", "summary": "Book a paid Performance Group hold", "tag": "Performance Groups", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": true, "schema": "PerformanceGroupBookRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "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" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "PerformanceGroupBookingEnvelope", "description": "All group inventory was booked." }, "alternates": [ { "status": 202, "schema": "PerformanceGroupBookingEnvelope", "description": "Booking is in progress. Poll the response Location until the booking state is terminal.", "headers": [ "Location", "Retry-After" ] } ] }, "reliability": { "idempotency": "domain-exact-booking-ref", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "hold_not_active", "book_operation_mismatch", "book_failed" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "invalid_request" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/performance-groups/", "url": "https://docs.seatlayer.io/server-api/performance-groups/" } }, { "operationId": "retrievePerformanceGroupBooking", "method": "GET", "path": "/v1/performance-groups/{performanceGroupKey}/bookings/{actionId}", "summary": "Retrieve a Performance Group booking action", "tag": "Performance Groups", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "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" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "PerformanceGroupBookingEnvelope", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "not-applicable", "automaticRetry": true, "retryClass": "transient-read", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/performance-groups/", "url": "https://docs.seatlayer.io/server-api/performance-groups/" } }, { "operationId": "listSeasons", "method": "GET", "path": "/v1/seasons", "summary": "List Seasons in the workspace", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [], "queryParameters": [ { "name": "workspaceId", "description": "Active workspace id. Defaults to the caller workspace.", "schema": { "type": "string" } }, { "name": "structureState", "description": "Filter by structural lifecycle state.", "schema": { "type": "string", "enum": [ "draft", "active", "closing", "closed", "archived" ] } }, { "name": "limit", "description": "Page size. Defaults to 100 and is capped at 200.", "schema": { "type": "integer", "minimum": 1, "maximum": 200 } }, { "name": "cursor", "description": "Opaque cursor returned by the previous page.", "schema": { "type": "string" } } ] }, "success": { "primary": { "status": 200, "schema": "SeasonPage", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "not-applicable", "automaticRetry": true, "retryClass": "transient-read", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "workspace_not_found_or_disabled" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "invalid_state", "invalid_mode" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "validateSeason", "method": "POST", "path": "/v1/seasons/validate", "summary": "Preflight direct Events and active Performance Groups with exact remediation", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": true, "schema": "SeasonValidateRequest", "contentTypes": [ "application/json" ], "pathParameters": [], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "SeasonValidationEnvelope", "description": "Compatibility result with exact Event/field remediation." }, "alternates": [] }, "reliability": { "idempotency": "unsupported", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden", "module_not_enabled", "module_required" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "workspace_not_found_or_disabled" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "invalid_selection" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "createSeason", "method": "POST", "path": "/v1/seasons", "summary": "Create a draft Season catalogue", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": true, "schema": "SeasonCreateRequest", "contentTypes": [ "application/json" ], "pathParameters": [], "queryParameters": [] }, "success": { "primary": { "status": 201, "schema": "SeasonEnvelope", "description": "Season created as a draft with sales closed." }, "alternates": [] }, "reliability": { "idempotency": "header-replay", "automaticRetry": true, "retryClass": "exact-header-replay", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 400, "sources": [ "business" ], "codes": [ "invalid_idempotency_key" ], "reasons": [], "descriptions": [ "The request is malformed or misses a required value." ] }, { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden", "module_not_enabled", "module_required" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "event_not_found", "workspace_not_found_or_disabled" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "idempotency_conflict", "idempotency_in_progress", "workspace_mismatch", "mode_mismatch", "chart_mismatch", "chart_unavailable", "currency_mismatch", "venue_mismatch", "timezone_mismatch" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "invalid_name", "invalid_edition", "invalid_event_keys", "invalid_event_count", "channel_restricted_inventory", "unsupported_season_inventory" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "business", "maintenance" ], "codes": [ "channel_state_unavailable", "maintenance_mode" ], "reasons": [], "descriptions": [ "The service or one of its required dependencies is temporarily unavailable.", "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "retrieveSeason", "method": "GET", "path": "/v1/seasons/{seasonKey}", "summary": "Retrieve a Season and its Plans", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "SeasonEnvelope", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "not-applicable", "automaticRetry": true, "retryClass": "transient-read", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found", "season_not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "updateSeason", "method": "PATCH", "path": "/v1/seasons/{seasonKey}", "summary": "Rename a draft Season", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": true, "schema": "SeasonUpdateRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "SeasonEnvelope", "description": "Draft Season updated." }, "alternates": [] }, "reliability": { "idempotency": "header-replay", "automaticRetry": true, "retryClass": "exact-header-replay", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 400, "sources": [ "business" ], "codes": [ "invalid_idempotency_key" ], "reasons": [], "descriptions": [ "The request is malformed or misses a required value." ] }, { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found", "season_not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "not_a_draft", "revision_mismatch", "idempotency_conflict", "idempotency_in_progress" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "invalid_name", "invalid_edition", "invalid_expected_revision" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "deleteSeason", "method": "DELETE", "path": "/v1/seasons/{seasonKey}", "summary": "Discard an unused draft Season", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 204, "description": "Draft Season discarded." }, "alternates": [] }, "reliability": { "idempotency": "header-replay", "automaticRetry": true, "retryClass": "exact-header-replay", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found", "season_not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "not_a_draft" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "activateSeason", "method": "POST", "path": "/v1/seasons/{seasonKey}/activate", "summary": "Activate Season structure without publishing a Plan or opening sales", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": true, "schema": "SeasonLifecycleRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "SeasonLifecycleEnvelope", "description": "Season structure activated. Sales remain closed." }, "alternates": [ { "status": 202, "schema": "SeasonLifecycleEnvelope", "description": "Activation is durably accepted and awaiting recovery. Poll Location until terminal.", "headers": [ "Location", "Retry-After" ] } ] }, "reliability": { "idempotency": "domain-exact", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden", "module_not_enabled", "module_required" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found", "season_not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "revision_mismatch", "not_a_draft", "chart_mismatch", "chart_unavailable" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "invalid_expected_revision" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [ { "event": "season.structure.activated", "when": "After the immutable Season activation is retained." } ], "audit": [ { "surface": "season-lifecycle-audit", "actions": [ "season.structure.activated" ], "when": "The exact Season lifecycle outcome is retained.", "visibility": "public-api" } ] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "closeSeason", "method": "POST", "path": "/v1/seasons/{seasonKey}/close", "summary": "Close an active Season after sales are not open", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": true, "schema": "SeasonLifecycleRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "SeasonLifecycleEnvelope", "description": "Season structure closed." }, "alternates": [ { "status": 202, "schema": "SeasonLifecycleEnvelope", "description": "Close is durably accepted and awaiting recovery. Poll Location until terminal.", "headers": [ "Location", "Retry-After" ] } ] }, "reliability": { "idempotency": "domain-exact", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found", "season_not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "revision_mismatch", "sales_open", "sales_not_ended", "not_active" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "invalid_expected_revision" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [ { "event": "season.structure.closed", "when": "After structural close reaches its terminal state." } ], "audit": [ { "surface": "season-lifecycle-audit", "actions": [ "season.structure.closed" ], "when": "The exact Season lifecycle outcome is retained.", "visibility": "public-api" } ] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "archiveSeason", "method": "POST", "path": "/v1/seasons/{seasonKey}/archive", "summary": "Archive a closed Season while retaining recovery and audit", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": true, "schema": "SeasonLifecycleRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "SeasonLifecycleEnvelope", "description": "Closed Season archived with recovery and audit retained." }, "alternates": [ { "status": 202, "schema": "SeasonLifecycleEnvelope", "description": "Archive is durably accepted and awaiting recovery. Poll Location until terminal.", "headers": [ "Location", "Retry-After" ] } ] }, "reliability": { "idempotency": "domain-exact", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found", "season_not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "not_closed", "revision_mismatch", "lifecycle_transition_pending", "lifecycle_operation_mismatch" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "invalid_expected_revision" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [ { "event": "season.structure.archived", "when": "After a closed Season becomes archived." } ], "audit": [ { "surface": "season-lifecycle-audit", "actions": [ "season.structure.archived" ], "when": "The exact Season lifecycle outcome is retained.", "visibility": "public-api" } ] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "retrieveSeasonLifecycle", "method": "GET", "path": "/v1/seasons/{seasonKey}/lifecycle/{operationId}", "summary": "Retrieve a Season structure lifecycle operation", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "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" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "SeasonLifecycleEnvelope", "description": "Lifecycle state. A non-terminal response includes Retry-After.", "headers": [ "Retry-After" ] }, "alternates": [] }, "reliability": { "idempotency": "not-applicable", "automaticRetry": true, "retryClass": "transient-read", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found", "season_not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "createSeasonPlan", "method": "POST", "path": "/v1/seasons/{seasonKey}/plans", "summary": "Add a draft Plan to a Season edition", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": true, "schema": "SeasonPlanCreateRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 201, "schema": "SeasonPlanEnvelope", "description": "Draft Season Plan created." }, "alternates": [] }, "reliability": { "idempotency": "header-replay", "automaticRetry": true, "retryClass": "exact-header-replay", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 400, "sources": [ "business" ], "codes": [ "invalid_idempotency_key" ], "reasons": [], "descriptions": [ "The request is malformed or misses a required value." ] }, { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden", "module_not_enabled", "module_required" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found", "season_not_found", "event_not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "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" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "invalid_name", "invalid_event_keys", "invalid_event_count", "channel_restricted_inventory", "unsupported_season_inventory" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "business", "maintenance" ], "codes": [ "channel_state_unavailable", "maintenance_mode" ], "reasons": [], "descriptions": [ "The service or one of its required dependencies is temporarily unavailable.", "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "retrieveSeasonPlan", "method": "GET", "path": "/v1/seasons/{seasonKey}/plans/{planKey}", "summary": "Retrieve a Season Plan", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "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" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "SeasonPlanEnvelope", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "not-applicable", "automaticRetry": true, "retryClass": "transient-read", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found", "season_not_found", "plan_not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "publishSeasonPlan", "method": "POST", "path": "/v1/seasons/{seasonKey}/plans/{planKey}/publish", "summary": "Publish an immutable Season Plan without opening sales", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": true, "schema": "SeasonLifecycleRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "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" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "SeasonPlanPublishEnvelope", "description": "Plan published. Sales remain closed." }, "alternates": [ { "status": 202, "schema": "SeasonPlanPublishEnvelope", "description": "Plan publication is durably accepted and awaiting recovery. Poll Location until terminal.", "headers": [ "Location", "Retry-After" ] } ] }, "reliability": { "idempotency": "domain-exact", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden", "module_not_enabled", "module_required" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found", "season_not_found", "plan_not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "not_a_draft", "revision_mismatch", "chart_unavailable", "chart_mismatch", "season_not_active", "sales_not_ended" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "invalid_expected_revision", "channel_restricted_inventory", "unsupported_season_inventory" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "business", "maintenance" ], "codes": [ "channel_state_unavailable", "maintenance_mode" ], "reasons": [], "descriptions": [ "The service or one of its required dependencies is temporarily unavailable.", "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [ { "event": "season.plan.published", "when": "After immutable Plan activation is retained." } ], "audit": [ { "surface": "season-lifecycle-audit", "actions": [ "season.plan.published" ], "when": "The exact Season lifecycle outcome is retained.", "visibility": "public-api" } ] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "supersedeSeasonPlan", "method": "POST", "path": "/v1/seasons/{seasonKey}/plans/{planKey}/supersede", "summary": "Supersede a published Season Plan", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": true, "schema": "SeasonLifecycleRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "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" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "SeasonPlanPublishEnvelope", "description": "Published Plan superseded." }, "alternates": [] }, "reliability": { "idempotency": "domain-exact", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found", "season_not_found", "plan_not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "not_published", "sales_not_ended", "revision_mismatch" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "invalid_expected_revision" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [ { "event": "season.plan.superseded", "when": "After the published Plan becomes superseded." } ], "audit": [ { "surface": "season-lifecycle-audit", "actions": [ "season.plan.superseded" ], "when": "The exact Season lifecycle outcome is retained.", "visibility": "public-api" } ] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "openSeasonSales", "method": "POST", "path": "/v1/seasons/{seasonKey}/sales/open", "summary": "Open Season sales after rehearsal evidence exists", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": true, "schema": "SeasonLifecycleRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "SeasonSalesOpenEnvelope", "description": "Season sales opened. Audience remains embed_only. `warnings` names anything unproven, such as a missing checkout test, without blocking the sale." }, "alternates": [] }, "reliability": { "idempotency": "domain-exact", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden", "module_not_enabled", "module_required" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found", "season_not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "coupled_lifecycle", "invalid_transition", "revision_mismatch" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "invalid_expected_revision", "channel_restricted_inventory", "unsupported_season_inventory" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "business", "maintenance" ], "codes": [ "channel_state_unavailable", "maintenance_mode" ], "reasons": [], "descriptions": [ "The service or one of its required dependencies is temporarily unavailable.", "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [ { "event": "season.sales.opened", "when": "After sales become open." } ], "audit": [ { "surface": "season-lifecycle-audit", "actions": [ "season.sales.opened" ], "when": "The exact Season lifecycle outcome is retained.", "visibility": "public-api" } ] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "pauseSeasonSales", "method": "POST", "path": "/v1/seasons/{seasonKey}/sales/pause", "summary": "Pause open Season sales", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": true, "schema": "SeasonLifecycleRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "SeasonEnvelope", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "domain-exact", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found", "season_not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "invalid_transition", "revision_mismatch" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "invalid_expected_revision" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [ { "event": "season.sales.paused", "when": "After sales become paused." } ], "audit": [ { "surface": "season-lifecycle-audit", "actions": [ "season.sales.paused" ], "when": "The exact Season lifecycle outcome is retained.", "visibility": "public-api" } ] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "resumeSeasonSales", "method": "POST", "path": "/v1/seasons/{seasonKey}/sales/resume", "summary": "Resume paused Season sales", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": true, "schema": "SeasonLifecycleRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "SeasonSalesOpenEnvelope", "description": "Paused Season sales resumed. `warnings` carries the same advisory readiness notes as open." }, "alternates": [] }, "reliability": { "idempotency": "domain-exact", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden", "module_not_enabled", "module_required" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found", "season_not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "coupled_lifecycle", "invalid_transition", "revision_mismatch" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "invalid_expected_revision", "channel_restricted_inventory", "unsupported_season_inventory" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "business", "maintenance" ], "codes": [ "channel_state_unavailable", "maintenance_mode" ], "reasons": [], "descriptions": [ "The service or one of its required dependencies is temporarily unavailable.", "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [ { "event": "season.sales.opened", "when": "After paused sales become open." } ], "audit": [ { "surface": "season-lifecycle-audit", "actions": [ "season.sales.opened" ], "when": "The exact Season lifecycle outcome is retained.", "visibility": "public-api" } ] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "endSeasonSales", "method": "POST", "path": "/v1/seasons/{seasonKey}/sales/end", "summary": "End Season sales", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": true, "schema": "SeasonLifecycleRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "SeasonEnvelope", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "domain-exact", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found", "season_not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "invalid_transition", "revision_mismatch" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "invalid_expected_revision" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [ { "event": "season.sales.ended", "when": "After sales become terminally ended." } ], "audit": [ { "surface": "season-lifecycle-audit", "actions": [ "season.sales.ended" ], "when": "The exact Season lifecycle outcome is retained.", "visibility": "public-api" } ] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "duplicateSeasonToLive", "method": "POST", "path": "/v1/seasons/{seasonKey}/duplicate-to-live", "summary": "Duplicate a test Season to new live identities with sales closed", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": true, "schema": "SeasonDuplicateRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 201, "schema": "SeasonEnvelope", "description": "New live Season identities created with sales closed." }, "alternates": [] }, "reliability": { "idempotency": "header-replay", "automaticRetry": true, "retryClass": "exact-header-replay", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 400, "sources": [ "business" ], "codes": [ "invalid_idempotency_key" ], "reasons": [], "descriptions": [ "The request is malformed or misses a required value." ] }, { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden", "module_not_enabled", "module_required" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found", "season_not_found", "event_not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "test_season_required", "workspace_mismatch", "mode_mismatch", "chart_mismatch", "idempotency_conflict", "idempotency_in_progress" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "invalid_name", "invalid_event_keys", "invalid_event_count", "channel_restricted_inventory", "unsupported_season_inventory" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "business", "maintenance" ], "codes": [ "channel_state_unavailable", "maintenance_mode" ], "reasons": [], "descriptions": [ "The service or one of its required dependencies is temporarily unavailable.", "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "createSeasonBuyerAccessSession", "method": "POST", "path": "/v1/seasons/{seasonKey}/buyer-access-sessions", "summary": "Create a one-time Season browser access token", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": true, "schema": "SeasonBuyerAccessSessionRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 201, "schema": "SeasonBuyerAccessReveal", "description": "One-time Season browser access token created." }, "alternates": [] }, "reliability": { "idempotency": "unsupported-one-time-secret", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden", "module_not_enabled" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "season_not_active", "plan_not_published", "plan_selection_required", "chart_unavailable", "chart_mismatch", "channel_restricted_inventory", "unsupported_season_inventory" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "invalid_allowed_origin", "include_public_required", "invalid_expiry", "invalid_max_quantity", "invalid_reference", "invalid_session_purpose", "invalid_plan_activation_id", "channel_authority_unsupported" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "business", "maintenance" ], "codes": [ "channel_state_unavailable", "maintenance_mode" ], "reasons": [], "descriptions": [ "The service or one of its required dependencies is temporarily unavailable.", "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "python": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "listSeasonBuyerAccessSessions", "method": "GET", "path": "/v1/seasons/{seasonKey}/buyer-access-sessions", "summary": "List Season browser session metadata", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "queryParameters": [ { "name": "limit", "description": "Latest session records to return, capped at 100.", "schema": { "type": "integer", "minimum": 1, "maximum": 100 } } ] }, "success": { "primary": { "status": 200, "schema": "SeasonBuyerAccessSessionList", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "not-applicable", "automaticRetry": true, "retryClass": "transient-read", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "python": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "revokeSeasonBuyerAccessSession", "method": "DELETE", "path": "/v1/seasons/{seasonKey}/buyer-access-sessions/{sessionId}", "summary": "Revoke a Season browser session", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "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" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "SeasonBuyerAccessRevokeResult", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "domain-exact", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "retrieveSeasonHold", "method": "GET", "path": "/v1/seasons/{seasonKey}/holds/{operationId}", "summary": "Inspect a Season allocation without commercial amounts", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "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" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "SeasonHoldEnvelope", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "not-applicable", "automaticRetry": true, "retryClass": "transient-read", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "bookSeasonHold", "method": "POST", "path": "/v1/seasons/{seasonKey}/holds/{operationId}/book", "summary": "Book Season inventory after the host payment decision", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": true, "schema": "SeasonBookRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "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" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "SeasonBookingEnvelope", "description": "All Season inventory was booked." }, "alternates": [ { "status": 202, "schema": "SeasonBookingEnvelope", "description": "Booking is durably accepted. Poll Location until the booking is terminal.", "headers": [ "Location", "Retry-After" ] } ] }, "reliability": { "idempotency": "domain-exact-booking-ref", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "hold_not_active", "book_operation_mismatch", "book_failed" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "invalid_request" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [ { "event": "season.booking.confirmed", "when": "After all participant allocations are booked." }, { "event": "season.operation.partial_terminal", "when": "After booking reaches an explicit failed or partial terminal outcome." } ], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "retrieveSeasonBooking", "method": "GET", "path": "/v1/seasons/{seasonKey}/bookings/{actionId}", "summary": "Retrieve a Season booking action", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "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" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "SeasonBookingEnvelope", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "not-applicable", "automaticRetry": true, "retryClass": "transient-read", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "cancelSeasonBooking", "method": "POST", "path": "/v1/seasons/{seasonKey}/bookings/{actionId}/cancel", "summary": "Cancel a Season booking with an explicit right disposition", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": true, "schema": "SeasonCancelRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "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" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "SeasonBookingEnvelope", "description": "Season booking cancelled with an explicit right disposition." }, "alternates": [ { "status": 202, "schema": "SeasonBookingEnvelope", "description": "Cancellation is durably accepted. Poll Location until the cancellation is terminal.", "headers": [ "Location", "Retry-After" ] } ] }, "reliability": { "idempotency": "domain-exact", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "booking_not_cancellable", "cancel_operation_mismatch", "active_occurrence_return", "hosted_order_use_refund" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "invalid_request", "right_disposition_required" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [ { "event": "season.booking.cancelled", "when": "After all participant allocations are cancelled." }, { "event": "season.operation.partial_terminal", "when": "After cancellation reaches an explicit failed or partial terminal outcome." } ], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "validateSeasonBuyerRehearsal", "method": "POST", "path": "/v1/seasons/{seasonKey}/buyer-rehearsals/validate", "summary": "Discover and validate retained buyer rehearsal evidence", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "SeasonBuyerRehearsalEnvelope", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "domain-exact", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "rehearsal_incomplete" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "invalid_request" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [ { "surface": "season-lifecycle-audit", "actions": [ "season.buyer_rehearsal.validated" ], "when": "The exact Season lifecycle outcome is retained.", "visibility": "public-api" } ] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "python": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "createSeasonHolderImport", "method": "POST", "path": "/v1/seasons/{seasonKey}/imports", "summary": "Dry-run or commit an incumbent holder/right import", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": true, "schema": "SeasonHolderImportRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 201, "schema": "SeasonHolderImportEnvelope", "description": "Incumbent holder import committed." }, "alternates": [ { "status": 200, "schema": "SeasonHolderImportEnvelope", "description": "Dry-run or rejected import recorded; no rights created." } ] }, "reliability": { "idempotency": "header-replay", "automaticRetry": true, "retryClass": "exact-header-replay", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 400, "sources": [ "business" ], "codes": [ "invalid_idempotency_key" ], "reasons": [], "descriptions": [ "The request is malformed or misses a required value." ] }, { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden", "module_not_enabled" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found", "season_not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "season_not_active", "plan_not_published", "import_mismatch", "idempotency_conflict", "idempotency_in_progress" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "invalid_request", "invalid_rows", "invalid_row", "invalid_successor_plan", "unknown_seat", "duplicate_row_id", "invalid_holder_email", "invalid_holder_name" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "createSeasonHolderImportFromSeason", "method": "POST", "path": "/v1/seasons/{seasonKey}/imports/from-season", "summary": "Dry-run or commit renewal rights derived from a previous season's holders", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": true, "schema": "SeasonHolderImportFromSeasonRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 201, "schema": "SeasonHolderImportFromSeasonEnvelope", "description": "Holders brought across; rejected rows reported." }, "alternates": [ { "status": 200, "schema": "SeasonHolderImportFromSeasonEnvelope", "description": "Dry run: who would come across; nothing created." } ] }, "reliability": { "idempotency": "header-replay", "automaticRetry": true, "retryClass": "exact-header-replay", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 400, "sources": [ "business" ], "codes": [ "invalid_idempotency_key" ], "reasons": [], "descriptions": [ "The request is malformed or misses a required value." ] }, { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden", "module_not_enabled" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found", "season_not_found", "source_season_not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "season_not_active", "plan_not_published", "source_too_large", "import_mismatch", "idempotency_conflict", "idempotency_in_progress" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "invalid_request", "invalid_source_season", "invalid_successor_plan", "invalid_rows" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "retrieveSeasonHolderImport", "method": "GET", "path": "/v1/seasons/{seasonKey}/imports/{importId}", "summary": "Retrieve an incumbent holder import", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "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" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "SeasonHolderImportEnvelope", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "not-applicable", "automaticRetry": true, "retryClass": "transient-read", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "createSeasonRenewalOffers", "method": "POST", "path": "/v1/seasons/{seasonKey}/renewal-offers", "summary": "Generate one renewal offer per eligible prior Contract", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": true, "schema": "SeasonRenewalOfferCreateRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 201, "schema": "SeasonRenewalOfferList", "description": "One offer per eligible prior Contract." }, "alternates": [] }, "reliability": { "idempotency": "header-replay", "automaticRetry": true, "retryClass": "exact-header-replay", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 400, "sources": [ "business" ], "codes": [ "invalid_idempotency_key" ], "reasons": [], "descriptions": [ "The request is malformed or misses a required value." ] }, { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden", "module_not_enabled" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "season_not_active", "plan_not_published", "plan_selection_required", "offer_plan_mismatch", "idempotency_conflict", "idempotency_in_progress" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "invalid_successor_plan", "invalid_deadline" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [ { "event": "season.renewal.offered", "when": "For each newly materialized renewal offer." }, { "event": "season.renewal.lapsed", "when": "If an existing offer is first observed after its deadline." } ], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "python": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "listSeasonRenewalOffers", "method": "GET", "path": "/v1/seasons/{seasonKey}/renewal-offers", "summary": "List Season renewal offers", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "SeasonRenewalOfferList", "description": "Latest 100 renewal offers; truncated reports whether older offers exist." }, "alternates": [] }, "reliability": { "idempotency": "not-applicable", "automaticRetry": true, "retryClass": "transient-read", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] } ], "sideEffects": { "webhooks": [ { "event": "season.renewal.lapsed", "when": "If an offer is first observed after its deadline." } ], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "retrieveSeasonRenewalOffer", "method": "GET", "path": "/v1/seasons/{seasonKey}/renewal-offers/{offerId}", "summary": "Retrieve a Season renewal offer", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "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" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "SeasonRenewalOfferEnvelope", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "not-applicable", "automaticRetry": true, "retryClass": "transient-read", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] } ], "sideEffects": { "webhooks": [ { "event": "season.renewal.lapsed", "when": "If the offer is first observed after its deadline." } ], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "extendSeasonRenewalOffer", "method": "POST", "path": "/v1/seasons/{seasonKey}/renewal-offers/{offerId}/extend", "summary": "Extend a non-terminal renewal offer deadline", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": true, "schema": "SeasonRenewalOfferExtendRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "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" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "SeasonRenewalOfferEnvelope", "description": "Offer deadline extended." }, "alternates": [] }, "reliability": { "idempotency": "domain-exact", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "offer_terminal", "order_edit_in_progress" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "invalid_deadline" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [ { "event": "season.renewal.lapsed", "when": "If the offer is already past its deadline." } ], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "inspectSeasonRenewalOffer", "method": "GET", "path": "/v1/seasons/{seasonKey}/renewal-offers/{offerId}/inspect", "summary": "Inspect the exact Seat Right set and successor Plan of an offer", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "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" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "SeasonRenewalOfferEnvelope", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "not-applicable", "automaticRetry": true, "retryClass": "transient-read", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] } ], "sideEffects": { "webhooks": [ { "event": "season.renewal.lapsed", "when": "If the offer is first observed after its deadline." } ], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "commitSeasonRenewalOffer", "method": "POST", "path": "/v1/seasons/{seasonKey}/renewal-offers/{offerId}/commit", "summary": "Commit a renewal offer after holder intent and host payment", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": true, "schema": "SeasonRenewalOfferCommitRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "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" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "SeasonRenewalOfferEnvelope", "description": "Renewal committed to a host-confirmed Contract." }, "alternates": [ { "status": 202, "schema": "SeasonRenewalOfferEnvelope", "description": "Renewal commit is durably accepted. Poll Location until the offer is terminal.", "headers": [ "Location", "Retry-After" ] } ] }, "reliability": { "idempotency": "domain-exact-booking-ref", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "intent_required", "plan_activation_mismatch", "commit_mismatch", "plan_not_published", "payment_in_progress" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "invalid_request" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [ { "event": "season.renewal.lapsed", "when": "If commit first observes an expired offer." }, { "event": "season.renewal.renewed", "when": "After every EventDO participant commits exactly once." }, { "event": "season.operation.partial_terminal", "when": "After renewal commit reaches an explicit terminal participant exception." } ], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "declineSeasonRenewalOffer", "method": "POST", "path": "/v1/seasons/{seasonKey}/renewal-offers/{offerId}/decline", "summary": "Decline a renewal offer and release the Seat Right set", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "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" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "SeasonRenewalOfferEnvelope", "description": "Offer declined and Seat Rights released." }, "alternates": [] }, "reliability": { "idempotency": "domain-exact", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "offer_terminal", "order_edit_in_progress", "payment_in_progress" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [ { "event": "season.renewal.lapsed", "when": "If decline first observes an expired offer." }, { "event": "season.renewal.declined", "when": "After the offer is declined and its Seat Right is released." } ], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "releaseSeasonRenewalOffer", "method": "POST", "path": "/v1/seasons/{seasonKey}/renewal-offers/{offerId}/release", "summary": "Release a lapsed renewal offer into new-sale inventory", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "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" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "SeasonRenewalOfferEnvelope", "description": "Lapsed offer released into new-sale inventory." }, "alternates": [] }, "reliability": { "idempotency": "domain-exact", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "offer_not_lapsed", "order_edit_in_progress", "payment_in_progress" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [ { "event": "season.renewal.lapsed", "when": "If release first observes an expired offer." }, { "event": "season.renewal.released", "when": "After the lapsed Seat Right is released." } ], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "listSeasonPerformances", "method": "GET", "path": "/v1/seasons/{seasonKey}/performances", "summary": "List Season performances and package membership in every lifecycle state", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "SeasonPerformanceList", "description": "Catalogue schedule and package membership. Answers in every lifecycle state, including draft." }, "alternates": [] }, "reliability": { "idempotency": "not-applicable", "automaticRetry": true, "retryClass": "transient-read", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "python": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "createSeasonPerformances", "method": "POST", "path": "/v1/seasons/{seasonKey}/performances", "summary": "Create performances inside a draft Season from a repeat rule", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": true, "schema": "SeasonPerformanceCreateRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 201, "schema": "SeasonPerformanceCreateEnvelope", "description": "Performances created on the Season chart and attached to the chosen packages." }, "alternates": [] }, "reliability": { "idempotency": "header-replay", "automaticRetry": true, "retryClass": "exact-header-replay", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 400, "sources": [ "business" ], "codes": [ "invalid_idempotency_key" ], "reasons": [], "descriptions": [ "The request is malformed or misses a required value." ] }, { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 402, "sources": [ "business" ], "codes": [ "insufficient_credits" ], "reasons": [], "descriptions": [ "The account does not have enough credits for this operation." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden", "module_not_enabled" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found", "event_not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "season_not_draft", "chart_mismatch", "chart_unavailable", "revision_mismatch", "idempotency_conflict" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "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" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [ { "event": "event.created", "when": "Once per performance created on the Season chart." } ], "audit": [ { "surface": "season-lifecycle-audit", "actions": [ "season.draft.performances_attached" ], "when": "The exact Season lifecycle outcome is retained.", "visibility": "public-api" } ] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "python": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "attachSeasonPerformances", "method": "POST", "path": "/v1/seasons/{seasonKey}/performances/attach", "summary": "Attach existing Events to a draft Season and its packages", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": true, "schema": "SeasonPerformanceAttachRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "SeasonPerformanceList", "description": "Existing Events attached to the draft Season." }, "alternates": [] }, "reliability": { "idempotency": "header-replay", "automaticRetry": true, "retryClass": "exact-header-replay", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 400, "sources": [ "business" ], "codes": [ "invalid_idempotency_key" ], "reasons": [], "descriptions": [ "The request is malformed or misses a required value." ] }, { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden", "module_not_enabled" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found", "event_not_found", "plan_not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "season_not_draft", "plan_not_draft", "plan_source_group_locked", "revision_mismatch" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "invalid_event_keys", "invalid_plan_keys", "too_many_performances", "incompatible_events" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [ { "surface": "season-lifecycle-audit", "actions": [ "season.draft.performances_attached" ], "when": "The exact Season lifecycle outcome is retained.", "visibility": "public-api" } ] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "python": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "deleteSeasonPerformance", "method": "DELETE", "path": "/v1/seasons/{seasonKey}/performances/{eventKey}", "summary": "Remove a performance from a draft Season and every package", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "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" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "SeasonPerformanceList", "description": "Performance removed from the draft Season." }, "alternates": [] }, "reliability": { "idempotency": "header-replay", "automaticRetry": true, "retryClass": "exact-header-replay", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 400, "sources": [ "business" ], "codes": [ "invalid_idempotency_key" ], "reasons": [], "descriptions": [ "The request is malformed or misses a required value." ] }, { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden", "module_not_enabled" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found", "event_not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "season_not_draft", "plan_not_draft", "plan_source_group_locked", "revision_mismatch" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "too_few_performances" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [ { "surface": "season-lifecycle-audit", "actions": [ "season.draft.performance_removed" ], "when": "The exact Season lifecycle outcome is retained.", "visibility": "public-api" } ] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "python": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "updateSeasonPlan", "method": "PATCH", "path": "/v1/seasons/{seasonKey}/plans/{planKey}", "summary": "Rename a draft package or change the performances it covers", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": true, "schema": "SeasonPlanUpdateRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "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" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "SeasonPackageEnvelope", "description": "Draft package renamed or re-scoped." }, "alternates": [] }, "reliability": { "idempotency": "header-replay", "automaticRetry": true, "retryClass": "exact-header-replay", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 400, "sources": [ "business" ], "codes": [ "invalid_idempotency_key" ], "reasons": [], "descriptions": [ "The request is malformed or misses a required value." ] }, { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden", "module_not_enabled" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found", "plan_not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "season_not_draft", "plan_not_draft", "plan_source_group_locked", "duplicate_plan_name", "duplicate_event", "revision_mismatch" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "invalid_request", "invalid_name", "invalid_event_keys", "too_few_performances", "incompatible_events" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [ { "surface": "season-lifecycle-audit", "actions": [ "season.draft.plan_updated" ], "when": "The exact Season lifecycle outcome is retained.", "visibility": "public-api" } ] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "python": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "deleteSeasonPlan", "method": "DELETE", "path": "/v1/seasons/{seasonKey}/plans/{planKey}", "summary": "Delete a draft package that is not the last one", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "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" } } ], "queryParameters": [] }, "success": { "primary": { "status": 204, "description": "Draft package deleted." }, "alternates": [] }, "reliability": { "idempotency": "header-replay", "automaticRetry": true, "retryClass": "exact-header-replay", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 400, "sources": [ "business" ], "codes": [ "invalid_idempotency_key" ], "reasons": [], "descriptions": [ "The request is malformed or misses a required value." ] }, { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden", "module_not_enabled" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found", "plan_not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "season_not_draft", "plan_not_draft", "last_plan", "revision_mismatch" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "too_few_performances" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [ { "surface": "season-lifecycle-audit", "actions": [ "season.draft.plan_deleted" ], "when": "The exact Season lifecycle outcome is retained.", "visibility": "public-api" } ] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "python": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "publishSeason", "method": "POST", "path": "/v1/seasons/{seasonKey}/publish", "summary": "Activate the Season structure and publish every draft package in one retryable call", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "SeasonPublishEnvelope", "description": "Structure activated where needed and every draft package published. Safe to retry." }, "alternates": [] }, "reliability": { "idempotency": "header-replay", "automaticRetry": true, "retryClass": "exact-header-replay", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 400, "sources": [ "business" ], "codes": [ "invalid_idempotency_key" ], "reasons": [], "descriptions": [ "The request is malformed or misses a required value." ] }, { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden", "module_not_enabled" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found", "season_not_found", "plan_not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "too_few_performances", "publish_pending", "revision_mismatch", "source_group_changed", "chart_mismatch", "chart_unavailable" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "channel_restricted_inventory" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "business", "maintenance" ], "codes": [ "channel_state_unavailable", "maintenance_mode" ], "reasons": [], "descriptions": [ "The service or one of its required dependencies is temporarily unavailable.", "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [ { "event": "season.structure.activated", "when": "When the call activates a still-draft Season." }, { "event": "season.plan.published", "when": "Once per draft package the call publishes." } ], "audit": [ { "surface": "season-lifecycle-audit", "actions": [ "season.structure.activated", "season.plan.published" ], "when": "The exact Season lifecycle outcome is retained.", "visibility": "public-api" } ] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "python": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "createSeasonCheckoutTest", "method": "POST", "path": "/v1/seasons/{seasonKey}/checkout-tests", "summary": "Run a server-side hold and release to prove the Season buyer path", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": false, "schema": "SeasonCheckoutTestRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "SeasonCheckoutTestEnvelope", "description": "Checkout test completed. `status` says whether every step passed; nothing is ever booked." }, "alternates": [] }, "reliability": { "idempotency": "header-replay", "automaticRetry": true, "retryClass": "exact-header-replay", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 400, "sources": [ "business" ], "codes": [ "invalid_idempotency_key" ], "reasons": [], "descriptions": [ "The request is malformed or misses a required value." ] }, { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden", "module_not_enabled" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found", "plan_not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "season_not_active", "plan_not_published" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "invalid_plan_key", "invalid_quantity" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [ { "event": "season.hold.committed", "when": "The test hold is a real Season allocation." }, { "event": "season.hold.released", "when": "The test hold is always released; nothing is booked." } ], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "python": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "listSeasonCheckoutTests", "method": "GET", "path": "/v1/seasons/{seasonKey}/checkout-tests", "summary": "List recent Season checkout tests, newest first", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "SeasonCheckoutTestList", "description": "Up to twenty checkout tests, newest first." }, "alternates": [] }, "reliability": { "idempotency": "not-applicable", "automaticRetry": true, "retryClass": "transient-read", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "python": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "replaceSeasonPackagePrices", "method": "PUT", "path": "/v1/seasons/{seasonKey}/plans/{planKey}/prices", "summary": "Replace a package price table, per chart category, in minor units", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": true, "schema": "SeasonPackagePricesRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "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" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "SeasonPackagePricesEnvelope", "description": "Package price table replaced. Categories absent from the body stop being priced." }, "alternates": [] }, "reliability": { "idempotency": "header-replay", "automaticRetry": true, "retryClass": "exact-header-replay", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 400, "sources": [ "business" ], "codes": [ "invalid_idempotency_key" ], "reasons": [], "descriptions": [ "The request is malformed or misses a required value." ] }, { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden", "module_not_enabled" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found", "plan_not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "invalid_prices", "invalid_currency", "currency_mismatch", "invalid_category_key", "duplicate_category_key", "invalid_unit_price" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "python": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "listSeasonPrices", "method": "GET", "path": "/v1/seasons/{seasonKey}/prices", "summary": "List every package price table for a Season", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "SeasonPriceList", "description": "Every package and its priced categories." }, "alternates": [] }, "reliability": { "idempotency": "not-applicable", "automaticRetry": true, "retryClass": "transient-read", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "python": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "attachSeasonPlanPerformance", "method": "POST", "path": "/v1/seasons/{seasonKey}/plans/{planKey}/performances", "summary": "Add a performance to a published package and extend its allocations", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": true, "schema": "SeasonAttachPerformanceRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "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" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "SeasonAmendmentPerformanceEnvelope", "description": "The performance joined the published package; extended allocations and unresolved conflicts are listed." }, "alternates": [] }, "reliability": { "idempotency": "header-replay", "automaticRetry": true, "retryClass": "exact-header-replay", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 400, "sources": [ "business" ], "codes": [ "invalid_idempotency_key" ], "reasons": [], "descriptions": [ "The request is malformed or misses a required value." ] }, { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden", "module_not_enabled" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found", "plan_not_found", "event_not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "season_not_published", "plan_not_published", "revision_mismatch", "amendment_in_flight", "chart_mismatch", "chart_unavailable", "idempotency_conflict" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "invalid_event_key", "incompatible_events", "too_many_performances" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [ { "event": "season.performance.added", "when": "Once per package the performance joins." }, { "event": "season.amendment.applied", "when": "Every amendment is announced on the shared event too." } ], "audit": [ { "surface": "season-lifecycle-audit", "actions": [ "season.amendment.applied" ], "when": "The exact Season lifecycle outcome is retained.", "visibility": "public-api" } ] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "python": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "deleteSeasonPlanPerformance", "method": "DELETE", "path": "/v1/seasons/{seasonKey}/plans/{planKey}/performances/{eventKey}", "summary": "Remove a performance from a published package and release its allocations", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "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" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "SeasonRemovePerformanceEnvelope", "description": "The package no longer covers the performance; its allocations were released to that Event." }, "alternates": [] }, "reliability": { "idempotency": "header-replay", "automaticRetry": true, "retryClass": "exact-header-replay", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 400, "sources": [ "business" ], "codes": [ "invalid_idempotency_key" ], "reasons": [], "descriptions": [ "The request is malformed or misses a required value." ] }, { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden", "module_not_enabled" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found", "plan_not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "season_not_published", "plan_not_published", "revision_mismatch", "amendment_in_flight", "idempotency_conflict" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "too_few_performances" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [ { "event": "season.performance.removed", "when": "After the package loses the performance and its allocations are released." }, { "event": "season.amendment.applied", "when": "Every amendment is announced on the shared event too." } ], "audit": [ { "surface": "season-lifecycle-audit", "actions": [ "season.amendment.applied" ], "when": "The exact Season lifecycle outcome is retained.", "visibility": "public-api" } ] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "python": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "markSeasonPerformancePast", "method": "POST", "path": "/v1/seasons/{seasonKey}/performances/{eventKey}/past", "summary": "Mark a performance past so it stops blocking new Season sales", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": true, "schema": "SeasonMarkPastRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "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" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "SeasonPerformanceList", "description": "The performance is past for Season purposes and no longer blocks a new sale." }, "alternates": [] }, "reliability": { "idempotency": "header-replay", "automaticRetry": true, "retryClass": "exact-header-replay", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 400, "sources": [ "business" ], "codes": [ "invalid_idempotency_key" ], "reasons": [], "descriptions": [ "The request is malformed or misses a required value." ] }, { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden", "module_not_enabled" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found", "event_not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "season_not_published", "idempotency_conflict" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "not_yet_past" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [ { "event": "season.performance.past", "when": "Once, when the performance is first declared past." }, { "event": "season.amendment.applied", "when": "Every amendment is announced on the shared event too." } ], "audit": [ { "surface": "season-lifecycle-audit", "actions": [ "season.amendment.applied" ], "when": "The exact Season lifecycle outcome is retained.", "visibility": "public-api" } ] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "python": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "listSeasonOccurrences", "method": "GET", "path": "/v1/seasons/{seasonKey}/occurrences", "summary": "List Season occurrences with schedule and amendment state", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "queryParameters": [ { "name": "planActivationId", "description": "Published Plan activation to inspect. Required when multiple Plans are published.", "schema": { "type": "string", "minLength": 1, "maxLength": 160 } } ] }, "success": { "primary": { "status": 200, "schema": "SeasonOccurrenceList", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "not-applicable", "automaticRetry": true, "retryClass": "transient-read", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found", "season_not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "plan_not_published", "plan_selection_required" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "invalid_plan_activation_id" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "python": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "returnSeasonOccurrenceInventory", "method": "POST", "path": "/v1/seasons/{seasonKey}/occurrences/{eventKey}/returns", "summary": "Return one Season occurrence allocation to ordinary Event inventory", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": true, "schema": "SeasonOccurrenceReturnRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "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" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "SeasonOccurrenceInventoryActionEnvelope", "description": "Occurrence inventory returned to ordinary Event sale." }, "alternates": [] }, "reliability": { "idempotency": "domain-exact", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden", "module_not_enabled" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "occurrence_action_mismatch", "request_mismatch", "source_not_active", "conflict", "hosted_order_use_date_cancel" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "invalid_request" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "business", "maintenance" ], "codes": [ "participant_unavailable", "order_edit_in_progress", "maintenance_mode" ], "reasons": [], "descriptions": [ "The service or one of its required dependencies is temporarily unavailable.", "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [ { "event": "season.occurrence.returned", "when": "After one booked Season occurrence is returned to ordinary Event inventory." } ], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "baseline-replay-pending", "publishedArtifact": "not-verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "python": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "reclaimSeasonOccurrenceInventory", "method": "POST", "path": "/v1/seasons/{seasonKey}/occurrences/{eventKey}/reclaims", "summary": "Reclaim returned occurrence inventory while it is still free", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": true, "schema": "SeasonOccurrenceReclaimRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "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" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "SeasonOccurrenceInventoryActionEnvelope", "description": "Returned occurrence inventory reclaimed by the Season holder." }, "alternates": [] }, "reliability": { "idempotency": "domain-exact", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden", "module_not_enabled" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "occurrence_action_mismatch", "request_mismatch", "source_not_active", "return_not_active", "conflict", "hosted_order_use_date_cancel" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "invalid_request" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "business", "maintenance" ], "codes": [ "participant_unavailable", "order_edit_in_progress", "maintenance_mode" ], "reasons": [], "descriptions": [ "The service or one of its required dependencies is temporarily unavailable.", "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [ { "event": "season.occurrence.reclaimed", "when": "After still-free returned inventory is restored to the Season holder." } ], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "baseline-replay-pending", "publishedArtifact": "not-verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "python": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "createSeasonAmendment", "method": "POST", "path": "/v1/seasons/{seasonKey}/amendments", "summary": "Record an identity-preserving reschedule or an operator exception", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": true, "schema": "SeasonAmendmentRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 201, "schema": "SeasonAmendmentEnvelope", "description": "Amendment recorded. Published Plan membership is unchanged." }, "alternates": [] }, "reliability": { "idempotency": "header-replay", "automaticRetry": true, "retryClass": "exact-header-replay", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 400, "sources": [ "business" ], "codes": [ "invalid_idempotency_key" ], "reasons": [], "descriptions": [ "The request is malformed or misses a required value." ] }, { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "forbidden", "module_not_enabled" ], "reasons": [], "descriptions": [ "The caller lacks authority or its credential mode conflicts." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found", "season_not_found", "occurrence_not_in_plan" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "occurrence_membership_immutable", "occurrence_shared_across_plans", "plan_not_published", "plan_selection_required", "inventory_identity_changed", "idempotency_conflict", "idempotency_in_progress" ], "reasons": [], "descriptions": [ "The request conflicts with current resource or inventory state." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "invalid_request", "invalid_kind", "invalid_plan_activation_id" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "python": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "listSeasonAmendments", "method": "GET", "path": "/v1/seasons/{seasonKey}/amendments", "summary": "List Season amendments", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "SeasonAmendmentList", "description": "Latest 100 amendments; truncated reports whether older amendments exist." }, "alternates": [] }, "reliability": { "idempotency": "not-applicable", "automaticRetry": true, "retryClass": "transient-read", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "python": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "retrieveSeasonAmendment", "method": "GET", "path": "/v1/seasons/{seasonKey}/amendments/{amendmentId}", "summary": "Retrieve a Season amendment", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "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" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "SeasonAmendmentEnvelope", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "not-applicable", "automaticRetry": true, "retryClass": "transient-read", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "retrieveSeasonReport", "method": "GET", "path": "/v1/seasons/{seasonKey}/reports", "summary": "Retrieve inventory, renewal, operation, and outbox totals", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "SeasonReportEnvelope", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "not-applicable", "automaticRetry": true, "retryClass": "transient-read", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "listSeasonOperations", "method": "GET", "path": "/v1/seasons/{seasonKey}/operations", "summary": "List Season inventory operations including stuck work", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "SeasonOperationList", "description": "Latest 50 operations; truncated reports whether older operations exist." }, "alternates": [] }, "reliability": { "idempotency": "not-applicable", "automaticRetry": true, "retryClass": "transient-read", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "retrieveSeasonSupportLookup", "method": "GET", "path": "/v1/seasons/{seasonKey}/support-lookups", "summary": "Look up a booking or holder reference without refund claims", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "queryParameters": [ { "name": "bookingRef", "description": "Opaque host booking reference.", "schema": { "type": "string" } }, { "name": "holderRef", "description": "Opaque holder reference.", "schema": { "type": "string" } } ] }, "success": { "primary": { "status": 200, "schema": "SeasonSupportLookupEnvelope", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "not-applicable", "automaticRetry": true, "retryClass": "transient-read", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "lookup_ref_required" ], "reasons": [], "descriptions": [ "The request is well formed but violates an operation rule." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "listSeasonOutbox", "method": "GET", "path": "/v1/seasons/{seasonKey}/outbox", "summary": "List the Season missed-event outbox", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "SeasonOutboxList", "description": "Latest 100 outbox occurrences; truncated reports whether older occurrences exist." }, "alternates": [] }, "reliability": { "idempotency": "not-applicable", "automaticRetry": true, "retryClass": "transient-read", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "replaySeasonOutbox", "method": "POST", "path": "/v1/seasons/{seasonKey}/outbox/{occurrenceId}/replay", "summary": "Replay one Season outbox occurrence with the same payload", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "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" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "SeasonOutboxReplayEnvelope", "description": "Outbox occurrence replayed with the original payload." }, "alternates": [] }, "reliability": { "idempotency": "unsupported", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "listSeasonAudit", "method": "GET", "path": "/v1/seasons/{seasonKey}/audit", "summary": "List the redacted Season support audit", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "SeasonAuditEnvelope", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "not-applicable", "automaticRetry": true, "retryClass": "transient-read", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "exportSeasonSupportSnapshot", "method": "GET", "path": "/v1/seasons/{seasonKey}/export", "summary": "Export a bounded, versioned Season support snapshot", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "SeasonSupportExportEnvelope", "description": "Successful response." }, "alternates": [] }, "reliability": { "idempotency": "not-applicable", "automaticRetry": true, "retryClass": "transient-read", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such resource exists in the caller scope." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "python": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "listSeasonHolders", "method": "GET", "path": "/v1/seasons/{seasonKey}/holders", "summary": "List season ticket holders, one page at a time", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "queryParameters": [ { "name": "q", "description": "Search by holder name, email, reference, order number or seat.", "schema": { "type": "string", "maxLength": 120 } }, { "name": "status", "description": "Only these holders.", "schema": { "type": "string", "enum": [ "active", "cancelled", "renewal" ] } }, { "name": "cursor", "description": "Opaque cursor returned by the previous page.", "schema": { "type": "string" } }, { "name": "limit", "description": "Page size. Defaults to 50 and is capped at 100.", "schema": { "type": "integer", "minimum": 1, "maximum": 100 } } ] }, "success": { "primary": { "status": 200, "schema": "SeasonHolderPage", "description": "One page of holders. `totals` comes with the first page." }, "alternates": [] }, "reliability": { "idempotency": "not-applicable", "automaticRetry": true, "retryClass": "transient-read", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 400, "sources": [ "business" ], "codes": [ "invalid_status", "invalid_cursor" ], "reasons": [], "descriptions": [ "The status or cursor is not valid." ] }, { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "publishable_key_not_allowed" ], "reasons": [], "descriptions": [ "A publishable key was sent. These calls need a secret key." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such season, order or offer for this key and mode." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "python": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "refundSeasonOrder", "method": "POST", "path": "/v1/seasons/{seasonKey}/orders/{orderId}/refund", "summary": "Refund a season order in full or in part through its payment provider", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": false, "schema": "SeasonOrderRefundRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "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" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "SeasonOrderRefundEnvelope", "description": "The payment provider confirmed the refund." }, "alternates": [ { "status": 202, "schema": "SeasonOrderRefundEnvelope", "description": "The provider accepted the refund but has not confirmed it. Retry with the same Idempotency-Key to read its state." } ] }, "reliability": { "idempotency": "header-replay", "automaticRetry": true, "retryClass": "exact-header-replay", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 400, "sources": [ "business" ], "codes": [ "idempotency_key_required", "invalid_idempotency_key" ], "reasons": [], "descriptions": [ "The Idempotency-Key header is missing or not valid." ] }, { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "publishable_key_not_allowed" ], "reasons": [], "descriptions": [ "A publishable key was sent. These calls need a secret key." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such season, order or offer for this key and mode." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "not_refundable", "already_refunded", "gateway_not_connected", "order_edit_in_progress", "refund_unavailable", "refund_failed", "idempotency_conflict", "idempotency_in_progress" ], "reasons": [], "descriptions": [ "The order cannot be refunded as asked right now." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "invalid_amount" ], "reasons": [], "descriptions": [ "The amount is not a whole number above zero, or is more than is left." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 502, "sources": [ "business" ], "codes": [ "refund_recovery_required" ], "reasons": [], "descriptions": [ "The provider may have taken the refund; retry with the same Idempotency-Key." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [ { "event": "season.order.refunded", "when": "Once per refund, full or partial, when the provider confirms it." }, { "event": "season.booking.cancelled", "when": "A full refund gives every date back." } ], "audit": [ { "surface": "order-audit", "actions": [ "partially_refunded", "refunded" ], "when": "The order change is committed.", "visibility": "excluded-organizer-surface" } ] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "python": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "cancelSeasonOrder", "method": "POST", "path": "/v1/seasons/{seasonKey}/orders/{orderId}/cancel", "summary": "Cancel a season order without moving money and release every date", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": true, "schema": "SeasonOrderCancelRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "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" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "SeasonOrderCancelEnvelope", "description": "Order cancelled, every ticket void and every date released." }, "alternates": [] }, "reliability": { "idempotency": "header-replay", "automaticRetry": true, "retryClass": "exact-header-replay", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 400, "sources": [ "business" ], "codes": [ "idempotency_key_required", "invalid_idempotency_key" ], "reasons": [], "descriptions": [ "The Idempotency-Key header is missing or not valid." ] }, { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "publishable_key_not_allowed" ], "reasons": [], "descriptions": [ "A publishable key was sent. These calls need a secret key." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such season, order or offer for this key and mode." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "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" ], "reasons": [], "descriptions": [ "The order cannot be cancelled here right now." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "invalid_reason", "cancellation_reason_required", "used_tickets_acknowledgement_required", "external_refund_confirmation_required" ], "reasons": [], "descriptions": [ "A reason, or a confirmation, is missing." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [ { "event": "season.booking.cancelled", "when": "Every date of the order is given back." } ], "audit": [ { "surface": "order-audit", "actions": [ "order_cancelled_without_refund" ], "when": "The order change is committed.", "visibility": "excluded-organizer-surface" } ] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "python": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "cancelSeasonOrderDate", "method": "POST", "path": "/v1/seasons/{seasonKey}/orders/{orderId}/dates/{eventKey}/cancel", "summary": "Take back one date of a season order and put its seats back on sale", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": false, "schema": "SeasonOrderDateCancelRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "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" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "SeasonOrderDateCancelEnvelope", "description": "The date's tickets are void and its seats are back on sale." }, "alternates": [ { "status": 202, "schema": "SeasonOrderDateCancelEnvelope", "description": "The tickets are void and the seats are on their way back. Retry with the same Idempotency-Key.", "headers": [ "Retry-After" ] } ] }, "reliability": { "idempotency": "header-replay", "automaticRetry": true, "retryClass": "exact-header-replay", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 400, "sources": [ "business" ], "codes": [ "idempotency_key_required", "invalid_idempotency_key" ], "reasons": [], "descriptions": [ "The Idempotency-Key header is missing or not valid." ] }, { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "publishable_key_not_allowed" ], "reasons": [], "descriptions": [ "A publishable key was sent. These calls need a secret key." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such season, order or offer for this key and mode." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "order_not_active", "date_not_held", "date_already_used", "idempotency_conflict", "idempotency_in_progress" ], "reasons": [], "descriptions": [ "The order or the date cannot be taken back." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "invalid_request" ], "reasons": [], "descriptions": [ "The action id or the date key is not valid." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [ { "event": "season.occurrence.returned", "when": "The date's seats are back on sale." } ], "audit": [ { "surface": "order-audit", "actions": [ "season_date_cancelled" ], "when": "The order change is committed.", "visibility": "excluded-organizer-surface" } ] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "python": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "resendSeasonOrderTickets", "method": "POST", "path": "/v1/seasons/{seasonKey}/orders/{orderId}/resend", "summary": "Email a season order's tickets again", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": false, "schema": "SeasonOrderResendRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "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" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "SeasonOrderResendEnvelope", "description": "The tickets were emailed to `sentTo`." }, "alternates": [] }, "reliability": { "idempotency": "unsupported", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "publishable_key_not_allowed" ], "reasons": [], "descriptions": [ "A publishable key was sent. These calls need a secret key." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such season, order or offer for this key and mode." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "no_tickets", "no_buyer_email", "order_edit_in_progress", "order_changed" ], "reasons": [], "descriptions": [ "There are no live tickets to send, or no address to send them to." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "invalid_email" ], "reasons": [], "descriptions": [ "The email address is not valid." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 502, "sources": [ "business" ], "codes": [ "resend_failed" ], "reasons": [], "descriptions": [ "The email could not be sent." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [ { "surface": "order-audit", "actions": [ "tickets_resent" ], "when": "The order change is committed.", "visibility": "excluded-organizer-surface" } ] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "python": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "retrieveSeasonHostedRenewals", "method": "GET", "path": "/v1/seasons/{seasonKey}/renewal-hosted", "summary": "Retrieve renewal links, payments and emails per offer", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "SeasonHostedRenewals", "description": "Link, payment and email state for each renewal offer." }, "alternates": [] }, "reliability": { "idempotency": "not-applicable", "automaticRetry": true, "retryClass": "transient-read", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "publishable_key_not_allowed" ], "reasons": [], "descriptions": [ "A publishable key was sent. These calls need a secret key." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such season, order or offer for this key and mode." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "python": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "rotateSeasonRenewalOfferLink", "method": "POST", "path": "/v1/seasons/{seasonKey}/renewal-offers/{offerId}/link", "summary": "Make a new renewal link for one holder; the old link stops working", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "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" } } ], "queryParameters": [] }, "success": { "primary": { "status": 201, "schema": "SeasonRenewalLinkEnvelope", "description": "A new renewal link. The previous link no longer works." }, "alternates": [] }, "reliability": { "idempotency": "unsupported-one-time-secret", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "publishable_key_not_allowed" ], "reasons": [], "descriptions": [ "A publishable key was sent. These calls need a secret key." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such season, order or offer for this key and mode." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "python": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "updateSeasonRenewalOfferContact", "method": "POST", "path": "/v1/seasons/{seasonKey}/renewal-offers/{offerId}/contact", "summary": "Set the name and email a renewal offer is sent to", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": true, "schema": "SeasonRenewalContactRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "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" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "SeasonRenewalContactEnvelope", "description": "Contact saved. A new email turns the current link off." }, "alternates": [] }, "reliability": { "idempotency": "domain-exact", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "publishable_key_not_allowed" ], "reasons": [], "descriptions": [ "A publishable key was sent. These calls need a secret key." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such season, order or offer for this key and mode." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "invalid_holder_email", "invalid_holder_name" ], "reasons": [], "descriptions": [ "The email or name is not valid." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "python": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "createSeasonRenewalNotices", "method": "POST", "path": "/v1/seasons/{seasonKey}/renewal-notices", "summary": "Email renewal invitations now and reminders before the deadline", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "json", "required": false, "schema": "SeasonRenewalNoticesRequest", "contentTypes": [ "application/json" ], "pathParameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "SeasonRenewalNoticesEnvelope", "description": "How many holders will get the emails, and how many have no address." }, "alternates": [] }, "reliability": { "idempotency": "domain-exact", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "publishable_key_not_allowed" ], "reasons": [], "descriptions": [ "A publishable key was sent. These calls need a secret key." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such season, order or offer for this key and mode." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "checkout_mode_not_seatlayer" ], "reasons": [], "descriptions": [ "The season does not use SeatLayer checkout; your own system emails holders." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "python": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "resendSeasonRenewalOffer", "method": "POST", "path": "/v1/seasons/{seasonKey}/renewal-offers/{offerId}/resend", "summary": "Send one holder a new renewal invitation", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "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" } } ], "queryParameters": [] }, "success": { "primary": { "status": 202, "schema": "Ok", "description": "A new invitation is on its way. The old link no longer works." }, "alternates": [] }, "reliability": { "idempotency": "unsupported", "automaticRetry": false, "retryClass": "single-attempt", "retryableFailures": [] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "publishable_key_not_allowed" ], "reasons": [], "descriptions": [ "A publishable key was sent. These calls need a secret key." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such season, order or offer for this key and mode." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "offer_not_open", "checkout_mode_not_seatlayer" ], "reasons": [], "descriptions": [ "The offer is closed, or the season does not use SeatLayer checkout." ] }, { "status": 422, "sources": [ "business" ], "codes": [ "holder_email_missing" ], "reasons": [], "descriptions": [ "The holder has no email address. Set one first." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "maintenance" ], "codes": [ "maintenance_mode" ], "reasons": [], "descriptions": [ "The API is temporarily read-only." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "python": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "retrieveSeasonSalesReport", "method": "GET", "path": "/v1/seasons/{seasonKey}/reports/sales", "summary": "Retrieve season money, seats, holders and renewals as totals", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "SeasonSalesReportEnvelope", "description": "Totals only. A section that could not be read is listed in `unavailable`." }, "alternates": [] }, "reliability": { "idempotency": "not-applicable", "automaticRetry": true, "retryClass": "transient-read", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "publishable_key_not_allowed" ], "reasons": [], "descriptions": [ "A publishable key was sent. These calls need a secret key." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such season, order or offer for this key and mode." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "python": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "retrieveSeasonSeatsReport", "method": "GET", "path": "/v1/seasons/{seasonKey}/reports/seats", "summary": "Retrieve seats still free per package and per date", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "SeasonSeatsReportEnvelope", "description": "Seats free on every date of each package, and on each date." }, "alternates": [] }, "reliability": { "idempotency": "not-applicable", "automaticRetry": true, "retryClass": "transient-read", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "publishable_key_not_allowed" ], "reasons": [], "descriptions": [ "A publishable key was sent. These calls need a secret key." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such season, order or offer for this key and mode." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "python": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "exportSeasonHoldersCsv", "method": "GET", "path": "/v1/seasons/{seasonKey}/reports/holders.csv", "summary": "Download every season ticket holder as CSV", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "queryParameters": [ { "name": "q", "description": "Search by holder name, email, reference, order number or seat.", "schema": { "type": "string", "maxLength": 120 } }, { "name": "status", "description": "Only these holders.", "schema": { "type": "string", "enum": [ "active", "cancelled", "renewal" ] } } ] }, "success": { "primary": { "status": 200, "schema": "SeasonCsvDownload", "description": "The holders as CSV, 17 columns.", "contentType": "text/csv" }, "alternates": [] }, "reliability": { "idempotency": "not-applicable", "automaticRetry": true, "retryClass": "transient-read", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 400, "sources": [ "business" ], "codes": [ "invalid_status", "invalid_cursor" ], "reasons": [], "descriptions": [ "The status or search is not valid." ] }, { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "publishable_key_not_allowed" ], "reasons": [], "descriptions": [ "A publishable key was sent. These calls need a secret key." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such season, order or offer for this key and mode." ] }, { "status": 413, "sources": [ "business" ], "codes": [ "download_too_large" ], "reasons": [], "descriptions": [ "More holders than one download can hold. Filter by status." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] }, { "status": 503, "sources": [ "business" ], "codes": [ "holders_unavailable" ], "reasons": [], "descriptions": [ "The holder list cannot be read right now. Try again shortly." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "python": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "exportSeasonOrdersCsv", "method": "GET", "path": "/v1/seasons/{seasonKey}/reports/orders.csv", "summary": "Download every season order SeatLayer took as CSV", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "SeasonCsvDownload", "description": "Every order SeatLayer took for the season, as CSV.", "contentType": "text/csv" }, "alternates": [] }, "reliability": { "idempotency": "not-applicable", "automaticRetry": true, "retryClass": "transient-read", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "publishable_key_not_allowed" ], "reasons": [], "descriptions": [ "A publishable key was sent. These calls need a secret key." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such season, order or offer for this key and mode." ] }, { "status": 409, "sources": [ "business" ], "codes": [ "season_sold_elsewhere" ], "reasons": [], "descriptions": [ "Your own checkout sells this season, so SeatLayer has no orders for it." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "python": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } }, { "operationId": "retrieveSeasonSeatCounts", "method": "GET", "path": "/v1/seasons/{seasonKey}/seat-counts", "summary": "Retrieve season seats sold per package and per date", "tag": "Seasons", "classification": { "status": "stable", "surface": "public-server-api" }, "auth": { "server": { "type": "secret-key", "tokenPrefixes": [ "sk_test_", "sk_live_" ] }, "browserManage": { "accepted": false } }, "request": { "kind": "none", "required": false, "schema": null, "contentTypes": [], "pathParameters": [ { "name": "seasonKey", "in": "path", "required": true, "description": "SeatLayer Season key.", "schema": { "type": "string" } } ], "queryParameters": [] }, "success": { "primary": { "status": 200, "schema": "SeasonSeatCountsEnvelope", "description": "Season seats sold. `seats` is null when the figures cannot be read right now." }, "alternates": [] }, "reliability": { "idempotency": "not-applicable", "automaticRetry": true, "retryClass": "transient-read", "retryableFailures": [ "connection", "408", "429", "5xx" ] }, "rateLimits": [ { "policy": "season-api", "audience": "secret-key", "limit": 600, "windowSeconds": 60, "bucket": "secret-key-id", "standardHeaders": true } ], "errors": [ { "status": 401, "sources": [ "authentication" ], "codes": [ "bad_key" ], "reasons": [], "descriptions": [ "Missing, invalid, or expired credential." ] }, { "status": 403, "sources": [ "business" ], "codes": [ "publishable_key_not_allowed" ], "reasons": [], "descriptions": [ "A publishable key was sent. These calls need a secret key." ] }, { "status": 404, "sources": [ "business" ], "codes": [ "not_found" ], "reasons": [], "descriptions": [ "No such season, order or offer for this key and mode." ] }, { "status": 429, "sources": [ "rate-limit" ], "codes": [ "rate_limited" ], "reasons": [], "descriptions": [ "The applicable operation budget is exhausted." ] }, { "status": 500, "sources": [ "server" ], "codes": [], "reasons": [], "descriptions": [ "Unexpected server error." ] } ], "sideEffects": { "webhooks": [], "audit": [] }, "support": { "rest": { "package": "SeatLayer REST API", "sourceCoverage": "implemented", "candidateVerification": "verified", "publishedArtifact": "not-verified" }, "node": { "package": "@seatlayer/server", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "python": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "php": { "package": "seatlayer/seatlayer-php", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "java": { "package": "io.seatlayer:seatlayer-java", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "go": { "package": "github.com/seatlayer/seatlayer-go", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "ruby": { "package": "seatlayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" }, "dotnet": { "package": "SeatLayer", "sourceCoverage": "not-implemented", "candidateVerification": "not-verified", "publishedArtifact": "not-verified" } }, "docs": { "path": "/server-api/seasons/", "url": "https://docs.seatlayer.io/server-api/seasons/" } } ] }