Sign in
Authentication

Refresh access token

Changed on

Get a new access token using a refresh token. Requires an anon key.

Send refresh_token in the body for the default flow. An eligible cookie-mode browser request may instead send session_mode: cookie with an empty token or omit the request body; the API reads and resets the project's HttpOnly cookie and omits refresh_token from the response.

post/auth/refresh

Request

  • Base URL: https://api.volcano.dev
  • URL: https://api.volcano.dev/auth/refresh
  • Auth: HTTP bearer

Request body

refresh_tokenstring
session_mode'cookie'

Response

Token refreshed

access_tokenstring required

JWT access token (expires after configured lifetime)

token_typestring required
expires_ininteger required

Access token lifetime in seconds

refresh_tokenstring

Long-lived token for getting new access tokens. Omitted when the request uses eligible HttpOnly cookie session storage.

Example response

{
  "token_type": "bearer"
}

Changes

  • 3a6f365f3f35Revision changes
    • ▲

      the response's body type changed from no type to object for status

    • ▲

      the response's body type changed from no type to object for status

    • ▲

      the response's body type changed from no type to object for status

    • ▲

      the response's body type changed from no type to object for status

    • ○

      added the optional property to the response with the status

    • ○

      added the optional property to the response with the status

    • ○

      added the optional property to the response with the status

    • ○

      added the optional property to the response with the status

    • ○

      added the required property to the response with the status

    • ○

      added the required property to the response with the status

    • ○

      added the required property to the response with the status

    • ○

      added the required property to the response with the status

    • ○

      added the required property to the response with the status

    • ○

      added the required property to the response with the status

    • ○

      added the required property to the response with the status

  • bb44e98aba2eRevision changes
    • ▲

      the response's body type changed from object to no type for status

    • ▲

      the response's body type changed from object to no type for status

    • ▲

      the response's body type changed from object to no type for status

    • ▲

      removed the required property from the response with the status

    • ▲

      removed the required property from the response with the status

    • ▲

      removed the required property from the response with the status

    • ▲

      removed the required property from the response with the status

    • ▲

      removed the required property from the response with the status

    • ▲

      removed the required property from the response with the status

    • ▲

      removed the required property from the response with the status

    • ●

      removed the optional property from the response with the status

    • ●

      removed the optional property from the response with the status

    • ○

      added the new optional request property

    • ○

      request body became optional

    • ○

      the request property became optional

    • ○

      added the non-success response with the status