{ "$comment": "GENERATED release truth. Published package/registry status is explicitly maintained only after the immutable public artifacts and live API have been checked.", "schemaVersion": 2, "generatedFrom": [ "workers/api/src/publicApi.ts", "workers/api/src/publicApiContracts.ts", "workers/api/src/publicRateLimits.ts", "workers/api/src/publicApiOperationMetadata.ts" ], "releaseTruth": { "sourceSnapshot": "production-release", "publishedArtifacts": "verified", "note": "Each listed SDK has a verified public registry release; the matching REST API route was checked live after deployment." }, "scope": { "operations": "stable-public-only" }, "counts": { "stablePublicOperations": 92 }, "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", "distribution": "worker-isolate", "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": "ChartEnvelope", "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": "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", "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": "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": 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": "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": 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": "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", "seats_would_vanish" ], "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" ], "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/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", "distribution": "durable", "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", "distribution": "durable", "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" ], "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", "distribution": "durable", "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": "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", "distribution": "durable", "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": 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" ], "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", "distribution": "durable", "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", "distribution": "durable", "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", "distribution": "durable", "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", "distribution": "durable", "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": "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", "distribution": "durable", "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", "distribution": "durable", "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", "distribution": "durable", "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", "distribution": "durable", "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": "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", "distribution": "durable", "standardHeaders": false } ], "errors": [ { "status": 400, "sources": [ "business" ], "codes": [ "invalid_cursor", "invalid_booking_state" ], "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", "distribution": "durable", "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", "distribution": "durable", "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", "distribution": "durable", "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", "distribution": "durable", "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", "distribution": "durable", "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", "distribution": "durable", "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", "distribution": "durable", "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", "distribution": "durable", "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", "distribution": "durable", "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", "distribution": "durable", "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", "distribution": "durable", "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", "distribution": "durable", "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", "distribution": "durable", "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", "distribution": "durable", "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" ], "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", "distribution": "durable", "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", "distribution": "durable", "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", "distribution": "durable", "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", "distribution": "durable", "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": "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": "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_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": "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": "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": "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": "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": "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": "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/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" ], "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" ], "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 fixed 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 fixed 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", "module_not_enabled" ], "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", "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", "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 fixed 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": "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 fixed 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", "module_not_enabled" ], "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 fixed 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 Performance Group 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", "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": [ "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 Performance Group 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 Performance Group 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/" } } ] }