Sign in

v15

latestOpenAPI 3.0.0MIT Licenseraw.githubusercontent.com2026-08-016088119.5 KB
session

Refresh access token

Generate a new JWT access token using a valid refresh token. The refresh token used will be revoked and a new one will be issued.

post/token

Request body

refreshTokenstring required

Refresh token used to generate a new access token

Example request

{
  "refreshToken": "2c35b6f3-c4b9-48e3-978a-d4d0f1d42e24"
}

Response

Access token successfully refreshed

accessTokenstring required

JWT token for authenticating API requests

accessTokenExpiresIninteger required

Expiration time of the access token in seconds

refreshTokenIdstring required

Identifier for the refresh token

refreshTokenstring required

Token used to refresh the access token

Example response

{
  "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "accessTokenExpiresIn": 900,
  "refreshTokenId": "2c35b6f3-c4b9-48e3-978a-d4d0f1d42e24",
  "refreshToken": "2c35b6f3-c4b9-48e3-978a-d4d0f1d42e24",
  "user": {
    "avatarUrl": "https://myapp.com/avatars/user123.jpg",
    "createdAt": "2023-01-15T12:34:56Z",
    "defaultRole": "user",
    "displayName": "John Smith",
    "email": "john.smith@nhost.io",
    "emailVerified": true,
    "id": "2c35b6f3-c4b9-48e3-978a-d4d0f1d42e24",
    "locale": "en",
    "metadata": {
      "firstName": "John",
      "lastName": "Smith"
    },
    "phoneNumber": "+12025550123",
    "roles": [
      "user",
      "customer"
    ]
  }
}