{ "openapi": "3.1.0", "info": { "title": "Destiny Emperor API", "version": "1.0.0", "description": "Same-origin APIs. Protected operations require host-only sessions and CSRF headers. Admin operations require invited roles and fresh verification where documented." }, "servers": [ { "url": "/api/v1" } ], "paths": { "/internal/metrics": { "get": { "operationId": "metrics_get_internal_metrics", "tags": [ "internal" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:352", "responses": { "200": { "description": "Authorized raw response; select parseAs: blob for files, or text for ICS/metrics. JSON errors retain their own MIME type.", "content": { "text/plain": { "schema": { "type": "string" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string" }, "description": "Request correlation identifier." } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "internalBearer": [] } ], "servers": [ { "url": "http://127.0.0.1:8002" } ] } }, "/public/settings": { "get": { "operationId": "publicSystemSettings_get_public_settings", "tags": [ "public" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:354", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicSystemSettings" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } } } }, "/auth/request": { "post": { "operationId": "requestOTP_post_auth_request", "tags": [ "auth" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:355", "responses": { "202": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChallengeIssued" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "parameters": [ { "name": "X-CSRF-Token", "in": "header", "required": false, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OTPRequest" } } } } } }, "/auth/verify": { "post": { "operationId": "verifyOTP_post_auth_verify", "tags": [ "auth" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:356", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LoginVerified" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "parameters": [ { "name": "X-CSRF-Token", "in": "header", "required": false, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OTPVerify" } } } } } }, "/auth/link": { "post": { "operationId": "verifyLoginLink_post_auth_link", "tags": [ "auth" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:357", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LoginVerified" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "parameters": [ { "name": "X-CSRF-Token", "in": "header", "required": false, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EmailLinkVerify" } } } } } }, "/recovery/request": { "post": { "operationId": "recoveryCode_post_recovery_request", "tags": [ "recovery" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:358", "responses": { "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "202": { "description": "Purpose-bound recovery result. No recovery authentication cookie or private calculation data is returned.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChallengeIssued" } } } } }, "parameters": [ { "name": "X-CSRF-Token", "in": "header", "required": false, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OTPRequest" } } } }, "description": "Public contact-email verification, separate from login and step-up purposes. Generic request behavior does not disclose whether the claimed original account exists. No automatic account access or registration. Codes are single-use and expire after ten minutes." } }, "/recovery/verify": { "post": { "operationId": "recoveryVerify_post_recovery_verify", "tags": [ "recovery" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:359", "responses": { "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "200": { "description": "Purpose-bound recovery result. No recovery authentication cookie or private calculation data is returned.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RecoveryVerified" } } } } }, "parameters": [ { "name": "X-CSRF-Token", "in": "header", "required": false, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RecoveryVerifyRequest" } } } }, "description": "Public contact-email verification, separate from login and step-up purposes. Generic request behavior does not disclose whether the claimed original account exists. No automatic account access or registration. Codes are single-use and expire after ten minutes." } }, "/public/plans": { "get": { "operationId": "plans_get_public_plans", "tags": [ "public" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:360", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PlanCatalog" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } } } }, "/public/calendar": { "get": { "operationId": "calendar_get_public_calendar", "tags": [ "public" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:361", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalendarResponse" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "parameters": [ { "name": "from", "in": "query", "schema": { "type": "string", "format": "date" } }, { "name": "to", "in": "query", "schema": { "type": "string", "format": "date" } }, { "name": "timezone", "in": "query", "schema": { "type": "string" } }, { "name": "profile_id", "in": "query", "schema": { "type": "string", "format": "uuid" }, "description": "Owned profile for paid personal overlays." } ], "description": "Up to 32 consecutive Gregorian dates, within actual coverage. Anonymous/Free output is capped by server-time today in the selected IANA timezone. Public endpoints cannot return private personal overlays. Personal overlays also recheck the selected stored birth date against the same publication snapshot." } }, "/public/calendar/coverage": { "get": { "operationId": "publicCalendarCoverage_get_public_calendar_coverage", "tags": [ "public" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:362", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalendarCoverage" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "parameters": [ { "name": "timezone", "in": "query", "schema": { "type": "string" }, "description": "Valid IANA timezone; UTC by default. No private or future calendar facts are returned." } ], "description": "Server-time cutoff and actual coverage, including explicit unpublished-preview status in development. Production refuses unpublished coverage." } }, "/public/convert": { "get": { "operationId": "convertLunar_get_public_convert", "tags": [ "public" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:363", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LunarConversion" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "parameters": [ { "name": "year", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1899, "maximum": 2200 } }, { "name": "month", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1, "maximum": 12 } }, { "name": "day", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1, "maximum": 30 } }, { "name": "leap", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "timezone", "in": "query", "required": false, "schema": { "type": "string" } } ] } }, "/public/contact": { "post": { "operationId": "publicContact_post_public_contact", "tags": [ "public" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:364", "responses": { "202": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ContactAccepted" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "parameters": [ { "name": "X-CSRF-Token", "in": "header", "required": false, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ContactRequest" } } } } } }, "/public/visit": { "post": { "operationId": "publicVisit_post_public_visit", "tags": [ "public" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:365", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VisitRecorded" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "parameters": [ { "name": "X-CSRF-Token", "in": "header", "required": false, "schema": { "type": "string" } } ] } }, "/public/methods": { "get": { "operationId": "publicMethods_get_public_methods", "tags": [ "public" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:366", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MethodCollection" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } } } }, "/public/sample": { "get": { "operationId": "publicSample_get_public_sample", "tags": [ "public" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:367", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HistoricalSample" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "description": " New calculations require each supplied/stored birth date to remain inside the current request-scoped calendar publication coverage. Method approval alone does not bypass missing or withdrawn coverage. Already accepted report snapshots remain owner-readable and downloadable." } }, "/public/navigation": { "get": { "operationId": "publicNavigation_get_public_navigation", "tags": [ "public" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:368", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NavigationCollection" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } } } }, "/public/media/{id}": { "get": { "operationId": "mediaView_get_public_media__id", "tags": [ "public" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:369", "responses": { "200": { "description": "Authorized raw response; select parseAs: blob for files, or text for ICS/metrics. JSON errors retain their own MIME type.", "content": { "image/png": { "schema": { "type": "string", "format": "binary" } }, "image/jpeg": { "schema": { "type": "string", "format": "binary" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string" }, "description": "Request correlation identifier." } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." } ] } }, "/shares/{token}": { "get": { "operationId": "shareView_get_shares__token", "tags": [ "shares" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:370", "responses": { "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "200": { "description": "Birth details redacted recursively; previews create no tokens and consume no report allowance.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SharePreview" } } } } }, "parameters": [ { "name": "token", "in": "path", "required": true, "schema": { "type": "string" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." } ] } }, "/wallet/webhook": { "post": { "operationId": "walletWebhook_post_wallet_webhook", "tags": [ "wallet" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:371", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WalletEventAccepted" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "walletHMAC": [] } ], "parameters": [ { "name": "X-Wallet-Timestamp", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^[0-9]+$" }, "description": "Unix timestamp within five minutes; retries receive fresh timestamps/signatures." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WalletEvent" } } } } } }, "/email/mailgun/webhook": { "post": { "operationId": "mailgunWebhook_post_email_mailgun_webhook", "tags": [ "email" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:372", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EmailWebhookAccepted" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Webhook signing key is not configured.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "406": { "description": "Invalid signature, mismatched tracked message or conflicting replay; provider must not retry.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error406" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "parameters": [ { "name": "X-CSRF-Token", "in": "header", "required": false, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailgunEvent" } } } }, "security": [], "description": "Mailgun event webhook, authenticated by the account HTTP webhook signing key (not SMTP/API credentials). HMAC-SHA256 covers timestamp+token; a 24-hour signature window and persistent nonce binding apply. Known tracked message/domain/recipient correlation, day-scoped provider event deduplication and monotonic outcomes commit together. Unknown/tracking/test events are acknowledged without creating delivery proof. 406 rejects permanently; transient persistence failure returns an error without acknowledging. Requires externally configured HTTPS and provider key." } }, "/admin/system-settings/status": { "get": { "operationId": "adminSystemStatus_get_admin_system_settings_status", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:375", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SystemStatus" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ] } }, "/admin/health": { "get": { "operationId": "adminHealth_get_admin_health", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:376", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OperationalHealth" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Owner, Analyst, Finance or Support only. Private aggregate observation; three-minute freshness gate. Missing, invalid, incomplete or unsafe observation files never claim healthy status. No recipient, profile, report contents, paths or credentials are exposed. Read-only; triage actions retain their independent backend roles." } }, "/admin/email-deliveries": { "get": { "operationId": "emailDeliveryList_get_admin_email_deliveries", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:377", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EmailDeliveryPage" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Owner/Support only. Masked delivery metadata; excludes bodies, subjects, OTPs, recipient hashes and provider signatures. SMTP acceptance and recipient-server delivery are distinct.", "parameters": [ { "name": "cursor", "in": "query", "schema": { "$ref": "#/components/schemas/Cursor" } }, { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 100 } }, { "name": "status", "in": "query", "schema": { "type": "string" } } ] } }, "/me": { "get": { "operationId": "me_get_me", "tags": [ "me" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:378", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CurrentAccount" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ] } }, "/auth/logout": { "post": { "operationId": "logout_post_auth_logout", "tags": [ "auth" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:379", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SignedOut" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ], "parameters": [ { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } } ] } }, "/auth/step-up/request": { "post": { "operationId": "requestStepUp_post_auth_step_up_request", "tags": [ "auth" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:380", "responses": { "202": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChallengeIssued" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ], "parameters": [ { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } } ] } }, "/auth/step-up/verify": { "post": { "operationId": "verifyStepUp_post_auth_step_up_verify", "tags": [ "auth" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:381", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StepUpVerified" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ], "parameters": [ { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OTPVerify" } } } } } }, "/auth/email/request": { "post": { "operationId": "requestEmailChange_post_auth_email_request", "tags": [ "auth" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:382", "responses": { "202": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChallengeIssued" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ], "parameters": [ { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OTPRequest" } } } } } }, "/auth/email/verify": { "post": { "operationId": "verifyEmailChange_post_auth_email_verify", "tags": [ "auth" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:383", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EmailChanged" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ], "parameters": [ { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OTPVerify" } } } } } }, "/overview": { "get": { "operationId": "overview_get_overview", "tags": [ "overview" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:384", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserOverview" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ], "description": "Workspace counts and next three planner events by their recorded UTC instant, with server-time today in the account timezone. Calendar data uses the same publication/method/correction gates as Calendar. Unavailable calculations return a structured calendar_error and null today without hiding account/planner widgets. Arbitrary query timezones and profile IDs do not select another workspace." } }, "/profiles": { "get": { "operationId": "profiles_get_profiles", "tags": [ "profiles" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:385", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProfileCollection" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ] }, "post": { "operationId": "profileSave_post_profiles", "tags": [ "profiles" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:386", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RecordID" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ], "parameters": [ { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProfileInput" } } } }, "description": " Saving rechecks the current session, funded purchase or Free limits after the workspace lock. Read-only excess profiles cannot be edited; linking a client requires current client access. Conflicting revisions never overwrite saved details." } }, "/profiles/{id}": { "put": { "operationId": "profileSave_put_profiles__id", "tags": [ "profiles" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:387", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RecordID" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProfileInput" } } } }, "description": " Saving rechecks the current session, funded purchase or Free limits after the workspace lock. Read-only excess profiles cannot be edited; linking a client requires current client access. Conflicting revisions never overwrite saved details." }, "delete": { "operationId": "profileDelete_delete_profiles__id", "tags": [ "profiles" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:388", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeletedRecord" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } } ] } }, "/charts/{kind}/{id}": { "get": { "operationId": "chart_get_charts__kind___id", "tags": [ "charts" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:389", "responses": { "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "200": { "description": "Authoritative owned calculation with its versions. Zi Wei sensitivity samples preserve the primary chart and resolve calendar corrections per sampled civil date.", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/BaZiChart" }, { "$ref": "#/components/schemas/ZiWeiChart" }, { "$ref": "#/components/schemas/BusinessChart" } ] } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ], "parameters": [ { "name": "kind", "in": "path", "required": true, "schema": { "enum": [ "bazi", "ziwei", "business" ] }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "year", "in": "query", "schema": { "type": "integer", "minimum": 1900, "maximum": 2200 } } ], "description": "Zi Wei outlook years must be fully inside actual published calendar coverage; future years require calendar.future. Unknown birth time is unavailable. Chart inputs remain owned and server-validated. New calculations require each supplied/stored birth date to remain inside the current request-scoped calendar publication coverage. Method approval alone does not bypass missing or withdrawn coverage. Already accepted report snapshots remain owner-readable and downloadable." } }, "/insights/{id}": { "get": { "operationId": "personalInsights_get_insights__id", "tags": [ "insights" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:390", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PersonalInsights" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "year", "in": "query", "schema": { "type": "integer", "minimum": 1900, "maximum": 2200 } }, { "name": "date", "in": "query", "schema": { "type": "string", "format": "date" }, "description": "Daily insight date; account-timezone today by default." } ], "description": " New calculations require each supplied/stored birth date to remain inside the current request-scoped calendar publication coverage. Method approval alone does not bypass missing or withdrawn coverage. Already accepted report snapshots remain owner-readable and downloadable." } }, "/calendar": { "get": { "operationId": "calendar_get_calendar", "tags": [ "calendar" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:391", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalendarResponse" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ], "parameters": [ { "name": "from", "in": "query", "schema": { "type": "string", "format": "date" } }, { "name": "to", "in": "query", "schema": { "type": "string", "format": "date" } }, { "name": "timezone", "in": "query", "schema": { "type": "string" } }, { "name": "profile_id", "in": "query", "schema": { "type": "string", "format": "uuid" }, "description": "Owned profile for paid personal overlays." } ], "description": "Up to 32 consecutive Gregorian dates, within actual coverage. Anonymous/Free output is capped by server-time today in the selected IANA timezone. Public endpoints cannot return private personal overlays. Personal overlays also recheck the selected stored birth date against the same publication snapshot." } }, "/calendar/convert": { "get": { "operationId": "convertLunar_get_calendar_convert", "tags": [ "calendar" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:392", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LunarConversion" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ], "parameters": [ { "name": "year", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1899, "maximum": 2200 } }, { "name": "month", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1, "maximum": 12 } }, { "name": "day", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1, "maximum": 30 } }, { "name": "leap", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "timezone", "in": "query", "required": false, "schema": { "type": "string" } } ] } }, "/date-selection": { "post": { "operationId": "selectDates_post_date_selection", "tags": [ "date-selection" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:393", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DateSelectionResult" } } } }, "202": { "description": "Accepted bounded search; poll the owned job endpoint.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JobAccepted" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ], "parameters": [ { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DateSelectionRequest" } } } }, "description": " New calculations require each supplied/stored birth date to remain inside the current request-scoped calendar publication coverage. Method approval alone does not bypass missing or withdrawn coverage. Already accepted report snapshots remain owner-readable and downloadable. Immediate and background searches recheck the active session, current purchase limits, maintenance flags and all participant revisions under the workspace lock. Background insertion is atomic with acceptance and freezes package terms and UTC acceptance time. Date searches do not reserve report allowance." } }, "/comparisons": { "post": { "operationId": "comparisons_post_comparisons", "tags": [ "comparisons" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:394", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ComparisonResult" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ], "parameters": [ { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ComparisonRequest" } } } }, "description": " New calculations require each supplied/stored birth date to remain inside the current request-scoped calendar publication coverage. Method approval alone does not bypass missing or withdrawn coverage. Already accepted report snapshots remain owner-readable and downloadable." } }, "/reports": { "get": { "operationId": "reports_get_reports", "tags": [ "reports" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:395", "responses": { "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReportCollection" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ], "parameters": [ { "name": "cursor", "in": "query", "schema": { "type": "string", "maxLength": 1400 }, "description": "Opaque signed position bound to the caller, collection and selected filters. Empty or omitted starts a new traversal. Refresh the list when changing filters." }, { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 } } ] }, "post": { "operationId": "reportCreate_post_reports", "tags": [ "reports" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:396", "responses": { "200": { "description": "Stored result of the same idempotent request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RecordID" } } } }, "202": { "description": "Allowance reserved; generation runs as a background job.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReportAccepted" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ], "parameters": [ { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 128 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReportRequest" } } } }, "description": " Report admission rechecks the current funded purchase, calculation capabilities, maintenance flags, participating profile limits and date-selection limits under the workspace lock. The accepted package and UTC allowance window are frozen together; a later expiry does not cancel an accepted report or charge a retry again. New calculations require each supplied/stored birth date to remain inside the current request-scoped calendar publication coverage. Method approval alone does not bypass missing or withdrawn coverage. Already accepted report snapshots remain owner-readable and downloadable." } }, "/reports/{id}": { "get": { "operationId": "reportView_get_reports__id", "tags": [ "reports" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:397", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReportDetail" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." } ] } }, "/reports/{id}/cancel": { "post": { "operationId": "reportCancel_post_reports__id__cancel", "tags": [ "reports" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:398", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReportCancelled" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } } ] } }, "/reports/{id}/pdf": { "get": { "operationId": "reportPDF_get_reports__id__pdf", "tags": [ "reports" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:399", "responses": { "200": { "description": "Authorized raw response; select parseAs: blob for files, or text for ICS/metrics. JSON errors retain their own MIME type.", "content": { "application/pdf": { "schema": { "type": "string", "format": "binary" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string" }, "description": "Request correlation identifier." }, "Content-Disposition": { "schema": { "type": "string" }, "description": "Attachment filename." } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." } ] } }, "/reports/{id}/share": { "post": { "operationId": "reportShare_post_reports__id__share", "tags": [ "reports" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:400", "responses": { "201": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ShareCreated" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } } ] } }, "/reports/{id}/share-preview": { "get": { "operationId": "reportSharePreview_get_reports__id__share_preview", "tags": [ "reports" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:401", "responses": { "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "200": { "description": "Birth details redacted recursively; previews create no tokens and consume no report allowance.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SharePreview" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." } ] } }, "/reports/{id}/shares": { "delete": { "operationId": "shareRevoke_delete_reports__id__shares", "tags": [ "reports" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:402", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RevokedRecord" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } } ] } }, "/subscription": { "get": { "operationId": "subscription_get_subscription", "tags": [ "subscription" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:403", "responses": { "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "200": { "description": "Stored operation result.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SubscriptionStatus" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ], "parameters": [ { "name": "periods_cursor", "in": "query", "schema": { "type": "string", "maxLength": 1400 }, "description": "Opaque owned subscription-period cursor." }, { "name": "periods_limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20 } } ] } }, "/wallet/capabilities": { "get": { "operationId": "walletCapabilities_get_wallet_capabilities", "tags": [ "wallet" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:404", "responses": { "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "200": { "description": "Stored operation result.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WalletCapabilities" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ] } }, "/orders": { "post": { "operationId": "createOrder_post_orders", "tags": [ "orders" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:405", "responses": { "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "200": { "description": "Stored operation result.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PurchaseQuote" } } } }, "201": { "description": "Stored operation result.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PurchaseQuote" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ], "parameters": [ { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 128 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OrderRequest" } } } } }, "get": { "operationId": "orders_get_orders", "tags": [ "orders" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:406", "responses": { "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "200": { "description": "Stored operation result.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PurchaseHistory" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ], "parameters": [ { "name": "cursor", "in": "query", "schema": { "type": "string", "maxLength": 1400 }, "description": "Opaque signed position bound to the caller, collection and selected filters. Empty or omitted starts a new traversal. Refresh the list when changing filters." }, { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 } } ] } }, "/orders/{id}/invoice": { "post": { "operationId": "createInvoice_post_orders__id__invoice", "tags": [ "orders" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:407", "responses": { "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "200": { "description": "Stored operation result.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RecordID" } } } }, "201": { "description": "Stored operation result.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvoiceCreated" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ], "description": "Concurrent retries reuse a durable provider quote request. An expired quote receives a new provider key. Only merchant-enabled and provider-available asset/network pairs are accepted.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvoiceRequest" } } } } } }, "/invoices/{id}": { "get": { "operationId": "invoiceView_get_invoices__id", "tags": [ "invoices" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:408", "responses": { "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "200": { "description": "Stored operation result.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvoiceDetail" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." } ] } }, "/invoices/{id}/simulate": { "post": { "operationId": "simulatePayment_post_invoices__id__simulate", "tags": [ "invoices" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:409", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SimulationResult" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SimulationRequest" } } } } } }, "/resources/{kind}": { "get": { "operationId": "resourceList_get_resources__kind", "tags": [ "resources" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:410", "responses": { "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "200": { "description": "Stored operation result.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResourceList" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ], "parameters": [ { "name": "kind", "in": "path", "required": true, "schema": { "enum": [ "planner", "clients", "notifications", "support", "refunds", "consents" ] }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "cursor", "in": "query", "schema": { "type": "string", "maxLength": 1400 }, "description": "Opaque signed position bound to the caller, collection and selected filters. Empty or omitted starts a new traversal. Refresh the list when changing filters." }, { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 } } ], "description": "Registered resource pattern. Use the concrete kind operations for exact request/response schemas. Notification creation and refund editing/deletion are read-only service/Finance operations." }, "post": { "operationId": "resourceSave_post_resources__kind", "tags": [ "resources" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:412", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RecordID" } } } }, "201": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RecordID" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ], "description": "Registered resource pattern. Use the concrete kind operations for exact request/response schemas. Notification creation and refund editing/deletion are read-only service/Finance operations.", "parameters": [ { "name": "kind", "in": "path", "required": true, "schema": { "enum": [ "planner", "clients", "notifications", "support", "refunds", "consents" ] }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "Required for refund creation, Finance decisions and other financial commands. Replays retain their stored result; changed payloads return a conflict." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/PlannerCreateRequest" }, { "$ref": "#/components/schemas/ClientsCreateRequest" }, { "$ref": "#/components/schemas/SupportCreateRequest" }, { "$ref": "#/components/schemas/RefundsCreateRequest" }, { "$ref": "#/components/schemas/ConsentsCreateRequest" } ] } } } } } }, "/clients/options": { "get": { "operationId": "clientOptions_get_clients_options", "tags": [ "clients" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:411", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SelectionPage" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ], "description": "Bounded label-only choices with literal search and signed immutable-position pagination. The independently resolved selection survives filters/pages without granting access. Support choices additionally require current Owner/Support eligibility.", "parameters": [ { "name": "cursor", "in": "query", "schema": { "type": "string", "maxLength": 1400 }, "description": "Opaque signed position bound to the caller, collection and selected filters. Empty or omitted starts a new traversal. Refresh the list when changing filters." }, { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 } }, { "name": "q", "in": "query", "schema": { "type": "string", "maxLength": 160 }, "description": "Literal, case-insensitive search across supported summary fields, applied before paging." }, { "name": "selected_id", "in": "query", "schema": { "type": "string", "format": "uuid" }, "description": "Optional current selection, resolved independently of paging/search under the same ownership or active-role rules. Unavailable/foreign selections return null." } ] } }, "/resources/{kind}/{id}": { "put": { "operationId": "resourceSave_put_resources__kind___id", "tags": [ "resources" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:413", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RecordID" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ], "description": "Registered resource pattern. Use the concrete kind operations for exact request/response schemas. Notification creation and refund editing/deletion are read-only service/Finance operations.", "parameters": [ { "name": "kind", "in": "path", "required": true, "schema": { "enum": [ "planner", "clients", "notifications", "support", "refunds", "consents" ] }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "Required for refund creation, Finance decisions and other financial commands. Replays retain their stored result; changed payloads return a conflict." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/PlannerEditRequest" }, { "$ref": "#/components/schemas/ClientsEditRequest" }, { "$ref": "#/components/schemas/NotificationEditRequest" }, { "$ref": "#/components/schemas/SupportEditRequest" }, { "$ref": "#/components/schemas/ConsentsEditRequest" } ] } } } } }, "delete": { "operationId": "resourceDelete_delete_resources__kind___id", "tags": [ "resources" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:414", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeletedRecord" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ], "parameters": [ { "name": "kind", "in": "path", "required": true, "schema": { "enum": [ "planner", "clients", "notifications", "support", "refunds", "consents" ] }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } } ], "description": "Registered resource pattern. Use the concrete kind operations for exact request/response schemas. Notification creation and refund editing/deletion are read-only service/Finance operations." } }, "/planner/{id}/ics": { "get": { "operationId": "plannerICS_get_planner__id__ics", "tags": [ "planner" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:415", "responses": { "200": { "description": "Authorized raw response; select parseAs: blob for files, or text for ICS/metrics. JSON errors retain their own MIME type.", "content": { "text/calendar": { "schema": { "type": "string" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string" }, "description": "Request correlation identifier." }, "Content-Disposition": { "schema": { "type": "string" }, "description": "Attachment filename." } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." } ] } }, "/settings": { "get": { "operationId": "settings_get_settings", "tags": [ "settings" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:416", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccountSettings" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ] }, "put": { "operationId": "settings_put_settings", "tags": [ "settings" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:417", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccountSettings" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ], "parameters": [ { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SettingsEdit" } } } } } }, "/support/{id}/attachments": { "post": { "operationId": "attachmentUpload_post_support__id__attachments", "tags": [ "support" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:418", "responses": { "201": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AttachmentMetadata" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "type": "object", "properties": { "file": { "type": "string", "format": "binary" } }, "required": [ "file" ], "additionalProperties": false } } } } }, "get": { "operationId": "attachmentList_get_support__id__attachments", "tags": [ "support" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:419", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AttachmentCollection" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." } ] } }, "/support/{id}": { "get": { "operationId": "supportCustomerDetail_get_support__id", "tags": [ "support" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:420", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SupportDetail" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." } ] } }, "/attachments/{id}": { "get": { "operationId": "attachmentDownload_get_attachments__id", "tags": [ "attachments" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:421", "responses": { "200": { "description": "Authorized raw response; select parseAs: blob for files, or text for ICS/metrics. JSON errors retain their own MIME type.", "content": { "application/pdf": { "schema": { "type": "string", "format": "binary" } }, "image/png": { "schema": { "type": "string", "format": "binary" } }, "image/jpeg": { "schema": { "type": "string", "format": "binary" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string" }, "description": "Request correlation identifier." }, "Content-Disposition": { "schema": { "type": "string" }, "description": "Attachment filename." } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." } ] } }, "/admin/support/{id}/attachments": { "get": { "operationId": "attachmentList_get_admin_support__id__attachments", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:422", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AttachmentCollection" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." } ] } }, "/admin/attachments/{id}": { "get": { "operationId": "attachmentDownload_get_admin_attachments__id", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:423", "responses": { "200": { "description": "Authorized raw response; select parseAs: blob for files, or text for ICS/metrics. JSON errors retain their own MIME type.", "content": { "application/pdf": { "schema": { "type": "string", "format": "binary" } }, "image/png": { "schema": { "type": "string", "format": "binary" } }, "image/jpeg": { "schema": { "type": "string", "format": "binary" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string" }, "description": "Request correlation identifier." }, "Content-Disposition": { "schema": { "type": "string" }, "description": "Attachment filename." } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." } ] } }, "/sessions": { "get": { "operationId": "sessions_get_sessions", "tags": [ "sessions" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:424", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SessionCollection" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ] } }, "/sessions/{id}": { "delete": { "operationId": "revokeSession_delete_sessions__id", "tags": [ "sessions" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:425", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RevokedRecord" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } } ] } }, "/export": { "get": { "operationId": "exportData_get_export", "tags": [ "export" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:426", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DataExport" } } }, "headers": { "Content-Disposition": { "schema": { "type": "string" }, "description": "The authorized JSON data export filename." } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ] } }, "/account/delete": { "post": { "operationId": "deleteAccount_post_account_delete", "tags": [ "account" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:427", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccountDeleted" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ], "parameters": [ { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } } ] } }, "/jobs/{id}": { "get": { "operationId": "jobView_get_jobs__id", "tags": [ "jobs" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:428", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JobState" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." } ], "description": " Owner-only status/results for an already accepted job remain accessible after subscription expiry. Creating another premium search requires current access; account and profile deletion retain their cancellation behavior." } }, "/admin/media": { "post": { "operationId": "mediaUpload_post_admin_media", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:429", "responses": { "201": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MediaUploaded" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "parameters": [ { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "type": "object", "properties": { "file": { "type": "string", "format": "binary" } }, "required": [ "file" ], "additionalProperties": false } } } } }, "get": { "operationId": "mediaList_get_admin_media", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:430", "responses": { "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "200": { "description": "Stored operation result.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MediaList" } } } } }, "security": [ { "adminSession": [] } ], "parameters": [ { "name": "cursor", "in": "query", "schema": { "type": "string", "maxLength": 1400 }, "description": "Opaque signed position bound to the caller, collection and selected filters. Empty or omitted starts a new traversal. Refresh the list when changing filters." }, { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 24 } }, { "name": "q", "in": "query", "schema": { "type": "string", "maxLength": 160 }, "description": "Literal, case-insensitive search across supported summary fields, applied before paging." }, { "name": "status", "in": "query", "schema": { "enum": [ "", "draft", "published", "archived" ] }, "description": "Filters the cover-image picker to published media." } ] } }, "/admin/media/{id}": { "get": { "operationId": "mediaView_get_admin_media__id", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:431", "responses": { "200": { "description": "Authorized raw response; select parseAs: blob for files, or text for ICS/metrics. JSON errors retain their own MIME type.", "content": { "image/png": { "schema": { "type": "string", "format": "binary" } }, "image/jpeg": { "schema": { "type": "string", "format": "binary" } } }, "headers": { "X-Request-ID": { "schema": { "type": "string" }, "description": "Request correlation identifier." } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." } ] } }, "/admin/overview": { "get": { "operationId": "adminOverview_get_admin_overview", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:432", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdministrationOverview" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ] } }, "/admin/members": { "get": { "operationId": "adminMembers_get_admin_members", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:433", "responses": { "200": { "description": "Authorized member summary.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MemberPage" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Owner or Support only. Summary metadata for registered accounts, including administrative accounts. Birth data, report contents, private notes, tokens and session records are excluded. Current package uses the effective funded period; expired periods return Free. Status mutations use the revision-checked /admin/users/{id}/{action} operations with fresh email verification.", "parameters": [ { "name": "cursor", "in": "query", "schema": { "$ref": "#/components/schemas/Cursor" } }, { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 } }, { "name": "q", "in": "query", "schema": { "type": "string", "maxLength": 160 }, "description": "Literal email substring or exact member UUID." }, { "name": "status", "in": "query", "schema": { "enum": [ "", "active", "suspended", "deleted" ] } }, { "name": "plan", "in": "query", "schema": { "enum": [ "", "free", "seeker", "strategist", "practitioner" ] } } ] } }, "/admin/members/{id}": { "get": { "operationId": "adminMemberDetail_get_admin_members__id", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:434", "responses": { "200": { "description": "Authorized member summary.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MemberDetail" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." } ], "description": "Owner or Support only. Summary metadata for registered accounts, including administrative accounts. Birth data, report contents, private notes, tokens and session records are excluded. Current package uses the effective funded period; expired periods return Free. Status mutations use the revision-checked /admin/users/{id}/{action} operations with fresh email verification." } }, "/admin/support/assignees": { "get": { "operationId": "supportAssignees_get_admin_support_assignees", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:435", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SupportAssignees" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Bounded label-only choices with literal search and signed immutable-position pagination. The independently resolved selection survives filters/pages without granting access. Support choices additionally require current Owner/Support eligibility.", "parameters": [ { "name": "cursor", "in": "query", "schema": { "type": "string", "maxLength": 1400 }, "description": "Opaque signed position bound to the caller, collection and selected filters. Empty or omitted starts a new traversal. Refresh the list when changing filters." }, { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 } }, { "name": "q", "in": "query", "schema": { "type": "string", "maxLength": 160 }, "description": "Literal, case-insensitive search across supported summary fields, applied before paging." }, { "name": "selected_id", "in": "query", "schema": { "type": "string", "format": "uuid" }, "description": "Optional current selection, resolved independently of paging/search under the same ownership or active-role rules. Unavailable/foreign selections return null." } ] } }, "/admin/support/{id}": { "get": { "operationId": "supportDetail_get_admin_support__id", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:436", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SupportStaffDetail" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "notes_cursor", "in": "query", "schema": { "type": "string", "maxLength": 1400 }, "description": "Opaque signed cursor bound to this ticket and administrator." }, { "name": "notes_limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 } } ] } }, "/admin/support/{id}/{action}": { "post": { "operationId": "supportOperation_post_admin_support__id___action", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:437", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SupportChanged" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "action", "in": "path", "required": true, "schema": { "enum": [ "assign", "note", "reply", "close", "reopen" ] }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SupportActionRequest" } } } } } }, "/admin/account-recovery": { "get": { "operationId": "adminRecoveryList_get_admin_account_recovery", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:438", "responses": { "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "200": { "description": "Purpose-bound recovery result. No recovery authentication cookie or private calculation data is returned.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RecoveryAdminPage" } } } } }, "security": [ { "adminSession": [] } ], "parameters": [ { "name": "status", "in": "query", "schema": { "enum": [ "", "pending_review", "needs_information", "approved", "declined", "cancelled", "expired" ] } }, { "name": "cursor", "in": "query", "schema": { "$ref": "#/components/schemas/Cursor" } }, { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 30 } } ] } }, "/admin/account-recovery/{id}/{action}": { "post": { "operationId": "adminRecoveryAction_post_admin_account_recovery__id___action", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:439", "responses": { "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "200": { "description": "Purpose-bound recovery result. No recovery authentication cookie or private calculation data is returned.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RecoveryReviewed" } } } } }, "security": [ { "adminSession": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "action", "in": "path", "required": true, "schema": { "enum": [ "request-information", "approve", "decline" ] }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RecoveryReviewRequest" } } } }, "description": "Owner only; fresh purpose-bound OTP, current role and session are rechecked inside the locked transaction. Revision, independent ownership notes and confirmation are required for approval. Cannot approve self-recovery, merge accounts, bypass suspension/deletion, accept stale contact proof, or overwrite a changed original account. Approval keeps workspace ownership/entitlements and revokes every old session. Notifications and audit commit with the update." } }, "/admin/{kind}": { "get": { "operationId": "adminList_get_admin__kind", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:440", "responses": { "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "200": { "description": "Stored operation result.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedRecords" } } } } }, "security": [ { "adminSession": [] } ], "parameters": [ { "name": "kind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "cursor", "in": "query", "schema": { "type": "string", "maxLength": 1400 }, "description": "Opaque signed position bound to the caller, collection and selected filters. Empty or omitted starts a new traversal. Refresh the list when changing filters." }, { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "description": "Growing collections: default 100, or 50 for support. Plans/features/wallet return their complete finite catalogs." }, { "name": "q", "in": "query", "schema": { "type": "string", "maxLength": 160 }, "description": "Literal, case-insensitive search across supported summary fields, applied before paging." }, { "name": "category", "in": "query", "schema": { "enum": [ "", "General", "Calculations", "Billing", "Privacy" ] }, "description": "Support collection only." }, { "name": "status", "in": "query", "schema": { "enum": [ "", "open", "answered", "closed" ] }, "description": "Support collection only." }, { "name": "assigned", "in": "query", "schema": { "enum": [ "", "mine", "unassigned" ] }, "description": "Support collection only." } ] }, "post": { "operationId": "adminSave_post_admin__kind", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:441", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SavedConfiguration" } } } }, "201": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SavedConfiguration" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Administrator invitations are POST-only and cannot overwrite an existing administrator record. Publication records save content, immutable history, and audit atomically. Replacement drafts supply version_of; publishing/rollback leaves one live version in that lineage.", "parameters": [ { "name": "kind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RevisionEdit" } } } } } }, "/admin/{kind}/{id}/versions": { "get": { "operationId": "publicationHistory_get_admin__kind___id__versions", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:442", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicationHistory" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "parameters": [ { "name": "kind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "cursor", "in": "query", "schema": { "type": "integer", "minimum": 1 }, "description": "Exclusive publication revision cursor." } ], "description": "Immutable history for the supported administrative collection, including calendar batches. Calendar versions retain evidence, range, engine, author, independent review, action and publication state." } }, "/admin/{kind}/{id}": { "put": { "operationId": "adminSave_put_admin__kind___id", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:443", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SavedConfiguration" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Administrator invitations are POST-only and cannot overwrite an existing administrator record. Publication records save content, immutable history, and audit atomically. Replacement drafts supply version_of; publishing/rollback leaves one live version in that lineage.", "parameters": [ { "name": "kind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RevisionEdit" } } } } } }, "/admin/{kind}/{id}/{action}": { "post": { "operationId": "adminAction_post_admin__kind___id___action", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:444", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdministrativeAction" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Account role/suspend/restore actions use AccountAccessRequest with the listed revision and fresh verification. They retain an active verified Owner and recheck current authorization inside the transaction. Deleted accounts cannot be restored. Method/rule/correction and content publication actions require PublicationCommand with the exact displayed revision. Review accepts reviewer identity/notes only and cannot replace tested content. Refund approval/decline uses RefundDecision and an idempotency key; decision/audit/outbox commit atomically before provider calls. Settings publication/archive/restore uses SettingsPublicationCommand, checking the current global release_revision and the selected immutable record revision. Only one settings revision is active; publication and supersession/history/audit are atomic. Calendar review/publish/retire/rollback uses CalendarPublicationCommand. Review accepts the displayed batch revision and reviewer name/notes; author self-review is forbidden. Publish/retire/rollback additionally require the displayed global publication_revision. Complete reference counts and independent checks must match the deployed engine/corrections/timezone versions; history/audit and single active coverage commit atomically.", "parameters": [ { "name": "kind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "action", "in": "path", "required": true, "schema": { "type": "string" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "Required for refund creation, Finance decisions and other financial commands. Replays retain their stored result; changed payloads return a conflict." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/public/pages": { "get": { "operationId": "cms_get__public_pages", "tags": [ "CMS" ], "parameters": [ { "name": "cursor", "in": "query", "schema": { "$ref": "#/components/schemas/Cursor" } }, { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 12 } }, { "name": "q", "in": "query", "schema": { "type": "string", "maxLength": 160 } }, { "name": "kind", "in": "query", "schema": { "enum": [ "", "page", "article" ] } }, { "name": "slug", "in": "query", "schema": { "type": "string", "maxLength": 180 } }, { "name": "view", "in": "query", "schema": { "enum": [ "summary", "sitemap" ], "default": "summary" } }, { "name": "category", "in": "query", "schema": { "type": "string", "maxLength": 120 }, "description": "Exact case-sensitive published/editorial article category; combines with q. Empty means all. A supplied category defaults kind to article, excludes kind=page and binds the cursor to this selection." } ], "responses": { "200": { "description": "Signed creation-position pagination. Summaries omit full bodies; detail endpoints return the stored revision. Public output includes published content only.", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ContentSummaryList" }, { "$ref": "#/components/schemas/SitemapMetadataList" } ] } } } }, "403": { "description": "Structured content, selection, revision or service error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Structured content, selection, revision or service error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Structured content, selection, revision or service error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Structured content, selection, revision or service error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Structured content, selection, revision or service error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Structured content, selection, revision or service error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error. Private diagnostics are excluded.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } } } }, "/public/pages/{slug}": { "get": { "operationId": "cms_get__public_pages__slug_", "tags": [ "CMS" ], "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Full stored revision. CMS detail requires content administration access; public detail resolves the published version.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublishedRevision" } } } }, "403": { "description": "Structured content, selection, revision or service error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Structured content, selection, revision or service error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Structured content, selection, revision or service error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Structured content, selection, revision or service error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Structured content, selection, revision or service error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Structured content, selection, revision or service error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error. Private diagnostics are excluded.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } } } }, "/cms/pages": { "get": { "operationId": "cms_get__cms_pages", "tags": [ "CMS" ], "parameters": [ { "name": "cursor", "in": "query", "schema": { "$ref": "#/components/schemas/Cursor" } }, { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 } }, { "name": "q", "in": "query", "schema": { "type": "string", "maxLength": 160 } }, { "name": "kind", "in": "query", "schema": { "enum": [ "", "page", "article" ] } }, { "name": "slug", "in": "query", "schema": { "type": "string", "maxLength": 180 } }, { "name": "status", "in": "query", "schema": { "enum": [ "", "draft", "preview", "published", "archived" ] } }, { "name": "category", "in": "query", "schema": { "type": "string", "maxLength": 120 }, "description": "Exact case-sensitive published/editorial article category; combines with q. Empty means all. A supplied category defaults kind to article, excludes kind=page and binds the cursor to this selection." } ], "responses": { "200": { "description": "Signed creation-position pagination. Summaries omit full bodies; detail endpoints return the stored revision. Public output includes published content only.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CMSContentList" } } } }, "403": { "description": "Structured content, revision, or service error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Structured content, revision, or service error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Structured content, selection, revision or service error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Structured content, revision, or service error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Structured content, revision, or service error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Structured content, revision, or service error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error. Private diagnostics are excluded.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ] }, "post": { "operationId": "cms_post__cms_pages", "tags": [ "CMS" ], "parameters": [ { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "The stored content/state revision after the transactional operation.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CMSChanged" } } } }, "403": { "description": "Structured content, revision, or service error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Structured content, revision, or service error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Structured content, selection, revision or service error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Structured content, revision, or service error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Structured content, revision, or service error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Structured content, revision, or service error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request exceeds one MiB, including trailing bytes.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error. Private diagnostics are excluded.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CMSDraft" } } } }, "description": " Content validation returns field_errors keyed by editable field or nested document path. Unsupported fields, invalid UTF-8, NUL text and malformed document hierarchy are rejected before persistence." } }, "/cms/pages/{id}": { "get": { "operationId": "cms_get__cms_pages__id_", "tags": [ "CMS" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "Full stored revision. CMS detail requires content administration access; public detail resolves the published version.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CMSRevision" } } } }, "403": { "description": "Structured content, revision, or service error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Structured content, revision, or service error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Structured content, selection, revision or service error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Structured content, revision, or service error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Structured content, revision, or service error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Structured content, revision, or service error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error. Private diagnostics are excluded.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ] } }, "/cms/pages/{id}/{action}": { "post": { "operationId": "cms_post__cms_pages__id___action_", "tags": [ "CMS" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "action", "in": "path", "required": true, "schema": { "enum": [ "preview", "publish", "archive", "rollback" ] } }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "The stored content/state revision after the transactional operation.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CMSChanged" } } } }, "403": { "description": "Structured content, revision, or service error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Structured content, revision, or service error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Structured content, selection, revision or service error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Structured content, revision, or service error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Structured content, revision, or service error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Structured content, revision, or service error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request exceeds one MiB, including trailing bytes.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error. Private diagnostics are excluded.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CMSCommand" } } } }, "description": "Draft \u2192 preview \u2192 published \u2192 archived. Rollback selects a previously published immutable revision. Slug locking, state revisions, replacement archival and audits commit atomically. Content validation returns field_errors keyed by editable field or nested document path. Unsupported fields, invalid UTF-8, NUL text and malformed document hierarchy are rejected before persistence." } }, "/internal/database-health": { "get": { "operationId": "marketing_database_health_get", "servers": [ { "url": "/" } ], "tags": [ "Operations" ], "security": [ { "internalBearer": [] } ], "description": "Private Marketing API only. Read-only bounded aggregate MySQL/pool observation. No accounts, statements, connection identities, DSNs or credentials. Global observation is explicitly null/unavailable if its bounded reads fail; pool statistics remain reported. Never proxy this route through public /api.", "parameters": [], "responses": { "200": { "description": "Typed aggregate observation, including explicit global unavailability.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MarketingDatabaseHealth" } } } }, "403": { "description": "Structured internal-access or method error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Structured internal-access or method error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error. Private diagnostics are excluded.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } } } }, "/public/article-categories": { "get": { "operationId": "public_article_categories_get", "tags": [ "CMS" ], "parameters": [ { "name": "cursor", "in": "query", "schema": { "type": "string", "maxLength": 1000 } }, { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 } } ], "description": "Anonymous published-article categories only, alphabetically paginated with namespace-signed cursors and current article counts. Blank/missing categories use Methods & Perspectives. Draft/archive categories and article bodies are excluded.", "responses": { "200": { "description": "Published category page.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ArticleCategoryPage" } } } }, "422": { "description": "Structured category selection or service error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Structured category selection or service error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error. Private diagnostics are excluded.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } } } }, "/resources/planner": { "get": { "operationId": "resource_planner_get", "tags": [ "Resources" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:410", "responses": { "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PlannerPage" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ], "parameters": [ { "name": "cursor", "in": "query", "schema": { "type": "string", "maxLength": 1400 }, "description": "Opaque signed position bound to the caller, collection and selected filters. Empty or omitted starts a new traversal. Refresh the list when changing filters." }, { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 } } ], "x-runtime-pattern": "/resources/{kind}", "x-resource-kind": "planner", "description": "Typed planner view of /resources/{kind}. Reads, edits and deletion check workspace ownership. Only editable fields are accepted; server-generated values cannot be supplied." }, "post": { "operationId": "resource_planner_post", "tags": [ "Resources" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:412", "responses": { "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "200": { "description": "Saved record, or the original refund request on an idempotent replay.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RecordID" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ], "description": "Typed planner view of /resources/{kind}. Reads, edits and deletion check workspace ownership. Only editable fields are accepted; server-generated values cannot be supplied.", "parameters": [ { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "Not required for this nonfinancial resource." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PlannerCreateRequest" } } } }, "x-runtime-pattern": "/resources/{kind}", "x-resource-kind": "planner" } }, "/resources/planner/{id}": { "put": { "operationId": "resource_planner_put", "tags": [ "Resources" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:413", "responses": { "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "200": { "description": "Saved record, or the original refund request on an idempotent replay.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RecordID" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ], "description": "Typed planner view of /resources/{kind}/{id}. Reads, edits and deletion check workspace ownership. Only editable fields are accepted; server-generated values cannot be supplied.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "Not required for this nonfinancial resource." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PlannerEditRequest" } } } }, "x-runtime-pattern": "/resources/{kind}/{id}", "x-resource-kind": "planner" }, "delete": { "operationId": "resource_planner_delete", "tags": [ "Resources" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:414", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeletedRecord" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } } ], "x-runtime-pattern": "/resources/{kind}/{id}", "x-resource-kind": "planner", "description": "Typed planner view of /resources/{kind}/{id}. Reads, edits and deletion check workspace ownership. Only editable fields are accepted; server-generated values cannot be supplied. Requires OTP verification within five minutes, rechecked after acquiring the workspace lock. Planner removal cancels pending reminder jobs; client removal unlinks preserved birth profiles." } }, "/resources/clients": { "get": { "operationId": "resource_clients_get", "tags": [ "Resources" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:410", "responses": { "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientsPage" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ], "parameters": [ { "name": "cursor", "in": "query", "schema": { "type": "string", "maxLength": 1400 }, "description": "Opaque signed position bound to the caller, collection and selected filters. Empty or omitted starts a new traversal. Refresh the list when changing filters." }, { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 } } ], "x-runtime-pattern": "/resources/{kind}", "x-resource-kind": "clients", "description": "Typed clients view of /resources/{kind}. Reads, edits and deletion check workspace ownership. Only editable fields are accepted; server-generated values cannot be supplied. Writes require the Practitioner capability; preserved records remain readable/deletable after expiry. Client records cannot bypass birth-profile limits." }, "post": { "operationId": "resource_clients_post", "tags": [ "Resources" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:412", "responses": { "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "200": { "description": "Saved record, or the original refund request on an idempotent replay.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RecordID" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ], "description": "Typed clients view of /resources/{kind}. Reads, edits and deletion check workspace ownership. Only editable fields are accepted; server-generated values cannot be supplied. Writes require the Practitioner capability; preserved records remain readable/deletable after expiry. Client records cannot bypass birth-profile limits.", "parameters": [ { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "Not required for this nonfinancial resource." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientsCreateRequest" } } } }, "x-runtime-pattern": "/resources/{kind}", "x-resource-kind": "clients" } }, "/resources/clients/{id}": { "put": { "operationId": "resource_clients_put", "tags": [ "Resources" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:413", "responses": { "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "200": { "description": "Saved record, or the original refund request on an idempotent replay.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RecordID" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ], "description": "Typed clients view of /resources/{kind}/{id}. Reads, edits and deletion check workspace ownership. Only editable fields are accepted; server-generated values cannot be supplied. Writes require the Practitioner capability; preserved records remain readable/deletable after expiry. Client records cannot bypass birth-profile limits.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "Not required for this nonfinancial resource." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClientsEditRequest" } } } }, "x-runtime-pattern": "/resources/{kind}/{id}", "x-resource-kind": "clients" }, "delete": { "operationId": "resource_clients_delete", "tags": [ "Resources" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:414", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeletedRecord" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } } ], "x-runtime-pattern": "/resources/{kind}/{id}", "x-resource-kind": "clients", "description": "Typed clients view of /resources/{kind}/{id}. Reads, edits and deletion check workspace ownership. Only editable fields are accepted; server-generated values cannot be supplied. Writes require the Practitioner capability; preserved records remain readable/deletable after expiry. Client records cannot bypass birth-profile limits. Requires OTP verification within five minutes, rechecked after acquiring the workspace lock. Planner removal cancels pending reminder jobs; client removal unlinks preserved birth profiles." } }, "/resources/notifications": { "get": { "operationId": "resource_notifications_get", "tags": [ "Resources" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:410", "responses": { "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NotificationPage" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ], "parameters": [ { "name": "cursor", "in": "query", "schema": { "type": "string", "maxLength": 1400 }, "description": "Opaque signed position bound to the caller, collection and selected filters. Empty or omitted starts a new traversal. Refresh the list when changing filters." }, { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 } } ], "x-runtime-pattern": "/resources/{kind}", "x-resource-kind": "notifications", "description": "Typed notifications view of /resources/{kind}. Reads, edits and deletion check workspace ownership. Only editable fields are accepted; server-generated values cannot be supplied." } }, "/resources/notifications/{id}": { "put": { "operationId": "resource_notifications_put", "tags": [ "Resources" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:413", "responses": { "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "200": { "description": "Saved record, or the original refund request on an idempotent replay.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RecordID" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ], "description": "Typed notifications view of /resources/{kind}/{id}. Reads, edits and deletion check workspace ownership. Only editable fields are accepted; server-generated values cannot be supplied.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "Not required for this nonfinancial resource." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NotificationEditRequest" } } } }, "x-runtime-pattern": "/resources/{kind}/{id}", "x-resource-kind": "notifications" }, "delete": { "operationId": "resource_notifications_delete", "tags": [ "Resources" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:414", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeletedRecord" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } } ], "x-runtime-pattern": "/resources/{kind}/{id}", "x-resource-kind": "notifications", "description": "Typed notifications view of /resources/{kind}/{id}. Reads, edits and deletion check workspace ownership. Only editable fields are accepted; server-generated values cannot be supplied. Requires OTP verification within five minutes, rechecked after acquiring the workspace lock. Planner removal cancels pending reminder jobs; client removal unlinks preserved birth profiles." } }, "/resources/support": { "get": { "operationId": "resource_support_get", "tags": [ "Resources" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:410", "responses": { "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SupportPage" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ], "parameters": [ { "name": "cursor", "in": "query", "schema": { "type": "string", "maxLength": 1400 }, "description": "Opaque signed position bound to the caller, collection and selected filters. Empty or omitted starts a new traversal. Refresh the list when changing filters." }, { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 } } ], "x-runtime-pattern": "/resources/{kind}", "x-resource-kind": "support", "description": "Typed support view of /resources/{kind}. Reads, edits and deletion check workspace ownership. Only editable fields are accepted; server-generated values cannot be supplied." }, "post": { "operationId": "resource_support_post", "tags": [ "Resources" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:412", "responses": { "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "200": { "description": "Saved record, or the original refund request on an idempotent replay.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RecordID" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ], "description": "Typed support view of /resources/{kind}. Reads, edits and deletion check workspace ownership. Only editable fields are accepted; server-generated values cannot be supplied.", "parameters": [ { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "Not required for this nonfinancial resource." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SupportCreateRequest" } } } }, "x-runtime-pattern": "/resources/{kind}", "x-resource-kind": "support" } }, "/resources/support/{id}": { "put": { "operationId": "resource_support_put", "tags": [ "Resources" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:413", "responses": { "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "200": { "description": "Saved record, or the original refund request on an idempotent replay.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RecordID" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ], "description": "Typed support view of /resources/{kind}/{id}. Reads, edits and deletion check workspace ownership. Only editable fields are accepted; server-generated values cannot be supplied.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "Not required for this nonfinancial resource." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SupportEditRequest" } } } }, "x-runtime-pattern": "/resources/{kind}/{id}", "x-resource-kind": "support" }, "delete": { "operationId": "resource_support_delete", "tags": [ "Resources" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:414", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeletedRecord" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } } ], "x-runtime-pattern": "/resources/{kind}/{id}", "x-resource-kind": "support", "description": "Typed support view of /resources/{kind}/{id}. Reads, edits and deletion check workspace ownership. Only editable fields are accepted; server-generated values cannot be supplied. Requires OTP verification within five minutes, rechecked after acquiring the workspace lock. Planner removal cancels pending reminder jobs; client removal unlinks preserved birth profiles." } }, "/resources/refunds": { "get": { "operationId": "resource_refunds_get", "tags": [ "Resources" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:410", "responses": { "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RefundsPage" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ], "parameters": [ { "name": "cursor", "in": "query", "schema": { "type": "string", "maxLength": 1400 }, "description": "Opaque signed position bound to the caller, collection and selected filters. Empty or omitted starts a new traversal. Refresh the list when changing filters." }, { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 } } ], "x-runtime-pattern": "/resources/{kind}", "x-resource-kind": "refunds", "description": "Typed refunds view of /resources/{kind}. Reads, edits and deletion check workspace ownership. Only editable fields are accepted; server-generated values cannot be supplied. Requires recent OTP verification and an idempotency key. Paid invoice ownership, original network and Finance processing rules apply." }, "post": { "operationId": "resource_refunds_post", "tags": [ "Resources" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:412", "responses": { "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "200": { "description": "Saved record, or the original refund request on an idempotent replay.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RecordID" } } } }, "201": { "description": "New refund request recorded for Finance.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RecordID" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ], "description": "Typed refunds view of /resources/{kind}. Reads, edits and deletion check workspace ownership. Only editable fields are accepted; server-generated values cannot be supplied. Requires recent OTP verification and an idempotency key. Paid invoice ownership, original network and Finance processing rules apply.", "parameters": [ { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "Required for refund creation, Finance decisions and other financial commands. Replays retain their stored result; changed payloads return a conflict." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RefundsCreateRequest" } } } }, "x-runtime-pattern": "/resources/{kind}", "x-resource-kind": "refunds" } }, "/resources/consents": { "get": { "operationId": "resource_consents_get", "tags": [ "Resources" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:410", "responses": { "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConsentsPage" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ], "parameters": [ { "name": "cursor", "in": "query", "schema": { "type": "string", "maxLength": 1400 }, "description": "Opaque signed position bound to the caller, collection and selected filters. Empty or omitted starts a new traversal. Refresh the list when changing filters." }, { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 } } ], "x-runtime-pattern": "/resources/{kind}", "x-resource-kind": "consents", "description": "Typed consents view of /resources/{kind}. Reads, edits and deletion check workspace ownership. Only editable fields are accepted; server-generated values cannot be supplied." }, "post": { "operationId": "resource_consents_post", "tags": [ "Resources" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:412", "responses": { "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "200": { "description": "Saved record, or the original refund request on an idempotent replay.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RecordID" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ], "description": "Typed consents view of /resources/{kind}. Reads, edits and deletion check workspace ownership. Only editable fields are accepted; server-generated values cannot be supplied.", "parameters": [ { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "Not required for this nonfinancial resource." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConsentsCreateRequest" } } } }, "x-runtime-pattern": "/resources/{kind}", "x-resource-kind": "consents" } }, "/resources/consents/{id}": { "put": { "operationId": "resource_consents_put", "tags": [ "Resources" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:413", "responses": { "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "200": { "description": "Saved record, or the original refund request on an idempotent replay.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RecordID" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ], "description": "Typed consents view of /resources/{kind}/{id}. Reads, edits and deletion check workspace ownership. Only editable fields are accepted; server-generated values cannot be supplied.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "Not required for this nonfinancial resource." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConsentsEditRequest" } } } }, "x-runtime-pattern": "/resources/{kind}/{id}", "x-resource-kind": "consents" }, "delete": { "operationId": "resource_consents_delete", "tags": [ "Resources" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:414", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeletedRecord" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "session": [] }, { "adminSession": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } } ], "x-runtime-pattern": "/resources/{kind}/{id}", "x-resource-kind": "consents", "description": "Typed consents view of /resources/{kind}/{id}. Reads, edits and deletion check workspace ownership. Only editable fields are accepted; server-generated values cannot be supplied. Requires OTP verification within five minutes, rechecked after acquiring the workspace lock. Planner removal cancels pending reminder jobs; client removal unlinks preserved birth profiles." } }, "/admin/users": { "post": { "operationId": "admin_configuration_users_post", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:441", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SavedConfiguration" } } } }, "201": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SavedConfiguration" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Concrete users configuration view. Validated editable fields, authoritative backend roles and current revisions apply; saved immutable purchases and reports are preserved. Requires email verification within five minutes. Sensitive authorization is rechecked within the mutation transaction.", "parameters": [ { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminUsersCreateRequest" } } } }, "x-runtime-pattern": "/admin/{kind}", "x-admin-configuration-kind": "users" }, "get": { "operationId": "admin_users_get", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:440", "responses": { "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "200": { "description": "Stored operation result.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedRecords" } } } } }, "security": [ { "adminSession": [] } ], "parameters": [ { "name": "cursor", "in": "query", "schema": { "type": "string", "maxLength": 1400 }, "description": "Opaque signed position bound to the caller, collection and selected filters. Empty or omitted starts a new traversal. Refresh the list when changing filters." }, { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "description": "Growing collections: default 100, or 50 for support. Plans/features/wallet return their complete finite catalogs." }, { "name": "q", "in": "query", "schema": { "type": "string", "maxLength": 160 }, "description": "Literal, case-insensitive search across supported summary fields, applied before paging." }, { "name": "administrators", "in": "query", "schema": { "type": "boolean" }, "description": "When true, Owner-only view of invited administrators; includes revoked access for audit and restoration. Ordinary members are excluded. The cursor is bound to this view." } ], "x-runtime-pattern": "/admin/{kind}" } }, "/admin/plans/{id}": { "put": { "operationId": "admin_configuration_plans_put", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:443", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SavedConfiguration" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Concrete plans configuration view. Validated editable fields, authoritative backend roles and current revisions apply; saved immutable purchases and reports are preserved. Requires email verification within five minutes. Sensitive authorization is rechecked within the mutation transaction. Idempotency-Key is required. Free prices and saved-report allowance remain zero; Free cannot acquire premium capabilities. Rank, identifier and package version are assigned by the service.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "enum": [ "free", "seeker", "strategist", "practitioner" ] }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 128 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminPlansEditRequest" } } } }, "x-runtime-pattern": "/admin/{kind}/{id}", "x-admin-configuration-kind": "plans" } }, "/admin/features/{id}": { "put": { "operationId": "admin_configuration_features_put", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:443", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminFeatureUpdated" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Concrete features configuration view. Validated editable fields, authoritative backend roles and current revisions apply; saved immutable purchases and reports are preserved. Requires email verification within five minutes. Sensitive authorization is rechecked within the mutation transaction. Owner only. Stale updates return 409; update, revision and audit commit atomically.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminFeaturesEditRequest" } } } }, "x-runtime-pattern": "/admin/{kind}/{id}", "x-admin-configuration-kind": "features" } }, "/admin/menus": { "post": { "operationId": "admin_configuration_menus_post", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:441", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SavedConfiguration" } } } }, "201": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SavedConfiguration" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Concrete menus configuration view. Validated editable fields, authoritative backend roles and current revisions apply; saved immutable purchases and reports are preserved.", "parameters": [ { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminMenusCreateRequest" } } } }, "x-runtime-pattern": "/admin/{kind}", "x-admin-configuration-kind": "menus" } }, "/admin/menus/{id}": { "put": { "operationId": "admin_configuration_menus_put", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:443", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SavedConfiguration" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Concrete menus configuration view. Validated editable fields, authoritative backend roles and current revisions apply; saved immutable purchases and reports are preserved.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminMenusEditRequest" } } } }, "x-runtime-pattern": "/admin/{kind}/{id}", "x-admin-configuration-kind": "menus" } }, "/admin/methods": { "post": { "operationId": "admin_configuration_methods_post", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:441", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SavedConfiguration" } } } }, "201": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SavedConfiguration" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Concrete methods configuration view. Validated editable fields, authoritative backend roles and current revisions apply; saved immutable purchases and reports are preserved.", "parameters": [ { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminMethodsCreateRequest" } } } }, "x-runtime-pattern": "/admin/{kind}", "x-admin-configuration-kind": "methods" }, "get": { "operationId": "admin_methods_get", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:440", "responses": { "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminMethodsPage" } } } } }, "security": [ { "adminSession": [] } ], "parameters": [ { "name": "cursor", "in": "query", "schema": { "type": "string", "maxLength": 1400 }, "description": "Opaque signed position bound to the caller, collection and selected filters. Empty or omitted starts a new traversal. Refresh the list when changing filters." }, { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "description": "Growing collections: default 100, or 50 for support. Plans/features/wallet return their complete finite catalogs." }, { "name": "q", "in": "query", "schema": { "type": "string", "maxLength": 160 }, "description": "Literal, case-insensitive search across supported summary fields, applied before paging." } ], "x-runtime-pattern": "/admin/{kind}", "x-admin-configuration-kind": "methods", "description": "Calculation method records plus the installed original-engine scope, actual embedded-data fingerprints, pinned timezone/calendar identities and exact retained publication approvals. Owner, Methods Editor or Methods Reviewer only. Record search and pagination do not filter the installed knowledge inventory. No source website is contacted." } }, "/admin/methods/{id}": { "put": { "operationId": "admin_configuration_methods_put", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:443", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SavedConfiguration" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Concrete methods configuration view. Validated editable fields, authoritative backend roles and current revisions apply; saved immutable purchases and reports are preserved.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminMethodsEditRequest" } } } }, "x-runtime-pattern": "/admin/{kind}/{id}", "x-admin-configuration-kind": "methods" } }, "/admin/rules": { "post": { "operationId": "admin_configuration_rules_post", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:441", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SavedConfiguration" } } } }, "201": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SavedConfiguration" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Concrete rules configuration view. Validated editable fields, authoritative backend roles and current revisions apply; saved immutable purchases and reports are preserved.", "parameters": [ { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminRulesCreateRequest" } } } }, "x-runtime-pattern": "/admin/{kind}", "x-admin-configuration-kind": "rules" } }, "/admin/rules/{id}": { "put": { "operationId": "admin_configuration_rules_put", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:443", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SavedConfiguration" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Concrete rules configuration view. Validated editable fields, authoritative backend roles and current revisions apply; saved immutable purchases and reports are preserved.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminRulesEditRequest" } } } }, "x-runtime-pattern": "/admin/{kind}/{id}", "x-admin-configuration-kind": "rules" } }, "/admin/corrections": { "post": { "operationId": "admin_configuration_corrections_post", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:441", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SavedConfiguration" } } } }, "201": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SavedConfiguration" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Concrete corrections configuration view. Validated editable fields, authoritative backend roles and current revisions apply; saved immutable purchases and reports are preserved.", "parameters": [ { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminCorrectionsCreateRequest" } } } }, "x-runtime-pattern": "/admin/{kind}", "x-admin-configuration-kind": "corrections" } }, "/admin/corrections/{id}": { "put": { "operationId": "admin_configuration_corrections_put", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:443", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SavedConfiguration" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Concrete corrections configuration view. Validated editable fields, authoritative backend roles and current revisions apply; saved immutable purchases and reports are preserved.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminCorrectionsEditRequest" } } } }, "x-runtime-pattern": "/admin/{kind}/{id}", "x-admin-configuration-kind": "corrections" } }, "/admin/notifications": { "post": { "operationId": "admin_configuration_notifications_post", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:441", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SavedConfiguration" } } } }, "201": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SavedConfiguration" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Concrete notifications configuration view. Validated editable fields, authoritative backend roles and current revisions apply; saved immutable purchases and reports are preserved.", "parameters": [ { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminNotificationsCreateRequest" } } } }, "x-runtime-pattern": "/admin/{kind}", "x-admin-configuration-kind": "notifications" } }, "/admin/notifications/{id}": { "put": { "operationId": "admin_configuration_notifications_put", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:443", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SavedConfiguration" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Concrete notifications configuration view. Validated editable fields, authoritative backend roles and current revisions apply; saved immutable purchases and reports are preserved.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminNotificationsEditRequest" } } } }, "x-runtime-pattern": "/admin/{kind}/{id}", "x-admin-configuration-kind": "notifications" } }, "/admin/settings": { "post": { "operationId": "admin_configuration_settings_post", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:441", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SavedConfiguration" } } } }, "201": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SavedConfiguration" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Concrete settings configuration view. Validated editable fields, authoritative backend roles and current revisions apply; saved immutable purchases and reports are preserved. Requires email verification within five minutes. Sensitive authorization is rechecked within the mutation transaction.", "parameters": [ { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminSettingsCreateRequest" } } } }, "x-runtime-pattern": "/admin/{kind}", "x-admin-configuration-kind": "settings" } }, "/admin/settings/{id}": { "put": { "operationId": "admin_configuration_settings_put", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:443", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SavedConfiguration" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Concrete settings configuration view. Validated editable fields, authoritative backend roles and current revisions apply; saved immutable purchases and reports are preserved. Requires email verification within five minutes. Sensitive authorization is rechecked within the mutation transaction.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminSettingsEditRequest" } } } }, "x-runtime-pattern": "/admin/{kind}/{id}", "x-admin-configuration-kind": "settings" } }, "/admin/features": { "get": { "operationId": "admin_features_get", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:440", "responses": { "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminFeaturePage" } } } } }, "security": [ { "adminSession": [] } ], "parameters": [ { "name": "cursor", "in": "query", "schema": { "type": "string", "maxLength": 1400 }, "description": "Opaque signed position bound to the caller, collection and selected filters. Empty or omitted starts a new traversal. Refresh the list when changing filters." }, { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "description": "Growing collections: default 100, or 50 for support. Plans/features/wallet return their complete finite catalogs." }, { "name": "q", "in": "query", "schema": { "type": "string", "maxLength": 160 }, "description": "Literal, case-insensitive search across supported summary fields, applied before paging." } ], "x-runtime-pattern": "/admin/{kind}", "x-admin-configuration-kind": "features", "description": "Finite capability catalog, including immutable identifiers and current revisions. Content/Owner may inspect; only Owner can mutate." } }, "/admin/contacts/{id}/reply": { "post": { "operationId": "admin_operation_contacts_reply", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:444", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdministrativeAction" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Current role/session authorization, mutation and audit are checked in one transaction. Support/Owner only. Include the displayed revision; stale or closed conversations return 409. Replies atomically enqueue one encrypted email with the saved conversation.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "Required for refund creation, Finance decisions and other financial commands. Replays retain their stored result; changed payloads return a conflict." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminContactReplyInput" } } } }, "x-runtime-pattern": "/admin/{kind}/{id}/{action}" } }, "/admin/contacts/{id}/close": { "post": { "operationId": "admin_operation_contacts_close", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:444", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdministrativeAction" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Current role/session authorization, mutation and audit are checked in one transaction. Support/Owner only. Include the displayed revision; stale or closed conversations return 409. Replies atomically enqueue one encrypted email with the saved conversation.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "Required for refund creation, Finance decisions and other financial commands. Replays retain their stored result; changed payloads return a conflict." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminContactCloseInput" } } } }, "x-runtime-pattern": "/admin/{kind}/{id}/{action}" } }, "/admin/jobs/{id}/retry": { "post": { "operationId": "admin_operation_jobs_retry", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:444", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdministrativeAction" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Current role/session authorization, mutation and audit are checked in one transaction. Support/Finance/Owner may retry currently failed service jobs. A released report requires new generation. Financial refund delivery additionally requires recent email verification, Finance/Owner and Idempotency-Key.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "Required for refund creation, Finance decisions and other financial commands. Replays retain their stored result; changed payloads return a conflict." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminServiceRetryInput" } } } }, "x-runtime-pattern": "/admin/{kind}/{id}/{action}" } }, "/admin/wallet/{id}/enable": { "post": { "operationId": "admin_operation_wallet_enable", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:444", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdministrativeAction" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Current role/session authorization, mutation and audit are checked in one transaction. Finance/Owner and recent email verification required. Include the displayed enabled state; a changed state returns 409. Provider capabilities remain authoritative; a missing external wallet does not enable checkout.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "maxLength": 256 }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "Required for refund creation, Finance decisions and other financial commands. Replays retain their stored result; changed payloads return a conflict." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminWalletPairInput" } } } }, "x-runtime-pattern": "/admin/{kind}/{id}/{action}" } }, "/admin/wallet/{id}/disable": { "post": { "operationId": "admin_operation_wallet_disable", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:444", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdministrativeAction" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Current role/session authorization, mutation and audit are checked in one transaction. Finance/Owner and recent email verification required. Include the displayed enabled state; a changed state returns 409. Provider capabilities remain authoritative; a missing external wallet does not enable checkout.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "maxLength": 256 }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "Required for refund creation, Finance decisions and other financial commands. Replays retain their stored result; changed payloads return a conflict." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminWalletPairInput" } } } }, "x-runtime-pattern": "/admin/{kind}/{id}/{action}" } }, "/cms/pages/{id}/preview": { "post": { "operationId": "cms_publication_preview", "tags": [ "CMS" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "The stored content/state revision after the transactional operation.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CMSChanged" } } } }, "403": { "description": "Structured content, revision, or service error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Structured content, revision, or service error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Structured content, selection, revision or service error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Structured content, revision, or service error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Structured content, revision, or service error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Structured content, revision, or service error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request exceeds one MiB, including trailing bytes.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error. Private diagnostics are excluded.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CMSCommand" } } } }, "description": "Draft \u2192 preview \u2192 published \u2192 archived. Rollback selects a previously published immutable revision. Slug locking, state revisions, replacement archival and audits commit atomically. Content validation returns field_errors keyed by editable field or nested document path. Unsupported fields, invalid UTF-8, NUL text and malformed document hierarchy are rejected before persistence. Concrete preview command; no additional runtime handler is registered.", "x-runtime-pattern": "/cms/pages/{id}/{action}" } }, "/cms/pages/{id}/publish": { "post": { "operationId": "cms_publication_publish", "tags": [ "CMS" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "The stored content/state revision after the transactional operation.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CMSChanged" } } } }, "403": { "description": "Structured content, revision, or service error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Structured content, revision, or service error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Structured content, selection, revision or service error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Structured content, revision, or service error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Structured content, revision, or service error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Structured content, revision, or service error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request exceeds one MiB, including trailing bytes.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error. Private diagnostics are excluded.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CMSCommand" } } } }, "description": "Draft \u2192 preview \u2192 published \u2192 archived. Rollback selects a previously published immutable revision. Slug locking, state revisions, replacement archival and audits commit atomically. Content validation returns field_errors keyed by editable field or nested document path. Unsupported fields, invalid UTF-8, NUL text and malformed document hierarchy are rejected before persistence. Concrete publish command; no additional runtime handler is registered.", "x-runtime-pattern": "/cms/pages/{id}/{action}" } }, "/cms/pages/{id}/archive": { "post": { "operationId": "cms_publication_archive", "tags": [ "CMS" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "The stored content/state revision after the transactional operation.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CMSChanged" } } } }, "403": { "description": "Structured content, revision, or service error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Structured content, revision, or service error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Structured content, selection, revision or service error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Structured content, revision, or service error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Structured content, revision, or service error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Structured content, revision, or service error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request exceeds one MiB, including trailing bytes.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error. Private diagnostics are excluded.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CMSCommand" } } } }, "description": "Draft \u2192 preview \u2192 published \u2192 archived. Rollback selects a previously published immutable revision. Slug locking, state revisions, replacement archival and audits commit atomically. Content validation returns field_errors keyed by editable field or nested document path. Unsupported fields, invalid UTF-8, NUL text and malformed document hierarchy are rejected before persistence. Concrete archive command; no additional runtime handler is registered.", "x-runtime-pattern": "/cms/pages/{id}/{action}" } }, "/cms/pages/{id}/rollback": { "post": { "operationId": "cms_publication_rollback", "tags": [ "CMS" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "The stored content/state revision after the transactional operation.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CMSChanged" } } } }, "403": { "description": "Structured content, revision, or service error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Structured content, revision, or service error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Structured content, selection, revision or service error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Structured content, revision, or service error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Structured content, revision, or service error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Structured content, revision, or service error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request exceeds one MiB, including trailing bytes.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error. Private diagnostics are excluded.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CMSCommand" } } } }, "description": "Draft \u2192 preview \u2192 published \u2192 archived. Rollback selects a previously published immutable revision. Slug locking, state revisions, replacement archival and audits commit atomically. Content validation returns field_errors keyed by editable field or nested document path. Unsupported fields, invalid UTF-8, NUL text and malformed document hierarchy are rejected before persistence. Concrete rollback command; no additional runtime handler is registered.", "x-runtime-pattern": "/cms/pages/{id}/{action}" } }, "/admin/users/{id}/roles": { "post": { "operationId": "admin_action_users_roles", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:444", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdministrativeAction" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Concrete users roles command. Only declared fields are accepted; text uses Unicode limits, excludes NUL, and required text must remain nonempty after trimming. No extra runtime handler is registered. Recent email verification required. Roles and administrator suspension/restoration require Owner; Support can suspend/restore customer accounts. Last verified Owner and deleted-account protections apply. Complimentary access is Owner-only, uses the current catalog and workspace lock, and cannot overlap current/future funded access.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "Required for refund creation, Finance decisions and other financial commands. Replays retain their stored result; changed payloads return a conflict." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminRoleActionInput" } } } }, "x-runtime-pattern": "/admin/{kind}/{id}/{action}", "x-admin-action-kind": "users" } }, "/admin/users/{id}/suspend": { "post": { "operationId": "admin_action_users_suspend", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:444", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdministrativeAction" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Concrete users suspend command. Only declared fields are accepted; text uses Unicode limits, excludes NUL, and required text must remain nonempty after trimming. No extra runtime handler is registered. Recent email verification required. Roles and administrator suspension/restoration require Owner; Support can suspend/restore customer accounts. Last verified Owner and deleted-account protections apply. Complimentary access is Owner-only, uses the current catalog and workspace lock, and cannot overlap current/future funded access.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "Required for refund creation, Finance decisions and other financial commands. Replays retain their stored result; changed payloads return a conflict." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminSuspendActionInput" } } } }, "x-runtime-pattern": "/admin/{kind}/{id}/{action}", "x-admin-action-kind": "users" } }, "/admin/users/{id}/restore": { "post": { "operationId": "admin_action_users_restore", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:444", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdministrativeAction" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Concrete users restore command. Only declared fields are accepted; text uses Unicode limits, excludes NUL, and required text must remain nonempty after trimming. No extra runtime handler is registered. Recent email verification required. Roles and administrator suspension/restoration require Owner; Support can suspend/restore customer accounts. Last verified Owner and deleted-account protections apply. Complimentary access is Owner-only, uses the current catalog and workspace lock, and cannot overlap current/future funded access.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "Required for refund creation, Finance decisions and other financial commands. Replays retain their stored result; changed payloads return a conflict." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminRevisionActionInput" } } } }, "x-runtime-pattern": "/admin/{kind}/{id}/{action}", "x-admin-action-kind": "users" } }, "/admin/users/{id}/grant": { "post": { "operationId": "admin_action_users_grant", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:444", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdministrativeAction" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Concrete users grant command. Only declared fields are accepted; text uses Unicode limits, excludes NUL, and required text must remain nonempty after trimming. No extra runtime handler is registered. Recent email verification required. Roles and administrator suspension/restoration require Owner; Support can suspend/restore customer accounts. Last verified Owner and deleted-account protections apply. Complimentary access is Owner-only, uses the current catalog and workspace lock, and cannot overlap current/future funded access.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "Required for refund creation, Finance decisions and other financial commands. Replays retain their stored result; changed payloads return a conflict." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminGrantActionInput" } } } }, "x-runtime-pattern": "/admin/{kind}/{id}/{action}", "x-admin-action-kind": "users" } }, "/admin/subscriptions/{id}/cancel": { "post": { "operationId": "admin_action_subscriptions_cancel", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:444", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdministrativeAction" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Concrete subscriptions cancel command. Only declared fields are accepted; text uses Unicode limits, excludes NUL, and required text must remain nonempty after trimming. No extra runtime handler is registered. Finance/Owner, recent email verification and Idempotency-Key required. Only a currently funded period can be cancelled; financial snapshots remain retained.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "Required for refund creation, Finance decisions and other financial commands. Replays retain their stored result; changed payloads return a conflict." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminAdjustmentInput" } } } }, "x-runtime-pattern": "/admin/{kind}/{id}/{action}", "x-admin-action-kind": "subscriptions" } }, "/admin/refunds/{id}/approve": { "post": { "operationId": "admin_action_refunds_approve", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:444", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdministrativeAction" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Concrete refunds approve command. Only declared fields are accepted; text uses Unicode limits, excludes NUL, and required text must remain nonempty after trimming. No extra runtime handler is registered. Finance/Owner, fresh email verification and Idempotency-Key required. Revision is checked before a new decision; exact authenticated replay returns the recorded decision. Changed replay payload conflicts. Approval queues execution through the separate wallet.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "Required for refund creation, Finance decisions and other financial commands. Replays retain their stored result; changed payloads return a conflict." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminRefundApproveInput" } } } }, "x-runtime-pattern": "/admin/{kind}/{id}/{action}", "x-admin-action-kind": "refunds" } }, "/admin/refunds/{id}/decline": { "post": { "operationId": "admin_action_refunds_decline", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:444", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdministrativeAction" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Concrete refunds decline command. Only declared fields are accepted; text uses Unicode limits, excludes NUL, and required text must remain nonempty after trimming. No extra runtime handler is registered. Finance/Owner, fresh email verification and Idempotency-Key required. Revision is checked before a new decision; exact authenticated replay returns the recorded decision. Changed replay payload conflicts. Approval queues execution through the separate wallet.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "Required for refund creation, Finance decisions and other financial commands. Replays retain their stored result; changed payloads return a conflict." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminRefundDeclineInput" } } } }, "x-runtime-pattern": "/admin/{kind}/{id}/{action}", "x-admin-action-kind": "refunds" } }, "/admin/methods/{id}/test": { "post": { "operationId": "admin_action_methods_test", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:444", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdministrativeAction" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Concrete methods test command. Only declared fields are accepted; text uses Unicode limits, excludes NUL, and required text must remain nonempty after trimming. No extra runtime handler is registered. Authors cannot review their own method/calendar revision. Test requires Methods Editor/Owner; review/publication/restoration requires Methods Reviewer/Owner and fresh email verification. Independent expert evidence remains necessary.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "Required for refund creation, Finance decisions and other financial commands. Replays retain their stored result; changed payloads return a conflict." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminRevisionActionInput" } } } }, "x-runtime-pattern": "/admin/{kind}/{id}/{action}", "x-admin-action-kind": "methods" } }, "/admin/methods/{id}/approve": { "post": { "operationId": "admin_action_methods_approve", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:444", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdministrativeAction" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Concrete methods approve command. Only declared fields are accepted; text uses Unicode limits, excludes NUL, and required text must remain nonempty after trimming. No extra runtime handler is registered. Authors cannot review their own method/calendar revision. Test requires Methods Editor/Owner; review/publication/restoration requires Methods Reviewer/Owner and fresh email verification. Independent expert evidence remains necessary.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "Required for refund creation, Finance decisions and other financial commands. Replays retain their stored result; changed payloads return a conflict." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminIndependentReviewInput" } } } }, "x-runtime-pattern": "/admin/{kind}/{id}/{action}", "x-admin-action-kind": "methods" } }, "/admin/methods/{id}/publish": { "post": { "operationId": "admin_action_methods_publish", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:444", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdministrativeAction" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Concrete methods publish command. Only declared fields are accepted; text uses Unicode limits, excludes NUL, and required text must remain nonempty after trimming. No extra runtime handler is registered. Authors cannot review their own method/calendar revision. Test requires Methods Editor/Owner; review/publication/restoration requires Methods Reviewer/Owner and fresh email verification. Independent expert evidence remains necessary.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "Required for refund creation, Finance decisions and other financial commands. Replays retain their stored result; changed payloads return a conflict." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminRevisionActionInput" } } } }, "x-runtime-pattern": "/admin/{kind}/{id}/{action}", "x-admin-action-kind": "methods" } }, "/admin/methods/{id}/retire": { "post": { "operationId": "admin_action_methods_retire", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:444", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdministrativeAction" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Concrete methods retire command. Only declared fields are accepted; text uses Unicode limits, excludes NUL, and required text must remain nonempty after trimming. No extra runtime handler is registered. Authors cannot review their own method/calendar revision. Test requires Methods Editor/Owner; review/publication/restoration requires Methods Reviewer/Owner and fresh email verification. Independent expert evidence remains necessary.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "Required for refund creation, Finance decisions and other financial commands. Replays retain their stored result; changed payloads return a conflict." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminRevisionActionInput" } } } }, "x-runtime-pattern": "/admin/{kind}/{id}/{action}", "x-admin-action-kind": "methods" } }, "/admin/methods/{id}/rollback": { "post": { "operationId": "admin_action_methods_rollback", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:444", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdministrativeAction" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Concrete methods rollback command. Only declared fields are accepted; text uses Unicode limits, excludes NUL, and required text must remain nonempty after trimming. No extra runtime handler is registered. Authors cannot review their own method/calendar revision. Test requires Methods Editor/Owner; review/publication/restoration requires Methods Reviewer/Owner and fresh email verification. Independent expert evidence remains necessary.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "Required for refund creation, Finance decisions and other financial commands. Replays retain their stored result; changed payloads return a conflict." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminRevisionActionInput" } } } }, "x-runtime-pattern": "/admin/{kind}/{id}/{action}", "x-admin-action-kind": "methods" } }, "/admin/rules/{id}/test": { "post": { "operationId": "admin_action_rules_test", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:444", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdministrativeAction" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Concrete rules test command. Only declared fields are accepted; text uses Unicode limits, excludes NUL, and required text must remain nonempty after trimming. No extra runtime handler is registered. Authors cannot review their own method/calendar revision. Test requires Methods Editor/Owner; review/publication/restoration requires Methods Reviewer/Owner and fresh email verification. Independent expert evidence remains necessary.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "Required for refund creation, Finance decisions and other financial commands. Replays retain their stored result; changed payloads return a conflict." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminRevisionActionInput" } } } }, "x-runtime-pattern": "/admin/{kind}/{id}/{action}", "x-admin-action-kind": "rules" } }, "/admin/rules/{id}/approve": { "post": { "operationId": "admin_action_rules_approve", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:444", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdministrativeAction" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Concrete rules approve command. Only declared fields are accepted; text uses Unicode limits, excludes NUL, and required text must remain nonempty after trimming. No extra runtime handler is registered. Authors cannot review their own method/calendar revision. Test requires Methods Editor/Owner; review/publication/restoration requires Methods Reviewer/Owner and fresh email verification. Independent expert evidence remains necessary.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "Required for refund creation, Finance decisions and other financial commands. Replays retain their stored result; changed payloads return a conflict." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminIndependentReviewInput" } } } }, "x-runtime-pattern": "/admin/{kind}/{id}/{action}", "x-admin-action-kind": "rules" } }, "/admin/rules/{id}/publish": { "post": { "operationId": "admin_action_rules_publish", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:444", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdministrativeAction" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Concrete rules publish command. Only declared fields are accepted; text uses Unicode limits, excludes NUL, and required text must remain nonempty after trimming. No extra runtime handler is registered. Authors cannot review their own method/calendar revision. Test requires Methods Editor/Owner; review/publication/restoration requires Methods Reviewer/Owner and fresh email verification. Independent expert evidence remains necessary.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "Required for refund creation, Finance decisions and other financial commands. Replays retain their stored result; changed payloads return a conflict." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminRevisionActionInput" } } } }, "x-runtime-pattern": "/admin/{kind}/{id}/{action}", "x-admin-action-kind": "rules" } }, "/admin/rules/{id}/retire": { "post": { "operationId": "admin_action_rules_retire", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:444", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdministrativeAction" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Concrete rules retire command. Only declared fields are accepted; text uses Unicode limits, excludes NUL, and required text must remain nonempty after trimming. No extra runtime handler is registered. Authors cannot review their own method/calendar revision. Test requires Methods Editor/Owner; review/publication/restoration requires Methods Reviewer/Owner and fresh email verification. Independent expert evidence remains necessary.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "Required for refund creation, Finance decisions and other financial commands. Replays retain their stored result; changed payloads return a conflict." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminRevisionActionInput" } } } }, "x-runtime-pattern": "/admin/{kind}/{id}/{action}", "x-admin-action-kind": "rules" } }, "/admin/rules/{id}/rollback": { "post": { "operationId": "admin_action_rules_rollback", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:444", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdministrativeAction" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Concrete rules rollback command. Only declared fields are accepted; text uses Unicode limits, excludes NUL, and required text must remain nonempty after trimming. No extra runtime handler is registered. Authors cannot review their own method/calendar revision. Test requires Methods Editor/Owner; review/publication/restoration requires Methods Reviewer/Owner and fresh email verification. Independent expert evidence remains necessary.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "Required for refund creation, Finance decisions and other financial commands. Replays retain their stored result; changed payloads return a conflict." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminRevisionActionInput" } } } }, "x-runtime-pattern": "/admin/{kind}/{id}/{action}", "x-admin-action-kind": "rules" } }, "/admin/corrections/{id}/test": { "post": { "operationId": "admin_action_corrections_test", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:444", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdministrativeAction" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Concrete corrections test command. Only declared fields are accepted; text uses Unicode limits, excludes NUL, and required text must remain nonempty after trimming. No extra runtime handler is registered. Authors cannot review their own method/calendar revision. Test requires Methods Editor/Owner; review/publication/restoration requires Methods Reviewer/Owner and fresh email verification. Independent expert evidence remains necessary.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "Required for refund creation, Finance decisions and other financial commands. Replays retain their stored result; changed payloads return a conflict." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminRevisionActionInput" } } } }, "x-runtime-pattern": "/admin/{kind}/{id}/{action}", "x-admin-action-kind": "corrections" } }, "/admin/corrections/{id}/approve": { "post": { "operationId": "admin_action_corrections_approve", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:444", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdministrativeAction" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Concrete corrections approve command. Only declared fields are accepted; text uses Unicode limits, excludes NUL, and required text must remain nonempty after trimming. No extra runtime handler is registered. Authors cannot review their own method/calendar revision. Test requires Methods Editor/Owner; review/publication/restoration requires Methods Reviewer/Owner and fresh email verification. Independent expert evidence remains necessary.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "Required for refund creation, Finance decisions and other financial commands. Replays retain their stored result; changed payloads return a conflict." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminIndependentReviewInput" } } } }, "x-runtime-pattern": "/admin/{kind}/{id}/{action}", "x-admin-action-kind": "corrections" } }, "/admin/corrections/{id}/publish": { "post": { "operationId": "admin_action_corrections_publish", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:444", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdministrativeAction" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Concrete corrections publish command. Only declared fields are accepted; text uses Unicode limits, excludes NUL, and required text must remain nonempty after trimming. No extra runtime handler is registered. Authors cannot review their own method/calendar revision. Test requires Methods Editor/Owner; review/publication/restoration requires Methods Reviewer/Owner and fresh email verification. Independent expert evidence remains necessary.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "Required for refund creation, Finance decisions and other financial commands. Replays retain their stored result; changed payloads return a conflict." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminRevisionActionInput" } } } }, "x-runtime-pattern": "/admin/{kind}/{id}/{action}", "x-admin-action-kind": "corrections" } }, "/admin/corrections/{id}/retire": { "post": { "operationId": "admin_action_corrections_retire", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:444", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdministrativeAction" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Concrete corrections retire command. Only declared fields are accepted; text uses Unicode limits, excludes NUL, and required text must remain nonempty after trimming. No extra runtime handler is registered. Authors cannot review their own method/calendar revision. Test requires Methods Editor/Owner; review/publication/restoration requires Methods Reviewer/Owner and fresh email verification. Independent expert evidence remains necessary.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "Required for refund creation, Finance decisions and other financial commands. Replays retain their stored result; changed payloads return a conflict." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminRevisionActionInput" } } } }, "x-runtime-pattern": "/admin/{kind}/{id}/{action}", "x-admin-action-kind": "corrections" } }, "/admin/corrections/{id}/rollback": { "post": { "operationId": "admin_action_corrections_rollback", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:444", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdministrativeAction" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Concrete corrections rollback command. Only declared fields are accepted; text uses Unicode limits, excludes NUL, and required text must remain nonempty after trimming. No extra runtime handler is registered. Authors cannot review their own method/calendar revision. Test requires Methods Editor/Owner; review/publication/restoration requires Methods Reviewer/Owner and fresh email verification. Independent expert evidence remains necessary.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "Required for refund creation, Finance decisions and other financial commands. Replays retain their stored result; changed payloads return a conflict." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminRevisionActionInput" } } } }, "x-runtime-pattern": "/admin/{kind}/{id}/{action}", "x-admin-action-kind": "corrections" } }, "/admin/menus/{id}/publish": { "post": { "operationId": "admin_action_menus_publish", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:444", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdministrativeAction" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Concrete menus publish command. Only declared fields are accepted; text uses Unicode limits, excludes NUL, and required text must remain nonempty after trimming. No extra runtime handler is registered. Content Editor/Owner only, with exact displayed revision and atomic publication history/audit.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "Required for refund creation, Finance decisions and other financial commands. Replays retain their stored result; changed payloads return a conflict." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminRevisionActionInput" } } } }, "x-runtime-pattern": "/admin/{kind}/{id}/{action}", "x-admin-action-kind": "menus" } }, "/admin/menus/{id}/archive": { "post": { "operationId": "admin_action_menus_archive", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:444", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdministrativeAction" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Concrete menus archive command. Only declared fields are accepted; text uses Unicode limits, excludes NUL, and required text must remain nonempty after trimming. No extra runtime handler is registered. Content Editor/Owner only, with exact displayed revision and atomic publication history/audit.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "Required for refund creation, Finance decisions and other financial commands. Replays retain their stored result; changed payloads return a conflict." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminRevisionActionInput" } } } }, "x-runtime-pattern": "/admin/{kind}/{id}/{action}", "x-admin-action-kind": "menus" } }, "/admin/notifications/{id}/publish": { "post": { "operationId": "admin_action_notifications_publish", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:444", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdministrativeAction" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Concrete notifications publish command. Only declared fields are accepted; text uses Unicode limits, excludes NUL, and required text must remain nonempty after trimming. No extra runtime handler is registered. Content Editor/Owner only, with exact displayed revision and atomic publication history/audit.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "Required for refund creation, Finance decisions and other financial commands. Replays retain their stored result; changed payloads return a conflict." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminRevisionActionInput" } } } }, "x-runtime-pattern": "/admin/{kind}/{id}/{action}", "x-admin-action-kind": "notifications" } }, "/admin/notifications/{id}/archive": { "post": { "operationId": "admin_action_notifications_archive", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:444", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdministrativeAction" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Concrete notifications archive command. Only declared fields are accepted; text uses Unicode limits, excludes NUL, and required text must remain nonempty after trimming. No extra runtime handler is registered. Content Editor/Owner only, with exact displayed revision and atomic publication history/audit.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "Required for refund creation, Finance decisions and other financial commands. Replays retain their stored result; changed payloads return a conflict." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminRevisionActionInput" } } } }, "x-runtime-pattern": "/admin/{kind}/{id}/{action}", "x-admin-action-kind": "notifications" } }, "/admin/media/{id}/publish": { "post": { "operationId": "admin_action_media_publish", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:444", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdministrativeAction" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Concrete media publish command. Only declared fields are accepted; text uses Unicode limits, excludes NUL, and required text must remain nonempty after trimming. No extra runtime handler is registered. Content Editor/Owner only, with exact displayed revision and atomic publication history/audit.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "Required for refund creation, Finance decisions and other financial commands. Replays retain their stored result; changed payloads return a conflict." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminRevisionActionInput" } } } }, "x-runtime-pattern": "/admin/{kind}/{id}/{action}", "x-admin-action-kind": "media" } }, "/admin/media/{id}/archive": { "post": { "operationId": "admin_action_media_archive", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:444", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdministrativeAction" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Concrete media archive command. Only declared fields are accepted; text uses Unicode limits, excludes NUL, and required text must remain nonempty after trimming. No extra runtime handler is registered. Content Editor/Owner only, with exact displayed revision and atomic publication history/audit.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "Required for refund creation, Finance decisions and other financial commands. Replays retain their stored result; changed payloads return a conflict." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminRevisionActionInput" } } } }, "x-runtime-pattern": "/admin/{kind}/{id}/{action}", "x-admin-action-kind": "media" } }, "/admin/settings/{id}/publish": { "post": { "operationId": "admin_action_settings_publish", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:444", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdministrativeAction" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Concrete settings publish command. Only declared fields are accepted; text uses Unicode limits, excludes NUL, and required text must remain nonempty after trimming. No extra runtime handler is registered. Owner and fresh email verification required. The displayed global release_revision prevents unseen active-policy replacement.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "Required for refund creation, Finance decisions and other financial commands. Replays retain their stored result; changed payloads return a conflict." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminSettingsActionInput" } } } }, "x-runtime-pattern": "/admin/{kind}/{id}/{action}", "x-admin-action-kind": "settings" } }, "/admin/settings/{id}/archive": { "post": { "operationId": "admin_action_settings_archive", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:444", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdministrativeAction" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Concrete settings archive command. Only declared fields are accepted; text uses Unicode limits, excludes NUL, and required text must remain nonempty after trimming. No extra runtime handler is registered. Owner and fresh email verification required. The displayed global release_revision prevents unseen active-policy replacement.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "Required for refund creation, Finance decisions and other financial commands. Replays retain their stored result; changed payloads return a conflict." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminSettingsActionInput" } } } }, "x-runtime-pattern": "/admin/{kind}/{id}/{action}", "x-admin-action-kind": "settings" } }, "/admin/calendar/{id}/approve": { "post": { "operationId": "admin_action_calendar_approve", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:444", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdministrativeAction" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Concrete calendar approve command. Only declared fields are accepted; text uses Unicode limits, excludes NUL, and required text must remain nonempty after trimming. No extra runtime handler is registered. Authors cannot review their own method/calendar revision. Test requires Methods Editor/Owner; review/publication/restoration requires Methods Reviewer/Owner and fresh email verification. Independent expert evidence remains necessary.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "Required for refund creation, Finance decisions and other financial commands. Replays retain their stored result; changed payloads return a conflict." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminCalendarReviewInput" } } } }, "x-runtime-pattern": "/admin/{kind}/{id}/{action}", "x-admin-action-kind": "calendar" } }, "/admin/calendar/{id}/publish": { "post": { "operationId": "admin_action_calendar_publish", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:444", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdministrativeAction" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Concrete calendar publish command. Only declared fields are accepted; text uses Unicode limits, excludes NUL, and required text must remain nonempty after trimming. No extra runtime handler is registered. Authors cannot review their own method/calendar revision. Test requires Methods Editor/Owner; review/publication/restoration requires Methods Reviewer/Owner and fresh email verification. Independent expert evidence remains necessary.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "Required for refund creation, Finance decisions and other financial commands. Replays retain their stored result; changed payloads return a conflict." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminCalendarReleaseInput" } } } }, "x-runtime-pattern": "/admin/{kind}/{id}/{action}", "x-admin-action-kind": "calendar" } }, "/admin/calendar/{id}/retire": { "post": { "operationId": "admin_action_calendar_retire", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:444", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdministrativeAction" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Concrete calendar retire command. Only declared fields are accepted; text uses Unicode limits, excludes NUL, and required text must remain nonempty after trimming. No extra runtime handler is registered. Authors cannot review their own method/calendar revision. Test requires Methods Editor/Owner; review/publication/restoration requires Methods Reviewer/Owner and fresh email verification. Independent expert evidence remains necessary.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "Required for refund creation, Finance decisions and other financial commands. Replays retain their stored result; changed payloads return a conflict." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminCalendarReleaseInput" } } } }, "x-runtime-pattern": "/admin/{kind}/{id}/{action}", "x-admin-action-kind": "calendar" } }, "/admin/calendar/{id}/rollback": { "post": { "operationId": "admin_action_calendar_rollback", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:444", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdministrativeAction" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Concrete calendar rollback command. Only declared fields are accepted; text uses Unicode limits, excludes NUL, and required text must remain nonempty after trimming. No extra runtime handler is registered. Authors cannot review their own method/calendar revision. Test requires Methods Editor/Owner; review/publication/restoration requires Methods Reviewer/Owner and fresh email verification. Independent expert evidence remains necessary.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "Required for refund creation, Finance decisions and other financial commands. Replays retain their stored result; changed payloads return a conflict." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminCalendarReleaseInput" } } } }, "x-runtime-pattern": "/admin/{kind}/{id}/{action}", "x-admin-action-kind": "calendar" } }, "/admin/support/{id}/reply": { "post": { "operationId": "admin_action_support_reply", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:437", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SupportChanged" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminSupportReplyInput" } } } }, "x-runtime-pattern": "/admin/support/{id}/{action}", "x-admin-action-kind": "support", "description": "Concrete support reply command. Only declared fields are accepted; text uses Unicode limits, excludes NUL, and required text must remain nonempty after trimming. No extra runtime handler is registered. Support/Owner only. The displayed revision is required. Current authorization is rechecked under the administrator membership lock before workspace/record mutation. Closed tickets require reopening before reply. Assignment, notes, replies and notification/email/audit effects remain atomic." } }, "/admin/support/{id}/note": { "post": { "operationId": "admin_action_support_note", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:437", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SupportChanged" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminSupportNoteInput" } } } }, "x-runtime-pattern": "/admin/support/{id}/{action}", "x-admin-action-kind": "support", "description": "Concrete support note command. Only declared fields are accepted; text uses Unicode limits, excludes NUL, and required text must remain nonempty after trimming. No extra runtime handler is registered. Support/Owner only. The displayed revision is required. Current authorization is rechecked under the administrator membership lock before workspace/record mutation. Closed tickets require reopening before reply. Assignment, notes, replies and notification/email/audit effects remain atomic." } }, "/admin/support/{id}/assign": { "post": { "operationId": "admin_action_support_assign", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:437", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SupportChanged" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminSupportAssignInput" } } } }, "x-runtime-pattern": "/admin/support/{id}/{action}", "x-admin-action-kind": "support", "description": "Concrete support assign command. Only declared fields are accepted; text uses Unicode limits, excludes NUL, and required text must remain nonempty after trimming. No extra runtime handler is registered. Support/Owner only. The displayed revision is required. Current authorization is rechecked under the administrator membership lock before workspace/record mutation. Closed tickets require reopening before reply. Assignment, notes, replies and notification/email/audit effects remain atomic." } }, "/admin/support/{id}/close": { "post": { "operationId": "admin_action_support_close", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:437", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SupportChanged" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminRevisionActionInput" } } } }, "x-runtime-pattern": "/admin/support/{id}/{action}", "x-admin-action-kind": "support", "description": "Concrete support close command. Only declared fields are accepted; text uses Unicode limits, excludes NUL, and required text must remain nonempty after trimming. No extra runtime handler is registered. Support/Owner only. The displayed revision is required. Current authorization is rechecked under the administrator membership lock before workspace/record mutation. Closed tickets require reopening before reply. Assignment, notes, replies and notification/email/audit effects remain atomic." } }, "/admin/support/{id}/reopen": { "post": { "operationId": "admin_action_support_reopen", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:437", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SupportChanged" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminRevisionActionInput" } } } }, "x-runtime-pattern": "/admin/support/{id}/{action}", "x-admin-action-kind": "support", "description": "Concrete support reopen command. Only declared fields are accepted; text uses Unicode limits, excludes NUL, and required text must remain nonempty after trimming. No extra runtime handler is registered. Support/Owner only. The displayed revision is required. Current authorization is rechecked under the administrator membership lock before workspace/record mutation. Closed tickets require reopening before reply. Assignment, notes, replies and notification/email/audit effects remain atomic." } }, "/admin/templates": { "get": { "operationId": "report_template_get_templates", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:440", "responses": { "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReportTemplatePage" } } } } }, "security": [ { "adminSession": [] } ], "parameters": [ { "name": "cursor", "in": "query", "schema": { "type": "string", "maxLength": 1400 }, "description": "Opaque signed position bound to the caller, collection and selected filters. Empty or omitted starts a new traversal. Refresh the list when changing filters." }, { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "description": "Growing collections: default 100, or 50 for support. Plans/features/wallet return their complete finite catalogs." }, { "name": "q", "in": "query", "schema": { "type": "string", "maxLength": 160 }, "description": "Literal, case-insensitive search across supported summary fields, applied before paging." } ], "x-runtime-pattern": "/admin/{kind}", "description": "Content Editor/Owner only. Supported report kinds and complete section ordering; no arbitrary HTML/code or hidden calculation/source facts. Saved report-kind identity is immutable. Draft \u2192 saved preview \u2192 published \u2192 archived. Publication checks the per-kind release revision and atomically supersedes its previous active template. Each accepted report snapshots the template; later changes do not rewrite it or consume another allowance." }, "post": { "operationId": "report_template_post_templates", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:441", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SavedConfiguration" } } } }, "201": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SavedConfiguration" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Content Editor/Owner only. Supported report kinds and complete section ordering; no arbitrary HTML/code or hidden calculation/source facts. Saved report-kind identity is immutable. Draft \u2192 saved preview \u2192 published \u2192 archived. Publication checks the per-kind release revision and atomically supersedes its previous active template. Each accepted report snapshots the template; later changes do not rewrite it or consume another allowance.", "parameters": [ { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReportTemplateCreate" } } } }, "x-runtime-pattern": "/admin/{kind}" } }, "/admin/templates/{id}": { "put": { "operationId": "report_template_put_id", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:443", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SavedConfiguration" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Content Editor/Owner only. Supported report kinds and complete section ordering; no arbitrary HTML/code or hidden calculation/source facts. Saved report-kind identity is immutable. Draft \u2192 saved preview \u2192 published \u2192 archived. Publication checks the per-kind release revision and atomically supersedes its previous active template. Each accepted report snapshots the template; later changes do not rewrite it or consume another allowance.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReportTemplateEdit" } } } }, "x-runtime-pattern": "/admin/{kind}/{id}" } }, "/admin/templates/{id}/preview": { "post": { "operationId": "report_template_post_preview", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:444", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReportTemplatePreview" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Content Editor/Owner only. Supported report kinds and complete section ordering; no arbitrary HTML/code or hidden calculation/source facts. Saved report-kind identity is immutable. Draft \u2192 saved preview \u2192 published \u2192 archived. Publication checks the per-kind release revision and atomically supersedes its previous active template. Each accepted report snapshots the template; later changes do not rewrite it or consume another allowance.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminRevisionActionInput" } } } }, "x-runtime-pattern": "/admin/{kind}/{id}/{action}" } }, "/admin/templates/{id}/publish": { "post": { "operationId": "report_template_post_publish", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:444", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdministrativeAction" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Content Editor/Owner only. Supported report kinds and complete section ordering; no arbitrary HTML/code or hidden calculation/source facts. Saved report-kind identity is immutable. Draft \u2192 saved preview \u2192 published \u2192 archived. Publication checks the per-kind release revision and atomically supersedes its previous active template. Each accepted report snapshots the template; later changes do not rewrite it or consume another allowance.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReportTemplateRelease" } } } }, "x-runtime-pattern": "/admin/{kind}/{id}/{action}" } }, "/admin/templates/{id}/archive": { "post": { "operationId": "report_template_post_archive", "tags": [ "admin" ], "x-runtime-registration": "app.destinyemperor.com/backend/internal/platform/server.go:444", "responses": { "200": { "description": "Operation completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdministrativeAction" } } } }, "401": { "description": "Session expired or required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error401" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "403": { "description": "Access, CSRF, Origin, or step-up rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error403" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "404": { "description": "Owned record not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error404" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "405": { "description": "Unsupported request method", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error405" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "409": { "description": "Revision, idempotency, or workflow conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error409" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "413": { "description": "Request body exceeds the size limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error413" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "422": { "description": "Invalid input or unsupported date", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error422" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "429": { "description": "Rate limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error429" } } }, "headers": { "Retry-After": { "description": "Seconds before the limiting server window allows another attempt; supplied by platform rate limits.", "schema": { "type": "integer", "minimum": 1 } }, "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "500": { "description": "Unexpected service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error500" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } }, "503": { "description": "Service or publication unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error503" } } }, "headers": { "X-Request-ID": { "description": "Matches error.request_id for this response.", "schema": { "type": "string" } }, "Cache-Control": { "description": "Private failure responses cannot be stored.", "schema": { "const": "no-store", "type": "string" } } } } }, "security": [ { "adminSession": [] } ], "description": "Content Editor/Owner only. Supported report kinds and complete section ordering; no arbitrary HTML/code or hidden calculation/source facts. Saved report-kind identity is immutable. Draft \u2192 saved preview \u2192 published \u2192 archived. Publication checks the per-kind release revision and atomically supersedes its previous active template. Each accepted report snapshots the template; later changes do not rewrite it or consume another allowance.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "UUID for records; a registered identifier for plans, features, and collection kinds." }, { "name": "X-CSRF-Token", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReportTemplateRelease" } } } }, "x-runtime-pattern": "/admin/{kind}/{id}/{action}" } } }, "components": { "securitySchemes": { "session": { "type": "apiKey", "in": "cookie", "name": "__Host-de_app_session" }, "adminSession": { "type": "apiKey", "in": "cookie", "name": "__Host-de_admin_session" }, "internalBearer": { "type": "http", "scheme": "bearer", "description": "Private service credential; never sent by frontends." }, "walletHMAC": { "type": "apiKey", "in": "header", "name": "X-Wallet-Signature", "description": "HMAC-SHA256 of X-Wallet-Timestamp + dot + the raw body; a fresh timestamp and configured provider secret are required." } }, "schemas": { "Error": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "object", "required": [ "code", "message", "request_id", "field_errors" ], "properties": { "code": { "$ref": "#/components/schemas/ErrorCode" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "field_errors": { "type": "object", "additionalProperties": { "type": "string" } } }, "additionalProperties": false } }, "additionalProperties": false }, "Profile": { "type": "object", "required": [ "name", "birth_date", "certainty", "timezone", "calculation_basis", "purpose", "consent" ], "properties": { "id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "birth_date": { "type": "string", "format": "date" }, "birth_time": { "type": "string" }, "timezone": { "type": "string" }, "birthplace": { "type": "string" }, "client_id": { "type": "string" }, "certainty": { "enum": [ "exact", "approximate", "unknown" ] }, "calculation_basis": { "enum": [ "male", "female" ] }, "purpose": { "enum": [ "self", "family", "partner", "client" ] }, "consent": { "type": "boolean" }, "offset_seconds": { "type": "integer", "minimum": -50400, "maximum": 50400 }, "revision": { "type": "integer", "minimum": 1 }, "archived": { "type": "boolean" } } }, "Plan": { "type": "object", "required": [ "id", "name", "version", "monthly_minor", "annual_minor", "profile_limit", "report_limit", "features" ], "properties": { "id": { "enum": [ "free", "seeker", "strategist", "practitioner" ] }, "name": { "type": "string" }, "features": { "type": "array", "items": { "type": "string" } }, "version": { "type": "integer", "minimum": 0 }, "rank": { "type": "integer", "minimum": 0 }, "monthly_minor": { "type": "integer", "minimum": 0 }, "annual_minor": { "type": "integer", "minimum": 0 }, "profile_limit": { "type": "integer", "minimum": 0 }, "report_limit": { "type": "integer", "minimum": 0 } } }, "RevisionEdit": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "additionalProperties": true }, "revision": { "type": "integer", "minimum": 0 }, "version_of": { "type": "string", "format": "uuid", "description": "Immutable source record for a replacement draft. Publication supersedes the prior live version in that lineage." } } }, "OTPRequest": { "type": "object", "required": [ "email" ], "additionalProperties": false, "properties": { "email": { "type": "string", "format": "email" } } }, "OTPVerify": { "type": "object", "required": [ "challenge_id", "code" ], "additionalProperties": false, "properties": { "challenge_id": { "type": "string", "format": "uuid" }, "code": { "type": "string", "pattern": "^[0-9]{6}$" } } }, "EmailLinkVerify": { "type": "object", "required": [ "challenge_id", "token" ], "additionalProperties": false, "properties": { "challenge_id": { "type": "string", "format": "uuid" }, "token": { "type": "string", "pattern": "^[0-9a-f]{64}$" } } }, "OrderRequest": { "type": "object", "required": [ "plan_id", "cadence" ], "additionalProperties": false, "properties": { "plan_id": { "enum": [ "seeker", "strategist", "practitioner" ] }, "cadence": { "enum": [ "monthly", "annual" ] }, "kind": { "enum": [ "purchase", "renewal", "upgrade" ] } } }, "ReportRequest": { "type": "object", "required": [ "profile_id", "kind" ], "additionalProperties": false, "properties": { "profile_id": { "type": "string", "format": "uuid" }, "kind": { "enum": [ "bazi", "ziwei", "business", "annual", "relationships", "date_selection" ] }, "title": { "type": "string", "maxLength": 180 }, "right_profile_id": { "type": "string", "format": "uuid" }, "year": { "type": "integer", "minimum": 1900, "maximum": 2200 }, "selection": { "$ref": "#/components/schemas/DateSelectionRequest" } } }, "DateSelectionRequest": { "type": "object", "required": [ "from", "to", "timezone", "activity", "profile_ids" ], "additionalProperties": false, "properties": { "from": { "type": "string", "format": "date" }, "to": { "type": "string", "format": "date" }, "timezone": { "type": "string" }, "activity": { "enum": [ "business_launch", "contract_signing", "meeting", "wedding", "moving", "travel", "personal_event" ] }, "profile_ids": { "type": "array", "minItems": 1, "maxItems": 5, "uniqueItems": true, "items": { "type": "string", "format": "uuid" } }, "blackouts": { "type": "array", "items": { "type": "string", "format": "date" } }, "exclude_weekends": { "type": "boolean" } } }, "SupportActionRequest": { "oneOf": [ { "$ref": "#/components/schemas/AdminRevisionActionInput" }, { "$ref": "#/components/schemas/AdminSupportReplyInput" }, { "$ref": "#/components/schemas/AdminSupportNoteInput" }, { "$ref": "#/components/schemas/AdminSupportAssignInput" } ] }, "SupportTicket": { "type": "object", "required": [ "id", "revision", "data" ], "properties": { "id": { "type": "string", "format": "uuid" }, "revision": { "type": "integer" }, "created_at": { "type": "string", "format": "date-time" }, "data": { "type": "object", "properties": { "title": { "type": "string" }, "category": { "enum": [ "General", "Calculations", "Billing", "Privacy" ] }, "status": { "enum": [ "open", "answered", "closed" ] }, "messages": { "type": "array", "items": { "type": "object", "properties": { "author": { "type": "string" }, "body": { "type": "string" }, "at": { "type": "string", "format": "date-time" } } } } } } } }, "RecordID": { "type": "object", "required": [ "id" ], "properties": { "id": { "type": "string", "format": "uuid" } } }, "PurchaseQuote": { "type": "object", "required": [ "id", "amount_minor", "plan", "cadence", "kind" ], "properties": { "id": { "type": "string", "format": "uuid" }, "amount_minor": { "type": "integer", "minimum": 0 }, "plan": { "$ref": "#/components/schemas/Plan" }, "cadence": { "enum": [ "monthly", "annual" ] }, "kind": { "enum": [ "purchase", "renewal", "upgrade" ] } } }, "WalletAsset": { "type": "object", "required": [ "id", "symbol", "network", "token_identity", "decimals", "minimum_atomic", "confirmations", "available", "enabled" ], "properties": { "id": { "type": "string" }, "symbol": { "type": "string" }, "network": { "type": "string" }, "token_identity": { "type": "string" }, "decimals": { "type": "integer", "minimum": 0, "maximum": 30 }, "minimum_atomic": { "type": "string", "pattern": "^[0-9]+$" }, "confirmations": { "type": "integer", "minimum": 0 }, "available": { "type": "boolean", "description": "Provider availability; unavailable assets never enter checkout." }, "enabled": { "type": "boolean", "description": "Merchant enablement; new live assets default to disabled." } } }, "WalletInvoice": { "type": "object", "required": [ "id", "merchant_reference", "quote_id", "usd_amount_minor", "asset_id", "network", "amount_atomic", "decimals", "received_atomic", "destination", "status", "revision", "expires_at", "final", "simulation" ], "properties": { "id": { "type": "string" }, "merchant_reference": { "type": "string" }, "quote_id": { "type": "string" }, "asset_id": { "type": "string" }, "network": { "type": "string" }, "destination": { "type": "string" }, "amount_atomic": { "type": "string", "pattern": "^[0-9]+$" }, "received_atomic": { "type": "string", "pattern": "^[0-9]+$" }, "usd_amount_minor": { "type": "integer", "minimum": 0 }, "decimals": { "type": "integer", "minimum": 0, "maximum": 30 }, "status": { "enum": [ "awaiting_payment", "confirming", "paid", "underpaid", "overpaid", "expired", "failed", "refund_pending", "refunded", "reversed" ] }, "revision": { "type": "integer", "minimum": 0 }, "expires_at": { "type": "string", "format": "date-time" }, "observed_at": { "type": "string", "format": "date-time" }, "final": { "type": "boolean" }, "simulation": { "type": "boolean" }, "transaction_hashes": { "type": "array", "items": { "type": "string" } } } }, "InvoiceCreated": { "type": "object", "required": [ "id", "invoice" ], "properties": { "id": { "type": "string", "format": "uuid" }, "invoice": { "$ref": "#/components/schemas/WalletInvoice" } } }, "InvoiceDetail": { "allOf": [ { "$ref": "#/components/schemas/InvoiceCreated" }, { "type": "object", "required": [ "order_id", "order_status", "provider_refreshed", "simulation" ], "properties": { "order_id": { "type": "string", "format": "uuid" }, "order_status": { "type": "string", "description": "Local access fulfillment state, including payment_review for stale/conflicting purchases." }, "provider_refreshed": { "type": "boolean" }, "simulation": { "type": "boolean" } } } ] }, "PurchaseHistory": { "type": "object", "required": [ "items", "next_cursor" ], "properties": { "next_cursor": { "type": "string", "maxLength": 1400, "description": "Opaque signed cursor bound to the workspace and collection, or empty when no further page exists." }, "items": { "type": "array", "items": { "type": "object", "required": [ "id", "plan", "amount_minor", "status", "created_at", "invoices" ], "properties": { "id": { "type": "string", "format": "uuid" }, "plan": { "$ref": "#/components/schemas/Plan" }, "plan_id": { "type": "string" }, "cadence": { "enum": [ "monthly", "annual" ] }, "kind": { "enum": [ "purchase", "renewal", "upgrade" ] }, "amount_minor": { "type": "integer" }, "status": { "type": "string" }, "created_at": { "type": "string", "format": "date-time" }, "invoices": { "type": "array", "items": { "type": "object", "required": [ "id", "status", "data" ], "properties": { "id": { "type": "string", "format": "uuid" }, "status": { "type": "string" }, "data": { "$ref": "#/components/schemas/WalletInvoice" } } } } } } } } }, "WalletCapabilities": { "type": "object", "required": [ "assets", "simulation", "live" ], "properties": { "assets": { "type": "array", "items": { "$ref": "#/components/schemas/WalletAsset" } }, "simulation": { "type": "boolean" }, "live": { "type": "boolean" } } }, "RefundRequest": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "required": [ "invoice_id", "destination", "reason" ], "properties": { "invoice_id": { "type": "string", "format": "uuid" }, "destination": { "type": "string", "minLength": 10, "maxLength": 256 }, "reason": { "type": "string", "minLength": 1, "maxLength": 2000 } } } } }, "RefundDecision": { "oneOf": [ { "$ref": "#/components/schemas/AdminRefundApproveInput" }, { "$ref": "#/components/schemas/AdminRefundDeclineInput" } ] }, "AccountAccessRequest": { "oneOf": [ { "$ref": "#/components/schemas/AdminRoleActionInput" }, { "$ref": "#/components/schemas/AdminSuspendActionInput" }, { "$ref": "#/components/schemas/AdminRevisionActionInput" } ] }, "AdministratorAccount": { "type": "object", "required": [ "id", "email", "status", "roles", "administrator_active", "administrator_verified", "revision" ], "properties": { "id": { "type": "string", "format": "uuid" }, "email": { "type": "string", "format": "email" }, "status": { "enum": [ "active", "suspended", "deleted" ] }, "roles": { "type": "array", "items": { "type": "string" } }, "administrator_active": { "type": "boolean" }, "administrator_verified": { "type": "boolean", "description": "The administrator completed an email OTP login." }, "revision": { "type": "integer", "minimum": 1 }, "created_at": { "type": "string", "format": "date-time" } } }, "RuleCondition": { "oneOf": [ { "type": "object", "additionalProperties": false, "required": [ "fact", "equals" ], "properties": { "fact": { "const": "time_known" }, "equals": { "type": "boolean" } } }, { "type": "object", "additionalProperties": false, "required": [ "fact", "equals" ], "properties": { "fact": { "const": "day_master_element" }, "equals": { "enum": [ "Wood", "Fire", "Earth", "Metal", "Water" ] } } }, { "type": "object", "additionalProperties": false, "required": [ "fact", "equals" ], "properties": { "fact": { "const": "day_branch" }, "equals": { "enum": [ "Rat", "Ox", "Tiger", "Rabbit", "Dragon", "Snake", "Horse", "Goat", "Monkey", "Rooster", "Dog", "Pig" ] } } } ] }, "PublicationCommand": { "oneOf": [ { "$ref": "#/components/schemas/AdminRevisionActionInput" }, { "$ref": "#/components/schemas/AdminIndependentReviewInput" } ] }, "CMSDraft": { "type": "object", "required": [ "slug", "title", "kind", "content", "revision" ], "additionalProperties": false, "properties": { "slug": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$", "maxLength": 180 }, "title": { "type": "string", "maxLength": 240, "minLength": 1 }, "kind": { "enum": [ "page", "article" ] }, "revision": { "type": "integer", "minimum": 0, "maximum": 2147483646 }, "content": { "$ref": "#/components/schemas/CMSContent" } } }, "CMSCommand": { "type": "object", "required": [ "revision", "state_revision" ], "additionalProperties": false, "properties": { "revision": { "type": "integer", "minimum": 1, "maximum": 2147483646 }, "state_revision": { "type": "integer", "minimum": 1, "maximum": 2147483646 } } }, "Pillar": { "type": "object", "required": [ "label", "glyph", "stem", "branch", "stem_element", "branch_element", "polarity", "ten_god" ], "properties": { "label": { "type": "string" }, "glyph": { "type": "string" }, "stem": { "type": "string" }, "branch": { "type": "string" }, "stem_element": { "type": "string" }, "branch_element": { "type": "string" }, "polarity": { "type": "string" }, "ten_god": { "type": "string" }, "hidden_stems": { "type": [ "array", "null" ], "items": { "type": "string" } } } }, "ZiWeiStar": { "type": "object", "required": [ "name", "code", "type", "brightness" ], "properties": { "name": { "type": "string" }, "code": { "type": "string" }, "type": { "enum": [ "major", "auxiliary", "supporting" ] }, "brightness": { "type": "string" }, "brightness_code": { "type": "string" }, "transformation": { "enum": [ "Prosperity", "Authority", "Recognition", "Challenge" ] } } }, "ZiWeiPalace": { "type": "object", "required": [ "index", "name", "branch", "stem", "body", "stars", "decade" ], "properties": { "index": { "type": "integer", "minimum": 0, "maximum": 11 }, "name": { "type": "string" }, "branch": { "type": "string" }, "stem": { "type": "string" }, "body": { "type": "boolean" }, "stars": { "type": "array", "items": { "$ref": "#/components/schemas/ZiWeiStar" } }, "decade": { "type": "array", "minItems": 2, "maxItems": 2, "items": { "type": "integer" } } } }, "ZiWeiTraditionVariant": { "type": "object", "required": [ "name", "explanation", "source_url", "result" ], "properties": { "name": { "type": "string" }, "explanation": { "type": "string" }, "source_url": { "type": "string" }, "result": { "type": "object", "properties": { "palaces": { "type": "array", "minItems": 12, "maxItems": 12, "items": { "$ref": "#/components/schemas/ZiWeiPalace" } }, "effective_month": { "type": "integer" }, "life_index": { "type": "integer" }, "body_index": { "type": "integer" }, "bureau": { "type": "integer" }, "star": { "type": "string" }, "transformation": { "type": "string" }, "fire_branch": { "type": "string" }, "bell_branch": { "type": "string" }, "kui_branch": { "type": "string" }, "yue_branch": { "type": "string" } } } } }, "ZiWeiChart": { "type": "object", "required": [ "palaces", "soul_index", "body_index", "bureau", "bureau_element", "method", "engine_version", "supported_stars", "review_status" ], "properties": { "tradition_variants": { "type": "array", "maxItems": 4, "items": { "$ref": "#/components/schemas/ZiWeiTraditionVariant" } }, "calculation_identity": { "type": "object", "additionalProperties": true }, "palaces": { "type": "array", "minItems": 12, "maxItems": 12, "items": { "$ref": "#/components/schemas/ZiWeiPalace" } }, "soul_index": { "type": "integer", "minimum": 0, "maximum": 11 }, "body_index": { "type": "integer", "minimum": 0, "maximum": 11 }, "bureau": { "type": "integer", "minimum": 2, "maximum": 6 }, "lunar_year": { "type": "integer" }, "lunar_month": { "type": "integer" }, "calendar_lunar_month": { "type": "integer" }, "lunar_day": { "type": "integer" }, "bureau_element": { "type": "string" }, "method": { "type": "string" }, "engine_version": { "type": "string" }, "calendar_version": { "type": "string" }, "timezone_database": { "type": "string" }, "review_status": { "type": "string" }, "birth_time_certainty": { "enum": [ "exact", "approximate", "sensitivity_sample" ] }, "supported_stars": { "type": "integer" }, "warnings": { "type": "array", "items": { "type": "string" } }, "boundary_alternatives": { "type": "array", "maxItems": 2, "items": { "type": "object", "required": [ "basis", "chart" ], "properties": { "basis": { "type": "string", "description": "Illustrative one-hour sensitivity; not the actual uncertainty range." }, "chart": { "$ref": "#/components/schemas/ZiWeiChart" } } } }, "annual": { "type": "object", "required": [ "year", "branch", "transformations" ], "properties": { "year": { "type": "integer" }, "branch": { "type": "string" }, "nominal_age": { "type": "integer" }, "transformations": { "type": "array", "items": { "type": "object", "required": [ "star", "transformation" ], "properties": { "star": { "type": "string" }, "transformation": { "type": "string" } } } } } } } }, "BaZiChart": { "type": "object", "required": [ "pillars", "day_master", "elements", "complete", "warnings", "method", "engine_version", "review_status" ], "properties": { "pillars": { "type": "array", "minItems": 3, "maxItems": 4, "items": { "$ref": "#/components/schemas/Pillar" } }, "day_master": { "$ref": "#/components/schemas/Pillar" }, "elements": { "type": "object", "additionalProperties": { "type": "integer", "minimum": 0 } }, "complete": { "type": "boolean" }, "warnings": { "type": "array", "items": { "type": "string" } }, "method": { "type": "string" }, "engine_version": { "type": "string" }, "timezone_database": { "type": "string" }, "review_status": { "type": "string" }, "element_note": { "type": "string" }, "industries": { "type": "array", "items": { "type": "string" } }, "interpretation": { "type": "string" }, "profile": { "$ref": "#/components/schemas/Profile" }, "boundary_alternatives": { "type": "array", "items": { "type": "object" } }, "luck_cycles": { "type": "array", "items": { "type": "object" } }, "interactions": { "type": "array", "items": { "type": "object" } }, "matched_rules": { "type": "array", "items": { "type": "object" } }, "hour_boundary_note": { "type": "string" }, "calculation_identity": { "$ref": "#/components/schemas/CalculationIdentity" }, "solar_basis": { "type": "array", "items": { "$ref": "#/components/schemas/BaZiSolarBasis" } }, "luck_basis": { "$ref": "#/components/schemas/BaZiLuckBasis" }, "luck_forward": { "type": "boolean" }, "luck_start": { "type": "string", "description": "Civil display in the documented luck_basis.display_timezone; start_at supplies the UTC instant." } } }, "CalculationIdentity": { "type": "object", "required": [ "engine_version", "convention_version", "astronomy_version", "time_model", "solar_ledger_sha256", "timezone_database" ], "properties": { "engine_version": { "type": "string" }, "convention_version": { "type": "string" }, "astronomy_version": { "type": "string" }, "time_model": { "type": "string" }, "solar_ledger_sha256": { "type": "string" }, "timezone_database": { "type": "string" } } }, "AstronomicalTerm": { "type": "object", "required": [ "longitude_degrees", "jd_tdb", "civil_estimate" ], "properties": { "longitude_degrees": { "type": "integer", "minimum": 0, "maximum": 345, "multipleOf": 15 }, "jd_tdb": { "type": "number" }, "civil_estimate": { "type": "object", "required": [ "at", "basis", "estimated", "tt_offset_seconds" ], "properties": { "at": { "type": "string", "format": "date-time" }, "basis": { "type": "string" }, "estimated": { "type": "boolean" }, "tt_offset_seconds": { "type": "number" } } } } }, "BaZiSolarBasis": { "type": "object", "required": [ "year_boundary", "month_boundary" ], "properties": { "year_boundary": { "$ref": "#/components/schemas/AstronomicalTerm" }, "month_boundary": { "$ref": "#/components/schemas/AstronomicalTerm" } } }, "BaZiLuckBasis": { "type": "object", "required": [ "version", "forward", "boundary", "interval_minutes", "years", "months", "days", "hours", "start_at", "display_timezone", "note" ], "properties": { "version": { "type": "string" }, "forward": { "type": "boolean" }, "boundary": { "$ref": "#/components/schemas/AstronomicalTerm" }, "interval_minutes": { "type": "integer", "minimum": 0 }, "years": { "type": "integer", "minimum": 0 }, "months": { "type": "integer", "minimum": 0 }, "days": { "type": "integer", "minimum": 0 }, "hours": { "type": "integer", "minimum": 0 }, "start_at": { "type": "string", "format": "date-time" }, "display_timezone": { "type": "string" }, "note": { "type": "string" } } }, "SharePreview": { "type": "object", "required": [ "title", "kind", "result", "created_at", "redacted" ], "properties": { "title": { "type": "string" }, "kind": { "type": "string" }, "result": { "type": "object", "description": "Calculation facts with birth input, names, private objects and nested sensitivity birth fields removed. Same payload as the public share." }, "created_at": { "type": "string", "format": "date-time" }, "redacted": { "const": true } } }, "Cursor": { "type": "string", "maxLength": 1400, "description": "Opaque signed immutable position. Bound to the caller, collection and filters; never an authorization grant. Empty marks the final page. Newer records appear after a refresh." }, "PaginatedRecords": { "type": "object", "required": [ "items", "next_cursor" ], "properties": { "items": { "type": "array", "items": { "type": "object", "additionalProperties": true } }, "next_cursor": { "$ref": "#/components/schemas/Cursor" }, "registered_methods": { "type": "object", "description": "Present on administrative calculation-method pages. Supplies deployed versions and sources for new drafts.", "additionalProperties": { "$ref": "#/components/schemas/RegisteredMethod" } } } }, "RegisteredMethod": { "type": "object", "required": [ "engine_version", "source", "source_url" ], "properties": { "engine_version": { "type": "string" }, "source": { "type": "string" }, "source_url": { "type": "string" } } }, "ResourceRecord": { "type": "object", "required": [ "id", "data", "revision", "created_at" ], "properties": { "id": { "type": "string", "format": "uuid" }, "data": { "type": "object", "additionalProperties": true }, "revision": { "type": "integer", "minimum": 1 }, "created_at": { "type": "string", "format": "date-time" } } }, "ResourceList": { "type": "object", "required": [ "items", "next_cursor" ], "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/ResourceRecord" } }, "next_cursor": { "$ref": "#/components/schemas/Cursor" }, "registered_methods": { "type": "object", "description": "Present on administrative calculation-method pages. Supplies deployed versions and sources for new drafts.", "additionalProperties": { "$ref": "#/components/schemas/RegisteredMethod" } } } }, "AccessPeriod": { "type": "object", "required": [ "id", "plan_id", "starts_at", "ends_at", "cadence", "status" ], "properties": { "id": { "type": "string", "format": "uuid" }, "plan_id": { "type": "string" }, "starts_at": { "type": "string", "format": "date-time" }, "ends_at": { "type": "string", "format": "date-time" }, "cadence": { "enum": [ "monthly", "annual" ] }, "status": { "type": "string" } } }, "SubscriptionStatus": { "type": "object", "required": [ "plan", "current_period", "periods", "periods_next_cursor", "usage", "wallet_live", "simulation" ], "properties": { "plan": { "$ref": "#/components/schemas/Plan" }, "current_period": { "oneOf": [ { "$ref": "#/components/schemas/AccessPeriod" }, { "type": "null" } ] }, "periods": { "type": "array", "items": { "$ref": "#/components/schemas/AccessPeriod" } }, "periods_next_cursor": { "$ref": "#/components/schemas/Cursor" }, "usage": { "type": "object", "required": [ "consumed", "reserved", "limit", "window_start", "next_reset" ], "properties": { "consumed": { "type": "integer", "minimum": 0 }, "reserved": { "type": "integer", "minimum": 0 }, "limit": { "type": "integer", "minimum": 0 }, "window_start": { "type": "string", "format": "date-time" }, "next_reset": { "type": "string", "format": "date-time" } } }, "wallet_live": { "type": "boolean" }, "simulation": { "type": "boolean" } } }, "ContentSummary": { "type": "object", "required": [ "id", "slug", "title", "kind", "revision", "content", "created_at", "updated_at" ], "properties": { "id": { "type": "string", "format": "uuid" }, "slug": { "type": "string" }, "title": { "type": "string" }, "kind": { "enum": [ "page", "article" ] }, "revision": { "type": "integer", "minimum": 1 }, "created_at": { "type": "string", "format": "date-time" }, "updated_at": { "type": "string", "format": "date-time" }, "content": { "type": "object", "additionalProperties": false, "properties": { "lead": { "type": "string" }, "category": { "type": "string" }, "seo_description": { "type": "string" }, "hero_image": { "type": "string" } } } } }, "CMSSummary": { "type": "object", "required": [ "id", "slug", "title", "kind", "revision", "content", "created_at", "updated_at", "status", "state_revision", "latest_revision" ], "properties": { "id": { "type": "string", "format": "uuid" }, "slug": { "type": "string" }, "title": { "type": "string" }, "kind": { "enum": [ "page", "article" ] }, "revision": { "type": "integer", "minimum": 1 }, "created_at": { "type": "string", "format": "date-time" }, "updated_at": { "type": "string", "format": "date-time" }, "content": { "type": "object", "additionalProperties": false, "properties": { "lead": { "type": "string" }, "category": { "type": "string" }, "seo_description": { "type": "string" }, "hero_image": { "type": "string" } } }, "status": { "enum": [ "draft", "preview", "published", "archived" ] }, "state_revision": { "type": "integer", "minimum": 1 }, "latest_revision": { "type": "integer", "minimum": 1 } } }, "CMSRevision": { "type": "object", "required": [ "id", "slug", "title", "kind", "revision", "content", "created_at", "updated_at", "status", "state_revision", "latest_revision" ], "properties": { "id": { "type": "string", "format": "uuid" }, "slug": { "type": "string" }, "title": { "type": "string" }, "kind": { "enum": [ "page", "article" ] }, "revision": { "type": "integer", "minimum": 1 }, "created_at": { "type": "string", "format": "date-time" }, "updated_at": { "type": "string", "format": "date-time" }, "content": { "$ref": "#/components/schemas/CMSContent" }, "status": { "enum": [ "draft", "preview", "published", "archived" ] }, "state_revision": { "type": "integer", "minimum": 1 }, "latest_revision": { "type": "integer", "minimum": 1 } } }, "PublishedRevision": { "type": "object", "required": [ "id", "slug", "title", "kind", "content", "revision" ], "properties": { "id": { "type": "string", "format": "uuid" }, "slug": { "type": "string" }, "title": { "type": "string" }, "kind": { "enum": [ "page", "article" ] }, "revision": { "type": "integer", "minimum": 1 }, "content": { "$ref": "#/components/schemas/CMSContent" } } }, "SitemapMetadata": { "type": "object", "required": [ "id", "slug", "kind", "created_at", "updated_at" ], "additionalProperties": false, "properties": { "id": { "type": "string", "format": "uuid" }, "slug": { "type": "string" }, "kind": { "enum": [ "page", "article" ] }, "created_at": { "type": "string", "format": "date-time" }, "updated_at": { "type": "string", "format": "date-time" } } }, "ContentSummaryList": { "type": "object", "required": [ "items", "next_cursor" ], "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/ContentSummary" } }, "next_cursor": { "$ref": "#/components/schemas/Cursor" } } }, "CMSContentList": { "type": "object", "required": [ "items", "next_cursor" ], "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/CMSSummary" } }, "next_cursor": { "$ref": "#/components/schemas/Cursor" } } }, "SitemapMetadataList": { "type": "object", "required": [ "items", "next_cursor" ], "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/SitemapMetadata" } }, "next_cursor": { "$ref": "#/components/schemas/Cursor" } } }, "MediaRecord": { "type": "object", "required": [ "id", "data", "status", "revision", "created_at" ], "properties": { "id": { "type": "string", "format": "uuid" }, "status": { "enum": [ "draft", "published", "archived" ] }, "revision": { "type": "integer", "minimum": 1 }, "created_at": { "type": "string", "format": "date-time" }, "data": { "type": "object", "required": [ "name", "mime", "bytes", "width", "height" ], "additionalProperties": false, "properties": { "name": { "type": "string" }, "mime": { "enum": [ "image/png", "image/jpeg" ] }, "bytes": { "type": "integer", "minimum": 1 }, "width": { "type": "integer", "minimum": 1 }, "height": { "type": "integer", "minimum": 1 } } } } }, "MediaList": { "type": "object", "required": [ "items", "next_cursor" ], "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/MediaRecord" } }, "next_cursor": { "$ref": "#/components/schemas/Cursor" } } }, "Actor": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "email": { "type": "string", "format": "email" }, "workspace_id": { "type": "string", "format": "uuid" }, "timezone": { "type": "string" }, "roles": { "type": "array", "items": { "type": "string" } } }, "required": [ "id", "email", "workspace_id", "timezone", "roles" ] }, "NavigationEntry": { "type": "object", "properties": { "path": { "type": "string" }, "label": { "type": "string" }, "order": { "type": "integer" }, "visible": { "type": "boolean" }, "application": { "type": "string" }, "name": { "type": "string" } }, "required": [ "path", "label", "order", "visible" ] }, "CurrentAccount": { "type": "object", "properties": { "user": { "$ref": "#/components/schemas/Actor" }, "plan": { "$ref": "#/components/schemas/Plan" }, "navigation": { "type": "array", "items": { "$ref": "#/components/schemas/NavigationEntry" } }, "environment": { "type": "string" }, "wallet_live": { "type": "boolean" } }, "required": [ "user", "plan", "navigation", "environment", "wallet_live" ] }, "PlanCatalog": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/Plan" } }, "currency": { "const": "USD" } }, "required": [ "items", "currency" ] }, "ChallengeIssued": { "type": "object", "properties": { "challenge_id": { "type": "string", "format": "uuid" }, "message": { "type": "string" }, "expires_in": { "type": "integer", "minimum": 1 }, "resend_after": { "type": "integer", "minimum": 1 } }, "required": [ "challenge_id", "message", "expires_in", "resend_after" ] }, "LoginVerified": { "type": "object", "properties": { "authenticated": { "type": "boolean" }, "created_account": { "type": "boolean" } }, "required": [ "authenticated", "created_account" ] }, "StepUpVerified": { "type": "object", "properties": { "verified": { "type": "boolean" } }, "required": [ "verified" ] }, "EmailChanged": { "type": "object", "properties": { "changed": { "type": "boolean" } }, "required": [ "changed" ] }, "SignedOut": { "type": "object", "properties": { "signed_out": { "type": "boolean" } }, "required": [ "signed_out" ] }, "DeletedRecord": { "type": "object", "properties": { "deleted": { "type": "boolean" } }, "required": [ "deleted" ] }, "RevokedRecord": { "type": "object", "properties": { "revoked": { "type": "boolean" } }, "required": [ "revoked" ] }, "VisitRecorded": { "type": "object", "properties": { "recorded": { "type": "boolean" } }, "required": [ "recorded" ] }, "ProfileInput": { "type": "object", "required": [ "name", "birth_date", "certainty", "timezone", "calculation_basis", "purpose" ], "properties": { "id": { "type": "string", "format": "uuid" }, "name": { "type": "string", "minLength": 1, "maxLength": 120 }, "birth_date": { "type": "string", "format": "date" }, "birth_time": { "type": "string" }, "timezone": { "type": "string" }, "birthplace": { "type": "string", "maxLength": 200 }, "client_id": { "type": "string" }, "certainty": { "enum": [ "exact", "approximate", "unknown" ] }, "calculation_basis": { "enum": [ "male", "female" ] }, "purpose": { "enum": [ "self", "family", "partner", "client" ] }, "consent": { "type": "boolean" }, "offset_seconds": { "type": [ "integer", "null" ], "minimum": -50400, "maximum": 50400 }, "revision": { "type": "integer", "minimum": 0 }, "archived": { "type": "boolean" } }, "additionalProperties": false, "allOf": [ { "if": { "properties": { "purpose": { "enum": [ "family", "partner", "client" ] } }, "required": [ "purpose" ] }, "then": { "required": [ "consent" ], "properties": { "consent": { "const": true } } } } ] }, "SavedProfile": { "type": "object", "required": [ "id", "name", "birth_date", "birth_time", "certainty", "timezone", "birthplace", "calculation_basis", "purpose", "consent", "revision", "read_only" ], "properties": { "id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "birth_date": { "type": "string", "format": "date" }, "birth_time": { "type": "string" }, "timezone": { "type": "string" }, "birthplace": { "type": "string" }, "client_id": { "type": "string" }, "certainty": { "enum": [ "exact", "approximate", "unknown" ] }, "calculation_basis": { "enum": [ "male", "female" ] }, "purpose": { "enum": [ "self", "family", "partner", "client" ] }, "consent": { "type": "boolean" }, "offset_seconds": { "type": "integer", "minimum": -50400, "maximum": 50400 }, "revision": { "type": "integer", "minimum": 1 }, "archived": { "type": "boolean" }, "read_only": { "type": "boolean" } } }, "ProfileCollection": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/SavedProfile" } }, "limit": { "type": "integer", "minimum": 1 } }, "required": [ "items", "limit" ] }, "SessionRecord": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "audience": { "enum": [ "app", "admin" ] }, "created_at": { "type": "string", "format": "date-time" }, "last_seen_at": { "type": "string", "format": "date-time" }, "expires_at": { "type": "string", "format": "date-time" }, "current": { "type": "boolean" } }, "required": [ "id", "audience", "created_at", "last_seen_at", "expires_at", "current" ] }, "SessionCollection": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/SessionRecord" } } }, "required": [ "items" ] }, "EmailPreferences": { "type": "object", "properties": { "reminder_email": { "type": "boolean" }, "support_reply_email": { "type": "boolean" } }, "required": [], "additionalProperties": false }, "ReportBranding": { "type": "object", "properties": { "name": { "type": "string", "maxLength": 120 } }, "required": [], "additionalProperties": false }, "SettingsEdit": { "type": "object", "properties": { "timezone": { "type": "string" }, "branding": { "oneOf": [ { "$ref": "#/components/schemas/ReportBranding" }, { "type": "null" } ] }, "preferences": { "oneOf": [ { "$ref": "#/components/schemas/EmailPreferences" }, { "type": "null" } ] } }, "required": [ "timezone" ], "additionalProperties": false }, "AccountSettings": { "type": "object", "properties": { "timezone": { "type": "string" }, "email": { "type": "string", "format": "email" }, "branding": { "$ref": "#/components/schemas/ReportBranding" }, "preferences": { "$ref": "#/components/schemas/EmailPreferences" } }, "required": [ "timezone", "email", "branding", "preferences" ] }, "AccountDeleted": { "type": "object", "properties": { "status": { "const": "deleted" }, "message": { "type": "string" } }, "required": [ "status", "message" ] }, "ReportStatus": { "enum": [ "queued", "running", "ready", "failed", "cancelled" ] }, "ReportSummary": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "title": { "type": "string" }, "kind": { "type": "string" }, "status": { "$ref": "#/components/schemas/ReportStatus" }, "created_at": { "type": "string", "format": "date-time" }, "error": { "type": "string" } }, "required": [ "id", "title", "kind", "status", "created_at", "error" ] }, "ReportCollection": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/ReportSummary" } }, "next_cursor": { "$ref": "#/components/schemas/Cursor" } }, "required": [ "items", "next_cursor" ] }, "ReportAccepted": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "status": { "const": "queued" } }, "required": [ "id", "status" ] }, "ReportDetail": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "title": { "type": "string" }, "kind": { "type": "string" }, "status": { "$ref": "#/components/schemas/ReportStatus" }, "snapshot": { "type": "object", "properties": {}, "required": [], "additionalProperties": true }, "result": { "type": "object", "properties": {}, "required": [], "additionalProperties": true } }, "required": [ "id", "title", "kind", "status", "snapshot", "result" ] }, "ReportCancelled": { "type": "object", "properties": { "status": { "const": "cancelled" } }, "required": [ "status" ] }, "ShareCreated": { "type": "object", "properties": { "token": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "expires_at": { "type": "string", "format": "date-time" }, "redacted": { "const": true } }, "required": [ "token", "expires_at", "redacted" ] }, "AttachmentMetadata": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "mime": { "enum": [ "application/pdf", "image/png", "image/jpeg" ] }, "bytes": { "type": "integer", "minimum": 1 } }, "required": [ "id", "name", "mime", "bytes" ] }, "AttachmentCollection": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/AttachmentMetadata" } } }, "required": [ "items" ] }, "MediaUploaded": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "revision": { "type": "integer", "minimum": 1 }, "status": { "const": "draft" } }, "required": [ "id", "revision", "status" ] }, "ContactRequest": { "type": "object", "properties": { "email": { "type": "string", "format": "email", "maxLength": 254 }, "title": { "type": "string", "minLength": 1, "maxLength": 160 }, "message": { "type": "string", "minLength": 1, "maxLength": 8000 } }, "required": [ "email", "title", "message" ], "additionalProperties": false }, "ContactAccepted": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "status": { "const": "received" } }, "required": [ "id", "status" ] }, "NavigationCollection": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/NavigationEntry" } } }, "required": [ "items" ] }, "LunarConversion": { "type": "object", "properties": { "gregorian_date": { "type": "string", "format": "date" }, "lunar_year": { "type": "integer" }, "lunar_month": { "type": "integer" }, "lunar_day": { "type": "integer" }, "leap_month": { "type": "boolean" }, "calendar_basis": { "type": "string" }, "coverage_status": { "type": "string" }, "engine_version": { "type": "string" }, "reference_gregorian_date": { "type": "string", "format": "date" }, "reference_note": { "type": "string" } }, "required": [ "gregorian_date", "lunar_year", "lunar_month", "lunar_day", "leap_month", "calendar_basis", "coverage_status", "engine_version" ] }, "Activity": { "type": "object", "properties": { "name": { "type": "string" }, "code": { "type": "string" } }, "required": [ "name", "code" ] }, "CivilInterval": { "type": "object", "properties": { "from": { "type": "string", "format": "date-time" }, "to": { "type": "string", "format": "date-time" } }, "required": [ "from", "to" ] }, "AlmanacDeity": { "type": "object", "properties": { "index": { "type": "integer", "minimum": 0, "maximum": 11 }, "name": { "type": "string" }, "glyph": { "type": "string" }, "favorable": { "type": "boolean" } }, "required": [ "index", "name", "glyph", "favorable" ] }, "AlmanacSource": { "type": "object", "properties": { "work": { "type": "string" }, "volume": { "type": "integer" }, "url": { "type": "string", "format": "uri" }, "paragraph_sha256": { "type": "string" }, "paragraph_index": { "type": "integer" } }, "required": [ "work", "volume", "url", "paragraph_sha256", "paragraph_index" ] }, "AlmanacAppliedRule": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "favorable": { "type": "array", "items": { "$ref": "#/components/schemas/Activity" } }, "caution": { "type": "array", "items": { "$ref": "#/components/schemas/Activity" } }, "neutral": { "type": "array", "items": { "$ref": "#/components/schemas/Activity" } }, "explanations": { "type": "array", "items": { "type": "string" } }, "source": { "$ref": "#/components/schemas/AlmanacSource" } }, "required": [ "id", "name", "favorable", "caution", "neutral", "explanations", "source" ] }, "AlmanacOutcome": { "type": "object", "properties": { "favorable": { "type": "array", "items": { "$ref": "#/components/schemas/Activity" } }, "caution": { "type": "array", "items": { "$ref": "#/components/schemas/Activity" } }, "neutral": { "type": "array", "items": { "$ref": "#/components/schemas/Activity" } }, "rules": { "type": "array", "items": { "$ref": "#/components/schemas/AlmanacAppliedRule" } }, "method_version": { "type": "string" }, "review_status": { "type": "string" } }, "required": [ "favorable", "caution", "neutral", "rules", "method_version", "review_status" ] }, "AlmanacSegment": { "type": "object", "properties": { "from": { "type": "string", "format": "date-time" }, "to": { "type": "string", "format": "date-time" }, "officer": { "type": "string" }, "day_deity": { "$ref": "#/components/schemas/AlmanacDeity" }, "outcome": { "$ref": "#/components/schemas/AlmanacOutcome" } }, "required": [ "from", "to", "officer", "day_deity", "outcome" ] }, "TraditionalHour": { "type": "object", "properties": { "start": { "type": "string" }, "end": { "type": "string" }, "branch": { "type": "string" }, "favorable": { "type": "boolean" }, "pillar": { "$ref": "#/components/schemas/Pillar" }, "almanac_version": { "type": "string" }, "available": { "type": "boolean" }, "intervals": { "type": "array", "items": { "$ref": "#/components/schemas/CivilInterval" } }, "deity": { "$ref": "#/components/schemas/AlmanacDeity" }, "total_minutes": { "type": "number" } }, "required": [ "start", "end", "branch", "favorable", "pillar" ] }, "PersonalDay": { "type": "object", "properties": { "classification": { "enum": [ "Favorable", "Neutral", "Use Caution" ] }, "reasons": { "type": "array", "items": { "type": "string" } } }, "required": [ "classification", "reasons" ] }, "SolarTerm": { "type": "object", "properties": { "name": { "type": "string" }, "at": { "type": "string", "format": "date-time" }, "local_time": { "type": "string", "format": "date-time" }, "time_basis": { "type": "string" }, "estimated": { "type": "boolean" } }, "required": [ "name", "at", "local_time", "time_basis", "estimated" ] }, "PillarSegment": { "type": "object", "properties": { "from": { "type": "string", "format": "date-time" }, "to": { "type": "string", "format": "date-time" }, "year_pillar": { "$ref": "#/components/schemas/Pillar" }, "month_pillar": { "$ref": "#/components/schemas/Pillar" } }, "required": [ "from", "to", "year_pillar", "month_pillar" ] }, "CivilTimeEstimate": { "type": "object", "properties": { "at": { "type": "string", "format": "date-time" }, "basis": { "type": "string" }, "estimated": { "type": "boolean" }, "tt_offset_seconds": { "type": "number" } }, "required": [ "at", "basis", "estimated", "tt_offset_seconds" ] }, "CalendarDay": { "type": "object", "properties": { "date": { "type": "string", "format": "date" }, "lunar_year": { "type": "integer" }, "lunar_month": { "type": "integer" }, "lunar_day": { "type": "integer" }, "leap_month": { "type": "boolean" }, "year_pillar": { "$ref": "#/components/schemas/Pillar" }, "month_pillar": { "$ref": "#/components/schemas/Pillar" }, "day_pillar": { "$ref": "#/components/schemas/Pillar" }, "chinese_zodiac": { "type": "string" }, "favorable": { "type": [ "array", "null" ], "items": { "$ref": "#/components/schemas/Activity" } }, "caution": { "type": [ "array", "null" ], "items": { "$ref": "#/components/schemas/Activity" } }, "solar_terms": { "type": [ "array", "null" ], "items": { "$ref": "#/components/schemas/SolarTerm" } }, "officer": { "type": "string" }, "clash": { "type": "string" }, "hours": { "type": "array", "items": { "$ref": "#/components/schemas/TraditionalHour" } }, "engine_version": { "type": "string" }, "pillar_segments": { "type": "array", "items": { "$ref": "#/components/schemas/PillarSegment" } }, "lunar_month_days": { "type": "integer" }, "personal": { "$ref": "#/components/schemas/PersonalDay" }, "reference_note": { "type": "string" }, "reference_alternative": { "type": "array", "items": { "type": "integer" } }, "calendar_basis": { "type": "string" }, "almanac_version": { "type": "string" }, "new_moon": { "oneOf": [ { "$ref": "#/components/schemas/CivilTimeEstimate" }, { "type": "null" } ] }, "almanac_segments": { "type": "array", "items": { "$ref": "#/components/schemas/AlmanacSegment" } }, "almanac_basis": { "type": "string" }, "almanac_review_status": { "type": "string" } }, "required": [ "date", "lunar_year", "lunar_month", "lunar_day", "leap_month", "year_pillar", "month_pillar", "day_pillar", "chinese_zodiac", "favorable", "caution", "solar_terms", "officer", "clash", "hours", "engine_version", "pillar_segments", "lunar_month_days" ] }, "CalendarResponse": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/CalendarDay" } }, "unavailable_dates": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "format": "date" }, "reason": { "type": "string" } }, "required": [ "date", "reason" ] } }, "today": { "type": "string", "format": "date" }, "timezone": { "type": "string" }, "calendar_basis": { "type": "string" }, "coverage_start": { "type": "string", "format": "date" }, "coverage_end": { "type": "string", "format": "date" }, "coverage_status": { "type": "string" }, "future_access": { "type": "boolean" }, "as_of_utc": { "type": "string", "format": "date-time" } }, "required": [ "items", "unavailable_dates", "today", "timezone", "calendar_basis", "coverage_start", "coverage_end", "coverage_status", "future_access", "as_of_utc" ] }, "CalendarCoverage": { "type": "object", "properties": { "today": { "type": "string", "format": "date" }, "timezone": { "type": "string" }, "calendar_basis": { "type": "string" }, "coverage_start": { "type": "string", "format": "date" }, "coverage_end": { "type": "string", "format": "date" }, "coverage_status": { "type": "string" }, "as_of_utc": { "type": "string", "format": "date-time" } }, "required": [ "today", "timezone", "calendar_basis", "coverage_start", "coverage_end", "coverage_status", "as_of_utc" ] }, "BusinessChart": { "allOf": [ { "$ref": "#/components/schemas/BaZiChart" }, { "type": "object", "properties": { "industries": { "type": "array", "items": { "type": "string" } }, "interpretation": { "type": "string" } }, "required": [ "industries", "interpretation" ] } ] }, "ComparisonRequest": { "type": "object", "properties": { "left_id": { "type": "string", "format": "uuid" }, "right_id": { "type": "string", "format": "uuid" } }, "required": [ "left_id", "right_id" ], "additionalProperties": false }, "ComparisonResult": { "type": "object", "properties": { "left": { "$ref": "#/components/schemas/BaZiChart" }, "right": { "$ref": "#/components/schemas/BaZiChart" }, "themes": { "type": "array", "items": { "type": "string" } }, "method": { "type": "string" }, "review_status": { "type": "string" } }, "required": [ "left", "right", "themes", "method", "review_status" ] }, "DailyInsight": { "type": "object", "properties": { "date": { "type": "string", "format": "date" }, "classification": { "enum": [ "Favorable", "Neutral", "Use Caution" ] }, "reasons": { "type": "array", "items": { "type": "string" } }, "day_pillar": { "$ref": "#/components/schemas/Pillar" }, "hours": { "type": "array", "items": { "$ref": "#/components/schemas/TraditionalHour" } } }, "required": [ "date", "classification", "reasons", "day_pillar", "hours" ] }, "PersonalInsights": { "type": "object", "properties": { "year": { "type": "integer" }, "annual_pillar": { "$ref": "#/components/schemas/Pillar" }, "annual_themes": { "type": "array", "items": { "type": "string" } }, "annual_conflicts": { "type": "array", "items": { "type": "string" } }, "year_boundary": { "type": "string" }, "daily": { "$ref": "#/components/schemas/DailyInsight" }, "engine_version": { "type": "string" }, "review_status": { "type": "string" }, "profile_name": { "type": "string" } }, "required": [ "year", "annual_pillar", "annual_themes", "annual_conflicts", "year_boundary", "daily", "engine_version", "review_status", "profile_name" ] }, "JobAccepted": { "type": "object", "properties": { "job_id": { "type": "string", "format": "uuid" }, "status": { "const": "queued" } }, "required": [ "job_id", "status" ] }, "SuitableEventTime": { "type": "object", "properties": { "instant": { "type": "string", "format": "date-time" }, "time": { "type": "string" }, "offset_seconds": { "type": "integer" }, "timezone": { "type": "string" } }, "required": [ "instant", "time", "offset_seconds", "timezone" ] }, "SelectedDate": { "type": "object", "properties": { "date": { "type": "string", "format": "date" }, "classification": { "enum": [ "Favorable", "Neutral", "Use Caution" ] }, "conflict_count": { "type": "integer", "minimum": 0 }, "reasons": { "type": "array", "items": { "type": "string" } }, "day": { "$ref": "#/components/schemas/CalendarDay" }, "suitable_intervals": { "type": [ "array", "null" ], "items": { "$ref": "#/components/schemas/CivilInterval" } }, "suitable_times": { "type": "array", "items": { "$ref": "#/components/schemas/SuitableEventTime" } } }, "required": [ "date", "classification", "conflict_count", "reasons", "day", "suitable_intervals", "suitable_times" ] }, "DateSelectionResult": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/SelectedDate" } }, "considered": { "type": "integer", "minimum": 0 }, "excluded": { "type": "integer", "minimum": 0 }, "timezone": { "type": "string" }, "activity": { "type": "string" }, "review_status": { "type": "string" }, "calendar_version": { "type": "string" }, "correction_version": { "type": "string" }, "calendar_publication_id": { "type": "string" }, "timezone_database": { "type": "string" } }, "required": [ "items", "considered", "excluded", "timezone", "activity", "review_status", "calendar_version", "correction_version", "calendar_publication_id", "timezone_database" ] }, "OverviewCalendarError": { "type": "object", "properties": { "code": { "$ref": "#/components/schemas/ErrorCode" }, "message": { "type": "string" } }, "required": [ "code", "message" ], "additionalProperties": false }, "UserOverview": { "type": "object", "properties": { "user": { "$ref": "#/components/schemas/Actor" }, "plan": { "$ref": "#/components/schemas/Plan" }, "counts": { "type": "object", "properties": { "profiles": { "type": "integer", "minimum": 0 }, "reports": { "type": "integer", "minimum": 0 }, "resources": { "type": "integer", "minimum": 0 } }, "required": [ "profiles", "reports", "resources" ] }, "date": { "type": "string", "format": "date" }, "timezone": { "type": "string" }, "as_of_utc": { "type": "string", "format": "date-time" }, "today": { "oneOf": [ { "$ref": "#/components/schemas/CalendarDay" }, { "type": "null" } ] }, "calendar_coverage": { "oneOf": [ { "$ref": "#/components/schemas/CalendarCoverage" }, { "type": "null" } ] }, "calendar_error": { "oneOf": [ { "$ref": "#/components/schemas/OverviewCalendarError" }, { "type": "null" } ] }, "upcoming_events": { "type": "array", "items": { "$ref": "#/components/schemas/PlannerRecord" }, "maxItems": 3 } }, "required": [ "user", "plan", "counts", "date", "timezone", "as_of_utc", "today", "calendar_coverage", "calendar_error", "upcoming_events" ] }, "HistoricalSample": { "type": "object", "properties": { "name": { "type": "string" }, "birth_date": { "type": "string", "format": "date" }, "birthplace": { "type": "string" }, "time_note": { "type": "string" }, "source_title": { "type": "string" }, "source_url": { "type": "string", "format": "uri" }, "chart": { "$ref": "#/components/schemas/BaZiChart" } }, "required": [ "name", "birth_date", "birthplace", "time_note", "source_title", "source_url", "chart" ] }, "JobState": { "type": "object", "properties": { "status": { "enum": [ "queued", "running", "completed", "failed", "cancelled" ] }, "result": {} }, "required": [ "status", "result" ] }, "ExportAccount": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "email": { "type": "string", "format": "email" }, "timezone": { "type": "string" }, "preferences": { "$ref": "#/components/schemas/EmailPreferences" }, "created_at": { "type": "string", "format": "date-time" } }, "required": [ "id", "email", "timezone", "preferences", "created_at" ] }, "ExportWorkspace": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "branding": { "$ref": "#/components/schemas/ReportBranding" } }, "required": [ "id", "branding" ] }, "ExportShare": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "report_id": { "type": "string", "format": "uuid" }, "expires_at": { "type": "string", "format": "date-time" }, "revoked_at": { "type": [ "string", "null" ], "format": "date-time" }, "redacted": { "type": "boolean" } }, "required": [ "id", "report_id", "expires_at", "revoked_at", "redacted" ], "additionalProperties": false }, "EmailDeliveryRecord": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "recipient_hint": { "type": "string" }, "purpose": { "enum": [ "verification", "notification", "receipt", "reminder" ] }, "transport": { "enum": [ "smtp", "local" ] }, "status": { "enum": [ "sending", "submission_failed", "smtp_accepted", "local_delivered", "provider_queued", "deferred", "delivered", "failed" ] }, "feedback": { "enum": [ "", "complained", "unsubscribed" ] }, "attempts": { "type": "integer", "minimum": 1 }, "failure_code": { "type": "integer", "minimum": 0, "maximum": 999 }, "created_at": { "type": "string", "format": "date-time" }, "updated_at": { "type": "string", "format": "date-time" } }, "required": [ "id", "recipient_hint", "purpose", "transport", "status", "feedback", "attempts", "failure_code", "created_at", "updated_at" ] }, "EmailDeliveryPage": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/EmailDeliveryRecord" } }, "next_cursor": { "$ref": "#/components/schemas/Cursor" }, "tracking_mode": { "enum": [ "smtp_only", "provider_callbacks" ] }, "provider_callbacks_configured": { "type": "boolean" }, "delivery_meaning": { "type": "string" } }, "required": [ "items", "next_cursor", "tracking_mode", "provider_callbacks_configured", "delivery_meaning" ] }, "EmailWebhookAccepted": { "type": "object", "properties": { "received": { "const": true }, "ignored": { "type": "boolean" }, "duplicate": { "type": "boolean" } }, "required": [ "received" ] }, "MailgunSignature": { "type": "object", "properties": { "timestamp": { "type": [ "string", "integer" ] }, "token": { "type": "string", "minLength": 16, "maxLength": 256 }, "signature": { "type": "string", "pattern": "^[a-fA-F0-9]{64}$" } }, "required": [ "timestamp", "token", "signature" ] }, "MailgunEvent": { "type": "object", "properties": { "signature": { "$ref": "#/components/schemas/MailgunSignature" }, "event-data": { "type": "object", "properties": { "id": { "type": "string" }, "event": { "type": "string" }, "timestamp": { "type": "number" }, "recipient": { "type": "string" }, "severity": { "type": "string" }, "domain": { "type": "object", "properties": { "name": { "type": "string" } }, "required": [ "name" ] }, "message": { "type": "object", "properties": { "headers": { "type": "object", "properties": { "message-id": { "type": "string" } }, "required": [ "message-id" ] } }, "required": [ "headers" ] }, "flags": { "type": "object", "properties": { "is-test-mode": { "type": "boolean" }, "is-system-test": { "type": "boolean" } }, "required": [], "additionalProperties": true }, "delivery-status": { "type": "object", "properties": { "code": { "type": "integer" } }, "required": [], "additionalProperties": true } }, "required": [ "id", "event", "timestamp", "message" ], "additionalProperties": true } }, "required": [ "signature", "event-data" ] }, "SystemPolicy": { "type": "object", "properties": { "name": { "type": "string" }, "project_name": { "type": "string", "minLength": 1, "maxLength": 120 }, "merchant_legal_name": { "type": "string" }, "merchant_jurisdiction": { "type": "string" }, "support_email": { "type": "string" }, "privacy_email": { "type": "string" }, "financial_retention_days": { "type": "integer", "minimum": 0, "maximum": 36500 }, "operational_retention_days": { "type": "integer", "minimum": 0, "maximum": 36500 }, "operational_cleanup_enabled": { "type": "boolean" }, "maintenance_mode": { "type": "boolean" }, "maintenance_message": { "type": "string" } }, "required": [ "name", "project_name", "merchant_legal_name", "merchant_jurisdiction", "support_email", "privacy_email", "financial_retention_days", "operational_retention_days", "operational_cleanup_enabled", "maintenance_mode", "maintenance_message" ] }, "EffectiveSystem": { "type": "object", "properties": { "id": { "type": "string" }, "revision": { "type": "integer", "minimum": 0 }, "source": { "enum": [ "published", "deployment" ] }, "policy": { "$ref": "#/components/schemas/SystemPolicy" } }, "required": [ "id", "revision", "source", "policy" ] }, "PublicSystemSettings": { "type": "object", "properties": { "project_name": { "type": "string" }, "project_configured": { "type": "boolean" }, "support_path": { "type": "string" }, "privacy_path": { "type": "string" }, "merchant_legal_name": { "type": "string" }, "merchant_jurisdiction": { "type": "string" }, "support_email": { "type": "string" }, "privacy_email": { "type": "string" }, "financial_retention_days": { "type": "integer", "minimum": 0 }, "business_configured": { "type": "boolean" }, "maintenance_mode": { "type": "boolean" }, "maintenance_message": { "type": "string" } }, "required": [ "project_name", "project_configured", "support_path", "privacy_path", "merchant_legal_name", "merchant_jurisdiction", "support_email", "privacy_email", "financial_retention_days", "business_configured", "maintenance_mode", "maintenance_message" ] }, "OperationalCleanup": { "type": "object", "properties": { "created_at": { "type": "string", "format": "date-time" }, "cutoff": { "type": "string", "format": "date-time" }, "counts": { "type": "object", "additionalProperties": { "type": "integer", "minimum": 0 } }, "settings_revision": { "type": "integer", "minimum": 0 } }, "required": [ "created_at", "cutoff", "counts", "settings_revision" ] }, "SystemStatus": { "type": "object", "properties": { "effective": { "$ref": "#/components/schemas/EffectiveSystem" }, "eligible_operational_records": { "type": "object", "additionalProperties": { "type": "integer", "minimum": 0 } }, "latest_cleanup": { "anyOf": [ { "$ref": "#/components/schemas/OperationalCleanup" }, { "type": "null" } ] }, "financial_cleanup": { "type": "string" }, "private_records": { "type": "string" } }, "required": [ "effective", "eligible_operational_records", "latest_cleanup", "financial_cleanup", "private_records" ] }, "DataExport": { "type": "object", "properties": { "user": { "$ref": "#/components/schemas/Actor" }, "account": { "$ref": "#/components/schemas/ExportAccount" }, "workspace": { "$ref": "#/components/schemas/ExportWorkspace" }, "exported_at": { "type": "string", "format": "date-time" }, "profiles": { "type": "array", "items": { "type": "object", "properties": {}, "required": [], "additionalProperties": true } }, "resources": { "type": "array", "items": { "type": "object", "properties": {}, "required": [], "additionalProperties": true } }, "reports": { "type": "array", "items": { "type": "object", "properties": {}, "required": [], "additionalProperties": true } }, "chart_snapshots": { "type": "array", "items": { "type": "object", "properties": {}, "required": [], "additionalProperties": true } }, "attachments": { "type": "array", "items": { "type": "object", "properties": {}, "required": [], "additionalProperties": true } }, "subscription_periods": { "type": "array", "items": { "type": "object", "properties": {}, "required": [], "additionalProperties": true } }, "orders": { "type": "array", "items": { "type": "object", "properties": {}, "required": [], "additionalProperties": true } }, "invoices": { "type": "array", "items": { "type": "object", "properties": {}, "required": [], "additionalProperties": true } }, "payment_events": { "type": "array", "items": { "type": "object", "properties": {}, "required": [], "additionalProperties": true } }, "quota_usage": { "type": "array", "items": { "type": "object", "properties": {}, "required": [], "additionalProperties": true } }, "email_deliveries": { "type": "array", "items": { "type": "object", "properties": {}, "required": [], "additionalProperties": true } }, "report_shares": { "type": "array", "items": { "$ref": "#/components/schemas/ExportShare" } }, "account_recovery": { "type": "array", "items": { "type": "object", "properties": {}, "required": [], "additionalProperties": true } } }, "required": [ "user", "account", "workspace", "exported_at", "profiles", "resources", "reports", "chart_snapshots", "attachments", "subscription_periods", "orders", "invoices", "payment_events", "quota_usage", "email_deliveries", "report_shares", "account_recovery" ] }, "WalletEvent": { "type": "object", "properties": { "event_id": { "type": "string", "minLength": 1 }, "invoice_id": { "type": "string", "minLength": 1 } }, "required": [ "event_id", "invoice_id" ], "additionalProperties": true }, "InvoiceRequest": { "type": "object", "properties": { "asset_id": { "type": "string", "minLength": 1 } }, "required": [ "asset_id" ], "additionalProperties": false }, "SimulationRequest": { "type": "object", "properties": { "status": { "enum": [ "confirming", "paid", "underpaid", "overpaid", "expired", "failed", "refunded", "reversed" ] } }, "required": [ "status" ], "additionalProperties": false }, "SimulationResult": { "type": "object", "properties": { "simulated": { "const": true }, "status": { "type": "string" } }, "required": [ "simulated", "status" ] }, "WalletEventAccepted": { "type": "object", "properties": { "received": { "type": "boolean" } }, "required": [ "received" ] }, "MethodCollection": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "method": { "type": "string" }, "name": { "type": "string" }, "engine_version": { "type": "string" }, "status": { "type": "string" } }, "required": [ "method", "name", "engine_version", "status" ], "additionalProperties": true } } }, "required": [ "items" ] }, "SupportDetail": { "type": "object", "required": [ "id", "data", "revision", "created_at" ], "properties": { "id": { "type": "string", "format": "uuid" }, "data": { "type": "object", "additionalProperties": true }, "revision": { "type": "integer", "minimum": 1 }, "created_at": { "type": "string", "format": "date-time" } } }, "SupportNote": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "author": { "type": "string" }, "body": { "type": "string" }, "created_at": { "type": "string", "format": "date-time" } }, "required": [ "id", "author", "body", "created_at" ] }, "SupportStaffDetail": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "data": { "type": "object", "additionalProperties": true }, "revision": { "type": "integer", "minimum": 1 }, "created_at": { "type": "string", "format": "date-time" }, "email": { "type": "string", "format": "email" }, "assignee_id": { "type": [ "string", "null" ] }, "assignee_email": { "type": [ "string", "null" ] }, "priority": { "enum": [ "normal", "high" ] }, "internal_notes": { "type": "array", "items": { "$ref": "#/components/schemas/SupportNote" } }, "next_notes_cursor": { "$ref": "#/components/schemas/Cursor" } }, "required": [ "id", "data", "revision", "created_at", "email", "assignee_id", "assignee_email", "priority", "internal_notes", "next_notes_cursor" ] }, "SupportChanged": { "type": "object", "properties": { "updated": { "type": "boolean" }, "revision": { "type": "integer", "minimum": 1 } }, "required": [ "updated", "revision" ] }, "SelectionOption": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "label": { "type": "string" } }, "required": [ "id", "label" ] }, "SelectionPage": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/SelectionOption" } }, "next_cursor": { "$ref": "#/components/schemas/Cursor" }, "selected": { "anyOf": [ { "$ref": "#/components/schemas/SelectionOption" }, { "type": "null" } ] } }, "required": [ "items", "next_cursor", "selected" ] }, "SupportAssignees": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "label": { "type": "string" }, "email": { "type": "string", "format": "email" } }, "required": [ "id", "label", "email" ] } }, "next_cursor": { "$ref": "#/components/schemas/Cursor" }, "selected": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "label": { "type": "string" }, "email": { "type": "string", "format": "email" } }, "required": [ "id", "label", "email" ] }, { "type": "null" } ] } }, "required": [ "items", "next_cursor", "selected" ] }, "SavedConfiguration": { "type": "object", "properties": { "id": { "type": "string" }, "revision": { "type": "integer", "minimum": 1 }, "status": { "type": "string" } }, "required": [ "id" ] }, "AdministrativeAction": { "type": "object", "properties": { "id": { "type": "string" }, "action": { "type": "string" }, "completed": { "type": "boolean" }, "revision": { "type": "integer", "minimum": 1 }, "status": { "type": "string" } }, "required": [ "id", "action", "completed" ] }, "PublicationRevision": { "type": "object", "properties": { "revision": { "type": "integer", "minimum": 1 }, "status": { "type": "string" }, "data": { "type": "object", "properties": {}, "required": [], "additionalProperties": true }, "created_by": { "type": "string" }, "approved_by": { "type": "string" }, "actor_id": { "type": "string" }, "action": { "type": "string" }, "recorded_at": { "type": "string", "format": "date-time" } }, "required": [ "revision", "status", "data", "created_by", "approved_by", "actor_id", "action", "recorded_at" ] }, "PublicationHistory": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/PublicationRevision" } }, "next_cursor": { "type": "string", "description": "Exclusive integer revision token or empty at the final page." } }, "required": [ "items", "next_cursor" ] }, "SettingsPublicationCommand": { "$ref": "#/components/schemas/AdminSettingsActionInput" }, "CalendarPublicationCommand": { "oneOf": [ { "$ref": "#/components/schemas/AdminCalendarReviewInput" }, { "$ref": "#/components/schemas/AdminCalendarReleaseInput" } ] }, "CalendarIndependentCheck": { "type": "object", "properties": { "status": { "enum": [ "pending", "validated" ] }, "cases": { "type": "integer", "minimum": 0 }, "failures": { "type": "integer", "minimum": 0 }, "source_url": { "type": "string" }, "artifact_sha256": { "type": "string" }, "range_start": { "type": "string", "format": "date" }, "range_end": { "type": "string", "format": "date" }, "covered_cases": { "type": "array", "items": { "type": "string" } } }, "required": [ "status", "cases", "failures", "source_url", "artifact_sha256", "range_start", "range_end" ] }, "CalendarValidationEvidence": { "type": "object", "properties": { "status": { "type": "string" }, "engine_version": { "type": "string" }, "corrections_version": { "type": "string" }, "timezone_version": { "type": "string" }, "reference_start": { "type": "string", "format": "date" }, "reference_end": { "type": "string", "format": "date" }, "reference_cases": { "type": "integer", "minimum": 0 }, "mismatches": { "type": "integer", "minimum": 0 }, "reference_url": { "type": "string" }, "reference_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "round_trip_cases": { "type": "integer", "minimum": 0 }, "round_trip_failures": { "type": "integer", "minimum": 0 }, "independent_checks": { "type": "object", "properties": { "lunar_months": { "$ref": "#/components/schemas/CalendarIndependentCheck" }, "solar_terms": { "$ref": "#/components/schemas/CalendarIndependentCheck" }, "stem_branches": { "$ref": "#/components/schemas/CalendarIndependentCheck" }, "difficult_cases": { "$ref": "#/components/schemas/CalendarIndependentCheck" }, "range_edges": { "$ref": "#/components/schemas/CalendarIndependentCheck" } }, "required": [ "lunar_months", "solar_terms", "stem_branches", "difficult_cases", "range_edges" ] } }, "required": [ "status", "engine_version", "corrections_version", "timezone_version", "reference_start", "reference_end", "reference_cases", "mismatches", "reference_url", "reference_sha256", "round_trip_cases", "round_trip_failures", "independent_checks" ], "additionalProperties": true }, "OperationalHealthCheck": { "type": "object", "properties": { "id": { "type": "string" }, "title": { "type": "string" }, "status": { "enum": [ "healthy", "warning", "critical", "pending", "unavailable" ] }, "value": { "type": "number", "minimum": 0 }, "unit": { "type": "string" }, "action": { "enum": [ "", "jobs", "email", "payments" ] }, "first_seen": { "type": "string", "format": "date-time" } }, "required": [ "id", "title", "status", "unit", "action" ] }, "OperationalHealth": { "type": "object", "properties": { "status": { "enum": [ "healthy", "needs_attention", "stale", "unavailable" ] }, "checked_at": { "type": [ "string", "null" ], "format": "date-time" }, "age_seconds": { "type": [ "integer", "null" ], "minimum": 0 }, "checks": { "type": "array", "items": { "$ref": "#/components/schemas/OperationalHealthCheck" } } }, "required": [ "status", "checked_at", "age_seconds", "checks" ] }, "AdministrationOverview": { "type": "object", "properties": { "counts": { "type": "object", "properties": {}, "required": [], "additionalProperties": { "type": "integer", "minimum": 0 } }, "invoiced_usd_minor": { "type": "integer", "minimum": 0 }, "crypto_received": { "type": "array", "items": { "type": "object", "properties": { "asset": { "type": "string" }, "network": { "type": "string" }, "decimals": { "type": "string" }, "received_atomic": { "type": "string" } }, "required": [ "asset", "network", "decimals", "received_atomic" ] } }, "environment": { "type": "string" }, "wallet_live": { "type": "boolean" }, "calendar_review_pending": { "type": "boolean" } }, "required": [ "counts", "invoiced_usd_minor", "crypto_received", "environment", "wallet_live", "calendar_review_pending" ] }, "CMSChanged": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "revision": { "type": "integer", "minimum": 1 }, "state_revision": { "type": "integer", "minimum": 1 }, "status": { "enum": [ "draft", "preview", "published", "archived" ] } }, "required": [ "id", "revision", "state_revision", "status" ] }, "DatabasePoolObservation": { "type": "object", "required": [ "in_use", "limit", "open", "wait_count", "wait_seconds" ], "additionalProperties": false, "properties": { "in_use": { "type": "integer", "minimum": 0 }, "limit": { "type": "integer", "minimum": 0 }, "open": { "type": "integer", "minimum": 0 }, "wait_count": { "type": "integer", "minimum": 0 }, "wait_seconds": { "type": "number", "minimum": 0 } } }, "MySQLCapacity": { "type": "object", "required": [ "max_connections", "connected", "running", "uptime_seconds", "connection_rejections", "row_lock_waits", "row_lock_milliseconds" ], "additionalProperties": false, "properties": { "max_connections": { "type": "integer", "minimum": 1 }, "connected": { "type": "integer", "minimum": 0 }, "running": { "type": "integer", "minimum": 0 }, "uptime_seconds": { "type": "integer", "minimum": 0 }, "connection_rejections": { "type": "integer", "minimum": 0 }, "row_lock_waits": { "type": "integer", "minimum": 0 }, "row_lock_milliseconds": { "type": "integer", "minimum": 0 } } }, "MarketingDatabaseHealth": { "type": "object", "required": [ "version", "checked_at", "available", "pool", "global" ], "additionalProperties": false, "properties": { "version": { "const": "de-mysql-health-1" }, "checked_at": { "type": "string", "format": "date-time" }, "available": { "type": "boolean" }, "pool": { "$ref": "#/components/schemas/DatabasePoolObservation" }, "global": { "oneOf": [ { "$ref": "#/components/schemas/MySQLCapacity" }, { "type": "null" } ] } } }, "ArticleCategory": { "type": "object", "required": [ "name", "article_count" ], "additionalProperties": false, "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 120 }, "article_count": { "type": "integer", "minimum": 1 } } }, "ArticleCategoryPage": { "type": "object", "required": [ "items", "next_cursor" ], "additionalProperties": false, "properties": { "items": { "type": "array", "maxItems": 100, "items": { "$ref": "#/components/schemas/ArticleCategory" } }, "next_cursor": { "type": "string", "maxLength": 1000 } } }, "PlannerInput": { "type": "object", "properties": { "title": { "type": "string", "minLength": 1, "maxLength": 160 }, "date": { "type": "string", "format": "date" }, "time": { "type": "string", "pattern": "^\\d{2}:\\d{2}$" }, "timezone": { "type": "string", "minLength": 1, "maxLength": 160 }, "offset_seconds": { "type": "integer", "minimum": -50400, "maximum": 50400 }, "notes": { "type": "string", "maxLength": 4000 }, "reminder": { "type": "boolean" } }, "required": [ "title", "date", "time", "timezone" ], "additionalProperties": false }, "ClientInput": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 120 }, "email": { "anyOf": [ { "type": "string", "format": "email", "maxLength": 254 }, { "const": "" } ] }, "notes": { "type": "string", "maxLength": 4000 }, "consent": { "const": true } }, "required": [ "name", "consent" ], "additionalProperties": false }, "NotificationReadInput": { "type": "object", "properties": { "read": { "type": "boolean" } }, "required": [ "read" ], "additionalProperties": false }, "SupportCreateInput": { "type": "object", "properties": { "title": { "type": "string", "minLength": 1, "maxLength": 160 }, "category": { "enum": [ "", "General", "Calculations", "Billing", "Privacy" ] }, "message": { "type": "string", "minLength": 1, "maxLength": 8000 } }, "required": [ "title", "message" ], "additionalProperties": false }, "SupportReplyInput": { "type": "object", "properties": { "title": { "type": "string", "minLength": 1, "maxLength": 160 }, "category": { "enum": [ "", "General", "Calculations", "Billing", "Privacy" ] }, "message": { "type": "string", "minLength": 1, "maxLength": 8000 } }, "required": [ "message" ], "additionalProperties": false, "description": "Reply to an owned ticket. Existing title/category values are accepted for form compatibility; original ticket details are preserved." }, "RefundInput": { "type": "object", "required": [ "invoice_id", "destination", "reason" ], "properties": { "invoice_id": { "type": "string", "format": "uuid" }, "destination": { "type": "string", "minLength": 10, "maxLength": 256 }, "reason": { "type": "string", "minLength": 1, "maxLength": 2000 } }, "additionalProperties": false }, "ConsentInput": { "type": "object", "properties": { "subject": { "type": "string", "minLength": 1, "maxLength": 160 }, "confirmed": { "const": true } }, "required": [ "subject", "confirmed" ], "additionalProperties": false }, "PlannerData": { "type": "object", "properties": { "title": { "type": "string", "minLength": 1, "maxLength": 160 }, "date": { "type": "string", "format": "date" }, "time": { "type": "string", "pattern": "^\\d{2}:\\d{2}$" }, "timezone": { "type": "string", "minLength": 1, "maxLength": 160 }, "offset_seconds": { "type": "integer", "minimum": -50400, "maximum": 50400 }, "notes": { "type": "string", "maxLength": 4000 }, "reminder": { "type": "boolean" }, "starts_at": { "type": "string", "format": "date-time" }, "timezone_version": { "type": "string" } }, "required": [ "title", "date", "time", "timezone" ], "additionalProperties": false }, "ClientData": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 120 }, "email": { "anyOf": [ { "type": "string", "format": "email", "maxLength": 254 }, { "const": "" } ] }, "notes": { "type": "string", "maxLength": 4000 }, "consent": { "const": true } }, "required": [ "name", "consent" ], "additionalProperties": false }, "NotificationData": { "type": "object", "properties": { "title": { "type": "string" }, "body": { "type": "string" }, "read": { "type": "boolean" }, "link": { "type": "string" } }, "required": [ "title", "body", "read" ], "additionalProperties": true }, "SupportMessage": { "type": "object", "properties": { "author": { "type": "string" }, "body": { "type": "string" }, "at": { "type": "string", "format": "date-time" } }, "required": [ "author", "body", "at" ] }, "SupportData": { "type": "object", "properties": { "title": { "type": "string" }, "category": { "enum": [ "General", "Calculations", "Billing", "Privacy" ] }, "status": { "enum": [ "open", "answered", "closed" ] }, "messages": { "type": "array", "items": { "$ref": "#/components/schemas/SupportMessage" } } }, "required": [ "title", "category", "status", "messages" ], "additionalProperties": false }, "RefundData": { "type": "object", "properties": { "invoice_id": { "type": "string", "format": "uuid" }, "destination": { "type": "string", "minLength": 10, "maxLength": 256 }, "reason": { "type": "string", "minLength": 1, "maxLength": 2000 }, "status": { "type": "string" }, "invoice_summary": { "type": "object", "properties": { "usd_amount_minor": { "type": "integer", "minimum": 0 }, "asset_id": { "type": "string" }, "network": { "type": "string" }, "amount_atomic": { "type": "string", "pattern": "^\\d+$" }, "received_atomic": { "type": "string", "pattern": "^\\d+$" }, "decimals": { "type": "integer", "minimum": 0, "maximum": 30 } }, "required": [ "usd_amount_minor", "asset_id", "network", "amount_atomic", "received_atomic", "decimals" ] } }, "required": [ "invoice_id", "destination", "reason", "status", "invoice_summary" ], "additionalProperties": true }, "ConsentData": { "type": "object", "properties": { "subject": { "type": "string", "minLength": 1, "maxLength": 160 }, "confirmed": { "const": true } }, "required": [ "subject", "confirmed" ], "additionalProperties": false }, "PlannerRecord": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "data": { "$ref": "#/components/schemas/PlannerData" }, "revision": { "type": "integer", "minimum": 1 }, "created_at": { "type": "string", "format": "date-time" } }, "required": [ "id", "data", "revision", "created_at" ] }, "PlannerPage": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/PlannerRecord" } }, "next_cursor": { "$ref": "#/components/schemas/Cursor" } }, "required": [ "items", "next_cursor" ] }, "PlannerCreateRequest": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/PlannerInput" }, "revision": { "type": "integer", "minimum": 0 } }, "required": [ "data" ], "additionalProperties": false }, "PlannerEditRequest": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/PlannerInput" }, "revision": { "type": "integer", "minimum": 1 } }, "required": [ "data", "revision" ], "additionalProperties": false }, "ClientsRecord": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "data": { "$ref": "#/components/schemas/ClientData" }, "revision": { "type": "integer", "minimum": 1 }, "created_at": { "type": "string", "format": "date-time" } }, "required": [ "id", "data", "revision", "created_at" ] }, "ClientsPage": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/ClientsRecord" } }, "next_cursor": { "$ref": "#/components/schemas/Cursor" } }, "required": [ "items", "next_cursor" ] }, "ClientsCreateRequest": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/ClientInput" }, "revision": { "type": "integer", "minimum": 0 } }, "required": [ "data" ], "additionalProperties": false }, "ClientsEditRequest": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/ClientInput" }, "revision": { "type": "integer", "minimum": 1 } }, "required": [ "data", "revision" ], "additionalProperties": false }, "NotificationRecord": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "data": { "$ref": "#/components/schemas/NotificationData" }, "revision": { "type": "integer", "minimum": 1 }, "created_at": { "type": "string", "format": "date-time" } }, "required": [ "id", "data", "revision", "created_at" ] }, "NotificationPage": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/NotificationRecord" } }, "next_cursor": { "$ref": "#/components/schemas/Cursor" } }, "required": [ "items", "next_cursor" ] }, "NotificationEditRequest": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/NotificationReadInput" }, "revision": { "type": "integer", "minimum": 1 } }, "required": [ "data", "revision" ], "additionalProperties": false }, "SupportRecord": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "data": { "$ref": "#/components/schemas/SupportData" }, "revision": { "type": "integer", "minimum": 1 }, "created_at": { "type": "string", "format": "date-time" } }, "required": [ "id", "data", "revision", "created_at" ] }, "SupportPage": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/SupportRecord" } }, "next_cursor": { "$ref": "#/components/schemas/Cursor" } }, "required": [ "items", "next_cursor" ] }, "SupportCreateRequest": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/SupportCreateInput" }, "revision": { "type": "integer", "minimum": 0 } }, "required": [ "data" ], "additionalProperties": false }, "SupportEditRequest": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/SupportReplyInput" }, "revision": { "type": "integer", "minimum": 1 } }, "required": [ "data", "revision" ], "additionalProperties": false }, "RefundsRecord": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "data": { "$ref": "#/components/schemas/RefundData" }, "revision": { "type": "integer", "minimum": 1 }, "created_at": { "type": "string", "format": "date-time" } }, "required": [ "id", "data", "revision", "created_at" ] }, "RefundsPage": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/RefundsRecord" } }, "next_cursor": { "$ref": "#/components/schemas/Cursor" } }, "required": [ "items", "next_cursor" ] }, "RefundsCreateRequest": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/RefundInput" }, "revision": { "type": "integer", "minimum": 0 } }, "required": [ "data" ], "additionalProperties": false }, "ConsentsRecord": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "data": { "$ref": "#/components/schemas/ConsentData" }, "revision": { "type": "integer", "minimum": 1 }, "created_at": { "type": "string", "format": "date-time" } }, "required": [ "id", "data", "revision", "created_at" ] }, "ConsentsPage": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/ConsentsRecord" } }, "next_cursor": { "$ref": "#/components/schemas/Cursor" } }, "required": [ "items", "next_cursor" ] }, "ConsentsCreateRequest": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/ConsentInput" }, "revision": { "type": "integer", "minimum": 0 } }, "required": [ "data" ], "additionalProperties": false }, "ConsentsEditRequest": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/ConsentInput" }, "revision": { "type": "integer", "minimum": 1 } }, "required": [ "data", "revision" ], "additionalProperties": false }, "AdminInvitationInput": { "type": "object", "properties": { "email": { "type": "string", "format": "email", "maxLength": 254 }, "roles": { "type": "array", "items": { "enum": [ "owner", "content", "methods_editor", "methods_reviewer", "support", "finance", "analyst" ] }, "minItems": 1, "maxItems": 7, "uniqueItems": true } }, "required": [ "email", "roles" ], "additionalProperties": false }, "AdminPlanInput": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 120 }, "monthly_minor": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "annual_minor": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "profile_limit": { "type": "integer", "minimum": 1, "maximum": 10000 }, "report_limit": { "type": "integer", "minimum": 0, "maximum": 10000 }, "features": { "type": "array", "items": { "type": "string" }, "maxItems": 100, "uniqueItems": true } }, "required": [ "name", "monthly_minor", "annual_minor", "profile_limit", "report_limit", "features" ], "additionalProperties": false }, "AdminFeatureInput": { "type": "object", "properties": { "enabled": { "type": "boolean" } }, "required": [ "enabled" ], "additionalProperties": false }, "AdminMenuInput": { "type": "object", "properties": { "name": { "type": "string", "maxLength": 160 }, "application": { "enum": [ "app", "landing" ] }, "path": { "type": "string", "maxLength": 160 }, "label": { "type": "string", "minLength": 1, "maxLength": 160 }, "order": { "type": "integer", "minimum": 0, "maximum": 1000 }, "visible": { "type": "boolean" } }, "required": [ "path", "label", "order" ], "additionalProperties": false }, "AdminMethodInput": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 4000 }, "source_url": { "type": "string", "format": "uri", "maxLength": 2000 }, "source": { "type": "string", "maxLength": 4000 }, "version": { "type": "string", "maxLength": 4000 }, "method": { "enum": [ "bazi", "ziwei", "tongshu" ] }, "engine_version": { "type": "string", "maxLength": 4000 }, "description": { "type": "string", "maxLength": 4000 }, "notes": { "type": "string", "maxLength": 4000 }, "examples": { "type": "array", "items": { "type": "string", "maxLength": 4000 }, "maxItems": 20 } }, "required": [ "name", "source_url", "method", "engine_version" ], "additionalProperties": false }, "AdminRuleInput": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 4000 }, "source_url": { "type": "string", "format": "uri", "maxLength": 2000 }, "source": { "type": "string", "maxLength": 4000 }, "version": { "type": "string", "maxLength": 4000 }, "method": { "const": "bazi" }, "condition": { "$ref": "#/components/schemas/RuleCondition" }, "text": { "type": "string", "minLength": 1, "maxLength": 4000 }, "examples": { "type": "array", "items": { "type": "string", "maxLength": 4000 }, "maxItems": 20 } }, "required": [ "name", "source_url", "condition", "text" ], "additionalProperties": false }, "AdminCorrectionInput": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 4000 }, "source_url": { "type": "string", "format": "uri", "maxLength": 2000 }, "source": { "type": "string", "maxLength": 4000 }, "version": { "type": "string", "maxLength": 4000 }, "date": { "type": "string", "format": "date" }, "lunar_year": { "type": "integer", "minimum": 1899, "maximum": 2200 }, "lunar_month": { "type": "integer", "minimum": -12, "maximum": 12, "description": "Negative denotes a leap month; zero is rejected.", "not": { "const": 0 } }, "lunar_day": { "type": "integer", "minimum": 1, "maximum": 30 }, "month_days": { "enum": [ 29, 30 ] }, "notes": { "type": "string", "maxLength": 4000 } }, "required": [ "name", "source_url", "date", "lunar_year", "lunar_month", "lunar_day", "month_days" ], "additionalProperties": false }, "AdminAnnouncementInput": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 240 }, "type": { "const": "announcement" }, "title": { "type": "string", "minLength": 1, "maxLength": 240 }, "body": { "type": "string", "minLength": 1, "maxLength": 8000 }, "event": { "const": "" } }, "required": [ "name", "type", "title", "body" ], "additionalProperties": false }, "AdminEmailTemplateInput": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 240 }, "type": { "const": "email_template" }, "event": { "enum": [ "otp", "receipt", "reminder", "support_reply" ] }, "title": { "type": "string", "minLength": 1, "maxLength": 240, "pattern": "^[^\\r\\n]+$" }, "body": { "type": "string", "minLength": 1, "maxLength": 8000 } }, "required": [ "name", "type", "event", "title", "body" ], "additionalProperties": false }, "AdminNotificationInput": { "oneOf": [ { "$ref": "#/components/schemas/AdminAnnouncementInput" }, { "$ref": "#/components/schemas/AdminEmailTemplateInput" } ] }, "AdminPolicyInput": { "type": "object", "properties": { "name": { "type": "string" }, "project_name": { "type": "string", "minLength": 1, "maxLength": 120 }, "merchant_legal_name": { "type": "string" }, "merchant_jurisdiction": { "type": "string" }, "support_email": { "type": "string" }, "privacy_email": { "type": "string" }, "financial_retention_days": { "type": "integer", "minimum": 0, "maximum": 36500 }, "operational_retention_days": { "type": "integer", "minimum": 0, "maximum": 36500 }, "operational_cleanup_enabled": { "type": "boolean" }, "maintenance_mode": { "type": "boolean" }, "maintenance_message": { "type": "string" } }, "required": [ "name" ], "additionalProperties": false }, "AdminFeatureUpdated": { "type": "object", "properties": { "id": { "type": "string" }, "revision": { "type": "integer", "minimum": 2 } }, "required": [ "id", "revision" ] }, "AdminFeatureRecord": { "type": "object", "properties": { "id": { "type": "string" }, "enabled": { "type": "boolean" }, "minimum_plan": { "enum": [ "free", "seeker", "strategist", "practitioner" ] }, "revision": { "type": "integer", "minimum": 1 } }, "required": [ "id", "enabled", "minimum_plan", "revision" ] }, "AdminFeaturePage": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/AdminFeatureRecord" } }, "next_cursor": { "const": "" } }, "required": [ "items", "next_cursor" ] }, "AdminUsersCreateRequest": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/AdminInvitationInput" }, "revision": { "type": "integer", "minimum": 0, "maximum": 2147483646 } }, "required": [ "data" ], "additionalProperties": false }, "AdminPlansEditRequest": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/AdminPlanInput" }, "revision": { "type": "integer", "minimum": 1, "maximum": 2147483646 } }, "required": [ "data", "revision" ], "additionalProperties": false }, "AdminFeaturesEditRequest": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/AdminFeatureInput" }, "revision": { "type": "integer", "minimum": 1, "maximum": 2147483646 } }, "required": [ "data", "revision" ], "additionalProperties": false }, "AdminMenusCreateRequest": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/AdminMenuInput" }, "revision": { "type": "integer", "minimum": 0, "maximum": 2147483646 }, "version_of": { "type": "string", "format": "uuid" } }, "required": [ "data" ], "additionalProperties": false }, "AdminMenusEditRequest": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/AdminMenuInput" }, "revision": { "type": "integer", "minimum": 1, "maximum": 2147483646 }, "version_of": { "type": "string", "format": "uuid" } }, "required": [ "data", "revision" ], "additionalProperties": false }, "AdminMethodsCreateRequest": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/AdminMethodInput" }, "revision": { "type": "integer", "minimum": 0, "maximum": 2147483646 }, "version_of": { "type": "string", "format": "uuid" } }, "required": [ "data" ], "additionalProperties": false }, "AdminMethodsEditRequest": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/AdminMethodInput" }, "revision": { "type": "integer", "minimum": 1, "maximum": 2147483646 }, "version_of": { "type": "string", "format": "uuid" } }, "required": [ "data", "revision" ], "additionalProperties": false }, "AdminRulesCreateRequest": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/AdminRuleInput" }, "revision": { "type": "integer", "minimum": 0, "maximum": 2147483646 }, "version_of": { "type": "string", "format": "uuid" } }, "required": [ "data" ], "additionalProperties": false }, "AdminRulesEditRequest": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/AdminRuleInput" }, "revision": { "type": "integer", "minimum": 1, "maximum": 2147483646 }, "version_of": { "type": "string", "format": "uuid" } }, "required": [ "data", "revision" ], "additionalProperties": false }, "AdminCorrectionsCreateRequest": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/AdminCorrectionInput" }, "revision": { "type": "integer", "minimum": 0, "maximum": 2147483646 }, "version_of": { "type": "string", "format": "uuid" } }, "required": [ "data" ], "additionalProperties": false }, "AdminCorrectionsEditRequest": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/AdminCorrectionInput" }, "revision": { "type": "integer", "minimum": 1, "maximum": 2147483646 }, "version_of": { "type": "string", "format": "uuid" } }, "required": [ "data", "revision" ], "additionalProperties": false }, "AdminNotificationsCreateRequest": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/AdminNotificationInput" }, "revision": { "type": "integer", "minimum": 0, "maximum": 2147483646 }, "version_of": { "type": "string", "format": "uuid" } }, "required": [ "data" ], "additionalProperties": false }, "AdminNotificationsEditRequest": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/AdminNotificationInput" }, "revision": { "type": "integer", "minimum": 1, "maximum": 2147483646 }, "version_of": { "type": "string", "format": "uuid" } }, "required": [ "data", "revision" ], "additionalProperties": false }, "AdminSettingsCreateRequest": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/AdminPolicyInput" }, "revision": { "type": "integer", "minimum": 0, "maximum": 2147483646 }, "version_of": { "type": "string", "format": "uuid" } }, "required": [ "data" ], "additionalProperties": false }, "AdminSettingsEditRequest": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/AdminPolicyInput" }, "revision": { "type": "integer", "minimum": 1, "maximum": 2147483646 }, "version_of": { "type": "string", "format": "uuid" } }, "required": [ "data", "revision" ], "additionalProperties": false }, "EmbeddedMethodArtifact": { "type": "object", "properties": { "name": { "type": "string" }, "sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "bytes": { "type": "integer", "minimum": 1 }, "records": { "type": "integer", "minimum": 1 }, "unit": { "type": "string" } }, "required": [ "name", "sha256", "bytes", "records", "unit" ] }, "OwnedMethodDescription": { "type": "object", "properties": { "id": { "enum": [ "bazi", "tongshu", "ziwei" ] }, "name": { "type": "string" }, "engine_version": { "type": "string" }, "summary": { "type": "string" }, "capabilities": { "type": "array", "items": { "type": "string" } }, "conventions": { "type": "array", "items": { "type": "string" } }, "limitations": { "type": "array", "items": { "type": "string" } }, "sources": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "url": { "type": "string", "format": "uri" } }, "required": [ "name", "url" ] } }, "artifacts": { "type": "array", "items": { "$ref": "#/components/schemas/EmbeddedMethodArtifact" } } }, "required": [ "id", "name", "engine_version", "summary", "capabilities", "conventions", "limitations", "sources", "artifacts" ] }, "CalculationSystem": { "type": "object", "properties": { "implementation": { "type": "string" }, "runtime_network_required": { "type": "boolean" }, "external_calculator_required": { "type": "boolean" }, "calendar_version": { "type": "string" }, "timezone_version": { "type": "string" }, "calendar_artifacts": { "type": "array", "items": { "$ref": "#/components/schemas/EmbeddedMethodArtifact" } }, "methods": { "type": "array", "items": { "$ref": "#/components/schemas/OwnedMethodDescription" } } }, "required": [ "implementation", "runtime_network_required", "external_calculator_required", "calendar_version", "timezone_version", "calendar_artifacts", "methods" ] }, "MethodSystemApproval": { "type": "object", "properties": { "method": { "type": "string" }, "engine_version": { "type": "string" }, "status": { "type": "string" }, "record_id": { "type": "string", "format": "uuid" }, "revision": { "type": "integer", "minimum": 1 }, "author_id": { "type": "string", "format": "uuid" }, "reviewer_id": { "type": "string", "format": "uuid" }, "publication": { "type": "object", "additionalProperties": true } }, "required": [ "method", "engine_version", "status" ] }, "MethodSystemCalendar": { "type": "object", "properties": { "start": { "type": "string" }, "end": { "type": "string" }, "status": { "type": "string" }, "review_type": { "type": "string" } }, "required": [ "start", "end", "status", "review_type" ] }, "AdminMethodsPage": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "additionalProperties": true } }, "next_cursor": { "$ref": "#/components/schemas/Cursor" }, "registered_methods": { "type": "object", "description": "Present on administrative calculation-method pages. Supplies deployed versions and sources for new drafts.", "additionalProperties": { "$ref": "#/components/schemas/RegisteredMethod" } }, "calculation_system": { "$ref": "#/components/schemas/CalculationSystem" }, "method_approvals": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/MethodSystemApproval" } }, "calendar_publication": { "$ref": "#/components/schemas/MethodSystemCalendar" } }, "required": [ "items", "next_cursor", "registered_methods", "calculation_system", "method_approvals", "calendar_publication" ] }, "AdminContactReplyInput": { "type": "object", "properties": { "revision": { "type": "integer", "minimum": 1, "maximum": 2147483646 }, "message": { "type": "string", "minLength": 1, "maxLength": 8000 } }, "required": [ "revision", "message" ], "additionalProperties": false }, "AdminContactCloseInput": { "type": "object", "properties": { "revision": { "type": "integer", "minimum": 1, "maximum": 2147483646 } }, "required": [ "revision" ], "additionalProperties": false }, "AdminServiceRetryInput": { "type": "object", "properties": {}, "required": [], "additionalProperties": false }, "AdminWalletPairInput": { "type": "object", "properties": { "expected_enabled": { "type": "boolean" } }, "required": [ "expected_enabled" ], "additionalProperties": false }, "CMSText": { "type": "object", "properties": { "type": { "const": "text" }, "text": { "type": "string", "minLength": 1, "maxLength": 200000 }, "marks": { "type": "array", "items": { "type": "object", "properties": { "type": { "enum": [ "bold", "italic", "strike", "code" ] } }, "required": [ "type" ], "additionalProperties": false }, "maxItems": 4, "uniqueItems": true }, "attrs": { "type": "object", "properties": {}, "required": [], "additionalProperties": false } }, "required": [ "type", "text" ], "additionalProperties": false }, "CMSHardBreak": { "type": "object", "properties": { "type": { "const": "hardBreak" }, "marks": { "type": "array", "items": { "type": "object", "properties": { "type": { "enum": [ "bold", "italic", "strike", "code" ] } }, "required": [ "type" ], "additionalProperties": false }, "maxItems": 4, "uniqueItems": true }, "attrs": { "type": "object", "properties": {}, "required": [], "additionalProperties": false } }, "required": [ "type" ], "additionalProperties": false }, "CMSInline": { "oneOf": [ { "$ref": "#/components/schemas/CMSText" }, { "$ref": "#/components/schemas/CMSHardBreak" } ] }, "CMSParagraph": { "type": "object", "properties": { "type": { "const": "paragraph" }, "content": { "type": "array", "items": { "$ref": "#/components/schemas/CMSInline" } }, "attrs": { "type": "object", "properties": {}, "required": [], "additionalProperties": false } }, "required": [ "type" ], "additionalProperties": false }, "CMSHeading": { "type": "object", "properties": { "type": { "const": "heading" }, "attrs": { "type": "object", "properties": { "level": { "enum": [ 2, 3, 4 ] } }, "required": [ "level" ], "additionalProperties": false }, "content": { "type": "array", "items": { "$ref": "#/components/schemas/CMSInline" } } }, "required": [ "type", "attrs" ], "additionalProperties": false }, "CMSHorizontalRule": { "type": "object", "properties": { "type": { "const": "horizontalRule" }, "attrs": { "type": "object", "properties": {}, "required": [], "additionalProperties": false } }, "required": [ "type" ], "additionalProperties": false }, "CMSCodeBlock": { "type": "object", "properties": { "type": { "const": "codeBlock" }, "attrs": { "type": "object", "properties": { "language": { "enum": [ null, "" ] } }, "required": [], "additionalProperties": false }, "content": { "type": "array", "items": { "allOf": [ { "$ref": "#/components/schemas/CMSText" }, { "not": { "required": [ "marks" ] } } ] } } }, "required": [ "type" ], "additionalProperties": false }, "CMSListItem": { "type": "object", "properties": { "type": { "const": "listItem" }, "content": { "type": "array", "items": { "$ref": "#/components/schemas/CMSBlock" }, "minItems": 1, "prefixItems": [ { "$ref": "#/components/schemas/CMSParagraph" } ] }, "attrs": { "type": "object", "properties": {}, "required": [], "additionalProperties": false } }, "required": [ "type", "content" ], "additionalProperties": false }, "CMSBulletList": { "type": "object", "properties": { "type": { "const": "bulletList" }, "content": { "type": "array", "items": { "$ref": "#/components/schemas/CMSListItem" }, "minItems": 1 }, "attrs": { "type": "object", "properties": {}, "required": [], "additionalProperties": false } }, "required": [ "type", "content" ], "additionalProperties": false }, "CMSOrderedList": { "type": "object", "properties": { "type": { "const": "orderedList" }, "attrs": { "type": "object", "properties": { "start": { "type": "integer", "minimum": 1, "maximum": 10000 }, "type": { "enum": [ null, "1", "a", "A", "i", "I" ] } }, "required": [], "additionalProperties": false }, "content": { "type": "array", "items": { "$ref": "#/components/schemas/CMSListItem" }, "minItems": 1 } }, "required": [ "type", "content" ], "additionalProperties": false }, "CMSBlockQuote": { "type": "object", "properties": { "type": { "const": "blockquote" }, "content": { "type": "array", "items": { "$ref": "#/components/schemas/CMSBlock" }, "minItems": 1 }, "attrs": { "type": "object", "properties": {}, "required": [], "additionalProperties": false } }, "required": [ "type", "content" ], "additionalProperties": false }, "CMSBlock": { "oneOf": [ { "$ref": "#/components/schemas/CMSParagraph" }, { "$ref": "#/components/schemas/CMSHeading" }, { "$ref": "#/components/schemas/CMSHorizontalRule" }, { "$ref": "#/components/schemas/CMSCodeBlock" }, { "$ref": "#/components/schemas/CMSBulletList" }, { "$ref": "#/components/schemas/CMSOrderedList" }, { "$ref": "#/components/schemas/CMSBlockQuote" } ] }, "CMSDocument": { "type": "object", "properties": { "type": { "const": "doc" }, "content": { "type": "array", "items": { "$ref": "#/components/schemas/CMSBlock" } }, "attrs": { "type": "object", "properties": {}, "required": [], "additionalProperties": false } }, "required": [ "type" ], "additionalProperties": false }, "CMSContent": { "type": "object", "additionalProperties": false, "properties": { "lead": { "type": "string", "maxLength": 4000 }, "seo_description": { "type": "string", "maxLength": 240 }, "category": { "type": "string", "maxLength": 120 }, "hero_image": { "type": "string", "description": "Published media UUID or empty" }, "faq": { "type": "array", "maxItems": 100, "items": { "type": "object", "required": [ "q", "a" ], "additionalProperties": false, "properties": { "q": { "type": "string", "maxLength": 500, "minLength": 1 }, "a": { "type": "string", "maxLength": 5000, "minLength": 1 } } } }, "body": { "oneOf": [ { "type": "string", "maxLength": 200000 }, { "type": "null" }, { "$ref": "#/components/schemas/CMSDocument" } ], "description": "Supported editor document, plain text or null. Aggregate document limits: depth 32, 5,000 nodes; stored content <=900,000 JSON bytes. Text must be valid UTF-8 and exclude NUL." } } }, "AdminRevisionActionInput": { "type": "object", "properties": { "revision": { "type": "integer", "minimum": 1, "maximum": 2147483646 } }, "required": [ "revision" ], "additionalProperties": false }, "AdminRoleActionInput": { "type": "object", "properties": { "revision": { "type": "integer", "minimum": 1, "maximum": 2147483646 }, "roles": { "type": "array", "items": { "enum": [ "owner", "content", "methods_editor", "methods_reviewer", "support", "finance", "analyst" ] }, "maxItems": 7, "uniqueItems": true } }, "required": [ "revision", "roles" ], "additionalProperties": false }, "AdminSuspendActionInput": { "type": "object", "properties": { "revision": { "type": "integer", "minimum": 1, "maximum": 2147483646 }, "reason": { "type": "string", "minLength": 1, "maxLength": 2000 } }, "required": [ "revision", "reason" ], "additionalProperties": false }, "AdminGrantActionInput": { "type": "object", "properties": { "plan_id": { "enum": [ "seeker", "strategist", "practitioner" ] }, "reason": { "type": "string", "minLength": 1, "maxLength": 2000 } }, "required": [ "plan_id", "reason" ], "additionalProperties": false }, "AdminAdjustmentInput": { "type": "object", "properties": { "reason": { "type": "string", "minLength": 1, "maxLength": 2000 } }, "required": [ "reason" ], "additionalProperties": false }, "AdminRefundApproveInput": { "type": "object", "properties": { "revision": { "type": "integer", "minimum": 1, "maximum": 2147483646 }, "reason": { "type": "string", "minLength": 1, "maxLength": 2000 }, "destination_confirmed": { "const": true } }, "required": [ "revision", "reason", "destination_confirmed" ], "additionalProperties": false }, "AdminRefundDeclineInput": { "type": "object", "properties": { "revision": { "type": "integer", "minimum": 1, "maximum": 2147483646 }, "reason": { "type": "string", "minLength": 1, "maxLength": 2000 } }, "required": [ "revision", "reason" ], "additionalProperties": false }, "AdminIndependentReviewInput": { "type": "object", "properties": { "revision": { "type": "integer", "minimum": 1, "maximum": 2147483646 }, "reviewer_name": { "type": "string", "minLength": 1, "maxLength": 240 }, "review_notes": { "type": "string", "minLength": 1, "maxLength": 8000 } }, "required": [ "revision", "reviewer_name", "review_notes" ], "additionalProperties": false }, "AdminSettingsActionInput": { "type": "object", "properties": { "revision": { "type": "integer", "minimum": 1, "maximum": 2147483646 }, "release_revision": { "type": "integer", "minimum": 0, "maximum": 2147483646 } }, "required": [ "revision", "release_revision" ], "additionalProperties": false }, "AdminCalendarReviewInput": { "type": "object", "properties": { "revision": { "type": "integer", "minimum": 1, "maximum": 2147483646 }, "reviewer_name": { "type": "string", "minLength": 1, "maxLength": 160 }, "review_notes": { "type": "string", "minLength": 1, "maxLength": 6000 } }, "required": [ "revision", "reviewer_name", "review_notes" ], "additionalProperties": false }, "AdminCalendarReleaseInput": { "type": "object", "properties": { "revision": { "type": "integer", "minimum": 1, "maximum": 2147483646 }, "publication_revision": { "type": "integer", "minimum": 0, "maximum": 2147483646 } }, "required": [ "revision", "publication_revision" ], "additionalProperties": false }, "AdminSupportReplyInput": { "type": "object", "properties": { "revision": { "type": "integer", "minimum": 1, "maximum": 2147483646 }, "message": { "type": "string", "minLength": 1, "maxLength": 8000 } }, "required": [ "revision", "message" ], "additionalProperties": false }, "AdminSupportNoteInput": { "type": "object", "properties": { "revision": { "type": "integer", "minimum": 1, "maximum": 2147483646 }, "body": { "type": "string", "minLength": 1, "maxLength": 8000 } }, "required": [ "revision", "body" ], "additionalProperties": false }, "AdminSupportAssignInput": { "type": "object", "properties": { "revision": { "type": "integer", "minimum": 1, "maximum": 2147483646 }, "assignee_id": { "oneOf": [ { "const": "" }, { "type": "string", "format": "uuid" } ] }, "priority": { "enum": [ "normal", "high" ] } }, "required": [ "revision", "priority" ], "additionalProperties": false }, "ReportTemplate": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 160 }, "report_kind": { "enum": [ "bazi", "ziwei", "business", "annual", "relationships", "date_selection" ] }, "subtitle": { "type": "string", "maxLength": 160 }, "introduction": { "type": "string", "maxLength": 1000 }, "closing_note": { "type": "string", "maxLength": 1000 }, "section_order": { "type": "array", "items": { "enum": [ "profile", "notes", "pillars", "elements", "luck", "annual", "daily", "dates", "comparison", "perspectives", "palaces", "variants", "sensitivity", "business", "sources" ] }, "minItems": 15, "maxItems": 15, "uniqueItems": true }, "headings": { "type": "object", "properties": { "profile": { "type": "string", "minLength": 1, "maxLength": 100 }, "notes": { "type": "string", "minLength": 1, "maxLength": 100 }, "pillars": { "type": "string", "minLength": 1, "maxLength": 100 }, "elements": { "type": "string", "minLength": 1, "maxLength": 100 }, "luck": { "type": "string", "minLength": 1, "maxLength": 100 }, "annual": { "type": "string", "minLength": 1, "maxLength": 100 }, "daily": { "type": "string", "minLength": 1, "maxLength": 100 }, "dates": { "type": "string", "minLength": 1, "maxLength": 100 }, "comparison": { "type": "string", "minLength": 1, "maxLength": 100 }, "perspectives": { "type": "string", "minLength": 1, "maxLength": 100 }, "palaces": { "type": "string", "minLength": 1, "maxLength": 100 }, "variants": { "type": "string", "minLength": 1, "maxLength": 100 }, "sensitivity": { "type": "string", "minLength": 1, "maxLength": 100 }, "business": { "type": "string", "minLength": 1, "maxLength": 100 } }, "required": [], "additionalProperties": false } }, "required": [ "name", "report_kind", "subtitle", "introduction", "closing_note", "section_order", "headings" ], "additionalProperties": false }, "ReportPresentation": { "type": "object", "properties": { "id": { "oneOf": [ { "const": "" }, { "type": "string", "format": "uuid" } ] }, "revision": { "type": "integer", "minimum": 0 }, "release_revision": { "type": "integer", "minimum": 0 }, "source": { "enum": [ "default", "published" ] }, "renderer_version": { "const": "de-report-presentation-1" }, "template": { "$ref": "#/components/schemas/ReportTemplate" } }, "required": [ "id", "revision", "release_revision", "source", "renderer_version", "template" ] }, "ReportTemplateCreate": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/ReportTemplate" }, "revision": { "const": 0 }, "version_of": { "type": "string", "format": "uuid" } }, "required": [ "data" ], "additionalProperties": false }, "ReportTemplateEdit": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/ReportTemplate" }, "revision": { "type": "integer", "minimum": 1, "maximum": 2147483646 } }, "required": [ "data", "revision" ], "additionalProperties": false }, "ReportTemplateRelease": { "type": "object", "properties": { "revision": { "type": "integer", "minimum": 1, "maximum": 2147483646 }, "release_revision": { "type": "integer", "minimum": 0, "maximum": 2147483646 } }, "required": [ "revision", "release_revision" ], "additionalProperties": false }, "PresentationBlock": { "type": "object", "properties": { "section": { "enum": [ "profile", "notes", "pillars", "elements", "luck", "annual", "daily", "dates", "comparison", "perspectives", "palaces", "variants", "sensitivity", "business", "sources" ] }, "heading": { "type": "string" }, "paragraphs": { "type": "array", "items": { "type": "string" } } }, "required": [ "heading", "paragraphs" ] }, "PresentationDocument": { "type": "object", "properties": { "title": { "type": "string" }, "brand": { "type": "string" }, "subtitle": { "type": "string" }, "footer": { "type": "string" }, "blocks": { "type": "array", "items": { "$ref": "#/components/schemas/PresentationBlock" } } }, "required": [ "title", "brand", "subtitle", "footer", "blocks" ] }, "ReportTemplatePreview": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "revision": { "type": "integer", "minimum": 2 }, "status": { "const": "preview" }, "preview": { "$ref": "#/components/schemas/PresentationDocument" } }, "required": [ "id", "revision", "status", "preview" ] }, "ReportTemplateRecord": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "data": { "$ref": "#/components/schemas/ReportTemplate" }, "revision": { "type": "integer", "minimum": 1 }, "status": { "enum": [ "draft", "preview", "published", "archived" ] }, "release_revision": { "type": "integer", "minimum": 0 }, "created_by": { "type": [ "string", "null" ] }, "approved_by": { "type": [ "string", "null" ] }, "created_at": { "type": "string", "format": "date-time" } }, "required": [ "id", "data", "revision", "status", "release_revision", "created_by", "approved_by", "created_at" ] }, "ReportTemplatePage": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/ReportTemplateRecord" } }, "next_cursor": { "type": "string" }, "report_kinds": { "type": "array", "items": { "enum": [ "bazi", "ziwei", "business", "annual", "relationships", "date_selection" ] } }, "sections": { "type": "array", "items": { "enum": [ "profile", "notes", "pillars", "elements", "luck", "annual", "daily", "dates", "comparison", "perspectives", "palaces", "variants", "sensitivity", "business", "sources" ] } }, "section_labels": { "type": "object", "properties": { "profile": { "type": "string" }, "notes": { "type": "string" }, "pillars": { "type": "string" }, "elements": { "type": "string" }, "luck": { "type": "string" }, "annual": { "type": "string" }, "daily": { "type": "string" }, "dates": { "type": "string" }, "comparison": { "type": "string" }, "perspectives": { "type": "string" }, "palaces": { "type": "string" }, "variants": { "type": "string" }, "sensitivity": { "type": "string" }, "business": { "type": "string" }, "sources": { "type": "string" } }, "required": [ "profile", "notes", "pillars", "elements", "luck", "annual", "daily", "dates", "comparison", "perspectives", "palaces", "variants", "sensitivity", "business", "sources" ] }, "defaults": { "$ref": "#/components/schemas/ReportTemplate" } }, "required": [ "items", "next_cursor", "report_kinds", "sections", "section_labels", "defaults" ] }, "RecoveryStatus": { "enum": [ "pending_review", "needs_information", "approved", "declined", "cancelled", "expired" ] }, "RecoveryMessage": { "type": "object", "properties": { "author": { "type": "string" }, "body": { "type": "string" }, "at": { "type": "string", "format": "date-time" } }, "required": [ "author", "body", "at" ] }, "RecoveryVerified": { "type": "object", "properties": { "reference": { "type": "string", "format": "uuid" }, "account_email": { "type": "string", "description": "Redacted claimed account email; account existence is not disclosed." }, "contact_email": { "type": "string", "format": "email" }, "status": { "$ref": "#/components/schemas/RecoveryStatus" }, "messages": { "type": "array", "items": { "$ref": "#/components/schemas/RecoveryMessage" } }, "created_at": { "type": "string", "format": "date-time" }, "updated_at": { "type": "string", "format": "date-time" }, "message": { "type": "string" } }, "required": [ "reference", "account_email", "contact_email", "status", "messages", "created_at", "updated_at", "message" ] }, "RecoveryVerifyRequest": { "type": "object", "properties": { "challenge_id": { "type": "string", "format": "uuid" }, "code": { "type": "string", "pattern": "^[0-9]{6}$" }, "reference": { "type": "string", "description": "Existing UUID reference, or empty for a new request." }, "account_email": { "type": "string" }, "description": { "type": "string", "maxLength": 4000 }, "message": { "type": "string", "maxLength": 4000 }, "action": { "enum": [ "", "check", "reply", "cancel" ] } }, "required": [ "challenge_id", "code" ], "additionalProperties": false, "description": "A new request requires a valid original account email and 20\u20134000 characters of ownership information. Existing requests require a UUID reference and a freshly verified matching contact address. Reply requires 10\u20134000 characters. No session or account is created." }, "RecoveryAdminRecord": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "account_email": { "type": "string" }, "contact_email": { "type": "string" }, "description": { "type": "string" }, "status": { "$ref": "#/components/schemas/RecoveryStatus" }, "messages": { "type": "array", "items": { "$ref": "#/components/schemas/RecoveryMessage" } }, "review_notes": { "type": "string" }, "reviewed_by": { "type": [ "string", "null" ], "format": "uuid" }, "contact_verified_at": { "type": "string", "format": "date-time" }, "revision": { "type": "integer", "minimum": 1 }, "created_at": { "type": "string", "format": "date-time" }, "updated_at": { "type": "string", "format": "date-time" }, "resolved_at": { "type": [ "string", "null" ], "format": "date-time" } }, "required": [ "id", "account_email", "contact_email", "description", "status", "messages", "review_notes", "reviewed_by", "contact_verified_at", "revision", "created_at", "updated_at", "resolved_at" ] }, "RecoveryAdminPage": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/RecoveryAdminRecord" } }, "next_cursor": { "$ref": "#/components/schemas/Cursor" } }, "required": [ "items", "next_cursor" ] }, "RecoveryReviewRequest": { "type": "object", "properties": { "revision": { "type": "integer", "minimum": 1 }, "notes": { "type": "string", "minLength": 20, "maxLength": 4000 }, "message": { "type": "string", "maxLength": 4000 }, "ownership_confirmed": { "type": "boolean" } }, "required": [ "revision", "notes" ], "additionalProperties": false }, "RecoveryReviewed": { "type": "object", "properties": { "status": { "$ref": "#/components/schemas/RecoveryStatus" }, "revision": { "type": "integer", "minimum": 2 } }, "required": [ "status", "revision" ] }, "MemberSummary": { "type": "object", "additionalProperties": false, "required": [ "id", "workspace_id", "email", "status", "timezone", "created_at", "revision", "roles", "administrator_active", "plan_id", "access_ends_at" ], "properties": { "id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "format": "uuid" }, "email": { "type": "string", "format": "email" }, "status": { "enum": [ "active", "suspended", "deleted" ] }, "timezone": { "type": "string" }, "created_at": { "type": "string", "format": "date-time" }, "revision": { "type": "integer", "minimum": 1 }, "roles": { "type": "array", "items": { "type": "string" } }, "administrator_active": { "type": "boolean" }, "plan_id": { "enum": [ "free", "seeker", "strategist", "practitioner" ] }, "access_ends_at": { "type": [ "string", "null" ], "format": "date-time" } } }, "MemberDetail": { "type": "object", "additionalProperties": false, "required": [ "id", "workspace_id", "email", "status", "timezone", "created_at", "revision", "roles", "administrator_active", "plan_id", "access_ends_at", "profile_count", "report_count", "last_sign_in_at", "last_active_at" ], "properties": { "id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "format": "uuid" }, "email": { "type": "string", "format": "email" }, "status": { "enum": [ "active", "suspended", "deleted" ] }, "timezone": { "type": "string" }, "created_at": { "type": "string", "format": "date-time" }, "revision": { "type": "integer", "minimum": 1 }, "roles": { "type": "array", "items": { "type": "string" } }, "administrator_active": { "type": "boolean" }, "plan_id": { "enum": [ "free", "seeker", "strategist", "practitioner" ] }, "access_ends_at": { "type": [ "string", "null" ], "format": "date-time" }, "profile_count": { "type": "integer", "minimum": 0 }, "report_count": { "type": "integer", "minimum": 0 }, "last_sign_in_at": { "type": [ "string", "null" ], "format": "date-time" }, "last_active_at": { "type": [ "string", "null" ], "format": "date-time" } } }, "MemberPage": { "type": "object", "required": [ "items", "next_cursor" ], "additionalProperties": false, "properties": { "items": { "type": "array", "maxItems": 100, "items": { "$ref": "#/components/schemas/MemberSummary" } }, "next_cursor": { "$ref": "#/components/schemas/Cursor" } } }, "ErrorCode": { "type": "string", "enum": [ "ACCOUNT_DELETED", "ACCOUNT_UNAVAILABLE", "ACCOUNT_UNCHANGED", "ACTIVE_SUBSCRIPTION", "ADMIN_ALREADY_INVITED", "ADMIN_REQUIRED", "AMBIGUOUS_LUNAR_DATE", "ASSET_STATE_CONFLICT", "AUTHOR_REQUIRED", "AUTH_REQUIRED", "BODY_TOO_LARGE", "CALCULATION_INPUT", "CALENDAR_REVALIDATION_REQUIRED", "CALENDAR_UNPUBLISHED", "CLIENT_LIMIT", "CONSENT_REQUIRED", "CONTACT_CLOSED", "CONTENT_SAVE_FAILED", "CONTENT_TOO_LONG", "CONTENT_UNAVAILABLE", "DATABASE_UNAVAILABLE", "DESTINATION_REVIEW_REQUIRED", "DUPLICATE_PROFILE", "EMAIL_EVENT_MISMATCH", "EMAIL_EVENT_REPLAY", "EMAIL_IN_USE", "EMAIL_WEBHOOK_UNCONFIGURED", "FILE_LIMIT", "FILE_REQUIRED", "FILE_TYPE", "FINANCIAL_COMMAND_REQUIRED", "IDEMPOTENCY_CONFLICT", "IDEMPOTENCY_REQUIRED", "INDEPENDENT_REVIEW_REQUIRED", "INTERNAL_ERROR", "INTERNAL_REQUIRED", "INVALID_ACTION", "INVALID_ACTION_INPUT", "INVALID_ACTIVITY", "INVALID_APPLICATION", "INVALID_ASSET", "INVALID_ASSIGNEE", "INVALID_ASSIGNMENT", "INVALID_BRANDING", "INVALID_CATEGORY", "INVALID_CHALLENGE", "INVALID_CLIENT", "INVALID_CODE", "INVALID_COMPARISON", "INVALID_CONFIGURATION", "INVALID_CONTACT", "INVALID_CONTENT", "INVALID_CONTENT_KIND", "INVALID_CORRECTION", "INVALID_CSRF", "INVALID_CURSOR", "INVALID_DATE", "INVALID_EMAIL", "INVALID_EMAIL_EVENT", "INVALID_EMAIL_SIGNATURE", "INVALID_EVENT", "INVALID_EXCLUSION", "INVALID_FEATURE", "INVALID_FILE", "INVALID_FILENAME", "INVALID_FLAG", "INVALID_ID", "INVALID_INPUT", "INVALID_INVOICE", "INVALID_KIND", "INVALID_LIMIT", "INVALID_LUNAR_DATE", "INVALID_MESSAGE", "INVALID_NAVIGATION", "INVALID_NOTIFICATION", "INVALID_OFFSET", "INVALID_ORDER", "INVALID_ORIGIN", "INVALID_PAYMENT_STATE", "INVALID_PERIOD", "INVALID_PLAN", "INVALID_PREFERENCE", "INVALID_PRIORITY", "INVALID_PROFILE", "INVALID_RANGE", "INVALID_REFUND", "INVALID_REPORT", "INVALID_RESOURCE", "INVALID_RETENTION", "INVALID_RETENTION_CONFIGURATION", "INVALID_REVISION", "INVALID_ROLE", "INVALID_ROLES", "INVALID_RULE", "INVALID_SEARCH", "INVALID_SETTING", "INVALID_SIGNATURE", "INVALID_SLUG", "INVALID_STATE", "INVALID_STATUS", "INVALID_STRUCTURED_CONTENT", "INVALID_SYSTEM_CONFIGURATION", "INVALID_TEMPLATE", "INVALID_TICKET", "INVALID_TIMEZONE", "INVALID_TITLE", "INVALID_UPGRADE", "INVALID_VERSION_PARENT", "INVALID_VIEW", "INVALID_WALLET_RESPONSE", "INVALID_WORKFLOW_FIELD", "INVALID_YEAR", "JOB_NOT_FAILED", "LAST_OWNER", "MAINTENANCE", "MAINTENANCE_MESSAGE_REQUIRED", "METHOD_NOT_ALLOWED", "METHOD_UNPUBLISHED", "MODULE_UNAVAILABLE", "NEW_REPORT_REQUIRED", "NOT_FOUND", "NOT_READY", "NO_ACTIVE_PERIOD", "OPERATION_UNAVAILABLE", "ORDER_COMPLETE", "OUTLOOK_BEFORE_BIRTH", "PAYMENT_MISMATCH", "PREVIEW_REQUIRED", "PROFILE_ARCHIVED", "PROFILE_CHANGED", "PROFILE_LIMIT", "PROFILE_READ_ONLY", "PROJECT_CONFIGURATION_REQUIRED", "PUBLICATION_CONFLICT", "PUBLICATION_FAILED", "PUBLICATION_REQUIRED", "QUOTA_EXCEEDED", "QUOTE_EXPIRED", "RATE_LIMITED", "RATE_LIMIT_UNAVAILABLE", "READ_ONLY", "REASON_REQUIRED", "RECOVERY_CONTACT_EXPIRED", "REFUND_ALREADY_REVIEWED", "REFUND_EXISTS", "RELEASE_REVISION_REQUIRED", "RENEWAL_FUNDED", "REPORT_TERMINAL", "REQUEST_VERIFICATION_FAILED", "REVIEW_REQUIRED", "REVISION_CONFLICT", "REVISION_REQUIRED", "ROLE_REQUIRED", "RULE_UNAVAILABLE", "SEARCH_LIMIT", "SELECTION_REQUIRED", "SELF_CHANGE", "SERVICE_UNAVAILABLE", "SESSION_EXPIRED", "SESSION_REQUIRED", "SETTINGS_RELEASE_CONFLICT", "SETTINGS_UNAVAILABLE", "SHARE_UNAVAILABLE", "SOURCE_REQUIRED", "STEP_UP_REQUIRED", "STORAGE_UNAVAILABLE", "SUBSCRIPTION_EXPIRED", "TEMPLATE_RELEASE_CONFLICT", "TEMPLATE_UNAVAILABLE", "TICKET_CLOSED", "TICKET_UNCHANGED", "TIME_REQUIRED", "UNSUPPORTED_DATE", "UNSUPPORTED_METHOD", "UPGRADE_REQUIRED", "VALIDATION_REQUIRED", "WALLET_ERROR", "WALLET_UNAVAILABLE" ], "description": "Owned backend error identifiers, derived from Go HTTP constructors. Client transport errors are separate." }, "ErrorCode401": { "type": "string", "enum": [ "AUTH_REQUIRED", "INVALID_SIGNATURE", "SESSION_EXPIRED", "SESSION_REQUIRED" ] }, "Error401": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "object", "required": [ "code", "message", "request_id", "field_errors" ], "properties": { "code": { "$ref": "#/components/schemas/ErrorCode401" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "field_errors": { "type": "object", "additionalProperties": { "type": "string" } } }, "additionalProperties": false } }, "additionalProperties": false, "description": "Structured HTTP 401 failure with status-specific codes. The field_errors object is always present and may be empty." }, "ErrorCode403": { "type": "string", "enum": [ "ACCOUNT_UNAVAILABLE", "ADMIN_REQUIRED", "CLIENT_LIMIT", "INDEPENDENT_REVIEW_REQUIRED", "INTERNAL_REQUIRED", "INVALID_CHALLENGE", "INVALID_CSRF", "INVALID_ORIGIN", "PROFILE_LIMIT", "PROFILE_READ_ONLY", "QUOTA_EXCEEDED", "READ_ONLY", "REQUEST_VERIFICATION_FAILED", "ROLE_REQUIRED", "STEP_UP_REQUIRED", "SUBSCRIPTION_EXPIRED", "UPGRADE_REQUIRED" ] }, "Error403": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "object", "required": [ "code", "message", "request_id", "field_errors" ], "properties": { "code": { "$ref": "#/components/schemas/ErrorCode403" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "field_errors": { "type": "object", "additionalProperties": { "type": "string" } } }, "additionalProperties": false } }, "additionalProperties": false, "description": "Structured HTTP 403 failure with status-specific codes. The field_errors object is always present and may be empty." }, "ErrorCode404": { "type": "string", "enum": [ "NOT_FOUND", "NOT_READY", "SHARE_UNAVAILABLE" ] }, "Error404": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "object", "required": [ "code", "message", "request_id", "field_errors" ], "properties": { "code": { "$ref": "#/components/schemas/ErrorCode404" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "field_errors": { "type": "object", "additionalProperties": { "type": "string" } } }, "additionalProperties": false } }, "additionalProperties": false, "description": "Structured HTTP 404 failure with status-specific codes. The field_errors object is always present and may be empty." }, "ErrorCode405": { "type": "string", "enum": [ "METHOD_NOT_ALLOWED", "OPERATION_UNAVAILABLE" ] }, "Error405": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "object", "required": [ "code", "message", "request_id", "field_errors" ], "properties": { "code": { "$ref": "#/components/schemas/ErrorCode405" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "field_errors": { "type": "object", "additionalProperties": { "type": "string" } } }, "additionalProperties": false } }, "additionalProperties": false, "description": "Structured HTTP 405 failure with status-specific codes. The field_errors object is always present and may be empty." }, "ErrorCode406": { "type": "string", "enum": [ "EMAIL_EVENT_MISMATCH", "EMAIL_EVENT_REPLAY", "INVALID_EMAIL_EVENT", "INVALID_EMAIL_SIGNATURE" ] }, "Error406": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "object", "required": [ "code", "message", "request_id", "field_errors" ], "properties": { "code": { "$ref": "#/components/schemas/ErrorCode406" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "field_errors": { "type": "object", "additionalProperties": { "type": "string" } } }, "additionalProperties": false } }, "additionalProperties": false, "description": "Structured HTTP 406 failure with status-specific codes. The field_errors object is always present and may be empty." }, "ErrorCode409": { "type": "string", "enum": [ "ACCOUNT_DELETED", "ACCOUNT_UNAVAILABLE", "ACCOUNT_UNCHANGED", "ADMIN_ALREADY_INVITED", "ASSET_STATE_CONFLICT", "AUTHOR_REQUIRED", "CONTACT_CLOSED", "EMAIL_IN_USE", "FINANCIAL_COMMAND_REQUIRED", "IDEMPOTENCY_CONFLICT", "INDEPENDENT_REVIEW_REQUIRED", "INVALID_INVOICE", "INVALID_STATE", "JOB_NOT_FAILED", "LAST_OWNER", "NEW_REPORT_REQUIRED", "ORDER_COMPLETE", "PAYMENT_MISMATCH", "PREVIEW_REQUIRED", "PROFILE_CHANGED", "PUBLICATION_CONFLICT", "PUBLICATION_REQUIRED", "QUOTE_EXPIRED", "RECOVERY_CONTACT_EXPIRED", "REFUND_ALREADY_REVIEWED", "REFUND_EXISTS", "RENEWAL_FUNDED", "REPORT_TERMINAL", "REVIEW_REQUIRED", "REVISION_CONFLICT", "SETTINGS_RELEASE_CONFLICT", "TEMPLATE_RELEASE_CONFLICT", "TICKET_CLOSED", "TICKET_UNCHANGED", "VALIDATION_REQUIRED" ] }, "Error409": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "object", "required": [ "code", "message", "request_id", "field_errors" ], "properties": { "code": { "$ref": "#/components/schemas/ErrorCode409" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "field_errors": { "type": "object", "additionalProperties": { "type": "string" } } }, "additionalProperties": false } }, "additionalProperties": false, "description": "Structured HTTP 409 failure with status-specific codes. The field_errors object is always present and may be empty." }, "ErrorCode413": { "type": "string", "enum": [ "BODY_TOO_LARGE" ] }, "Error413": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "object", "required": [ "code", "message", "request_id", "field_errors" ], "properties": { "code": { "$ref": "#/components/schemas/ErrorCode413" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "field_errors": { "type": "object", "additionalProperties": { "type": "string" } } }, "additionalProperties": false } }, "additionalProperties": false, "description": "Structured HTTP 413 failure with status-specific codes. The field_errors object is always present and may be empty." }, "ErrorCode422": { "type": "string", "enum": [ "ACTIVE_SUBSCRIPTION", "AMBIGUOUS_LUNAR_DATE", "CALCULATION_INPUT", "CONSENT_REQUIRED", "CONTENT_TOO_LONG", "DESTINATION_REVIEW_REQUIRED", "DUPLICATE_PROFILE", "FILE_LIMIT", "FILE_REQUIRED", "FILE_TYPE", "IDEMPOTENCY_REQUIRED", "INVALID_ACTION", "INVALID_ACTION_INPUT", "INVALID_ACTIVITY", "INVALID_APPLICATION", "INVALID_ASSET", "INVALID_ASSIGNEE", "INVALID_ASSIGNMENT", "INVALID_BRANDING", "INVALID_CATEGORY", "INVALID_CLIENT", "INVALID_CODE", "INVALID_COMPARISON", "INVALID_CONFIGURATION", "INVALID_CONTACT", "INVALID_CONTENT", "INVALID_CONTENT_KIND", "INVALID_CORRECTION", "INVALID_CURSOR", "INVALID_DATE", "INVALID_EMAIL", "INVALID_EVENT", "INVALID_EXCLUSION", "INVALID_FEATURE", "INVALID_FILE", "INVALID_FILENAME", "INVALID_FLAG", "INVALID_ID", "INVALID_INPUT", "INVALID_INVOICE", "INVALID_KIND", "INVALID_LIMIT", "INVALID_LUNAR_DATE", "INVALID_MESSAGE", "INVALID_NAVIGATION", "INVALID_NOTIFICATION", "INVALID_OFFSET", "INVALID_ORDER", "INVALID_PAYMENT_STATE", "INVALID_PERIOD", "INVALID_PLAN", "INVALID_PREFERENCE", "INVALID_PRIORITY", "INVALID_PROFILE", "INVALID_RANGE", "INVALID_REFUND", "INVALID_REPORT", "INVALID_RESOURCE", "INVALID_RETENTION", "INVALID_REVISION", "INVALID_ROLE", "INVALID_ROLES", "INVALID_RULE", "INVALID_SEARCH", "INVALID_SETTING", "INVALID_SLUG", "INVALID_STATUS", "INVALID_STRUCTURED_CONTENT", "INVALID_TEMPLATE", "INVALID_TICKET", "INVALID_TIMEZONE", "INVALID_TITLE", "INVALID_UPGRADE", "INVALID_VERSION_PARENT", "INVALID_VIEW", "INVALID_WORKFLOW_FIELD", "INVALID_YEAR", "MAINTENANCE_MESSAGE_REQUIRED", "NO_ACTIVE_PERIOD", "OUTLOOK_BEFORE_BIRTH", "PROFILE_ARCHIVED", "PROJECT_CONFIGURATION_REQUIRED", "REASON_REQUIRED", "RELEASE_REVISION_REQUIRED", "REVIEW_REQUIRED", "REVISION_REQUIRED", "SEARCH_LIMIT", "SELECTION_REQUIRED", "SELF_CHANGE", "SOURCE_REQUIRED", "TIME_REQUIRED", "UNSUPPORTED_DATE", "UNSUPPORTED_METHOD" ] }, "Error422": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "object", "required": [ "code", "message", "request_id", "field_errors" ], "properties": { "code": { "$ref": "#/components/schemas/ErrorCode422" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "field_errors": { "type": "object", "additionalProperties": { "type": "string" } } }, "additionalProperties": false } }, "additionalProperties": false, "description": "Structured HTTP 422 failure with status-specific codes. The field_errors object is always present and may be empty." }, "ErrorCode429": { "type": "string", "enum": [ "RATE_LIMITED" ] }, "Error429": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "object", "required": [ "code", "message", "request_id", "field_errors" ], "properties": { "code": { "$ref": "#/components/schemas/ErrorCode429" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "field_errors": { "type": "object", "additionalProperties": { "type": "string" } } }, "additionalProperties": false } }, "additionalProperties": false, "description": "Structured HTTP 429 failure with status-specific codes. The field_errors object is always present and may be empty." }, "ErrorCode500": { "type": "string", "enum": [ "INTERNAL_ERROR" ] }, "Error500": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "object", "required": [ "code", "message", "request_id", "field_errors" ], "properties": { "code": { "$ref": "#/components/schemas/ErrorCode500" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "field_errors": { "type": "object", "additionalProperties": { "type": "string" } } }, "additionalProperties": false } }, "additionalProperties": false, "description": "Structured HTTP 500 failure with status-specific codes. The field_errors object is always present and may be empty." }, "ErrorCode503": { "type": "string", "enum": [ "CALENDAR_REVALIDATION_REQUIRED", "CALENDAR_UNPUBLISHED", "CONTENT_SAVE_FAILED", "CONTENT_UNAVAILABLE", "DATABASE_UNAVAILABLE", "EMAIL_WEBHOOK_UNCONFIGURED", "INVALID_RETENTION_CONFIGURATION", "INVALID_SYSTEM_CONFIGURATION", "INVALID_WALLET_RESPONSE", "MAINTENANCE", "METHOD_UNPUBLISHED", "MODULE_UNAVAILABLE", "PUBLICATION_FAILED", "RATE_LIMIT_UNAVAILABLE", "RULE_UNAVAILABLE", "SERVICE_UNAVAILABLE", "SETTINGS_UNAVAILABLE", "STORAGE_UNAVAILABLE", "TEMPLATE_UNAVAILABLE", "WALLET_ERROR", "WALLET_UNAVAILABLE" ] }, "Error503": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "object", "required": [ "code", "message", "request_id", "field_errors" ], "properties": { "code": { "$ref": "#/components/schemas/ErrorCode503" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "field_errors": { "type": "object", "additionalProperties": { "type": "string" } } }, "additionalProperties": false } }, "additionalProperties": false, "description": "Structured HTTP 503 failure with status-specific codes. The field_errors object is always present and may be empty." } } } }