Your API key:

All requests below will use this key. Your API key is sent directly to api.cueapi.ai and never stored by the docs site.

POST/v1/auth/session/refresh

Refresh Session

Issue a fresh session JWT with a new 1-year expiry. Requires a still-valid session token.

Issues a fresh session JWT with a new 1-year expiry. Used by the dashboard for rolling renewal — call before expiry while the existing token is still valid.

Note

Requires a non-expired session JWT in the bearer header. If the token has expired, the user must redo the device-code login flow and call POST /v1/auth/session instead.

Request

bash

curl -X POST https://api.cueapi.ai/v1/auth/session/refresh \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.…"

Response

json

{
  "session_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.NEW.…",
  "email": "[email protected]"
}

When to call

Refresh ahead of expiry — the dashboard calls this at app boot if the token is more than 30 days from expiring. There is no rate limit beyond the standard auth bucket.

Errors

Status	Code	Cause
401	`not_authenticated`	Token expired or invalid signature
503	`session_unavailable`	JWT signing key not configured on this deployment

POST/v1/auth/session/refresh

Try it

Request Body

Enter your API key above to send requests

Previous← Create Session NextMCP Token Exchange →