Skip to main content

Overview

These docs cover only the latest business-facing APIs introduced in the /v1 namespace.
  • Base URL (production): https://b2b-api-backend-95487.ondigitalocean.app
  • API version in this guide: v1
  • Auth model: admin-key for organization bootstrap, x-api-key for business API calls

What is included

  • Organization bootstrap:
    • POST /v1/createOrganization
  • Source lifecycle:
    • POST /v1/sources/upload-url
    • GET /v1/sources
    • GET /v1/sources/{sourceId}
    • DELETE /v1/sources/{sourceId}
  • Generated resources:
    • Flashcards (/v1/flashcards, /v1/sources/{sourceId}/flashcards)
    • Mindmaps (/v1/mindmaps, /v1/sources/{sourceId}/mindmaps)
    • Quizzes (/v1/quizzes, /v1/sources/{sourceId}/quizzes)

OpenAPI spec

The source OpenAPI file for these APIs lives at:
  • docs/openapi/v1.yaml
Use this spec for client generation, request validation, and CI linting.