This section contains the API references for the Gradual Public API, organized by resource type:

  • Auth — Verify your API credentials
  • Users — Create, retrieve, update, delete, and batch create user profiles; manage profile questions and contribution logs
  • Events — Manage events, attendees, and registrations
  • Courses — List courses and retrieve their enrollees and certificate recipients
  • Spaces — List and assign spaces
  • Clubs — Manage club memberships, update user clubs, and batch add members
  • Content — Access collections, videos, blogs, podcasts, resources, and external content; add new videos
  • Tags — List, retrieve, create, rename, and delete the content tags used across events, content, courses, and the forum
  • Forum — List and retrieve forum posts and comments
  • Email Unsubscribes — Read custom-email opt-outs and the subscription types they belong to
  • Incremental Sync — Cursor-based change feeds for members, event attendees, course enrollments, and course certificates
  • Settings — Read and update the community's email domain allowlist

All endpoints use the base URL https://api.gradual-api.com/public-api/v1/ and require authentication headers (Authorization and x-client-id) as described in the Getting Started section. Each endpoint is assigned a rate limit tier (Light, Medium, or Heavy) — see the Rate Limits section for details.