Athena Attack/Defence Admin API
Administrative API for the attack/defence event’s services, settings, game state, scoreboard, host and diagnostics. Authenticate with an organizer API key as a bearer token. A few operations belong to the organizer panel or to the platform itself and say so in their description; an organizer key is refused on them. Players’ flag submission and the public attack-info document are not part of this API; see the player guide.
Version 1.0.0
Services
- GETList services
/api/admin/services - POSTCreate a service; refused once the host is allocated or the network opens
/api/admin/services - GETGet a service
/api/admin/services/{id} - PATCHUpdate a service; ports and checker timeout freeze with the host allocation
/api/admin/services/{id} - DELETEDelete a service; refused once the host is allocated or the network opens
/api/admin/services/{id} - POSTRecord a service's verified image digests; refused once the host is allocated
/api/admin/services/{id}/image - POSTResolve a service's image and checker image to digests with the registry credentials stored on the service; nothing is written
/api/admin/services/{id}/image/resolve - PATCHRelabel a flag store
/api/admin/services/{id}/stores/{index} - POSTEnable a service; refused once the host is allocated or the network opens
/api/admin/services/{id}/enable - POSTDisable a service; refused once the host is allocated or the network opens
/api/admin/services/{id}/disable - POSTAttach an uploaded source archive to a service
/api/admin/services/{id}/source - DELETEDetach a service's source archive
/api/admin/services/{id}/source
Config
- GETGet the current event settings
/api/admin/config - PATCHApply an idempotent event settings operation
/api/admin/config - GETList every version of the event settings
/api/admin/config/versions - POSTRestore settings through a new versioned operation
/api/admin/config/revert - GETRead settings synchronization status
/api/admin/config/sync - GETRead a durable settings operation
/api/admin/config/operations/{id} - POSTAcknowledge the control-plane settings commit
/api/admin/config/operations/{id}/ack
Game
- GETRead the game state
/api/admin/game - POSTPause the game; the engine withdraws running checks and retries them on resume
/api/admin/game/pause - POSTResume the game once both control streams are attached and the host has converged
/api/admin/game/resume - POSTRequest the network open; the engine opens it once prerequisites hold
/api/admin/game/open - GETRead the current host's opening attempt: its snapshot and seal operations and whether one failed
/api/admin/game/open - POSTRetry a failed network opening with fresh snapshot and seal operations for the attempt that failed; a replay of the same attempt returns the retry already made
/api/admin/game/open/retry - POSTRecord the End operation; the engine drains, scores and acknowledges it
/api/admin/game/end - GETRead the End operation and whether the engine acknowledged it
/api/admin/game/end
Roster
- GETRead the roster lock status
/api/admin/roster - POSTLock the roster: admit every team, assign stable numbers, refuse later formation
/api/admin/roster/lock
Submission tokens
- GETRead a team's live submission token
/api/admin/teams/{teamId}/submission-token - GETList every live submission-token generation of a team, newest first
/api/admin/teams/{teamId}/submission-tokens - POSTIssue a team's submission token
/api/admin/teams/{teamId}/submission-token/issue - POSTRevoke a submission token
/api/admin/submission-token/revoke
Scoreboard
- GETRead the teams x services scoreboard
/api/admin/scoreboard - GETRead per-tick score events and service states for the matrix history
/api/admin/scoreboard/history - GETDrill into one team's per-store states and score events for a service
/api/admin/scoreboard/stores
Checker attempts
Diagnostics
- POSTDispatch a diagnostic check against a team's box
/api/admin/diagnostics - GETList recent diagnostic checks
/api/admin/diagnostics - GETRead a diagnostic check's bounded, redacted output
/api/admin/diagnostics/{id}/bundle
Host
- GETRead the event host's desired/observed state
/api/admin/host - GETRead the enabled services a host is sized from, with the revision its allocation must match
/api/admin/host/inventory - PUTPin the event host's client certificate for a generation
/api/admin/host/credential - POSTRevoke the event host's credential up to and including a generation
/api/admin/host/credential/revoke - PUTDeliver the admitted host shape the engine composes desired state from
/api/admin/host/allocation - POSTRecord a host compromise: block both host sessions and pause play. Before the network opens the event may receive a replacement host; after, the loss is terminal
/api/admin/host/incident - POSTRetire the current host allocation before the network opens, for an image change or a recorded compromise
/api/admin/host/reallocation - GETRead the current host allocation and list retired ones and recorded host incidents
/api/admin/host/history
Boxes
- GETList every team's box
/api/admin/boxes - GETRead a team's box
/api/admin/boxes/{teamId} - POSTRequest a snapshot restore for a team's box
/api/admin/boxes/{teamId}/restore - POSTRevoke a registered SSH key
/api/admin/teams/{teamId}/ssh-keys/{keyId}/revoke
Runner
- GETRead the runner's connectivity and backlog
/api/admin/runner - POSTRequest a runner worker restart
/api/admin/runner/restart
Analytics
- GETGet the event's headline counts
/api/admin/stats - GETGet the analytics overview
/api/admin/analytics/overview - GETBreak submissions and captures down per tick
/api/admin/analytics/captures - GETBreak checks, captures and points down per service
/api/admin/analytics/services - GETDownload the analytics report
/api/admin/analytics/export
Players
- GETList players with their team and score
/api/admin/players - GETGet a player's profile, keys and VPN assignment
/api/admin/players/{id} - DELETEDelete a player account
/api/admin/players/{id} - POSTSuspend a player and end their sessions
/api/admin/players/{id}/ban - POSTLift a player's suspension
/api/admin/players/{id}/unban - POSTRevoke a player's WireGuard peer; the host drops it on its next desired generation
/api/admin/players/{id}/vpn-peer/revoke
Teams
- GETList teams by score
/api/admin/teams - POSTCreate a team before the roster locks; a hidden reference team may be memberless and is admitted but never scored
/api/admin/teams - GETGet a team's profile, members, scores and keys
/api/admin/teams/{teamId} - PATCHRename a team
/api/admin/teams/{teamId} - DELETEDelete an empty team, before the roster locks
/api/admin/teams/{teamId} - PATCHMake a team a hidden reference team or a scored one, before the roster locks
/api/admin/teams/{teamId}/visibility - POSTMove a player onto a team; their SSH keys and VPN peer on the old team are revoked
/api/admin/teams/{teamId}/members - DELETERemove a player from a team; an admitted team keeps its box when it empties
/api/admin/teams/{teamId}/members/{userId}
Submissions
Announcements
- GETList the announcements
/api/admin/announcements - POSTPost an announcement
/api/admin/announcements - PATCHEdit an announcement
/api/admin/announcements/{id} - DELETEDelete an announcement
/api/admin/announcements/{id}
Storage
- GETList every stored object with the service it sources
/api/admin/files - GETGet the event's storage usage against its quota
/api/admin/storage/usage - POSTReserve quota and presign a create-only upload
/api/admin/storage/upload-url - DELETEDelete an uploaded file from the event's storage
/api/admin/storage/files/{fileId}
Reports
- GETList the player reports
/api/admin/reports - GETGet a report with its full thread
/api/admin/reports/{id} - PATCHClose a report
/api/admin/reports/{id} - POSTReply to a report as an organizer
/api/admin/reports/{id}/admin-messages
Feedback
Audit
API keys
- GETList the organizer API keys
/api/admin/api-keys - POSTMint an organizer API key
/api/admin/api-keys - DELETERevoke an organizer API key
/api/admin/api-keys/{id} - POSTMint an additional system API key
/api/admin/api-keys/system - GETList the system API keys
/api/admin/api-keys/system - DELETERevoke one system API key
/api/admin/api-keys/system/{id} - PUTInstall the provisioner's system key by hash
/api/admin/api-keys/provisioner - POSTKeep every live system key valid until at least an instant; a revoked or expired key is never revived
/api/admin/api-keys/system/extend - POSTRevoke every organizer API key
/api/admin/api-keys/revoke-all
Certificates
- GETList the certificate templates
/api/admin/certificates/templates - POSTCreate a certificate template
/api/admin/certificates/templates - GETGet a certificate template with its background URL
/api/admin/certificates/templates/{id} - DELETEDelete a certificate template
/api/admin/certificates/templates/{id} - PUTSave a certificate template's draft layout
/api/admin/certificates/templates/{id}/draft - POSTAttach an uploaded background to a certificate draft
/api/admin/certificates/templates/{id}/background - POSTPublish a certificate template's draft as a version
/api/admin/certificates/templates/{id}/publish - GETGet a published version of a certificate template
/api/admin/certificates/templates/{id}/versions/{version} - GETGet the certificate tiers
/api/admin/certificates/tiers - PUTReplace the certificate tiers
/api/admin/certificates/tiers - GETPreview a sample credential per tier
/api/admin/certificates/samples - GETList the issued certificates
/api/admin/certificates - POSTIssue certificates to the qualifying players
/api/admin/certificates/issue - POSTRevoke an issued certificate
/api/admin/certificates/{id}/revoke - POSTStore the signed verification token and Open Badge
/api/admin/certificates/artifacts - POSTMark certificates as emailed to their holders
/api/admin/certificates/mark-emailed
Discord
- GETGet the event's Discord integration state
/api/admin/discord - PATCHTurn the Discord integration on or off
/api/admin/discord - PUTSet the Discord role that may run the bot's staff commands
/api/admin/discord/staff-role - DELETEDetach a player's Discord account
/api/admin/discord/link/{id}