account

Your account and its API keys.

#Get your account

GET/meaccount.read

The calling account. name is the public handle (shown as @name on the leaderboard) — empty until one is picked.

Returns

User

#Set your handle

POST/me/handleaccount.write

Sets the public handle, which doubles as the display name.

Body

handlestring 2–32 chars: lowercase letters, digits, underscores. Unique across bojo.

Returns

User

#List your API keys

GET/keyskeys.read

Every key on the account, including revoked ones (metadata only).

Returns

keysApiKeyMeta[]

#Register an API key

POST/keyskeys.write

Registers the public half of an Ed25519 keypair as an API key — the private key never leaves you, bojo stores no secret. Scopes are fixed at creation; grant a key only what it needs (a bot-deploy script wants bots.read + bots.write, nothing more). Requests are then authenticated by signing them with the private key — see Automation (optional).

Body

namestring · min length 1 · max length 64
publicKeystring An Ed25519 public key in any common keygen format: an OpenSSH ssh-ed25519 … line (the .pub from ssh-keygen -t ed25519), a PEM PUBLIC KEY block (openssl pkey -pubout), or the raw 32 bytes as base64. Stored and echoed as raw-32-byte base64.
scopes"bots.read" | "bots.write" | "keys.read" | "keys.write" | "account.read" | "account.write"[]

Returns

ApiKeyMeta

#Revoke an API key

POST/keys/{id}/revokekeys.write

Revocation is immediate: signatures from this key stop verifying.

path parameters

idstring

Returns

ApiKeyMeta