The REST surface

Every tool is mirrored by a route, and this is where they are. The contract is still the tool's own description — what each argument admits, what it defaults to, what it refuses — and this page carries none of it: see reference/surface.md for reading a description over either surface.

{game} is a game's slug, from whoami. A body is JSON and Content-Type: application/json is required. Authenticate with Authorization: Bearer <token>, the same token the MCP transport takes.

admins

• PATCH /api/admins

analysis

• POST /api/games/{game}/analysis/cycles
• POST /api/games/{game}/analysis/orphans
• POST /api/games/{game}/analysis/unreachable

assets

• GET /api/games/{game}/assets
• POST /api/games/{game}/assets
• DELETE /api/games/{game}/assets/{id}
• GET /api/games/{game}/assets/{id}

auth

• POST /api/auth/login
• POST /api/auth/logout
• POST /api/auth/register

comments

• GET /api/games/{game}/comments
• POST /api/games/{game}/comments
• DELETE /api/games/{game}/comments/{comment}

config

• GET /api/config

docs

• GET /api/games/{game}/docs
• POST /api/games/{game}/docs
• POST /api/games/{game}/docs/batch
• GET /api/games/{game}/docs/comparison
• GET /api/games/{game}/docs/diff
• GET /api/games/{game}/docs/history
• GET /api/games/{game}/docs/kinds
• DELETE /api/games/{game}/docs/links
• GET /api/games/{game}/docs/links
• POST /api/games/{game}/docs/links
• POST /api/games/{game}/docs/move
• DELETE /api/games/{game}/docs/one
• GET /api/games/{game}/docs/one
• GET /api/games/{game}/docs/rendered
• POST /api/games/{game}/docs/revert
• GET /api/games/{game}/docs/version

entities

• GET /api/games/{game}/entities
• POST /api/games/{game}/entities
• DELETE /api/games/{game}/entities/by-key/{type}/{key}
• GET /api/games/{game}/entities/by-key/{type}/{key}
• GET /api/games/{game}/entities/by-key/{type}/{key}/images
• POST /api/games/{game}/entities/by-key/{type}/{key}/images
• DELETE /api/games/{game}/entities/by-key/{type}/{key}/images/{image}
• POST /api/games/{game}/entities/repair

events

• GET /api/games/{game}/events

games

• GET /api/games
• POST /api/games
• DELETE /api/games/{game}
• PATCH /api/games/{game}

invites

• GET /api/games/{game}/invites
• POST /api/games/{game}/invites
• DELETE /api/games/{game}/invites/{invite}
• GET /api/invites
• POST /api/invites
• DELETE /api/invites/{invite}

mcp

• GET /api/mcp/tools

me

• GET /api/me
• PATCH /api/me/locale
• PATCH /api/me/password

members

• GET /api/games/{game}/members
• DELETE /api/games/{game}/members/{user}
• PATCH /api/games/{game}/members/{user}

relation-types

• GET /api/games/{game}/relation-types
• POST /api/games/{game}/relation-types
• DELETE /api/games/{game}/relation-types/by-key/{key}
• GET /api/games/{game}/relation-types/by-key/{key}
• POST /api/games/{game}/relation-types/rename

relations

• GET /api/games/{game}/relations
• POST /api/games/{game}/relations
• DELETE /api/games/{game}/relations/one
• GET /api/games/{game}/relations/one
• POST /api/games/{game}/relations/repair

routes

• GET /api/games/{game}/routes
• POST /api/games/{game}/routes
• DELETE /api/games/{game}/routes/by-key/{key}
• GET /api/games/{game}/routes/by-key/{key}
• POST /api/games/{game}/routes/by-key/{key}/check

search

• GET /api/games/{game}/search

summary

• GET /api/games/{game}/summary

tokens

• GET /api/games/{game}/tokens
• POST /api/games/{game}/tokens
• DELETE /api/games/{game}/tokens/{token}

types

• GET /api/games/{game}/types
• POST /api/games/{game}/types
• DELETE /api/games/{game}/types/by-key/{key}
• GET /api/games/{game}/types/by-key/{key}
• POST /api/games/{game}/types/rename

users

• GET /api/users
• PATCH /api/users/{user}

views

• GET /api/games/{game}/views
• POST /api/games/{game}/views
• DELETE /api/games/{game}/views/by-key/{key}
• GET /api/games/{game}/views/by-key/{key}
• POST /api/games/{game}/views/by-key/{key}/background
• POST /api/games/{game}/views/by-key/{key}/positions
• POST /api/games/{game}/views/by-key/{key}/positions/clear
• GET /api/games/{game}/views/renderers
• POST /api/games/{game}/views/run
• POST /api/games/{game}/views/validate