Skip to content
← All help

Operator

Embed your courses in another app

If another app's backend wants to read your school's published courses (title, description, category, and lesson list), for example to show them inside its own catalog UI, it can, using a per-school API key. This does not require the other app's users to sign in to Learn.WitUS.

Create a key

As an owner or brand admin, go to /admin/api-keys → Create a key, give it a name that says who/what it's for (e.g. "WanderLearn embed"), and click Create key. The full key is shown once, right after creation, copy it into the other app's server-side secret storage immediately. After you leave the page, only a short prefix is shown for identification; the full key can't be retrieved again.

What a key can read

  • GET /api/v1/courses, this school's published, public courses.
  • GET /api/v1/courses/[id], one of those courses plus its published lesson list.

A key only ever sees your school's published content, never drafts, never another school's. Send it as Authorization: Bearer <key> on every request.

Revoke a key

If a key is compromised or no longer needed, click Revoke next to it on /admin/api-keys. Revoking is immediate and permanent (create a new key if you need to reconnect later).

The lighter option: paste-anywhere embeds (no key at all)

For a visual embed with no backend integration, use an <iframe>. Never put an API key in an iframe snippet or any client-side HTML: keys are server-side secrets, and these embeds don't need one. They only ever show published, public content.

  • Course card (recommended, any site). Open your course under /teach and click Embed to get a ready-made copy-paste snippet pointing at /embed/card/<courseId> on your school's own domain: a small branded card (title, description, price) linking back to your course page. Paste it into any website (WordPress, a co-op site, a blog). A course that isn't vetted yet shows its public "Coming soon" face; anything unpublished or non-public shows nothing. Clicks from the card back to your course are counted in that course's Link usage panel.
  • Course view (for partner apps). /embed/course/<courseId> is a chromeless page listing the course's published lessons with a "Continue" link out to the full course, the visual companion to the API above.
Video tutorial scriptnot written yet

Nobody has written the narration for this one yet. It is listed here so the gap is visible rather than forgotten; an invented script would read as approved copy.