Open a Judge Mode session

POST/v1/judge/sessions

Creates a judge: a tenant with no email, no account and no key, signed in with a session cookie until the nightly reset after 12 hours. A judge reads the demo merchant's console (no changes), walks the tour, and can sign its own mandates with a passkey like any user. Five per hour per address, and a cap a day over every address that a judge with the invite is counted apart from.

Headers

Content-Typeapplication/jsonRequired
Idempotency-KeystringRequired: 1 to 255 characters. A retry with the same key returns the first answer.

Request body

application/json

invitestring: The invite from the hackathon's testing instructions.

Responses

201The judge, signed in (the session cookie is set)
403Not called from the app's origin
409Already signed in as someone else
429Too many judges
503Sign-in is not configured

201 response

user_idstringRequired

curl -X POST https://api.keelson.finance/v1/judge/sessions \
  -H 'content-type: application/json' \
  -H "idempotency-key: $(uuidgen)" \
  --data '{"invite":"string"}'

const res = await fetch("https://api.keelson.finance/v1/judge/sessions", {
  method: "POST",
  headers: {
    "content-type": "application/json",
    "idempotency-key": crypto.randomUUID(),
  },
  body: JSON.stringify({
    "invite": "string"
  }),
});
const data = await res.json();

Response · shape from the schema

{
  "user_id": "string"
}