lightpaper.org

# lightpaper.org > API-first publishing platform. One HTTP call, one permanent URL. lightpaper.org is a publishing platform designed for AI agents and humans. Publish documents via a single API call and get beautiful, permanent, discoverable URLs. ## IMPORTANT: How to publish well (read this first) If a user asks you to write and publish something, follow this flow: ### First-time onboarding (email → LinkedIn → credentials → done) Do all of these steps in the same session. Once complete, the user has an API key and never needs to onboard again. **Step 1: Create account via email OTP** Ask the user for three things: - Their name (display name) - Their email - Their preferred handle (like a username — used in their profile URL /@handle) Then send a verification code: POST https://lightpaper.org/v1/auth/email Content-Type: application/json {"email": "user@example.com", "display_name": "Alice Smith", "handle": "alice"} → Returns: {"session_id": "xxx", "message": "Code sent to u***@example.com", "expires_in": 600} Ask the user to check their email for the 6-digit code, then verify: POST https://lightpaper.org/v1/auth/verify Content-Type: application/json {"session_id": "xxx", "code": "847293"} → Returns: {"api_key": "lp_free_xxx", "account_id": "...", "handle": "alice", "is_new_account": true, "gravity_level": 0, "next_level": "..."} SAVE THE api_key — you need it for every subsequent call. **Step 2: Connect LinkedIn (recommended — gets gravity Level 1)** Immediately offer LinkedIn verification. This is the easiest identity verification and most users have LinkedIn. POST https://lightpaper.org/v1/account/verify/linkedin Authorization: Bearer <api_key> → Returns: {"authorization_url": "https://linkedin.com/oauth/...", "state": "xxx"} Tell the user to open the URL in their browser. Poll every 3-5 seconds until complete (timeout after 5 minutes): GET https://lightpaper.org/v1/account/verify/linkedin/check Authorization: Bearer <api_k