Refresh Access Token

Overview

This endpoint allows your application to obtain a new access_token (and often a new refresh_token) by exchanging an expired access_token's associated refresh_token. This process allows your application to maintain continuous access to the Hover API without requiring the user to re-authenticate.

Access tokens have a limited lifespan (2 hours). Once an access_token expires, it can no longer be used to make API requests. The refresh_token provides a secure mechanism to acquire a new, valid access_token programmatically, ensuring a seamless user experience.

Refreshing your Access Token

• Maintain Continuous Access: Acquire a new access_token when the current one expires, preventing interruptions to your application's functionality.
• Automated Token Management: Automate the process of obtaining new access credentials, eliminating the need for repeated user logins.

Sample Request Body

When refreshing an access_token using a refresh_token:

{
  "grant_type": "refresh_token",
  "refresh_token": "your_current_refresh_token_here",
  "client_id": "your_client_id_here",
  "client_secret": "your_client_secret_here"
}

Sample Response Body

The response body, when successful, will generate new tokens.

{
    "access_token": "eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOnsi",
    "token_type": "Bearer",
    "expires_in": 7200,
    "refresh_token": "q90aLQhunR_JZ1MQ0kivxtAV",
    "scope": "all",
    "created_at": 1750191095,
    "owner_id": 785,
    "owner_type": "orgs"
}