Skip to content

Cookie Refresh Token

POST
/api/auth/refresh
curl --request POST \
--url https://example.com/api/auth/refresh

Refresh an access token using the httpOnly refresh cookie.

This is the cold-start path: browser reopened, localStorage empty, but the httpOnly cookie persists. Validates the refresh token, rotates it, and issues a new access token + refresh cookie.

Cookie: canvas_refresh= Returns: {“access_token”: ”…”, “expires_in_minutes”: 480}

  • Set-Cookie: canvas_refresh=<rotated_token>; …

Successful Response

Media type application/json
CookieRefreshResponse

Response from POST /auth/refresh (cookie-based).

object
access_token
required
Access Token
string
expires_in_minutes
required
Expires In Minutes
integer
Example generated
{
"access_token": "example",
"expires_in_minutes": 1
}