For AI agents: the documentation index is at /llms.txt, and this page is available as Markdown at /api/auth/refresh-token.md.

Refresh access token

POST
/token/refresh

Exchange a valid refresh token for a new access/refresh token pair

Request Body

application/json
  1. body
refresh_token*string

The refresh token to exchange

Response Body

Tokens refreshed successfully

application/json
  1. response
access_token*string

JWT access token

refresh_token*string

JWT refresh token

expires_in*string

Access token expiration timestamp

Formatdate-time
token_type*string

Token type (always "Bearer")

device_token?string

Marks this client as signed in to the inbox by email; send it back as X-Device-Token. Present only on an email sign-in.

turnkey_session?

A Turnkey session on the public key a provider sign-in sent. Absent when none was asked for or none could be issued.

Example Request
curl -X POST 'https://api.truemarkets.co/v1/auth/token/refresh' \  -H 'Content-Type: application/json' \  -d '{  "refresh_token": "string"}'
Example Response
{  "access_token": "string",  "refresh_token": "string",  "expires_in": "2019-08-24T14:15:22Z",  "token_type": "Bearer",  "device_token": "string",  "turnkey_session": {    "expires_at": 0  }}