Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.grantiva.io/llms.txt

Use this file to discover all available pages before exploring further.

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

​
Response

{
  "session_id": "uuid"
}

​
Poll session status

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

​
Response

{
  "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"
}

​
Validate API key

GET /api/v1/auth/me

​
Headers

HeaderRequiredDescription
AuthorizationYesBearer <api_key>

​
Response

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