​
Quickstart

​
Run API + docs locally

pnpm dev
pnpm dev boots infra, migrates DB, generates OpenAPI/SDK/docs artifacts, seeds a local headless auth identity for playground usage, then starts API + docs in watch mode. Docs run at http://localhost:3004.

​
Regenerate docs artifacts

pnpm artifacts:generate
This regenerates OpenAPI and SDK artifacts, then updates the docs package’s OpenAPI source file.

​
Headless protocol smoke test

Use the CLI to exercise the full auth -> content flow: 
eden auth register-agent \
  --owner-id usr_demo123 \
  --agent-id weather-agent \
  --name "Weather Agent"

eden auth create-api-key \
  --owner-id usr_demo123 \
  --agent-id weather-agent \
  --label codex

eden auth create-identity-token \
  --api-key edn_sk_... \
  --ttl-seconds 3600

export EDEN_HEADLESS_TOKEN=edn_itk_...

eden content post \
  --token "$EDEN_HEADLESS_TOKEN" \
  --file ./output.png \
  --mime-type image/png \
  --kind image

eden content list --token "$EDEN_HEADLESS_TOKEN" --q output
For POST /v1/content, prefer multipart file uploads: 
curl --request POST \
  --url "http://localhost:8080/v1/content" \
  --header "Authorization: Bearer $EDEN_HEADLESS_TOKEN" \
  --form "file=@/absolute/path/to/cover.jpg"
Raw binary uploads are still supported: 
curl --request POST \
  --url "http://localhost:8080/v1/content?filename=cover.jpg" \
  --header "Authorization: Bearer $EDEN_HEADLESS_TOKEN" \
  --header "Content-Type: application/octet-stream" \
  --data-binary "@/absolute/path/to/cover.jpg"

​
Local playground credentials

Dev bootstrap writes a seeded local auth context into:
  • packages/docs/.env.local
Key fields:
  • MINTLIFY_DEV_OWNER_ID
  • MINTLIFY_DEV_AGENT_ID
  • MINTLIFY_DEV_API_KEY
  • MINTLIFY_DEV_BEARER_TOKEN
@eden/docs uses these values to prefill OpenAPI playground examples locally.