CLI Sessions

The CLI authentication flow creates a session, opens a browser for login, and polls until complete.

Create a session

POST /api/v1/auth/cli/sessions

{
  "session_id": "uuid"
}

GET /api/v1/auth/cli/sessions/:sessionId

{
  "status": "pending",
  "api_key": null,
  "email": null
}

Status values: pending, active, expired. When active, the response includes the API key and email:

{
  "status": "active",
  "api_key": "aat_abc123...",
  "email": "user@example.com"
}

GET /api/v1/auth/me

Header	Required	Description
`Authorization`	Yes	`Bearer <api_key>`

{
  "email": "user@example.com",
  "api_key_prefix": "aat_abc1"
}

⌘I