Refresh Google access token

Refreshes a Google access token using the server-held Google OAuth client id and secret. Google usually omits refresh_token on refresh; the desktop should preserve the old refresh token.

post/v1/google-oauth/refresh

Request

Base URL: / (relative, and the document was published on a file host, not at the API’s origin)
URL: /v1/google-oauth/refresh
Auth: HTTP bearer

Request body

refreshTokenstring required

Google refresh token from a prior claim.

Example request

{
  "refreshToken": "1//refresh"
}

Response

Refreshed Google access token bundle.

access_tokenstring required

Provider access token.

expires_atinteger required

Unix timestamp in seconds when the access token expires.

refresh_tokenstring nullable

Provider refresh token, present on claim when the provider issues one.

scopestring nullable

Space-delimited OAuth scopes.

token_typestring nullable

OAuth token type.

Example response

{
  "access_token": "example-access-token",
  "expires_at": 1790784000,
  "refresh_token": "1//refresh",
  "scope": "openid email profile https://www.googleapis.com/auth/gmail.readonly",
  "token_type": "Bearer"
}

Changes

No operation changes recorded.