Refresh OAuth2 provider tokens
POST /token/provider/{provider}
Refresh the OAuth2 provider access token using a valid refresh token. Returns a new provider session with updated access token, refresh token (if rotated by provider), and expiration information. This endpoint allows maintaining long-lived access to provider APIs without requiring the user to re-authenticate.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ”The name of the social provider
Request Body required
Section titled “Request Body required ”Provider refresh token to exchange for a new access token
Request to refresh OAuth2 provider tokens
object
OAuth2 provider refresh token obtained from previous authentication
Example
1//0gK8...Responses
Section titled “ Responses ”Successfully refreshed provider tokens
OAuth2 provider session containing access and refresh tokens
object
OAuth2 provider access token for API calls
Example
ya29.a0AfH6SMBx...Number of seconds until the access token expires
Example
3599Timestamp when the access token expires
Example
2024-12-31T23:59:59ZOAuth2 provider refresh token for obtaining new access tokens (if provided by the provider)
Example
1//0gK8...default
Section titled “default ”An error occurred while processing the request
Standardized error response
object
HTTP status error code
Example
400Human-friendly error message
Example
Invalid email formatError code identifying the specific application error