api

Refresh an Integration OAuth token

Changed on

Exchanges the current rotating refresh token using a public client ID. Only refresh_token grants and the three documented form fields are accepted. This OAuth endpoint uses flat responses, not the REST data envelope. No client secret or Authorization header is accepted. Refresh credentials must never be logged or retained. Identity verifies current connection authority and the User rollout gate before releasing credentials.

post/v1/oauth/token

Request

  • Base URL
    https://api.fieldguide.io
  • URL
    https://api.fieldguide.io/v1/oauth/token
  • Auth
    none required

Request body application/x-www-form-urlencoded

grant_type'refresh_token' required
client_idstring required

Public Auth0 client ID

refresh_tokenstring required

Current rotating refresh token

Response

Rotated credentials

access_tokenstring required

Access token

token_type'Bearer' required
expires_in900 required

Access token lifetime in seconds

refresh_tokenstring required

New rotating refresh token; replaces the submitted token

scopestring required

Space-delimited granted scopes

Changes