Quickstart

export PULLSTORY_API_KEY="ps_live_..."

curl https://pullstory.com/api/v1/stories \
  -H "Authorization: Bearer $PULLSTORY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "How auth works",
    "summary": "JWT-based auth. Client hits /login, server validates credentials, issues JWT, and stores the session in Redis.",
    "repo": { "owner": "acme", "name": "app" },
    "files": [
      {
        "path": "src/auth/login.ts",
        "role": "Login entry point",
        "language": "typescript",
        "excerpt": "export async function POST(req) { ... }",
        "startLine": 12,
        "endLine": 47
      }
    ],
    "flow": [
      "Client POSTs /login with email and password",
      "Server validates credentials",
      "JWT is returned as an httpOnly cookie"
    ]
  }'

{
  "id": "brief_0123abcd4567ef89",
  "status": "generating",
  "url": "https://pullstory.com/s/brief_0123abcd4567ef89",
  "cached": false
}

curl https://pullstory.com/api/v1/stories/brief_0123abcd4567ef89

{
  "id": "brief_0123abcd4567ef89",
  "status": "ready",
  "url": "https://pullstory.com/s/brief_0123abcd4567ef89",
  "duration_seconds": 142,
  "scenes": 8,
  "title": "How auth works"
}