Athena Jeopardy Admin API
Administrative API for CTF platform challenge, analytics, and content management.
Version 1.0.0
Event settings
- GETGet the current event settings
/api/admin/config - PATCHUpdate the event settings
/api/admin/config - GETList every version of the event settings
/api/admin/config/versions - POSTRoll the event settings back to an earlier version
/api/admin/config/revert
Discord integration
- 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
Players
- POSTAttach a Discord account to a player using a link code
/api/admin/discord/link - DELETEDetach a player's Discord account
/api/admin/discord/link/{id} - GETList players with their team and score
/api/admin/players - GETGet a player's profile, stats and solve history
/api/admin/players/{id} - DELETEDelete a player and reverse their score contribution
/api/admin/players/{id} - GETGet a player's activity timeline
/api/admin/players/{id}/activity - POSTSuspend a player and end their sessions
/api/admin/players/{id}/ban - POSTLift a player's suspension
/api/admin/players/{id}/unban
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} - POSTRevoke every organizer API key
/api/admin/api-keys/revoke-all
Analytics
- GETGet the event's headline counts
/api/admin/stats - GETCount submissions per day
/api/admin/submissions/over-time - GETGet the analytics overview
/api/admin/analytics/overview - GETBreak submissions down over a window
/api/admin/analytics/submissions - GETBreak solves and attempts down per challenge
/api/admin/analytics/challenges - GETDownload the analytics report
/api/admin/analytics/export
Storage and files
- GETList every challenge file with its download count
/api/admin/files - GETGet the event's storage usage against its quota
/api/admin/storage/usage - POSTReserve quota and presign an upload
/api/admin/storage/upload-url - DELETEDelete an uploaded file from the event's storage
/api/admin/storage/files/{fileId}
Image builds
- GETList the challenge image builds
/api/admin/image-builds - POSTReserve an image build and presign its context upload
/api/admin/image-builds - GETList the built images a challenge can run
/api/admin/image-builds/usable - GETGet image-build storage usage against the event's quota
/api/admin/image-builds/usage - POSTStart an image build
/api/admin/image-builds/{id}/start - POSTCancel a running image build
/api/admin/image-builds/{id}/cancel - DELETEDelete an image build and its image
/api/admin/image-builds/{id}
Challenges
- GETList every challenge
/api/admin/challenges - POSTCreate a challenge
/api/admin/challenges - GETGet one challenge with its hints, files and prerequisites
/api/admin/challenges/{id} - PATCHEdit a challenge's own fields
/api/admin/challenges/{id} - DELETEDelete a challenge and reverse every point it moved
/api/admin/challenges/{id} - GETCount challenges per category
/api/admin/challenges/by-category - POSTAdd a hint to a challenge
/api/admin/challenges/{id}/hints - PUTEdit a hint in place, keeping paid unlocks
/api/admin/challenges/{id}/hints/{hintId} - DELETEDelete a hint and refund every team that bought it
/api/admin/challenges/{id}/hints/{hintId} - POSTAttach an uploaded file to a challenge
/api/admin/challenges/{id}/files - DELETEDetach a file from a challenge
/api/admin/challenges/{id}/files/{fileId} - PUTReplace a challenge's flag
/api/admin/challenges/{id}/flag - POSTGate a challenge behind another challenge
/api/admin/challenges/{id}/prerequisites - DELETERemove one of a challenge's prerequisites
/api/admin/challenges/{id}/prerequisites/{prerequisiteId} - POSTPublish a challenge, now or at a release time
/api/admin/challenges/{id}/show - POSTReturn a scheduled challenge to hidden
/api/admin/challenges/{id}/unschedule - POSTLock a live challenge and reap its instances
/api/admin/challenges/{id}/lock - POSTUnlock a locked challenge
/api/admin/challenges/{id}/unlock - GETPreview what deleting a challenge would change
/api/admin/challenges/{id}/deletion-preview
Audit
Teams
- GETList teams by score
/api/admin/teams - GETGet a team's profile, members and solve history
/api/admin/teams/{id} - PATCHRename a team
/api/admin/teams/{id} - DELETEDelete an empty team
/api/admin/teams/{id} - POSTMove a player onto a team
/api/admin/teams/{id}/members - DELETERemove a player from a team
/api/admin/teams/{id}/members/{userId}
Scoring
- POSTAdjust a team or player's score by hand
/api/admin/score-adjustments - GETGet the current leaderboard
/api/admin/leaderboard - POSTRecompute the standings from the event's recorded results
/api/admin/leaderboard/rebuild - GETTrack the top teams' scores over time
/api/admin/leaderboard/progression
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}
Taxonomy
- GETList the challenge categories
/api/admin/categories - POSTCreate a challenge category
/api/admin/categories - GETList the challenge difficulties
/api/admin/difficulties - POSTCreate a challenge difficulty
/api/admin/difficulties - PATCHRename a challenge category
/api/admin/categories/{id} - DELETEDelete an unused challenge category
/api/admin/categories/{id} - PATCHEdit a challenge difficulty
/api/admin/difficulties/{id} - DELETEDelete an unused challenge difficulty
/api/admin/difficulties/{id}
Drafts
- GETList the challenge drafts
/api/admin/drafts - POSTCreate or save a challenge draft
/api/admin/drafts - GETGet a challenge draft
/api/admin/drafts/{id} - DELETEDelete a challenge draft
/api/admin/drafts/{id} - POSTPublish a draft as a challenge
/api/admin/drafts/{id}/publish
Reports
- GETList the player reports
/api/admin/challenge-reports - GETGet a report with its full thread
/api/admin/challenge-reports/{id} - PATCHClose a report
/api/admin/challenge-reports/{id} - POSTReply to a report as an organizer
/api/admin/challenge-reports/{id}/admin-messages
Submissions
Challenge instances
- GETList the challenge instances
/api/admin/challenge-instances - GETFind instances that drifted from the runner's view
/api/admin/challenge-instances/drift - POSTTerminate running challenge instances
/api/admin/challenge-instances/reap
Anti-cheat
- GETGet the anti-cheat run status and detection coverage
/api/admin/anticheat/status - GETList anti-cheat findings
/api/admin/anticheat/findings - GETGet a finding with its signals and evidence
/api/admin/anticheat/findings/{id} - PATCHMove a finding through review
/api/admin/anticheat/findings/{id} - GETList the subjects anti-cheat skips
/api/admin/anticheat/exclusions - POSTExclude a team or player from anti-cheat
/api/admin/anticheat/exclusions - DELETEPut an excluded subject back under anti-cheat
/api/admin/anticheat/exclusions/{id}
Feedback
Writeups
- GETList the submitted writeups
/api/admin/writeups - GETPresign a writeup download
/api/admin/writeups/{id}/download
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