Get new access token using refresh token

API ownership

• API family: Auth API
• Best for: Customer identity, session, token, cart, and wishlist flows.
• Do not use from: Merchant admin data syncs or public catalog rendering.
• Guide route: /apis/auth/latest

The OpenAPI contract defines the method, path, parameters, request body, and responses for this operation.

Operation

• Method: POST
• Path: /api/v1/:app_id/auth/refresh
• Summary: Refresh token
• Description: Get new access token using refresh token
• OpenAPI contract: auth-api
• Operation ID: Not documented in the OpenAPI contract.

Operation key uses API family, method, and path because this OpenAPI contract does not publish an operation ID.

{
  "refresh_token": "string"
}

{
  "access_token": "string",
  "expires_in": 0,
  "refresh_token": "string",
  "token_type": "string"
}

{
  "details": [
    "string"
  ],
  "message": "string",
  "success": false
}

{
  "details": [
    "string"
  ],
  "message": "string",
  "success": false
}

{
  "details": [
    "string"
  ],
  "message": "string",
  "success": false
}

Contract identity

Use these fields to confirm you are implementing the intended endpoint contract.

• API family: Auth API
• Method: POST
• Path: /api/v1/:app_id/auth/refresh
• Operation ID: Not documented in the OpenAPI contract.
• OpenAPI tag: Auth
• OpenAPI summary: Refresh token