---
seo:
  description: >-
    Administrative API for CTF platform challenge, analytics, and content
    management.
sidebar:
  label: Overview
title: Athena Jeopardy Admin API
---
Administrative API for CTF platform challenge, analytics, and content management.

Version 1.0.0

## Event settings

- [`GET /api/admin/config`](/api/event-settings/get-api-admin-config) — Get the current event settings.
- [`PATCH /api/admin/config`](/api/event-settings/patch-api-admin-config) — Update the event settings.
- [`GET /api/admin/config/versions`](/api/event-settings/get-api-admin-config-versions) — List every version of the event settings.
- [`POST /api/admin/config/revert`](/api/event-settings/post-api-admin-config-revert) — Roll the event settings back to an earlier version.

## Discord integration

- [`GET /api/admin/discord`](/api/discord-integration/get-api-admin-discord) — Get the event's Discord integration state.
- [`PATCH /api/admin/discord`](/api/discord-integration/patch-api-admin-discord) — Turn the Discord integration on or off.
- [`PUT /api/admin/discord/staff-role`](/api/discord-integration/put-api-admin-discord-staff-role) — Set the Discord role that may run the bot's staff commands.

## Players

- [`POST /api/admin/discord/link`](/api/players/post-api-admin-discord-link) — Attach a Discord account to a player using a link code.
- [`DELETE /api/admin/discord/link/{id}`](/api/players/delete-api-admin-discord-link-by-id) — Detach a player's Discord account.
- [`GET /api/admin/players`](/api/players/get-api-admin-players) — List players with their team and score.
- [`GET /api/admin/players/{id}`](/api/players/get-api-admin-players-by-id) — Get a player's profile, stats and solve history.
- [`DELETE /api/admin/players/{id}`](/api/players/delete-api-admin-players-by-id) — Delete a player and reverse their score contribution.
- [`GET /api/admin/players/{id}/activity`](/api/players/get-api-admin-players-by-id-activity) — Get a player's activity timeline.
- [`POST /api/admin/players/{id}/ban`](/api/players/post-api-admin-players-by-id-ban) — Suspend a player and end their sessions.
- [`POST /api/admin/players/{id}/unban`](/api/players/post-api-admin-players-by-id-unban) — Lift a player's suspension.

## API keys

- [`GET /api/admin/api-keys`](/api/api-keys/get-api-admin-api-keys) — List the organizer API keys.
- [`POST /api/admin/api-keys`](/api/api-keys/post-api-admin-api-keys) — Mint an organizer API key.
- [`DELETE /api/admin/api-keys/{id}`](/api/api-keys/delete-api-admin-api-keys-by-id) — Revoke an organizer API key.
- [`POST /api/admin/api-keys/system`](/api/api-keys/post-api-admin-api-keys-system) — Mint an additional system API key.
- [`GET /api/admin/api-keys/system`](/api/api-keys/get-api-admin-api-keys-system) — List the system API keys.
- [`DELETE /api/admin/api-keys/system/{id}`](/api/api-keys/delete-api-admin-api-keys-system-by-id) — Revoke one system API key.
- [`POST /api/admin/api-keys/revoke-all`](/api/api-keys/post-api-admin-api-keys-revoke-all) — Revoke every organizer API key.

## Analytics

- [`GET /api/admin/stats`](/api/analytics/get-api-admin-stats) — Get the event's headline counts.
- [`GET /api/admin/submissions/over-time`](/api/analytics/get-api-admin-submissions-over-time) — Count submissions per day.
- [`GET /api/admin/analytics/overview`](/api/analytics/get-api-admin-analytics-overview) — Get the analytics overview.
- [`GET /api/admin/analytics/submissions`](/api/analytics/get-api-admin-analytics-submissions) — Break submissions down over a window.
- [`GET /api/admin/analytics/challenges`](/api/analytics/get-api-admin-analytics-challenges) — Break solves and attempts down per challenge.
- [`GET /api/admin/analytics/export`](/api/analytics/get-api-admin-analytics-export) — Download the analytics report.

## Storage and files

- [`GET /api/admin/files`](/api/storage-and-files/get-api-admin-files) — List every challenge file with its download count.
- [`GET /api/admin/storage/usage`](/api/storage-and-files/get-api-admin-storage-usage) — Get the event's storage usage against its quota.
- [`POST /api/admin/storage/upload-url`](/api/storage-and-files/post-api-admin-storage-upload-url) — Reserve quota and presign an upload.
- [`DELETE /api/admin/storage/files/{fileId}`](/api/storage-and-files/delete-api-admin-storage-files-by-file-id) — Delete an uploaded file from the event's storage.

## Image builds

- [`GET /api/admin/image-builds`](/api/image-builds/get-api-admin-image-builds) — List the challenge image builds.
- [`POST /api/admin/image-builds`](/api/image-builds/post-api-admin-image-builds) — Reserve an image build and presign its context upload.
- [`GET /api/admin/image-builds/usable`](/api/image-builds/get-api-admin-image-builds-usable) — List the built images a challenge can run.
- [`GET /api/admin/image-builds/usage`](/api/image-builds/get-api-admin-image-builds-usage) — Get image-build storage usage against the event's quota.
- [`POST /api/admin/image-builds/{id}/start`](/api/image-builds/post-api-admin-image-builds-by-id-start) — Start an image build.
- [`POST /api/admin/image-builds/{id}/cancel`](/api/image-builds/post-api-admin-image-builds-by-id-cancel) — Cancel a running image build.
- [`DELETE /api/admin/image-builds/{id}`](/api/image-builds/delete-api-admin-image-builds-by-id) — Delete an image build and its image.

## Challenges

- [`GET /api/admin/challenges`](/api/challenges/get-api-admin-challenges) — List every challenge.
- [`POST /api/admin/challenges`](/api/challenges/post-api-admin-challenges) — Create a challenge.
- [`GET /api/admin/challenges/{id}`](/api/challenges/get-api-admin-challenges-by-id) — Get one challenge with its hints, files and prerequisites.
- [`PATCH /api/admin/challenges/{id}`](/api/challenges/patch-api-admin-challenges-by-id) — Edit a challenge's own fields.
- [`DELETE /api/admin/challenges/{id}`](/api/challenges/delete-api-admin-challenges-by-id) — Delete a challenge and reverse every point it moved.
- [`GET /api/admin/challenges/by-category`](/api/challenges/get-api-admin-challenges-by-category) — Count challenges per category.
- [`POST /api/admin/challenges/{id}/hints`](/api/challenges/post-api-admin-challenges-by-id-hints) — Add a hint to a challenge.
- [`PUT /api/admin/challenges/{id}/hints/{hintId}`](/api/challenges/put-api-admin-challenges-by-id-hints-by-hint-id) — Edit a hint in place, keeping paid unlocks.
- [`DELETE /api/admin/challenges/{id}/hints/{hintId}`](/api/challenges/delete-api-admin-challenges-by-id-hints-by-hint-id) — Delete a hint and refund every team that bought it.
- [`POST /api/admin/challenges/{id}/files`](/api/challenges/post-api-admin-challenges-by-id-files) — Attach an uploaded file to a challenge.
- [`DELETE /api/admin/challenges/{id}/files/{fileId}`](/api/challenges/delete-api-admin-challenges-by-id-files-by-file-id) — Detach a file from a challenge.
- [`PUT /api/admin/challenges/{id}/flag`](/api/challenges/put-api-admin-challenges-by-id-flag) — Replace a challenge's flag.
- [`POST /api/admin/challenges/{id}/prerequisites`](/api/challenges/post-api-admin-challenges-by-id-prerequisites) — Gate a challenge behind another challenge.
- [`DELETE /api/admin/challenges/{id}/prerequisites/{prerequisiteId}`](/api/challenges/delete-api-admin-challenges-by-id-prerequisites-by-prerequisite-id) — Remove one of a challenge's prerequisites.
- [`POST /api/admin/challenges/{id}/show`](/api/challenges/post-api-admin-challenges-by-id-show) — Publish a challenge, now or at a release time.
- [`POST /api/admin/challenges/{id}/unschedule`](/api/challenges/post-api-admin-challenges-by-id-unschedule) — Return a scheduled challenge to hidden.
- [`POST /api/admin/challenges/{id}/lock`](/api/challenges/post-api-admin-challenges-by-id-lock) — Lock a live challenge and reap its instances.
- [`POST /api/admin/challenges/{id}/unlock`](/api/challenges/post-api-admin-challenges-by-id-unlock) — Unlock a locked challenge.
- [`GET /api/admin/challenges/{id}/deletion-preview`](/api/challenges/get-api-admin-challenges-by-id-deletion-preview) — Preview what deleting a challenge would change.

## Audit

- [`GET /api/admin/audit`](/api/audit/get-api-admin-audit) — Read the event's audit trail.

## Teams

- [`GET /api/admin/teams`](/api/teams/get-api-admin-teams) — List teams by score.
- [`GET /api/admin/teams/{id}`](/api/teams/get-api-admin-teams-by-id) — Get a team's profile, members and solve history.
- [`PATCH /api/admin/teams/{id}`](/api/teams/patch-api-admin-teams-by-id) — Rename a team.
- [`DELETE /api/admin/teams/{id}`](/api/teams/delete-api-admin-teams-by-id) — Delete an empty team.
- [`POST /api/admin/teams/{id}/members`](/api/teams/post-api-admin-teams-by-id-members) — Move a player onto a team.
- [`DELETE /api/admin/teams/{id}/members/{userId}`](/api/teams/delete-api-admin-teams-by-id-members-by-user-id) — Remove a player from a team.

## Scoring

- [`POST /api/admin/score-adjustments`](/api/scoring/post-api-admin-score-adjustments) — Adjust a team or player's score by hand.
- [`GET /api/admin/leaderboard`](/api/scoring/get-api-admin-leaderboard) — Get the current leaderboard.
- [`POST /api/admin/leaderboard/rebuild`](/api/scoring/post-api-admin-leaderboard-rebuild) — Recompute the standings from the event's recorded results.
- [`GET /api/admin/leaderboard/progression`](/api/scoring/get-api-admin-leaderboard-progression) — Track the top teams' scores over time.

## Announcements

- [`GET /api/admin/announcements`](/api/announcements/get-api-admin-announcements) — List the announcements.
- [`POST /api/admin/announcements`](/api/announcements/post-api-admin-announcements) — Post an announcement.
- [`PATCH /api/admin/announcements/{id}`](/api/announcements/patch-api-admin-announcements-by-id) — Edit an announcement.
- [`DELETE /api/admin/announcements/{id}`](/api/announcements/delete-api-admin-announcements-by-id) — Delete an announcement.

## Taxonomy

- [`GET /api/admin/categories`](/api/taxonomy/get-api-admin-categories) — List the challenge categories.
- [`POST /api/admin/categories`](/api/taxonomy/post-api-admin-categories) — Create a challenge category.
- [`GET /api/admin/difficulties`](/api/taxonomy/get-api-admin-difficulties) — List the challenge difficulties.
- [`POST /api/admin/difficulties`](/api/taxonomy/post-api-admin-difficulties) — Create a challenge difficulty.
- [`PATCH /api/admin/categories/{id}`](/api/taxonomy/patch-api-admin-categories-by-id) — Rename a challenge category.
- [`DELETE /api/admin/categories/{id}`](/api/taxonomy/delete-api-admin-categories-by-id) — Delete an unused challenge category.
- [`PATCH /api/admin/difficulties/{id}`](/api/taxonomy/patch-api-admin-difficulties-by-id) — Edit a challenge difficulty.
- [`DELETE /api/admin/difficulties/{id}`](/api/taxonomy/delete-api-admin-difficulties-by-id) — Delete an unused challenge difficulty.

## Drafts

- [`GET /api/admin/drafts`](/api/drafts/get-api-admin-drafts) — List the challenge drafts.
- [`POST /api/admin/drafts`](/api/drafts/post-api-admin-drafts) — Create or save a challenge draft.
- [`GET /api/admin/drafts/{id}`](/api/drafts/get-api-admin-drafts-by-id) — Get a challenge draft.
- [`DELETE /api/admin/drafts/{id}`](/api/drafts/delete-api-admin-drafts-by-id) — Delete a challenge draft.
- [`POST /api/admin/drafts/{id}/publish`](/api/drafts/post-api-admin-drafts-by-id-publish) — Publish a draft as a challenge.

## Reports

- [`GET /api/admin/challenge-reports`](/api/reports/get-api-admin-challenge-reports) — List the player reports.
- [`GET /api/admin/challenge-reports/{id}`](/api/reports/get-api-admin-challenge-reports-by-id) — Get a report with its full thread.
- [`PATCH /api/admin/challenge-reports/{id}`](/api/reports/patch-api-admin-challenge-reports-by-id) — Close a report.
- [`POST /api/admin/challenge-reports/{id}/admin-messages`](/api/reports/post-api-admin-challenge-reports-by-id-admin-messages) — Reply to a report as an organizer.

## Submissions

- [`GET /api/admin/submissions`](/api/submissions/get-api-admin-submissions) — List flag submissions.

## Challenge instances

- [`GET /api/admin/challenge-instances`](/api/challenge-instances/get-api-admin-challenge-instances) — List the challenge instances.
- [`GET /api/admin/challenge-instances/drift`](/api/challenge-instances/get-api-admin-challenge-instances-drift) — Find instances that drifted from the runner's view.
- [`POST /api/admin/challenge-instances/reap`](/api/challenge-instances/post-api-admin-challenge-instances-reap) — Terminate running challenge instances.

## Anti-cheat

- [`GET /api/admin/anticheat/status`](/api/anti-cheat/get-api-admin-anticheat-status) — Get the anti-cheat run status and detection coverage.
- [`GET /api/admin/anticheat/findings`](/api/anti-cheat/get-api-admin-anticheat-findings) — List anti-cheat findings.
- [`GET /api/admin/anticheat/findings/{id}`](/api/anti-cheat/get-api-admin-anticheat-findings-by-id) — Get a finding with its signals and evidence.
- [`PATCH /api/admin/anticheat/findings/{id}`](/api/anti-cheat/patch-api-admin-anticheat-findings-by-id) — Move a finding through review.
- [`GET /api/admin/anticheat/exclusions`](/api/anti-cheat/get-api-admin-anticheat-exclusions) — List the subjects anti-cheat skips.
- [`POST /api/admin/anticheat/exclusions`](/api/anti-cheat/post-api-admin-anticheat-exclusions) — Exclude a team or player from anti-cheat.
- [`DELETE /api/admin/anticheat/exclusions/{id}`](/api/anti-cheat/delete-api-admin-anticheat-exclusions-by-id) — Put an excluded subject back under anti-cheat.

## Feedback

- [`GET /api/admin/feedback`](/api/feedback/get-api-admin-feedback) — Read the player feedback with its rating summary.

## Writeups

- [`GET /api/admin/writeups`](/api/writeups/get-api-admin-writeups) — List the submitted writeups.
- [`GET /api/admin/writeups/{id}/download`](/api/writeups/get-api-admin-writeups-by-id-download) — Presign a writeup download.

## Certificates

- [`GET /api/admin/certificates/templates`](/api/certificates/get-api-admin-certificates-templates) — List the certificate templates.
- [`POST /api/admin/certificates/templates`](/api/certificates/post-api-admin-certificates-templates) — Create a certificate template.
- [`GET /api/admin/certificates/templates/{id}`](/api/certificates/get-api-admin-certificates-templates-by-id) — Get a certificate template with its background URL.
- [`DELETE /api/admin/certificates/templates/{id}`](/api/certificates/delete-api-admin-certificates-templates-by-id) — Delete a certificate template.
- [`PUT /api/admin/certificates/templates/{id}/draft`](/api/certificates/put-api-admin-certificates-templates-by-id-draft) — Save a certificate template's draft layout.
- [`POST /api/admin/certificates/templates/{id}/background`](/api/certificates/post-api-admin-certificates-templates-by-id-background) — Attach an uploaded background to a certificate draft.
- [`POST /api/admin/certificates/templates/{id}/publish`](/api/certificates/post-api-admin-certificates-templates-by-id-publish) — Publish a certificate template's draft as a version.
- [`GET /api/admin/certificates/templates/{id}/versions/{version}`](/api/certificates/get-api-admin-certificates-templates-by-id-versions-by-version) — Get a published version of a certificate template.
- [`GET /api/admin/certificates/tiers`](/api/certificates/get-api-admin-certificates-tiers) — Get the certificate tiers.
- [`PUT /api/admin/certificates/tiers`](/api/certificates/put-api-admin-certificates-tiers) — Replace the certificate tiers.
- [`GET /api/admin/certificates/samples`](/api/certificates/get-api-admin-certificates-samples) — Preview a sample credential per tier.
- [`GET /api/admin/certificates`](/api/certificates/get-api-admin-certificates) — List the issued certificates.
- [`POST /api/admin/certificates/issue`](/api/certificates/post-api-admin-certificates-issue) — Issue certificates to the qualifying players.
- [`POST /api/admin/certificates/{id}/revoke`](/api/certificates/post-api-admin-certificates-by-id-revoke) — Revoke an issued certificate.
- [`POST /api/admin/certificates/artifacts`](/api/certificates/post-api-admin-certificates-artifacts) — Store the signed verification token and Open Badge.
- [`POST /api/admin/certificates/mark-emailed`](/api/certificates/post-api-admin-certificates-mark-emailed) — Mark certificates as emailed to their holders.
