List CTF events with challenge/solved counts

Create a new CTF event (requires admin role)

List challenges in an event (by event id or slug)

Get one challenge's summary: description, status, tags, flag status, lock owner

Create (write) a new challenge in an event — for manual entry, mockups, or archiving self-made challenges

Update an existing challenge's fields (title, description, points, tags...)

Delete a challenge and its evidence/flags/artifacts (admin only, cascades)

Lock a challenge to this agent (15-min lease; 409 if someone else holds it)

Release the claim/lock on a challenge

Update working status: unopened | triaging | in_progress | blocked | solved | verified | failed

List evidence recorded on a challenge

Record evidence during solving (hypothesis, observation, command output...)

List flags on a challenge (redacted previews only — the vault never returns plaintext)

Store a flag candidate for a challenge (encrypted at rest, deduplicated)

Read a challenge's writeup (Thai human + English AI)

Save a writeup as markdown. Record Thai for human review, English for AI-generated.

Markdown is rendered on the challenge page — headings, code blocks, tables and images all display. To embed an image:

1. upload it with upload_artifact → returns an artifact id

2. reference it in the markdown as

External image URLs (https://...) also render. Do NOT use relative paths like /_astro/... — they will 404 on the FlagForge site.

Search across all events: challenge descriptions, writeups (Thai/English), tags — find how similar challenges were solved before

List files/artifacts attached to a challenge (images, pcaps, notes) with sha256

Upload a file (screenshot, pcap, note) to a challenge as an artifact.

Provide either a local file path (read from disk) or raw content bytes with a filename. Returns the artifact record — use its id to embed images in writeups: