TorekaVault API

Developer Docs

Task-First API Quickstart

Start with base URL + auth, then split into API-key catalog reads and session-backed dashboard/admin workflows.

Quickstart

Choose your first workflow

Session cookies power dashboard/admin routes, while catalog and inventory reads accept X-API-Key or an active session cookie.

Auth

Get authenticated and make API calls

  1. Choose a base URL: production https://database.torekavault.com/api or local http://localhost:3000.
  2. Create your workspace on /signup.html.
  3. Confirm your email with Cognito, then sign in on /login.html.
  4. Open /dashboard.html and generate an API key in API Keys.
  5. Send your key in X-API-Key for catalog routes like GET /cards, GET /sets, and GET /inventory/prints/{cardPrintId}.
  6. Validate request volume and route health in dashboard usage analytics.

Admin

Run admin card edits in the dashboard

  1. Sign in to your workspace and open /dashboard.html.
  2. Use the same session to access /auth/session, /admin/*, /api-keys, /account, and /analytics/request-usage.
  3. In Admin card editor, load an existing card by UUID or use an example button.
  4. Edit card fields, image URL, and JSON attributes.
  5. Save a small, reversible patch and verify success in the editor panel.
  6. Non-admin authenticated users receive 403 on admin mutation routes.
  7. Confirm changes with read endpoints in the API reference below.

Reference

OpenAPI specification