{"openapi": "3.1.0", "info": {"title": "GLCS League External Integration API", "version": "3.8.9", "description": "GLCS team divisions, independent player Elo, Premier Matchmaking queues, and player-authored team setup with manual admin captain approval and in-game home fields. Nightly Official SUB availability, random captain draws, and audited match-wide Elo weighting. Only fully rostered team appearances count toward the tournament minimum; outside SUB games still move ladder Elo. Manual admin queue suspensions and bans; no automatic disciplinary rules. Independent official captain and Premier Matchmaking QB reports, league-configured required stats, automatic agreement and admin dispute review. Scoped bot adapters share website services for SUBs, reports, stats, moderation and Team Journey. New Premier Matchmaking use Premier ready checks, total-position-Elo captains, group-first drafts, QB ballots, Away stadium ban and Home stadium pick, uniform selection and manual lobby creation. Premier captains report results. Site admins grant registered players scoped league permissions. Linked player admins may execute permitted operational bot commands; site settings, credentials, exports, season resets and grants remain site-admin only. Discord linking is required by default for all queue participants. Queue mutations return 403 with affected player names when required links are missing. Link players using website OAuth or the existing verified bot pairing endpoint. Server membership is not required. Players now authenticate through Discord OAuth. Public password registration/login is retired. New Discord profiles must choose a site display name at /join before queueing. Site admins may grant integrations permission to player developers to create/revoke their own API keys. Removing that permission permanently revokes all their keys. Developer-issued keys cannot act as the site administrator; linked player/captain/league-admin rights and token scopes remain required. Site admins can revoke any or all API keys. Approved team captains are automatically rostered; roster membership and Core promotion require no official game. Only official starter affiliations count toward the two-team seasonal free-agent restriction."}, "servers": [{"url": "https://YOUR-GLCS-DOMAIN", "description": "Replace with the deployed GLCS site HTTPS domain"}], "components": {"securitySchemes": {"BotBearer": {"type": "http", "scheme": "bearer", "description": "Issue from admin Account & Integrations page, /account."}, "PlayerSession": {"type": "apiKey", "in": "cookie", "name": "gfl_player_session"}, "StaffSession": {"type": "apiKey", "in": "cookie", "name": "gfl_session"}}, "parameters": {"DiscordUser": {"name": "X-GLCS-Discord-User-ID", "in": "header", "required": true, "schema": {"type": "string", "pattern": "^[0-9]{15,22}$"}, "description": "Server-verifiable Discord interaction user ID, linked by one-time code."}, "Idempotency": {"name": "Idempotency-Key", "in": "header", "required": true, "schema": {"type": "string", "minLength": 8, "maxLength": 120}, "description": "Unique key per attempted mutation, retained for safe retries."}, "ActorRole": {"name": "X-GLCS-Actor-Role", "in": "header", "required": false, "schema": {"type": "string", "enum": ["player", "captain", "admin", "league_admin"]}}}, "schemas": {"PlayerPositionElo": {"type": "object", "properties": {"role": {"enum": ["QB", "WR", "OL"]}, "elo": {"type": "number"}, "elo_rank": {"type": "string"}, "official_games": {"type": "integer"}, "scrim_games": {"type": "integer"}, "wins": {"type": "integer"}, "losses": {"type": "integer"}, "ties": {"type": "integer"}, "provisional": {"type": "boolean"}}}, "ScrimPositionPreferences": {"type": "object", "properties": {"player_code": {"type": "string", "pattern": "^GFL-[A-F0-9]{8}$"}, "primary_role": {"type": "string", "enum": ["QB", "WR", "OL", "FLEX"]}, "secondary_role": {"type": "string", "enum": ["", "QB", "WR", "OL", "FLEX"]}, "wants_qb": {"type": "boolean", "description": "Explicit consent to QB selection; considered even if primary/secondary is WR or OL."}, "role": {"type": "string", "enum": ["QB", "WR", "OL", "FLEX"], "deprecated": true, "description": "Legacy single-position signup; explicit legacy QB acts as a QB opt-in."}}}, "TeamJourneySetup": {"type": "object", "required": ["expected_revision"], "properties": {"expected_revision": {"type": "integer", "minimum": 0}, "team_name": {"type": "string", "maxLength": 70}, "description": {"type": "string", "maxLength": 600}, "home_field": {"type": ["string", "null"], "enum": ["digi", "moon", "underwater", null]}, "image": {"type": "string", "description": "PNG/JPEG/WebP base64 data URL; at most 350000 decoded bytes. Omit to retain a previously saved logo."}, "remove_logo": {"type": "boolean"}}}}}, "paths": {"/api/v1/health": {"get": {"summary": "Public readiness and database connectivity", "operationId": "health", "parameters": [], "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "400": {"description": "Invalid request"}, "403": {"description": "Authentication/permission failed"}, "404": {"description": "Unknown endpoint"}}}}, "/api/v1/docs": {"get": {"summary": "Public API summary", "operationId": "docs", "parameters": [], "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "400": {"description": "Invalid request"}, "403": {"description": "Authentication/permission failed"}, "404": {"description": "Unknown endpoint"}}}}, "/api/v1/openapi.json": {"get": {"summary": "Machine-readable OpenAPI description", "operationId": "openapi_json", "parameters": [], "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "400": {"description": "Invalid request"}, "403": {"description": "Authentication/permission failed"}, "404": {"description": "Unknown endpoint"}}}}, "/api/v1/whoami": {"get": {"summary": "API token and linked actor context", "operationId": "whoami", "parameters": [], "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "400": {"description": "Invalid request"}, "403": {"description": "Authentication/permission failed"}, "404": {"description": "Unknown endpoint"}}, "security": [{"BotBearer": []}]}}, "/api/v1/standings": {"get": {"summary": "Team Elo and tier ranking", "operationId": "standings", "parameters": [], "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "400": {"description": "Invalid request"}, "403": {"description": "Authentication/permission failed"}, "404": {"description": "Unknown endpoint"}}, "security": [{"BotBearer": []}]}}, "/api/v1/teams": {"get": {"summary": "Team rosters and Core Five", "operationId": "teams", "parameters": [], "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "400": {"description": "Invalid request"}, "403": {"description": "Authentication/permission failed"}, "404": {"description": "Unknown endpoint"}}, "security": [{"BotBearer": []}], "description": "Team directory or profile: team current_elo, ladder place, tier_key and tier_name division. Teams do not carry named player rank badges."}}, "/api/v1/players": {"get": {"summary": "Player directory and free agents", "operationId": "players", "parameters": [], "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "400": {"description": "Invalid request"}, "403": {"description": "Authentication/permission failed"}, "404": {"description": "Unknown endpoint"}}, "security": [{"BotBearer": []}]}}, "/api/v1/queue": {"get": {"summary": "Official nightly queue declarations", "operationId": "queue", "parameters": [{"name": "date", "in": "query", "required": false, "schema": {"type": "string", "format": "date"}}], "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "400": {"description": "Invalid request"}, "403": {"description": "Authentication/permission failed"}, "404": {"description": "Unknown endpoint"}}, "security": [{"BotBearer": []}]}}, "/api/v1/schedule": {"get": {"summary": "Published official schedule/results", "operationId": "schedule", "parameters": [{"name": "date", "in": "query", "required": false, "schema": {"type": "string", "format": "date"}}], "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "400": {"description": "Invalid request"}, "403": {"description": "Authentication/permission failed"}, "404": {"description": "Unknown endpoint"}}, "security": [{"BotBearer": []}]}}, "/api/v1/matches": {"get": {"summary": "Verified official game history and player IDs", "operationId": "matches", "parameters": [{"name": "date", "in": "query", "schema": {"type": "string", "format": "date"}}, {"name": "team_id", "in": "query", "schema": {"type": "integer"}}, {"name": "limit", "in": "query", "schema": {"type": "integer", "minimum": 1, "maximum": 300}}], "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "400": {"description": "Invalid request"}, "403": {"description": "Authentication/permission failed"}, "404": {"description": "Unknown endpoint"}}, "security": [{"BotBearer": []}]}}, "/api/v1/championships": {"get": {"summary": "Projected and official tournament brackets", "operationId": "championships", "parameters": [], "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "400": {"description": "Invalid request"}, "403": {"description": "Authentication/permission failed"}, "404": {"description": "Unknown endpoint"}}, "security": [{"BotBearer": []}]}}, "/api/v1/scrims": {"get": {"summary": "Current Premier Matchmaking queues and history", "operationId": "scrims", "parameters": [], "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "400": {"description": "Invalid request"}, "403": {"description": "Authentication/permission failed"}, "404": {"description": "Unknown endpoint"}}, "security": [{"BotBearer": []}], "description": "Live Premier Matchmaking state including persistent drafts, per-match positions, and summary.positions with required, available, missing, assigned, flex_available, can_fill and ready_to_play. FLEX is allocated to WR/OL once while respecting both sides. Queue players include primary_role, secondary_role, wants_qb, and qb_elo for eligible opt-ins. Drafts include qbs_ready and per-side qbs with identity, source and selection-time QB Elo."}}, "/api/v1/events": {"get": {"summary": "Monotonic, durable change-event feed", "operationId": "events", "parameters": [{"name": "after", "in": "query", "schema": {"type": "integer", "minimum": 0}}, {"name": "limit", "in": "query", "schema": {"type": "integer", "minimum": 1, "maximum": 250}}], "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "400": {"description": "Invalid request"}, "403": {"description": "Authentication/permission failed"}, "404": {"description": "Unknown endpoint"}}, "security": [{"BotBearer": []}]}}, "/api/v1/links/claim": {"post": {"summary": "Claim a 10-minute website-generated pairing code (link scope)", "security": [{"BotBearer": []}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "required": ["code", "discord_user_id"], "properties": {"code": {"type": "string"}, "discord_user_id": {"type": "string"}}}}}}, "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "400": {"description": "Invalid request"}, "403": {"description": "Authentication/permission failed"}, "404": {"description": "Unknown endpoint"}}}}, "/api/v1/commands/queue.upsert": {"post": {"summary": "queue.upsert: requires queue scope and linked GLCS account", "operationId": "cmd_queue_upsert", "description": "Scope: queue. The central GLCS league engine performs all role and game-rule validation. Send the same fields as the website action. See GLCS_V2_4_WEBSITE_AND_API.md for payload examples.", "security": [{"BotBearer": []}], "parameters": [{"$ref": "#/components/parameters/DiscordUser"}, {"$ref": "#/components/parameters/Idempotency"}, {"$ref": "#/components/parameters/ActorRole"}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "400": {"description": "Invalid request"}, "403": {"description": "Authentication/permission failed"}, "404": {"description": "Unknown endpoint"}}}}, "/api/v1/commands/roster.sign": {"post": {"summary": "roster.sign: requires roster scope and linked GLCS account", "operationId": "cmd_roster_sign", "description": "Scope: roster. The central GLCS league engine performs all role and game-rule validation. Send the same fields as the website action. See GLCS_V2_4_WEBSITE_AND_API.md for payload examples.", "security": [{"BotBearer": []}], "parameters": [{"$ref": "#/components/parameters/DiscordUser"}, {"$ref": "#/components/parameters/Idempotency"}, {"$ref": "#/components/parameters/ActorRole"}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "400": {"description": "Invalid request"}, "403": {"description": "Authentication/permission failed"}, "404": {"description": "Unknown endpoint"}}}}, "/api/v1/commands/roster.release": {"post": {"summary": "roster.release: requires roster scope and linked GLCS account", "operationId": "cmd_roster_release", "description": "Scope: roster. The central GLCS league engine performs all role and game-rule validation. Send the same fields as the website action. See GLCS_V2_4_WEBSITE_AND_API.md for payload examples.", "security": [{"BotBearer": []}], "parameters": [{"$ref": "#/components/parameters/DiscordUser"}, {"$ref": "#/components/parameters/Idempotency"}, {"$ref": "#/components/parameters/ActorRole"}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "400": {"description": "Invalid request"}, "403": {"description": "Authentication/permission failed"}, "404": {"description": "Unknown endpoint"}}}}, "/api/v1/commands/core.promote": {"post": {"summary": "core.promote: requires roster scope and linked GLCS account", "operationId": "cmd_core_promote", "description": "Scope: roster. The central GLCS league engine performs all role and game-rule validation. Send the same fields as the website action. See GLCS_V2_4_WEBSITE_AND_API.md for payload examples.", "security": [{"BotBearer": []}], "parameters": [{"$ref": "#/components/parameters/DiscordUser"}, {"$ref": "#/components/parameters/Idempotency"}, {"$ref": "#/components/parameters/ActorRole"}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "400": {"description": "Invalid request"}, "403": {"description": "Authentication/permission failed"}, "404": {"description": "Unknown endpoint"}}}}, "/api/v1/commands/core.retire": {"post": {"summary": "core.retire: requires roster scope and linked GLCS account", "operationId": "cmd_core_retire", "description": "Scope: roster. The central GLCS league engine performs all role and game-rule validation. Send the same fields as the website action. See GLCS_V2_4_WEBSITE_AND_API.md for payload examples.", "security": [{"BotBearer": []}], "parameters": [{"$ref": "#/components/parameters/DiscordUser"}, {"$ref": "#/components/parameters/Idempotency"}, {"$ref": "#/components/parameters/ActorRole"}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "400": {"description": "Invalid request"}, "403": {"description": "Authentication/permission failed"}, "404": {"description": "Unknown endpoint"}}}}, "/api/v1/commands/scrims.group": {"post": {"summary": "Premier Matchmaking.group: requires Premier Matchmaking scope and linked GLCS account", "operationId": "cmd_scrims_group", "description": "Captain-owned 4\u20137 player group. Each players[] item supplies player_code, primary_role, secondary_role and wants_qb. Each side selects a willing group QB first; unfilled QB slots use highest current-season QB Elo among opted-in solos. Group members stay together and group captains retain draft control.", "security": [{"BotBearer": []}], "parameters": [{"$ref": "#/components/parameters/DiscordUser"}, {"$ref": "#/components/parameters/Idempotency"}, {"$ref": "#/components/parameters/ActorRole"}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "required": ["players"], "properties": {"affiliation": {"type": "string"}, "players": {"type": "array", "minItems": 4, "maxItems": 7, "items": {"type": "object", "properties": {"player_code": {"type": "string", "pattern": "^GFL-[A-F0-9]{8}$"}, "primary_role": {"type": "string", "enum": ["QB", "WR", "OL", "FLEX"]}, "secondary_role": {"type": "string", "enum": ["", "QB", "WR", "OL", "FLEX"]}, "wants_qb": {"type": "boolean", "description": "Explicit consent to QB selection; considered even if primary/secondary is WR or OL."}, "role": {"type": "string", "enum": ["QB", "WR", "OL", "FLEX"], "deprecated": true, "description": "Legacy single-position signup; explicit legacy QB acts as a QB opt-in."}}}}}}}}}, "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "400": {"description": "Invalid request"}, "403": {"description": "Authentication/permission failed"}, "404": {"description": "Unknown endpoint"}}}}, "/api/v1/commands/scrims.volunteer": {"post": {"summary": "Premier Matchmaking.volunteer: requires Premier Matchmaking scope and linked GLCS account", "operationId": "cmd_scrims_volunteer", "description": "Join the authenticated player identity to the Premier Matchmaking solo pool with primary_role, optional secondary_role and wants_qb. Admin may select a saved player_code. Two opted-in highest-QB-Elo players captain a solo lobby. Players cannot spoof another identity. Legacy role payloads remain accepted.", "security": [{"BotBearer": []}], "parameters": [{"$ref": "#/components/parameters/DiscordUser"}, {"$ref": "#/components/parameters/Idempotency"}, {"$ref": "#/components/parameters/ActorRole"}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"player_code": {"type": "string", "pattern": "^GFL-[A-F0-9]{8}$"}, "primary_role": {"type": "string", "enum": ["QB", "WR", "OL", "FLEX"]}, "secondary_role": {"type": "string", "enum": ["", "QB", "WR", "OL", "FLEX"]}, "wants_qb": {"type": "boolean", "description": "Explicit consent to QB selection; considered even if primary/secondary is WR or OL."}, "role": {"type": "string", "enum": ["QB", "WR", "OL", "FLEX"], "deprecated": true, "description": "Legacy single-position signup; explicit legacy QB acts as a QB opt-in."}}}}}}, "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "400": {"description": "Invalid request"}, "403": {"description": "Authentication/permission failed"}, "404": {"description": "Unknown endpoint"}}}}, "/api/v1/commands/scrims.withdraw": {"post": {"summary": "Premier Matchmaking.withdraw: requires Premier Matchmaking scope and linked GLCS account", "operationId": "cmd_scrims_withdraw", "description": "Scope: Premier Matchmaking. The central GLCS league engine performs all role and game-rule validation. Send the same fields as the website action. See GLCS_V2_4_WEBSITE_AND_API.md for payload examples.", "security": [{"BotBearer": []}], "parameters": [{"$ref": "#/components/parameters/DiscordUser"}, {"$ref": "#/components/parameters/Idempotency"}, {"$ref": "#/components/parameters/ActorRole"}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "400": {"description": "Invalid request"}, "403": {"description": "Authentication/permission failed"}, "404": {"description": "Unknown endpoint"}}}}, "/api/v1/commands/scrims.queue.edit": {"post": {"summary": "Premier Matchmaking.queue.edit: requires Premier Matchmaking scope and linked GLCS account", "operationId": "cmd_scrims_queue_edit", "description": "Scope: Premier Matchmaking. The central GLCS league engine performs all role and game-rule validation. Send the same fields as the website action. See GLCS_V2_4_WEBSITE_AND_API.md for payload examples.", "security": [{"BotBearer": []}], "parameters": [{"$ref": "#/components/parameters/DiscordUser"}, {"$ref": "#/components/parameters/Idempotency"}, {"$ref": "#/components/parameters/ActorRole"}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "400": {"description": "Invalid request"}, "403": {"description": "Authentication/permission failed"}, "404": {"description": "Unknown endpoint"}}}}, "/api/v1/commands/scrims.match.player": {"post": {"summary": "Premier Matchmaking.match.player: requires Premier Matchmaking scope and linked GLCS account", "operationId": "cmd_scrims_match_player", "description": "Scope: Premier Matchmaking. The central GLCS league engine performs all role and game-rule validation. Send the same fields as the website action. See GLCS_V2_4_WEBSITE_AND_API.md for payload examples.", "security": [{"BotBearer": []}], "parameters": [{"$ref": "#/components/parameters/DiscordUser"}, {"$ref": "#/components/parameters/Idempotency"}, {"$ref": "#/components/parameters/ActorRole"}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "400": {"description": "Invalid request"}, "403": {"description": "Authentication/permission failed"}, "404": {"description": "Unknown endpoint"}}}}, "/api/v1/commands/scrims.match.cancel": {"post": {"summary": "Premier Matchmaking.match.cancel: requires Premier Matchmaking scope and linked GLCS account", "operationId": "cmd_scrims_match_cancel", "description": "Scope: Premier Matchmaking. The central GLCS league engine performs all role and game-rule validation. Send the same fields as the website action. See GLCS_V2_4_WEBSITE_AND_API.md for payload examples.", "security": [{"BotBearer": []}], "parameters": [{"$ref": "#/components/parameters/DiscordUser"}, {"$ref": "#/components/parameters/Idempotency"}, {"$ref": "#/components/parameters/ActorRole"}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "400": {"description": "Invalid request"}, "403": {"description": "Authentication/permission failed"}, "404": {"description": "Unknown endpoint"}}}}, "/api/v1/commands/scrims.match.result": {"post": {"summary": "Premier Matchmaking.match.result: requires Premier Matchmaking scope and linked GLCS account", "operationId": "cmd_scrims_match_result", "description": "Scope: Premier Matchmaking. The central GLCS league engine performs all role and game-rule validation. Send the same fields as the website action. See GLCS_V2_4_WEBSITE_AND_API.md for payload examples.", "security": [{"BotBearer": []}], "parameters": [{"$ref": "#/components/parameters/DiscordUser"}, {"$ref": "#/components/parameters/Idempotency"}, {"$ref": "#/components/parameters/ActorRole"}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "400": {"description": "Invalid request"}, "403": {"description": "Authentication/permission failed"}, "404": {"description": "Unknown endpoint"}}}}, "/api/v1/commands/games.result": {"post": {"summary": "games.result: requires admin scope and linked GLCS account", "operationId": "cmd_games_result", "description": "Scope: admin. The central GLCS league engine performs all role and game-rule validation. Send the same fields as the website action. See GLCS_V2_4_WEBSITE_AND_API.md for payload examples. Optional player_positions maps every verified participant Player ID to the actual QB, WR or OL position. Modern website scorecards supply this map. Missing positions keep the complete match pending for player Elo, without blocking team result recording. Official and postseason results use K=32. Corrections require the existing audit reason.", "security": [{"BotBearer": []}], "parameters": [{"$ref": "#/components/parameters/DiscordUser"}, {"$ref": "#/components/parameters/Idempotency"}, {"$ref": "#/components/parameters/ActorRole"}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "400": {"description": "Invalid request"}, "403": {"description": "Authentication/permission failed"}, "404": {"description": "Unknown endpoint"}}}}, "/api/v1/commands/games.manual": {"post": {"summary": "games.manual: requires admin scope and linked GLCS account", "operationId": "cmd_games_manual", "description": "Scope: admin. The central GLCS league engine performs all role and game-rule validation. Send the same fields as the website action. See GLCS_V2_4_WEBSITE_AND_API.md for payload examples.", "security": [{"BotBearer": []}], "parameters": [{"$ref": "#/components/parameters/DiscordUser"}, {"$ref": "#/components/parameters/Idempotency"}, {"$ref": "#/components/parameters/ActorRole"}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "400": {"description": "Invalid request"}, "403": {"description": "Authentication/permission failed"}, "404": {"description": "Unknown endpoint"}}}}, "/api/v1/commands/nights.generate": {"post": {"summary": "nights.generate: requires admin scope and linked GLCS account", "operationId": "cmd_nights_generate", "description": "Scope: admin. The central GLCS league engine performs all role and game-rule validation. Send the same fields as the website action. See GLCS_V2_4_WEBSITE_AND_API.md for payload examples.", "security": [{"BotBearer": []}], "parameters": [{"$ref": "#/components/parameters/DiscordUser"}, {"$ref": "#/components/parameters/Idempotency"}, {"$ref": "#/components/parameters/ActorRole"}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "400": {"description": "Invalid request"}, "403": {"description": "Authentication/permission failed"}, "404": {"description": "Unknown endpoint"}}}}, "/api/v1/commands/nights.publish": {"post": {"summary": "nights.publish: requires admin scope and linked GLCS account", "operationId": "cmd_nights_publish", "description": "Scope: admin. The central GLCS league engine performs all role and game-rule validation. Send the same fields as the website action. See GLCS_V2_4_WEBSITE_AND_API.md for payload examples.", "security": [{"BotBearer": []}], "parameters": [{"$ref": "#/components/parameters/DiscordUser"}, {"$ref": "#/components/parameters/Idempotency"}, {"$ref": "#/components/parameters/ActorRole"}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "400": {"description": "Invalid request"}, "403": {"description": "Authentication/permission failed"}, "404": {"description": "Unknown endpoint"}}}}, "/api/v1/commands/nights.finalize": {"post": {"summary": "nights.finalize: requires admin scope and linked GLCS account", "operationId": "cmd_nights_finalize", "description": "Scope: admin. The central GLCS league engine performs all role and game-rule validation. Send the same fields as the website action. See GLCS_V2_4_WEBSITE_AND_API.md for payload examples.", "security": [{"BotBearer": []}], "parameters": [{"$ref": "#/components/parameters/DiscordUser"}, {"$ref": "#/components/parameters/Idempotency"}, {"$ref": "#/components/parameters/ActorRole"}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "400": {"description": "Invalid request"}, "403": {"description": "Authentication/permission failed"}, "404": {"description": "Unknown endpoint"}}}}, "/api/v1/commands/championships.create": {"post": {"summary": "championships.create: requires admin scope and linked GLCS account", "operationId": "cmd_championships_create", "description": "Scope: admin. The central GLCS league engine performs all role and game-rule validation. Send the same fields as the website action. See GLCS_V2_4_WEBSITE_AND_API.md for payload examples.", "security": [{"BotBearer": []}], "parameters": [{"$ref": "#/components/parameters/DiscordUser"}, {"$ref": "#/components/parameters/Idempotency"}, {"$ref": "#/components/parameters/ActorRole"}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "400": {"description": "Invalid request"}, "403": {"description": "Authentication/permission failed"}, "404": {"description": "Unknown endpoint"}}}}, "/api/v1/commands/championships.result": {"post": {"summary": "championships.result: requires admin scope and linked GLCS account", "operationId": "cmd_championships_result", "description": "Scope: admin. The central GLCS league engine performs all role and game-rule validation. Send the same fields as the website action. See GLCS_V2_4_WEBSITE_AND_API.md for payload examples. Optional player_positions maps every verified participant Player ID to the actual QB, WR or OL position. Modern website scorecards supply this map. Missing positions keep the complete match pending for player Elo, without blocking team result recording. Official and postseason results use K=32. Corrections require the existing audit reason.", "security": [{"BotBearer": []}], "parameters": [{"$ref": "#/components/parameters/DiscordUser"}, {"$ref": "#/components/parameters/Idempotency"}, {"$ref": "#/components/parameters/ActorRole"}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "400": {"description": "Invalid request"}, "403": {"description": "Authentication/permission failed"}, "404": {"description": "Unknown endpoint"}}}}, "/api/v1/commands/players.create": {"post": {"summary": "players.create: requires admin scope and linked GLCS account", "operationId": "cmd_players_create", "description": "Scope: admin. The central GLCS league engine performs all role and game-rule validation. Send the same fields as the website action. See GLCS_V2_4_WEBSITE_AND_API.md for payload examples.", "security": [{"BotBearer": []}], "parameters": [{"$ref": "#/components/parameters/DiscordUser"}, {"$ref": "#/components/parameters/Idempotency"}, {"$ref": "#/components/parameters/ActorRole"}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "400": {"description": "Invalid request"}, "403": {"description": "Authentication/permission failed"}, "404": {"description": "Unknown endpoint"}}}}, "/api/v1/commands/seasons.transition": {"post": {"summary": "seasons.transition: requires admin scope and linked GLCS account", "operationId": "cmd_seasons_transition", "description": "Scope: admin. The central GLCS league engine performs all role and game-rule validation. Send the same fields as the website action. See GLCS_V2_4_WEBSITE_AND_API.md for payload examples.", "security": [{"BotBearer": []}], "parameters": [{"$ref": "#/components/parameters/DiscordUser"}, {"$ref": "#/components/parameters/Idempotency"}, {"$ref": "#/components/parameters/ActorRole"}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "400": {"description": "Invalid request"}, "403": {"description": "Authentication/permission failed"}, "404": {"description": "Unknown endpoint"}}}}, "/api/v1/teams/{team_id}/profile": {"get": {"summary": "Get public team profile, lineup, match history and tier championship records", "security": [{"BotBearer": []}], "parameters": [{"name": "team_id", "in": "path", "required": true, "schema": {"type": "integer", "minimum": 1}}], "responses": {"200": {"description": "Read-only team profile; same fields as /api/public/teams/{team_id}"}, "403": {"description": "Missing read scope or invalid token"}, "404": {"description": "Unknown team"}}, "description": "Team directory or profile: team current_elo, ladder place, tier_key and tier_name division. Teams do not carry named player rank badges."}}, "/api/public/teams": {"get": {"summary": "Public teams with Elo rank and APEX/Challengers/Open division", "responses": {"200": {"description": "Team listing includes elo_rank, elo_rank_reset, elo_rank_color, tier_key, tier_name and ladder rank."}}, "description": "Team directory or profile: team current_elo, ladder place, tier_key and tier_name division. Teams do not carry named player rank badges."}}, "/api/public/teams/{team_id}": {"get": {"summary": "Public profile with Core Five lineup, match history, stats and tier records", "security": [], "parameters": [{"name": "team_id", "in": "path", "required": true, "schema": {"type": "integer", "minimum": 1}}], "responses": {"200": {"description": "Team profile and playoff records"}, "404": {"description": "Unknown team"}}, "description": "Team directory or profile: team current_elo, ladder place, tier_key and tier_name division. Teams do not carry named player rank badges."}}, "/api/v1/player-rankings": {"get": {"summary": "Verified official player stat leaderboards and Elo-weighted skill tiers", "operationId": "playerRankings", "parameters": [{"name": "scope", "in": "query", "required": false, "schema": {"type": "string", "enum": ["season", "all_time"], "default": "season"}}, {"name": "limit", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 1, "maximum": 100, "default": 20}}], "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "400": {"description": "Invalid request"}, "403": {"description": "Authentication/permission failed"}, "404": {"description": "Unknown endpoint"}}, "security": [{"BotBearer": []}], "description": "Independent QB, WR and OL player Elo ladders from verified results. Starting Elo 1500, official K=32, Premier Matchmaking K=16. Each individual compares with the average pre-match position Elo of ALL opponents. scope=season or all_time. Named ranks use player Elo bands. Official statistics remain separate boards."}}, "/api/public/player-rankings": {"get": {"summary": "Public season/all-time statistical boards and three independent QB/WR/OL Top 100 lists", "parameters": [{"name": "scope", "in": "query", "required": false, "schema": {"type": "string", "enum": ["season", "all_time"]}}, {"name": "limit", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 1, "maximum": 100}}], "responses": {"200": {"description": "Role-specific rank and tier, with rated_by_position and ranked_by_position counts. Public access."}}, "description": "Independent QB, WR and OL player Elo ladders from verified results. Starting Elo 1500, official K=32, Premier Matchmaking K=16. Each individual compares with the average pre-match position Elo of ALL opponents. scope=season or all_time. Named ranks use player Elo bands. Official statistics remain separate boards."}}, "/api/v1/recruitment": {"get": {"summary": "Read a linked player\u2019s team applications or a linked captain\u2019s team inbox", "operationId": "recruitmentInbox", "parameters": [{"name": "X-GLCS-Discord-User-ID", "in": "header", "required": true, "schema": {"type": "string"}, "description": "Linked Discord user ID"}, {"name": "team_id", "in": "query", "required": false, "schema": {"type": "integer"}, "description": "For captain/admin team inbox; players omit to view own applications"}], "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "400": {"description": "Invalid request"}, "403": {"description": "Authentication/permission failed"}, "404": {"description": "Unknown endpoint"}}, "security": [{"BotBearer": []}]}}, "/api/v1/profile/preferences": {"get": {"summary": "Read a linked player onboarding profile, choices and current applications", "operationId": "playerOnboardingProfile", "parameters": [{"name": "X-GLCS-Discord-User-ID", "in": "header", "required": true, "schema": {"type": "string"}}], "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "400": {"description": "Invalid request"}, "403": {"description": "Authentication/permission failed"}, "404": {"description": "Unknown endpoint"}}, "security": [{"BotBearer": []}]}}, "/api/v1/commands/profile.preferences": {"post": {"summary": "Update linked player competitive preferences", "operationId": "profilePreferences", "description": "Scope: roster. The central GLCS league engine performs all role and game-rule validation. Send the same fields as the website action. See GLCS_V2_4_WEBSITE_AND_API.md for payload examples.", "security": [{"BotBearer": []}], "parameters": [{"$ref": "#/components/parameters/DiscordUser"}, {"$ref": "#/components/parameters/Idempotency"}, {"$ref": "#/components/parameters/ActorRole"}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "400": {"description": "Invalid request"}, "403": {"description": "Authentication/permission failed"}, "404": {"description": "Unknown endpoint"}}}}, "/api/v1/commands/recruitment.apply": {"post": {"summary": "Send a linked player team application", "operationId": "recruitmentApply", "description": "Scope: roster. The central GLCS league engine performs all role and game-rule validation. Send the same fields as the website action. See GLCS_V2_4_WEBSITE_AND_API.md for payload examples.", "security": [{"BotBearer": []}], "parameters": [{"$ref": "#/components/parameters/DiscordUser"}, {"$ref": "#/components/parameters/Idempotency"}, {"$ref": "#/components/parameters/ActorRole"}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "400": {"description": "Invalid request"}, "403": {"description": "Authentication/permission failed"}, "404": {"description": "Unknown endpoint"}}}}, "/api/v1/commands/recruitment.withdraw": {"post": {"summary": "Withdraw linked player pending application", "operationId": "recruitmentWithdraw", "description": "Scope: roster. The central GLCS league engine performs all role and game-rule validation. Send the same fields as the website action. See GLCS_V2_4_WEBSITE_AND_API.md for payload examples.", "security": [{"BotBearer": []}], "parameters": [{"$ref": "#/components/parameters/DiscordUser"}, {"$ref": "#/components/parameters/Idempotency"}, {"$ref": "#/components/parameters/ActorRole"}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "400": {"description": "Invalid request"}, "403": {"description": "Authentication/permission failed"}, "404": {"description": "Unknown endpoint"}}}}, "/api/v1/commands/recruitment.review": {"post": {"summary": "Captain/admin approve or decline an eligible application", "operationId": "recruitmentReview", "description": "Scope: roster. The central GLCS league engine performs all role and game-rule validation. Send the same fields as the website action. See GLCS_V2_4_WEBSITE_AND_API.md for payload examples.", "security": [{"BotBearer": []}], "parameters": [{"$ref": "#/components/parameters/DiscordUser"}, {"$ref": "#/components/parameters/Idempotency"}, {"$ref": "#/components/parameters/ActorRole"}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "400": {"description": "Invalid request"}, "403": {"description": "Authentication/permission failed"}, "404": {"description": "Unknown endpoint"}}}}, "/api/v1/pickem/markets": {"get": {"summary": "Frozen published predictive spreads/totals and linked user restrictions", "operationId": "marketsPickem", "parameters": [], "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "400": {"description": "Invalid request"}, "403": {"description": "Authentication/permission failed"}, "404": {"description": "Unknown endpoint"}}, "security": [{"BotBearer": []}]}}, "/api/v1/pickem/leaderboard": {"get": {"summary": "Season-long virtual points balance leaderboard", "operationId": "leaderboardPickem", "parameters": [], "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "400": {"description": "Invalid request"}, "403": {"description": "Authentication/permission failed"}, "404": {"description": "Unknown endpoint"}}, "security": [{"BotBearer": []}]}}, "/api/v1/pickem/wallet": {"get": {"summary": "Private, linked-player Pick\u2019em wallet and ticket history", "operationId": "walletPickem", "parameters": [], "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "400": {"description": "Invalid request"}, "403": {"description": "Authentication/permission failed"}, "404": {"description": "Unknown endpoint"}}, "security": [{"BotBearer": []}]}}, "/api/v1/commands/pickem.enroll": {"post": {"summary": "Link the player to the Pick\u2019em contest with +100 starting points", "description": "Requires Pick\u2019em API scope, linked Player ID, X-GLCS-Discord-User-ID and Idempotency-Key.", "security": [{"BotBearer": []}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "responses": {"200": {"description": "Success"}, "400": {"description": "Invalid pick"}, "403": {"description": "Permission denied"}}}}, "/api/v1/commands/pickem.place": {"post": {"summary": "Place a verified league-points straight pick or parlay; enforce own-team rule", "description": "Requires Pick\u2019em API scope, linked Player ID, X-GLCS-Discord-User-ID and Idempotency-Key.", "security": [{"BotBearer": []}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "responses": {"200": {"description": "Success"}, "400": {"description": "Invalid pick"}, "403": {"description": "Permission denied"}}}}, "/api/v1/pickem/rules": {"get": {"summary": "View current league virtual-points economy settings", "description": "Read-only. Current reward amounts and optional schedule refill policy. Requires a read-scoped GLCS API token.", "security": [{"BearerAuth": []}], "responses": {"200": {"description": "Current Pick\u2019em economy configuration"}}}}, "/api/v1/commands/scrims.draft.pick": {"post": {"summary": "Captain draft pick: requires Premier Matchmaking scope and the linked captain account", "operationId": "cmd_scrims_draft_pick", "description": "Group draft: owning captain identity. Solo draft: randomly selected QB player identity. Payload includes match_id, player_code, expected_pick (zero-based completed pick count). The server checks turn, reservation and role feasibility. Idempotency-Key required.", "security": [{"BotBearer": []}], "parameters": [{"$ref": "#/components/parameters/DiscordUser"}, {"$ref": "#/components/parameters/Idempotency"}, {"$ref": "#/components/parameters/ActorRole"}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "required": ["match_id", "player_code", "expected_pick"], "properties": {"match_id": {"type": "integer", "minimum": 1}, "player_code": {"type": "string", "pattern": "^GFL-[A-F0-9]{8}$"}, "expected_pick": {"type": "integer", "minimum": 0}}}}}}, "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}, "400": {"description": "Invalid request"}, "403": {"description": "Authentication/permission failed"}, "404": {"description": "Unknown endpoint"}}}}, "/api/scrims/draft/pick": {"post": {"summary": "Website captain draft pick (session authentication)", "operationId": "web_scrims_draft_pick", "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "required": ["match_id", "player_code", "expected_pick"], "properties": {"match_id": {"type": "integer", "minimum": 1}, "player_code": {"type": "string", "pattern": "^GFL-[A-F0-9]{8}$"}, "expected_pick": {"type": "integer", "minimum": 0}}}}}}, "responses": {"200": {"description": "Pick saved; match may now be ready"}, "400": {"description": "Stale pick or invalid player/role"}, "403": {"description": "Not the captain on the clock"}}}}, "/api/team-journey/stadiums": {"get": {"summary": "The three allowed in-game home fields and bundled image URLs", "security": [], "responses": {"200": {"description": "Successful response"}, "400": {"description": "Invalid or stale setup/decision"}, "403": {"description": "Account does not have the required access"}}}}, "/api/team-journey/me": {"get": {"summary": "Own setup, current captain access and approved team; optional admin team_id query", "security": [{}, {"PlayerSession": []}, {"StaffSession": []}], "responses": {"200": {"description": "Successful response"}, "400": {"description": "Invalid or stale setup/decision"}, "403": {"description": "Account does not have the required access"}}}}, "/api/team-journey/save": {"post": {"summary": "Save own private team setup draft", "security": [{"PlayerSession": []}], "responses": {"200": {"description": "Successful response"}, "400": {"description": "Invalid or stale setup/decision"}, "403": {"description": "Account does not have the required access"}}, "requestBody": {"required": true, "content": {"application/json": {"schema": {"$ref": "#/components/schemas/TeamJourneySetup"}}}}}}, "/api/team-journey/submit": {"post": {"summary": "Submit complete team name, logo, home field and captain request for manual review", "security": [{"PlayerSession": []}], "responses": {"200": {"description": "Successful response"}, "400": {"description": "Invalid or stale setup/decision"}, "403": {"description": "Account does not have the required access"}}, "requestBody": {"required": true, "content": {"application/json": {"schema": {"$ref": "#/components/schemas/TeamJourneySetup"}}}}}}, "/api/team-journey/withdraw": {"post": {"summary": "Withdraw own pending setup to edit and resubmit", "security": [{"PlayerSession": []}], "responses": {"200": {"description": "Successful response"}, "400": {"description": "Invalid or stale setup/decision"}, "403": {"description": "Account does not have the required access"}}}}, "/api/team-journey/requests": {"get": {"summary": "Admin list of submitted requests; status pending, approved, rejected or all", "security": [{"StaffSession": []}], "responses": {"200": {"description": "Successful response"}, "400": {"description": "Invalid or stale setup/decision"}, "403": {"description": "Account does not have the required access"}}}}, "/api/team-journey/requests/{id}/review": {"post": {"summary": "Admin-only approve or reject; approval creates a 1500 Elo team and player-linked captain account", "security": [{"StaffSession": []}], "responses": {"200": {"description": "Successful response"}, "400": {"description": "Invalid or stale setup/decision"}, "403": {"description": "Account does not have the required access"}}, "parameters": [{"name": "id", "in": "path", "required": true, "schema": {"type": "integer", "minimum": 1}}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "required": ["decision", "reason", "expected_revision"], "properties": {"decision": {"enum": ["approve", "reject"]}, "reason": {"type": "string", "minLength": 5, "maxLength": 600}, "expected_revision": {"type": "integer"}}}}}}}}, "/api/team-journey/requests/{id}/logo": {"get": {"summary": "Private request logo; owner Player ID or admin only", "security": [{"PlayerSession": []}, {"StaffSession": []}], "responses": {"200": {"description": "Successful response"}, "400": {"description": "Invalid or stale setup/decision"}, "403": {"description": "Account does not have the required access"}}, "parameters": [{"name": "id", "in": "path", "required": true, "schema": {"type": "integer", "minimum": 1}}]}}, "/api/team-journey/team": {"post": {"summary": "Approved own-team captain home/logo update; admins may explicitly select team_id", "security": [{"PlayerSession": []}, {"StaffSession": []}], "responses": {"200": {"description": "Successful response"}, "400": {"description": "Invalid or stale setup/decision"}, "403": {"description": "Account does not have the required access"}}}}, "/api/official-subs/state": {"get": {"summary": "View nightly Official SUB queue and viewer eligibility", "tags": ["Official SUB"], "responses": {"200": {"description": "Current state or successful operation"}, "400": {"description": "Invalid request or queue not available"}, "403": {"description": "Not authorized or ineligible"}}, "parameters": [{"in": "query", "name": "date", "schema": {"type": "string", "format": "date"}, "description": "Eastern league date; defaults to today."}]}}, "/api/official-subs/join": {"post": {"summary": "Volunteer the signed-in player", "tags": ["Official SUB"], "responses": {"200": {"description": "Current state or successful operation"}, "400": {"description": "Invalid request or queue not available"}, "403": {"description": "Not authorized or ineligible"}}, "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"date": {"type": "string", "format": "date"}, "role": {"enum": ["QB", "WR", "OL", "FLEX"]}}, "required": ["date", "role"]}}}}, "description": "Browser session cookie required. See GLCS_V3_3_0_OFFICIAL_SUB_QUEUE.md. Captains may draw/release only for their own team."}}, "/api/official-subs/leave": {"post": {"summary": "Withdraw the signed-in player", "tags": ["Official SUB"], "responses": {"200": {"description": "Current state or successful operation"}, "400": {"description": "Invalid request or queue not available"}, "403": {"description": "Not authorized or ineligible"}}, "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"date": {"type": "string", "format": "date"}}, "required": ["date"]}}}}, "description": "Browser session cookie required. See GLCS_V3_3_0_OFFICIAL_SUB_QUEUE.md. Captains may draw/release only for their own team."}}, "/api/official-subs/draw": {"post": {"summary": "Randomly reserve a queued SUB for own-team game", "tags": ["Official SUB"], "responses": {"200": {"description": "Current state or successful operation"}, "400": {"description": "Invalid request or queue not available"}, "403": {"description": "Not authorized or ineligible"}}, "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"game_id": {"type": "integer"}, "team_id": {"type": "integer"}, "role": {"enum": ["ANY", "QB", "WR", "OL", "FLEX"]}, "request_key": {"type": "string", "minLength": 8, "maxLength": 100}}, "required": ["game_id", "team_id", "request_key"]}}}}, "description": "Browser session cookie required. See GLCS_V3_3_0_OFFICIAL_SUB_QUEUE.md. Captains may draw/release only for their own team."}}, "/api/official-subs/release": {"post": {"summary": "Release an unused SUB assignment", "tags": ["Official SUB"], "responses": {"200": {"description": "Current state or successful operation"}, "400": {"description": "Invalid request or queue not available"}, "403": {"description": "Not authorized or ineligible"}}, "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"assignment_id": {"type": "integer"}, "reason": {"type": "string", "minLength": 5, "maxLength": 400}}, "required": ["assignment_id", "reason"]}}}}, "description": "Browser session cookie required. See GLCS_V3_3_0_OFFICIAL_SUB_QUEUE.md. Captains may draw/release only for their own team."}}, "/api/queue-restrictions/state": {"get": {"summary": "Admin restriction history and player picker", "tags": ["Queue Restrictions"], "responses": {"200": {"description": "Queue restriction state or successful manual action"}, "400": {"description": "Invalid action, reason, duration or existing active restriction"}, "403": {"description": "Admin session required"}}, "description": "Browser session endpoint. Only admins manage restrictions; /me exposes only the signed-in player\u2019s active kind/expiry. See GLCS_V3_4_0_QUEUE_SUSPENSIONS_BANS.md."}}, "/api/queue-restrictions/impose": {"post": {"summary": "Admin manually suspends or bans player from queues", "tags": ["Queue Restrictions"], "responses": {"200": {"description": "Queue restriction state or successful manual action"}, "400": {"description": "Invalid action, reason, duration or existing active restriction"}, "403": {"description": "Admin session required"}}, "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"player_code": {"type": "string"}, "kind": {"enum": ["suspension", "ban"]}, "reason": {"type": "string", "minLength": 5, "maxLength": 1000}, "duration_days": {"type": ["integer", "null"], "minimum": 1, "maximum": 3650}}, "required": ["player_code", "kind", "reason"]}}}}, "description": "Browser session endpoint. Only admins manage restrictions; /me exposes only the signed-in player\u2019s active kind/expiry. See GLCS_V3_4_0_QUEUE_SUSPENSIONS_BANS.md."}}, "/api/queue-restrictions/lift": {"post": {"summary": "Admin manually lifts a saved queue restriction", "tags": ["Queue Restrictions"], "responses": {"200": {"description": "Queue restriction state or successful manual action"}, "400": {"description": "Invalid action, reason, duration or existing active restriction"}, "403": {"description": "Admin session required"}}, "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"id": {"type": "integer"}, "reason": {"type": "string", "minLength": 5, "maxLength": 1000}}, "required": ["id", "reason"]}}}}, "description": "Browser session endpoint. Only admins manage restrictions; /me exposes only the signed-in player\u2019s active kind/expiry. See GLCS_V3_4_0_QUEUE_SUSPENSIONS_BANS.md."}}, "/api/queue-restrictions/me": {"get": {"summary": "View own active queue restriction without private notes", "tags": ["Queue Restrictions"], "responses": {"200": {"description": "Queue restriction state or successful manual action"}, "400": {"description": "Invalid action, reason, duration or existing active restriction"}, "403": {"description": "Admin session required"}}, "description": "Browser session endpoint. Only admins manage restrictions; /me exposes only the signed-in player\u2019s active kind/expiry. See GLCS_V3_4_0_QUEUE_SUSPENSIONS_BANS.md."}}, "/api/match-center/matches": {"get": {"summary": "List own reporting matches; admins see all reports", "tags": ["Match Center"], "responses": {"200": {"description": "Current state or accepted report action"}, "400": {"description": "Invalid, incomplete, stale, or closed report"}, "403": {"description": "Actual match reporting identity or admin review permission required"}}, "description": "Browser session authentication. See GLCS_V3_5_0_MATCH_CENTER_REPORTING.md. Pending opponent details are hidden until both submit; admin review requires a recorded reason."}}, "/api/match-center/{source}/{id}/state": {"get": {"summary": "Authorized match report and league-stat form", "tags": ["Match Center"], "responses": {"200": {"description": "Current state or accepted report action"}, "400": {"description": "Invalid, incomplete, stale, or closed report"}, "403": {"description": "Actual match reporting identity or admin review permission required"}}, "parameters": [{"in": "path", "name": "source", "required": true, "schema": {"enum": ["official", "scrim"]}}, {"in": "path", "name": "id", "required": true, "schema": {"type": "integer", "minimum": 1}}], "description": "Browser session authentication. See GLCS_V3_5_0_MATCH_CENTER_REPORTING.md. Pending opponent details are hidden until both submit; admin review requires a recorded reason."}}, "/api/match-center/{source}/{id}/submit": {"post": {"summary": "Independently submit both sides as actual captain or assigned QB", "tags": ["Match Center"], "responses": {"200": {"description": "Current state or accepted report action"}, "400": {"description": "Invalid, incomplete, stale, or closed report"}, "403": {"description": "Actual match reporting identity or admin review permission required"}}, "parameters": [{"in": "path", "name": "source", "required": true, "schema": {"enum": ["official", "scrim"]}}, {"in": "path", "name": "id", "required": true, "schema": {"type": "integer", "minimum": 1}}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"config_hash": {"type": "string"}, "expected_own_revision": {"type": "integer", "minimum": 0}, "report": {"type": "object", "required": ["score_a", "score_b", "players"], "properties": {"score_a": {"type": "integer", "minimum": 0}, "score_b": {"type": "integer", "minimum": 0}, "players": {"type": "array", "minItems": 14, "maxItems": 42, "items": {"type": "object", "required": ["player_code", "side", "designation", "position", "values"], "properties": {"player_code": {"type": "string"}, "side": {"enum": ["a", "b"]}, "designation": {"enum": ["starter", "sub", "player"]}, "position": {"enum": ["QB", "WR", "OL"]}, "values": {"type": "object", "additionalProperties": {"type": "integer", "minimum": 0, "maximum": 1000000}}}}}}}}, "required": ["config_hash", "expected_own_revision", "report"]}}}}, "description": "Browser session authentication. See GLCS_V3_5_0_MATCH_CENTER_REPORTING.md. Pending opponent details are hidden until both submit; admin review requires a recorded reason."}}, "/api/match-center/{source}/{id}/resolve": {"post": {"summary": "Admin resolves conflicting reports with a reason", "tags": ["Match Center"], "responses": {"200": {"description": "Current state or accepted report action"}, "400": {"description": "Invalid, incomplete, stale, or closed report"}, "403": {"description": "Actual match reporting identity or admin review permission required"}}, "parameters": [{"in": "path", "name": "source", "required": true, "schema": {"enum": ["official", "scrim"]}}, {"in": "path", "name": "id", "required": true, "schema": {"type": "integer", "minimum": 1}}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"choice": {"enum": ["a", "b", "manual"]}, "expected_revision": {"type": "integer", "minimum": 0}, "reason": {"type": "string", "minLength": 8, "maxLength": 1000}, "report": {"type": "object", "required": ["score_a", "score_b", "players"], "properties": {"score_a": {"type": "integer", "minimum": 0}, "score_b": {"type": "integer", "minimum": 0}, "players": {"type": "array", "minItems": 14, "maxItems": 42, "items": {"type": "object", "required": ["player_code", "side", "designation", "position", "values"], "properties": {"player_code": {"type": "string"}, "side": {"enum": ["a", "b"]}, "designation": {"enum": ["starter", "sub", "player"]}, "position": {"enum": ["QB", "WR", "OL"]}, "values": {"type": "object", "additionalProperties": {"type": "integer", "minimum": 0, "maximum": 1000000}}}}}}}}, "required": ["choice", "expected_revision", "reason"]}}}}, "description": "Browser session authentication. See GLCS_V3_5_0_MATCH_CENTER_REPORTING.md. Pending opponent details are hidden until both submit; admin review requires a recorded reason."}}, "/api/v1/commands/subs.join": {"post": {"summary": "subs.join: official_subs scope and linked league role", "description": "Uses the same service as the website. See GLCS_V3_6_0_DISCORD_BOT_CONNECTIONS.md. Captains/QBs use reports.submit; direct stats writes and report resolution require admin.", "tags": ["Bot Connections"], "security": [{"BotBearer": []}], "x-required-token-scopes": ["official_subs"], "parameters": [{"$ref": "#/components/parameters/DiscordUser"}, {"$ref": "#/components/parameters/Idempotency"}, {"name": "X-GLCS-Actor-Role", "in": "header", "schema": {"enum": ["player", "captain", "admin", "league_admin"]}}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"date": {"type": "string", "format": "date"}, "role": {"enum": ["QB", "WR", "OL", "FLEX"]}}, "required": ["date", "role"]}}}}, "responses": {"200": {"description": "Authorized state or successful action; retries return original successful command result"}, "400": {"description": "Invalid, stale or incomplete request"}, "403": {"description": "Token scope or linked actor not permitted"}}}}, "/api/v1/commands/subs.leave": {"post": {"summary": "subs.leave: official_subs scope and linked league role", "description": "Uses the same service as the website. See GLCS_V3_6_0_DISCORD_BOT_CONNECTIONS.md. Captains/QBs use reports.submit; direct stats writes and report resolution require admin.", "tags": ["Bot Connections"], "security": [{"BotBearer": []}], "x-required-token-scopes": ["official_subs"], "parameters": [{"$ref": "#/components/parameters/DiscordUser"}, {"$ref": "#/components/parameters/Idempotency"}, {"name": "X-GLCS-Actor-Role", "in": "header", "schema": {"enum": ["player", "captain", "admin", "league_admin"]}}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"date": {"type": "string", "format": "date"}}, "required": ["date"]}}}}, "responses": {"200": {"description": "Authorized state or successful action; retries return original successful command result"}, "400": {"description": "Invalid, stale or incomplete request"}, "403": {"description": "Token scope or linked actor not permitted"}}}}, "/api/v1/commands/subs.draw": {"post": {"summary": "subs.draw: official_subs scope and linked league role", "description": "Uses the same service as the website. See GLCS_V3_6_0_DISCORD_BOT_CONNECTIONS.md. Captains/QBs use reports.submit; direct stats writes and report resolution require admin.", "tags": ["Bot Connections"], "security": [{"BotBearer": []}], "x-required-token-scopes": ["official_subs"], "parameters": [{"$ref": "#/components/parameters/DiscordUser"}, {"$ref": "#/components/parameters/Idempotency"}, {"name": "X-GLCS-Actor-Role", "in": "header", "schema": {"enum": ["player", "captain", "admin", "league_admin"]}}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"game_id": {"type": "integer"}, "team_id": {"type": "integer"}, "role": {"enum": ["ANY", "QB", "WR", "OL", "FLEX"]}}, "required": ["game_id", "team_id"]}}}}, "responses": {"200": {"description": "Authorized state or successful action; retries return original successful command result"}, "400": {"description": "Invalid, stale or incomplete request"}, "403": {"description": "Token scope or linked actor not permitted"}}}}, "/api/v1/commands/subs.release": {"post": {"summary": "subs.release: official_subs scope and linked league role", "description": "Uses the same service as the website. See GLCS_V3_6_0_DISCORD_BOT_CONNECTIONS.md. Captains/QBs use reports.submit; direct stats writes and report resolution require admin.", "tags": ["Bot Connections"], "security": [{"BotBearer": []}], "x-required-token-scopes": ["official_subs"], "parameters": [{"$ref": "#/components/parameters/DiscordUser"}, {"$ref": "#/components/parameters/Idempotency"}, {"name": "X-GLCS-Actor-Role", "in": "header", "schema": {"enum": ["player", "captain", "admin", "league_admin"]}}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"assignment_id": {"type": "integer"}, "reason": {"type": "string", "minLength": 5, "maxLength": 400}}, "required": ["assignment_id", "reason"]}}}}, "responses": {"200": {"description": "Authorized state or successful action; retries return original successful command result"}, "400": {"description": "Invalid, stale or incomplete request"}, "403": {"description": "Token scope or linked actor not permitted"}}}}, "/api/v1/commands/reports.submit": {"post": {"summary": "reports.submit: reports scope and linked league role", "description": "Uses the same service as the website. See GLCS_V3_6_0_DISCORD_BOT_CONNECTIONS.md. Captains/QBs use reports.submit; direct stats writes and report resolution require admin.", "tags": ["Bot Connections"], "security": [{"BotBearer": []}], "x-required-token-scopes": ["reports"], "parameters": [{"$ref": "#/components/parameters/DiscordUser"}, {"$ref": "#/components/parameters/Idempotency"}, {"name": "X-GLCS-Actor-Role", "in": "header", "schema": {"enum": ["player", "captain", "admin", "league_admin"]}}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"config_hash": {"type": "string"}, "expected_own_revision": {"type": "integer", "minimum": 0}, "report": {"type": "object", "required": ["score_a", "score_b", "players"], "properties": {"score_a": {"type": "integer", "minimum": 0}, "score_b": {"type": "integer", "minimum": 0}, "players": {"type": "array", "minItems": 14, "maxItems": 42, "items": {"type": "object", "required": ["player_code", "side", "designation", "position", "values"], "properties": {"player_code": {"type": "string"}, "side": {"enum": ["a", "b"]}, "designation": {"enum": ["starter", "sub", "player"]}, "position": {"enum": ["QB", "WR", "OL"]}, "values": {"type": "object", "additionalProperties": {"type": "integer", "minimum": 0, "maximum": 1000000}}}}}}}, "source": {"enum": ["official", "scrim"]}, "match_id": {"type": "integer", "minimum": 1}}, "required": ["config_hash", "expected_own_revision", "report", "source", "match_id"]}}}}, "responses": {"200": {"description": "Authorized state or successful action; retries return original successful command result"}, "400": {"description": "Invalid, stale or incomplete request"}, "403": {"description": "Token scope or linked actor not permitted"}}}}, "/api/v1/commands/reports.resolve": {"post": {"summary": "reports.resolve: reports scope and linked league role", "description": "Uses the same service as the website. See GLCS_V3_6_0_DISCORD_BOT_CONNECTIONS.md. Captains/QBs use reports.submit; direct stats writes and report resolution require admin.", "tags": ["Bot Connections"], "security": [{"BotBearer": []}], "x-required-token-scopes": ["reports"], "parameters": [{"$ref": "#/components/parameters/DiscordUser"}, {"$ref": "#/components/parameters/Idempotency"}, {"name": "X-GLCS-Actor-Role", "in": "header", "schema": {"enum": ["player", "captain", "admin", "league_admin"]}}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"choice": {"enum": ["a", "b", "manual"]}, "expected_revision": {"type": "integer", "minimum": 0}, "reason": {"type": "string", "minLength": 8, "maxLength": 1000}, "report": {"type": "object", "required": ["score_a", "score_b", "players"], "properties": {"score_a": {"type": "integer", "minimum": 0}, "score_b": {"type": "integer", "minimum": 0}, "players": {"type": "array", "minItems": 14, "maxItems": 42, "items": {"type": "object", "required": ["player_code", "side", "designation", "position", "values"], "properties": {"player_code": {"type": "string"}, "side": {"enum": ["a", "b"]}, "designation": {"enum": ["starter", "sub", "player"]}, "position": {"enum": ["QB", "WR", "OL"]}, "values": {"type": "object", "additionalProperties": {"type": "integer", "minimum": 0, "maximum": 1000000}}}}}}}, "source": {"enum": ["official", "scrim"]}, "match_id": {"type": "integer", "minimum": 1}}, "required": ["choice", "expected_revision", "reason", "source", "match_id"]}}}}, "responses": {"200": {"description": "Authorized state or successful action; retries return original successful command result"}, "400": {"description": "Invalid, stale or incomplete request"}, "403": {"description": "Token scope or linked actor not permitted"}}}}, "/api/v1/commands/stats.record": {"post": {"summary": "stats.record: stats scope and linked league role", "description": "Uses the same service as the website. See GLCS_V3_6_0_DISCORD_BOT_CONNECTIONS.md. Captains/QBs use reports.submit; direct stats writes and report resolution require admin.", "tags": ["Bot Connections"], "security": [{"BotBearer": []}], "x-required-token-scopes": ["stats"], "parameters": [{"$ref": "#/components/parameters/DiscordUser"}, {"$ref": "#/components/parameters/Idempotency"}, {"name": "X-GLCS-Actor-Role", "in": "header", "schema": {"enum": ["player", "captain", "admin", "league_admin"]}}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "required": ["game_id", "rows"], "properties": {"game_id": {"type": "integer", "minimum": 1}, "reason": {"type": "string", "minLength": 5, "maxLength": 1000}, "rows": {"type": "array", "maxItems": 42, "items": {"type": "object", "required": ["player_code", "position", "values"], "properties": {"player_code": {"type": "string"}, "position": {"enum": ["QB", "WR", "OL"]}, "values": {"type": "object", "additionalProperties": {"type": ["integer", "null"], "minimum": 0, "maximum": 1000000}}}}}}}}}}, "responses": {"200": {"description": "Authorized state or successful action; retries return original successful command result"}, "400": {"description": "Invalid, stale or incomplete request"}, "403": {"description": "Token scope or linked actor not permitted"}}}}, "/api/v1/commands/stats.configure": {"post": {"summary": "stats.configure: stats scope and linked league role", "description": "Uses the same service as the website. See GLCS_V3_6_0_DISCORD_BOT_CONNECTIONS.md. Captains/QBs use reports.submit; direct stats writes and report resolution require admin.", "tags": ["Bot Connections"], "security": [{"BotBearer": []}], "x-required-token-scopes": ["stats"], "parameters": [{"$ref": "#/components/parameters/DiscordUser"}, {"$ref": "#/components/parameters/Idempotency"}, {"name": "X-GLCS-Actor-Role", "in": "header", "schema": {"enum": ["player", "captain", "admin", "league_admin"]}}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "required": ["config", "reason"], "properties": {"config": {"type": "object", "required": ["enabled", "positions"], "properties": {"enabled": {"type": "object", "additionalProperties": {"type": "boolean"}}, "positions": {"type": "object", "required": ["QB", "WR", "OL"], "additionalProperties": {"type": "object", "additionalProperties": {"type": "boolean"}}}}}, "reason": {"type": "string", "minLength": 5, "maxLength": 1000}}}}}}, "responses": {"200": {"description": "Authorized state or successful action; retries return original successful command result"}, "400": {"description": "Invalid, stale or incomplete request"}, "403": {"description": "Token scope or linked actor not permitted"}}}}, "/api/v1/commands/moderation.impose": {"post": {"summary": "moderation.impose: moderation scope and linked league role", "description": "Uses the same service as the website. See GLCS_V3_6_0_DISCORD_BOT_CONNECTIONS.md. Captains/QBs use reports.submit; direct stats writes and report resolution require admin.", "tags": ["Bot Connections"], "security": [{"BotBearer": []}], "x-required-token-scopes": ["moderation"], "parameters": [{"$ref": "#/components/parameters/DiscordUser"}, {"$ref": "#/components/parameters/Idempotency"}, {"name": "X-GLCS-Actor-Role", "in": "header", "schema": {"enum": ["player", "captain", "admin", "league_admin"]}}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"player_code": {"type": "string"}, "kind": {"enum": ["suspension", "ban"]}, "reason": {"type": "string", "minLength": 5, "maxLength": 1000}, "duration_days": {"type": ["integer", "null"], "minimum": 1, "maximum": 3650}}, "required": ["player_code", "kind", "reason"]}}}}, "responses": {"200": {"description": "Authorized state or successful action; retries return original successful command result"}, "400": {"description": "Invalid, stale or incomplete request"}, "403": {"description": "Token scope or linked actor not permitted"}}}}, "/api/v1/commands/moderation.lift": {"post": {"summary": "moderation.lift: moderation scope and linked league role", "description": "Uses the same service as the website. See GLCS_V3_6_0_DISCORD_BOT_CONNECTIONS.md. Captains/QBs use reports.submit; direct stats writes and report resolution require admin.", "tags": ["Bot Connections"], "security": [{"BotBearer": []}], "x-required-token-scopes": ["moderation"], "parameters": [{"$ref": "#/components/parameters/DiscordUser"}, {"$ref": "#/components/parameters/Idempotency"}, {"name": "X-GLCS-Actor-Role", "in": "header", "schema": {"enum": ["player", "captain", "admin", "league_admin"]}}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"id": {"type": "integer"}, "reason": {"type": "string", "minLength": 5, "maxLength": 1000}}, "required": ["id", "reason"]}}}}, "responses": {"200": {"description": "Authorized state or successful action; retries return original successful command result"}, "400": {"description": "Invalid, stale or incomplete request"}, "403": {"description": "Token scope or linked actor not permitted"}}}}, "/api/v1/commands/teamjourney.save": {"post": {"summary": "teamjourney.save: team_journey scope and linked league role", "description": "Uses the same service as the website. See GLCS_V3_6_0_DISCORD_BOT_CONNECTIONS.md. Captains/QBs use reports.submit; direct stats writes and report resolution require admin.", "tags": ["Bot Connections"], "security": [{"BotBearer": []}], "x-required-token-scopes": ["team_journey"], "parameters": [{"$ref": "#/components/parameters/DiscordUser"}, {"$ref": "#/components/parameters/Idempotency"}, {"name": "X-GLCS-Actor-Role", "in": "header", "schema": {"enum": ["player", "captain", "admin", "league_admin"]}}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"$ref": "#/components/schemas/TeamJourneySetup"}}}}, "responses": {"200": {"description": "Authorized state or successful action; retries return original successful command result"}, "400": {"description": "Invalid, stale or incomplete request"}, "403": {"description": "Token scope or linked actor not permitted"}}}}, "/api/v1/commands/teamjourney.submit": {"post": {"summary": "teamjourney.submit: team_journey scope and linked league role", "description": "Uses the same service as the website. See GLCS_V3_6_0_DISCORD_BOT_CONNECTIONS.md. Captains/QBs use reports.submit; direct stats writes and report resolution require admin.", "tags": ["Bot Connections"], "security": [{"BotBearer": []}], "x-required-token-scopes": ["team_journey"], "parameters": [{"$ref": "#/components/parameters/DiscordUser"}, {"$ref": "#/components/parameters/Idempotency"}, {"name": "X-GLCS-Actor-Role", "in": "header", "schema": {"enum": ["player", "captain", "admin", "league_admin"]}}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"$ref": "#/components/schemas/TeamJourneySetup"}}}}, "responses": {"200": {"description": "Authorized state or successful action; retries return original successful command result"}, "400": {"description": "Invalid, stale or incomplete request"}, "403": {"description": "Token scope or linked actor not permitted"}}}}, "/api/v1/commands/teamjourney.withdraw": {"post": {"summary": "teamjourney.withdraw: team_journey scope and linked league role", "description": "Uses the same service as the website. See GLCS_V3_6_0_DISCORD_BOT_CONNECTIONS.md. Captains/QBs use reports.submit; direct stats writes and report resolution require admin.", "tags": ["Bot Connections"], "security": [{"BotBearer": []}], "x-required-token-scopes": ["team_journey"], "parameters": [{"$ref": "#/components/parameters/DiscordUser"}, {"$ref": "#/components/parameters/Idempotency"}, {"name": "X-GLCS-Actor-Role", "in": "header", "schema": {"enum": ["player", "captain", "admin", "league_admin"]}}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "required": ["expected_revision"], "properties": {"expected_revision": {"type": "integer", "minimum": 0}}}}}}, "responses": {"200": {"description": "Authorized state or successful action; retries return original successful command result"}, "400": {"description": "Invalid, stale or incomplete request"}, "403": {"description": "Token scope or linked actor not permitted"}}}}, "/api/v1/commands/teamjourney.review": {"post": {"summary": "teamjourney.review: team_journey scope and linked league role", "description": "Uses the same service as the website. See GLCS_V3_6_0_DISCORD_BOT_CONNECTIONS.md. Captains/QBs use reports.submit; direct stats writes and report resolution require admin.", "tags": ["Bot Connections"], "security": [{"BotBearer": []}], "x-required-token-scopes": ["team_journey"], "parameters": [{"$ref": "#/components/parameters/DiscordUser"}, {"$ref": "#/components/parameters/Idempotency"}, {"name": "X-GLCS-Actor-Role", "in": "header", "schema": {"enum": ["player", "captain", "admin", "league_admin"]}}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "required": ["decision", "reason", "expected_revision", "request_id"], "properties": {"decision": {"enum": ["approve", "reject"]}, "reason": {"type": "string", "minLength": 5, "maxLength": 600}, "expected_revision": {"type": "integer"}, "request_id": {"type": "integer", "minimum": 1}}}}}}, "responses": {"200": {"description": "Authorized state or successful action; retries return original successful command result"}, "400": {"description": "Invalid, stale or incomplete request"}, "403": {"description": "Token scope or linked actor not permitted"}}}}, "/api/v1/commands/teamjourney.update": {"post": {"summary": "teamjourney.update: team_journey scope and linked league role", "description": "Uses the same service as the website. See GLCS_V3_6_0_DISCORD_BOT_CONNECTIONS.md. Captains/QBs use reports.submit; direct stats writes and report resolution require admin.", "tags": ["Bot Connections"], "security": [{"BotBearer": []}], "x-required-token-scopes": ["team_journey"], "parameters": [{"$ref": "#/components/parameters/DiscordUser"}, {"$ref": "#/components/parameters/Idempotency"}, {"name": "X-GLCS-Actor-Role", "in": "header", "schema": {"enum": ["player", "captain", "admin", "league_admin"]}}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "required": ["home_field"], "properties": {"home_field": {"enum": ["digi", "moon", "underwater"]}, "image": {"type": "string", "description": "PNG/JPEG/WebP base64 data URI; decoded <=350KB"}, "team_id": {"type": "integer", "minimum": 1}}}}}}, "responses": {"200": {"description": "Authorized state or successful action; retries return original successful command result"}, "400": {"description": "Invalid, stale or incomplete request"}, "403": {"description": "Token scope or linked actor not permitted"}}}}, "/api/v1/official-subs": {"get": {"summary": "Read official-subs", "description": "Requires read and official_subs scopes plus website-equivalent linked identity visibility. See bot connection guide.", "tags": ["Bot Connections"], "security": [{"BotBearer": []}], "x-required-token-scopes": ["read", "official_subs"], "parameters": [{"name": "X-GLCS-Discord-User-ID", "in": "header", "schema": {"type": "string"}, "description": "Required for private/own resources; verified Discord interaction user ID."}, {"name": "date", "in": "query", "schema": {"type": "string", "format": "date"}}], "responses": {"200": {"description": "Authorized state or successful action; retries return original successful command result"}, "400": {"description": "Invalid, stale or incomplete request"}, "403": {"description": "Token scope or linked actor not permitted"}}}}, "/api/v1/match-center/matches": {"get": {"summary": "Read match-center/matches", "description": "Requires read and reports scopes plus website-equivalent linked identity visibility. See bot connection guide.", "tags": ["Bot Connections"], "security": [{"BotBearer": []}], "x-required-token-scopes": ["read", "reports"], "parameters": [{"name": "X-GLCS-Discord-User-ID", "in": "header", "schema": {"type": "string"}, "description": "Required for private/own resources; verified Discord interaction user ID."}], "responses": {"200": {"description": "Authorized state or successful action; retries return original successful command result"}, "400": {"description": "Invalid, stale or incomplete request"}, "403": {"description": "Token scope or linked actor not permitted"}}}}, "/api/v1/match-center/{source}/{id}": {"get": {"summary": "Read match-center/{source}/{id}", "description": "Requires read and reports scopes plus website-equivalent linked identity visibility. See bot connection guide.", "tags": ["Bot Connections"], "security": [{"BotBearer": []}], "x-required-token-scopes": ["read", "reports"], "parameters": [{"name": "X-GLCS-Discord-User-ID", "in": "header", "schema": {"type": "string"}, "description": "Required for private/own resources; verified Discord interaction user ID."}, {"name": "source", "in": "path", "required": true, "schema": {"enum": ["official", "scrim"]}}, {"name": "id", "in": "path", "required": true, "schema": {"type": "integer", "minimum": 1}}], "responses": {"200": {"description": "Authorized state or successful action; retries return original successful command result"}, "400": {"description": "Invalid, stale or incomplete request"}, "403": {"description": "Token scope or linked actor not permitted"}}}}, "/api/v1/stats/config": {"get": {"summary": "Read stats/config", "description": "Requires read and stats scopes plus website-equivalent linked identity visibility. See bot connection guide.", "tags": ["Bot Connections"], "security": [{"BotBearer": []}], "x-required-token-scopes": ["read", "stats"], "parameters": [{"name": "X-GLCS-Discord-User-ID", "in": "header", "schema": {"type": "string"}, "description": "Required for private/own resources; verified Discord interaction user ID."}], "responses": {"200": {"description": "Authorized state or successful action; retries return original successful command result"}, "400": {"description": "Invalid, stale or incomplete request"}, "403": {"description": "Token scope or linked actor not permitted"}}}}, "/api/v1/games/{id}/stats": {"get": {"summary": "Read games/{id}/stats", "description": "Requires read and stats scopes plus website-equivalent linked identity visibility. See bot connection guide.", "tags": ["Bot Connections"], "security": [{"BotBearer": []}], "x-required-token-scopes": ["read", "stats"], "parameters": [{"name": "X-GLCS-Discord-User-ID", "in": "header", "schema": {"type": "string"}, "description": "Required for private/own resources; verified Discord interaction user ID."}, {"name": "id", "in": "path", "required": true, "schema": {"type": "integer", "minimum": 1}}], "responses": {"200": {"description": "Authorized state or successful action; retries return original successful command result"}, "400": {"description": "Invalid, stale or incomplete request"}, "403": {"description": "Token scope or linked actor not permitted"}}}}, "/api/v1/queue-restrictions/me": {"get": {"summary": "Read queue-restrictions/me", "description": "Requires read and moderation scopes plus website-equivalent linked identity visibility. See bot connection guide.", "tags": ["Bot Connections"], "security": [{"BotBearer": []}], "x-required-token-scopes": ["read", "moderation"], "parameters": [{"name": "X-GLCS-Discord-User-ID", "in": "header", "schema": {"type": "string"}, "description": "Required for private/own resources; verified Discord interaction user ID."}], "responses": {"200": {"description": "Authorized state or successful action; retries return original successful command result"}, "400": {"description": "Invalid, stale or incomplete request"}, "403": {"description": "Token scope or linked actor not permitted"}}}}, "/api/v1/queue-restrictions/state": {"get": {"summary": "Read queue-restrictions/state", "description": "Requires read and moderation scopes plus website-equivalent linked identity visibility. See bot connection guide.", "tags": ["Bot Connections"], "security": [{"BotBearer": []}], "x-required-token-scopes": ["read", "moderation"], "parameters": [{"name": "X-GLCS-Discord-User-ID", "in": "header", "schema": {"type": "string"}, "description": "Required for private/own resources; verified Discord interaction user ID."}], "responses": {"200": {"description": "Authorized state or successful action; retries return original successful command result"}, "400": {"description": "Invalid, stale or incomplete request"}, "403": {"description": "Token scope or linked actor not permitted"}}}}, "/api/v1/team-journey/me": {"get": {"summary": "Read team-journey/me", "description": "Requires read and team_journey scopes plus website-equivalent linked identity visibility. See bot connection guide.", "tags": ["Bot Connections"], "security": [{"BotBearer": []}], "x-required-token-scopes": ["read", "team_journey"], "parameters": [{"name": "X-GLCS-Discord-User-ID", "in": "header", "schema": {"type": "string"}, "description": "Required for private/own resources; verified Discord interaction user ID."}, {"name": "team_id", "in": "query", "schema": {"type": "integer", "minimum": 1}, "description": "Admin-only team editing override."}], "responses": {"200": {"description": "Authorized state or successful action; retries return original successful command result"}, "400": {"description": "Invalid, stale or incomplete request"}, "403": {"description": "Token scope or linked actor not permitted"}}}}, "/api/v1/team-journey/stadiums": {"get": {"summary": "Read team-journey/stadiums", "description": "Requires read and team_journey scopes plus website-equivalent linked identity visibility. See bot connection guide.", "tags": ["Bot Connections"], "security": [{"BotBearer": []}], "x-required-token-scopes": ["read", "team_journey"], "parameters": [{"name": "X-GLCS-Discord-User-ID", "in": "header", "schema": {"type": "string"}, "description": "Required for private/own resources; verified Discord interaction user ID."}], "responses": {"200": {"description": "Authorized state or successful action; retries return original successful command result"}, "400": {"description": "Invalid, stale or incomplete request"}, "403": {"description": "Token scope or linked actor not permitted"}}}}, "/api/v1/team-journey/requests": {"get": {"summary": "Read team-journey/requests", "description": "Requires read and team_journey scopes plus website-equivalent linked identity visibility. See bot connection guide.", "tags": ["Bot Connections"], "security": [{"BotBearer": []}], "x-required-token-scopes": ["read", "team_journey"], "parameters": [{"name": "X-GLCS-Discord-User-ID", "in": "header", "schema": {"type": "string"}, "description": "Required for private/own resources; verified Discord interaction user ID."}, {"name": "status", "in": "query", "schema": {"enum": ["pending", "approved", "rejected", "all"]}}], "responses": {"200": {"description": "Authorized state or successful action; retries return original successful command result"}, "400": {"description": "Invalid, stale or incomplete request"}, "403": {"description": "Token scope or linked actor not permitted"}}}}, "/api/v1/team-journey/requests/{id}": {"get": {"summary": "Read team-journey/requests/{id}", "description": "Requires read and team_journey scopes plus website-equivalent linked identity visibility. See bot connection guide.", "tags": ["Bot Connections"], "security": [{"BotBearer": []}], "x-required-token-scopes": ["read", "team_journey"], "parameters": [{"name": "X-GLCS-Discord-User-ID", "in": "header", "schema": {"type": "string"}, "description": "Required for private/own resources; verified Discord interaction user ID."}, {"name": "id", "in": "path", "required": true, "schema": {"type": "integer", "minimum": 1}}], "responses": {"200": {"description": "Authorized state or successful action; retries return original successful command result"}, "400": {"description": "Invalid, stale or incomplete request"}, "403": {"description": "Token scope or linked actor not permitted"}}}}, "/api/v1/team-journey/requests/{id}/logo": {"get": {"summary": "Read team-journey/requests/{id}/logo", "description": "Requires read and team_journey scopes plus website-equivalent linked identity visibility. See bot connection guide.", "tags": ["Bot Connections"], "security": [{"BotBearer": []}], "x-required-token-scopes": ["read", "team_journey"], "parameters": [{"name": "X-GLCS-Discord-User-ID", "in": "header", "schema": {"type": "string"}, "description": "Required for private/own resources; verified Discord interaction user ID."}, {"name": "id", "in": "path", "required": true, "schema": {"type": "integer", "minimum": 1}}], "responses": {"200": {"description": "Authorized state or successful action; retries return original successful command result"}, "400": {"description": "Invalid, stale or incomplete request"}, "403": {"description": "Token scope or linked actor not permitted"}}}}, "/api/v1/teams/{id}/branding": {"get": {"summary": "Read teams/{id}/branding", "description": "Requires read and team_journey scopes plus website-equivalent linked identity visibility. See bot connection guide.", "tags": ["Bot Connections"], "security": [{"BotBearer": []}], "x-required-token-scopes": ["read", "team_journey"], "parameters": [{"name": "X-GLCS-Discord-User-ID", "in": "header", "schema": {"type": "string"}, "description": "Required for private/own resources; verified Discord interaction user ID."}, {"name": "id", "in": "path", "required": true, "schema": {"type": "integer", "minimum": 1}}], "responses": {"200": {"description": "Authorized state or successful action; retries return original successful command result"}, "400": {"description": "Invalid, stale or incomplete request"}, "403": {"description": "Token scope or linked actor not permitted"}}}}, "/api/v1/commands/scrims.premier.ready": {"post": {"summary": "Premier room: ready", "security": [{"BotBearer": []}], "x-glcs-required-scope": "scrims", "description": "Linked assigned player required. Match ID and current room revision required; captain-only actions enforce designated side. Standard Idempotency-Key and Discord identity headers apply.", "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "required": ["match_id", "revision"], "properties": {"match_id": {"type": "integer"}, "revision": {"type": "integer"}, "player_code": {"type": "string"}, "stadium": {"enum": ["digi", "moon", "underwater"]}, "uniform": {"type": "string"}, "lobby": {"type": "string", "maxLength": 300}}}}}}, "responses": {"200": {"description": "Saved room transition"}, "400": {"description": "Invalid action or stale revision"}, "403": {"description": "Not an eligible player or captain"}}}}, "/api/v1/commands/scrims.premier.decline": {"post": {"summary": "Premier room: decline", "security": [{"BotBearer": []}], "x-glcs-required-scope": "scrims", "description": "Linked assigned player required. Match ID and current room revision required; captain-only actions enforce designated side. Standard Idempotency-Key and Discord identity headers apply.", "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "required": ["match_id", "revision"], "properties": {"match_id": {"type": "integer"}, "revision": {"type": "integer"}, "player_code": {"type": "string"}, "stadium": {"enum": ["digi", "moon", "underwater"]}, "uniform": {"type": "string"}, "lobby": {"type": "string", "maxLength": 300}}}}}}, "responses": {"200": {"description": "Saved room transition"}, "400": {"description": "Invalid action or stale revision"}, "403": {"description": "Not an eligible player or captain"}}}}, "/api/v1/commands/scrims.premier.pick": {"post": {"summary": "Premier room: pick", "security": [{"BotBearer": []}], "x-glcs-required-scope": "scrims", "description": "Linked assigned player required. Match ID and current room revision required; captain-only actions enforce designated side. Standard Idempotency-Key and Discord identity headers apply.", "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "required": ["match_id", "revision"], "properties": {"match_id": {"type": "integer"}, "revision": {"type": "integer"}, "player_code": {"type": "string"}, "stadium": {"enum": ["digi", "moon", "underwater"]}, "uniform": {"type": "string"}, "lobby": {"type": "string", "maxLength": 300}}}}}}, "responses": {"200": {"description": "Saved room transition"}, "400": {"description": "Invalid action or stale revision"}, "403": {"description": "Not an eligible player or captain"}}}}, "/api/v1/commands/scrims.premier.vote": {"post": {"summary": "Premier room: vote", "security": [{"BotBearer": []}], "x-glcs-required-scope": "scrims", "description": "Linked assigned player required. Match ID and current room revision required; captain-only actions enforce designated side. Standard Idempotency-Key and Discord identity headers apply.", "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "required": ["match_id", "revision"], "properties": {"match_id": {"type": "integer"}, "revision": {"type": "integer"}, "player_code": {"type": "string"}, "stadium": {"enum": ["digi", "moon", "underwater"]}, "uniform": {"type": "string"}, "lobby": {"type": "string", "maxLength": 300}}}}}}, "responses": {"200": {"description": "Saved room transition"}, "400": {"description": "Invalid action or stale revision"}, "403": {"description": "Not an eligible player or captain"}}}}, "/api/v1/commands/scrims.premier.away_choice": {"post": {"summary": "Premier room: away_choice", "security": [{"BotBearer": []}], "x-glcs-required-scope": "scrims", "description": "Linked assigned player required. Match ID and current room revision required; captain-only actions enforce designated side. Standard Idempotency-Key and Discord identity headers apply.", "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "required": ["match_id", "revision"], "properties": {"match_id": {"type": "integer"}, "revision": {"type": "integer"}, "player_code": {"type": "string"}, "stadium": {"enum": ["digi", "moon", "underwater"]}, "uniform": {"type": "string"}, "lobby": {"type": "string", "maxLength": 300}}}}}}, "responses": {"200": {"description": "Saved room transition"}, "400": {"description": "Invalid action or stale revision"}, "403": {"description": "Not an eligible player or captain"}}}}, "/api/v1/commands/scrims.premier.home_choice": {"post": {"summary": "Premier room: home_choice", "security": [{"BotBearer": []}], "x-glcs-required-scope": "scrims", "description": "Linked assigned player required. Match ID and current room revision required; captain-only actions enforce designated side. Standard Idempotency-Key and Discord identity headers apply.", "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "required": ["match_id", "revision"], "properties": {"match_id": {"type": "integer"}, "revision": {"type": "integer"}, "player_code": {"type": "string"}, "stadium": {"enum": ["digi", "moon", "underwater"]}, "uniform": {"type": "string"}, "lobby": {"type": "string", "maxLength": 300}}}}}}, "responses": {"200": {"description": "Saved room transition"}, "400": {"description": "Invalid action or stale revision"}, "403": {"description": "Not an eligible player or captain"}}}}, "/api/v1/commands/scrims.premier.launch": {"post": {"summary": "Premier room: launch", "security": [{"BotBearer": []}], "x-glcs-required-scope": "scrims", "description": "Linked assigned player required. Match ID and current room revision required; captain-only actions enforce designated side. Standard Idempotency-Key and Discord identity headers apply.", "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "required": ["match_id", "revision"], "properties": {"match_id": {"type": "integer"}, "revision": {"type": "integer"}, "player_code": {"type": "string"}, "stadium": {"enum": ["digi", "moon", "underwater"]}, "uniform": {"type": "string"}, "lobby": {"type": "string", "maxLength": 300}}}}}}, "responses": {"200": {"description": "Saved room transition"}, "400": {"description": "Invalid action or stale revision"}, "403": {"description": "Not an eligible player or captain"}}}}, "/api/v1/scrims/premier/{id}": {"get": {"summary": "Private Premier match room", "security": [{"BotBearer": []}], "x-glcs-required-scope": "read + scrims", "parameters": [{"in": "path", "name": "id", "required": true, "schema": {"type": "integer"}}], "responses": {"200": {"description": "Room and private lobby instructions for an assigned player or admin"}, "403": {"description": "Insufficient scopes or match access"}}}}, "/api/v1/official-game-settings": {"get": {"summary": "Current Official Ladder in-game settings", "security": [{"BotBearer": []}], "x-glcs-required-scope": "read", "responses": {"200": {"description": "Five published values, revision, metadata and linked admin edit capability"}}}}, "/api/v1/commands/official.settings.update": {"post": {"summary": "Publish Official Ladder in-game settings", "security": [{"BotBearer": []}], "x-glcs-required-scope": "admin", "description": "Requires linked admin, Discord identity and Idempotency-Key. Public configuration only; no automatic in-game lobby control.", "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "required": ["revision", "settings"], "properties": {"revision": {"type": "integer", "minimum": 0}, "settings": {"type": "object", "additionalProperties": false, "required": ["quarter_length", "first_down_length", "starting_dashes", "dash_reload_time", "qb_slowdown"], "properties": {"quarter_length": {"type": "integer", "minimum": 1, "maximum": 10000}, "first_down_length": {"type": "integer", "minimum": 1, "maximum": 10000}, "starting_dashes": {"type": "integer", "minimum": 0, "maximum": 10000}, "dash_reload_time": {"type": "integer", "minimum": 0, "maximum": 10000}, "qb_slowdown": {"type": "integer", "minimum": 0, "maximum": 10000}}}}}}}}, "responses": {"200": {"description": "Published settings and new revision"}, "400": {"description": "Invalid values or stale revision"}, "403": {"description": "Admin identity and scope required"}}}}, "/api/staff-permissions": {"get": {"summary": "List registered players and delegated league permissions (site admin cookie only)", "responses": {"200": {"description": "Permission catalog, players and revisioned grants"}, "403": {"description": "Site admin required"}}}, "post": {"summary": "Grant or revoke player league permissions (site admin cookie only)", "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "required": ["player_id", "permissions", "revision"], "properties": {"player_id": {"type": "integer"}, "revision": {"type": "integer"}, "permissions": {"type": "array", "uniqueItems": true, "items": {"type": "string", "enum": ["official", "premiere", "results", "rosters", "records", "moderation"]}}}}}}}, "responses": {"200": {"description": "Saved; effective on the next request"}, "400": {"description": "Invalid permission or stale revision"}, "403": {"description": "Site admin required"}}}}, "/api/integrations/queue-policy": {"post": {"summary": "Site-admin-only Discord queue requirement (website session)", "description": "Cookie-authenticated site admin only; unavailable to bot tokens or delegated player admins. Enabling removes ineligible waiting entries without changing published games.", "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "required": ["required"], "properties": {"required": {"type": "boolean"}}}}}}, "responses": {"200": {"description": "Policy saved"}, "403": {"description": "Site admin required"}}}}, "/api/onboarding/display-name": {"post": {"summary": "Save the current Discord player\u2019s GLCS display name", "description": "Requires a player session and verified Discord link. Affects only the current player; accepts no alternate player ID.", "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "required": ["name"], "properties": {"name": {"type": "string", "minLength": 2, "maxLength": 48}}}}}}, "responses": {"200": {"description": "Display name saved"}, "400": {"description": "Invalid display name"}, "403": {"description": "Verified player session required"}}}}}, "x-bot-feature-scopes": ["moderation", "official_subs", "reports", "stats", "team_journey"], "x-bot-command-scopes": {"subs.join": "official_subs", "subs.leave": "official_subs", "subs.draw": "official_subs", "subs.release": "official_subs", "reports.submit": "reports", "reports.resolve": "reports", "stats.record": "stats", "stats.configure": "stats", "moderation.impose": "moderation", "moderation.lift": "moderation", "teamjourney.save": "team_journey", "teamjourney.submit": "team_journey", "teamjourney.withdraw": "team_journey", "teamjourney.review": "team_journey", "teamjourney.update": "team_journey"}}