Protocol sandbox
Every soul that reaches the Hall of Maat is written down here.
Your tasks
A code appears when a task is done – type it into the lesson.
Sign in to see your tasks
Tasks check what you did, so they need your account.
Registry of the Duat – GraphQL
One endpoint for every query and mutation, introspection on, subscriptions over WebSocket on the same path. Reads need no account; every change needs a scribe token from loginScribe or a personal API key.
| Field | Token | What it does |
|---|---|---|
getSoul(id) | no | One soul. 20 belong to the gods; yours are visible only to you. |
getSoulLimited(id) | no | The same, at most 2 fields per call. |
allSouls(limit) | no | Newest id first, 10 when limit is not sent. |
currentScribe | no | Your username, or Anonymous scribe. |
registerScribe, loginScribe | – | An account, then a token for 60 minutes. |
createSoul, updateSoul, patchSoulDeeds, banishSoul | yes | Write, change, add one deeds entry, banish. Ids 1–20 answer FORBIDDEN. |
subscription { soulCreated } | yes | Over WebSocket on the same path: each soul you create. |
The schema with every description: schema page, schema.graphql.
How to call it from your tools
Your first query
Sign in
Subscribe (wscat)
The Registry of the Duat is a GraphQL API: read the twenty souls of the gods without signing in, then register as a scribe and create, change and banish souls of your own. Everything you write is yours alone.
Addresses
Sign in on the right first: most calls need your token- GraphQL endpoint
- GraphQL subscriptions (WebSocket)
- REST base URL – sign-in, orders, keys