VerseOne API Docs

Auth Requests

Once you have obtained an access token, you need to include it in the Authorization header for every API request to protected endpoints. This tells the server who you are and grants you the rights associated with your token.

Header: Authorization: Bearer {YOUR_AUTH_KEY}

  • Replace {YOUR_AUTH_KEY} with the actual token value you received.
  • All endpoints that require authentication are clearly marked with a requires authentication badge in this documentation.

Retrieving Your Token:

You can quickly generate or revoke your API token by visiting your VerseOne Pro dashboard:

  • Log in to your account.
  • Navigate to the API Settings or Developer section.
  • Click Generate API Token (or Regenerate to replace an existing one).
  • Copy the token and store it securely—treat it like a password.

Handling Token Expiration and Errors

  • Tokens expire after the configured expires_in duration (see the Get Access Token response).
  • If your request returns a 401 Unauthorized error, obtain a fresh token and retry.
  • Never include expired tokens in requests, as they will be rejected by the server.

CONTENT