register

user.register

Finalises a new user account. Called after verify-otp returns isNewUser: true. Idempotent per session: calling it on an already-registered account is a no-op.

Auth

Bearer JWT required. Vault does not need to be unsealed — this mutation creates the user row and initialises the KMS keys for the caller.

Input

input UserRegisterInput {
    _placeholder: Boolean
}

UserRegisterInput currently has no required fields. Send an empty object.

GraphQL

mutation {
  user {
    register(input: {}) {
      userId
    }
  }
}

Response

{ "data": { "user": { "register": { "userId": "7b4f..." } } } }

curl

curl -X POST https://api.test.geena.eu/graphql \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"query":"mutation { user { register(input: {}) { userId } } }"}'

Errors

  • 401 Missing token / Invalid token — see GraphQL basics.
  • Scope error (data.user: null) — registration failed (e.g. user row already exists with different identity, KMS initialization error). See the errors array.