Geena User API

Geena User API

Reference documentation for the User scope of the Geena GraphQL API.

What’s here

  • Getting Started — authentication (email-OTP → JWT) and how to call the unified GraphQL endpoint.
  • User API — register, status, vault seal/unseal, document and file operations, shared vaults.
  • Reference — enums and error codes.

Endpoints at a glance

Purpose Method Path Auth
Send OTP code POST /auth/send-otp public
Verify OTP → get JWT POST /auth/verify-otp public
Renew session POST /auth/renew Bearer JWT
Verify 2nd email send POST /auth/verify-email/send Bearer JWT
Verify 2nd email cfm POST /auth/verify-email/confirm Bearer JWT
All GraphQL ops POST /graphql Bearer JWT

Base URL (test env): https://api.test.geena.eu

Unified GraphQL

There is one GraphQL endpoint (POST /graphql). Scopes are fields on the root:

type Query    { admin, business(orgId: ID!), user, guest }
type Mutation { admin, business(orgId: ID!), user, organizationCreate(...) }

Every operation in these docs is nested under user { ... }. Scope roots are nullable — a scope-level error yields { "data": { "user": null }, "errors": [...] }.