Guides

Everything in Talent is available over a REST API — the dashboard calls the same endpoints you do. These guides get you from an API key to a published course and a verified webhook. For the full endpoint list, see the API reference.

Before you start

Every request is authenticated with an API key. Create one in the dashboard under Developer → API keys, granting it the permissions each guide names. The key is shown once — store it somewhere safe. Send it as a bearer token on every call:

Shell

# Your API base URL and key. In local development the base is
#   http://localhost:3841/api/v1
export TALENT_API="https://your-workspace.example/api/v1"
export TALENT_KEY="tlk_live_…"

curl "$TALENT_API/health" -H "Authorization: Bearer $TALENT_KEY"

Cross-tenant and unknown ids return 404, never 403 — the API never reveals whether a resource exists in another workspace. A missing permission returns 403 with code missing_scope.

Start here

Create your first courseAuthor a course, add a lesson, and publish it — start to finish over HTTP.~5 min
Receive your first webhookRegister an endpoint and verify a signed delivery. Includes the verification snippet.~10 min