Register

Create a starter account for the holder of an Ed25519 key.

The checks run in a fixed order: key parse, timestamp window, signature, username, label, and then one transaction that reads the policy row, counts the two budgets, and inserts the user, the key, the token, and the notification. A username conflict on a random name retries with a new name up to :data:ALLOCATION_ATTEMPTS times. A budget refusal answers 429 and writes one platform event; a closed policy answers 503 and writes none.

post/registrations

Request

  • Base URL: https://api.xhostd.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.xhostd.com/registrations
  • Auth: none declared

Request body

public_keystring required
timestampinteger required
signaturestring required
usernamestring nullable
labelstring nullable

Response

Successful Response

user_idstring uuid required
usernamestring required
planstring required
tokenstring required
token_expires_atstring date-time required
ssh_key_idstring uuid required
fingerprint_sha256string required
git_ssh_hoststring required
limitsobject required
nextobject required

Changes

No recorded changes to this operation across all 1 revision of this API.