POST/auth/refresh

Refresh a member session

Rotates a refresh token and returns a fresh access-token pair.

Send request

Use the documented inputs to call this endpoint directly.

API serverbase URL

Request body

application/jsonrequired

refresh_tokenstringrequired

Responses

200application/json

Session refreshed.

{
  "id": "ses_01J8F0ZK3E9X",
  "access_token": "heyo_demo_01J8F2X6ZJ5Q3F7A4K9N",
  "refresh_token": "refresh_demo_01J8F0ZK3E9X",
  "expires_at": "2026-09-03T14:40:12Z",
  "member": {
    "id": "mem_01J8F3D2P9Q7V6N5M4K",
    "email": "mira@northstar.example",
    "role": "admin"
  }
}

idstringoptional

access_tokenstringoptional

refresh_tokenstringoptional

expires_atstring · date-timeoptional

memberobjectoptional

401application/json

Refresh token is invalid or expired.

{
  "error": {
    "code": "validation_failed",
    "message": "One or more fields need attention.",
    "details": [
      {
        "path": "name",
        "code": "too_short",
        "message": "Use at least 3 characters."
      }
    ]
  },
  "request_id": "req_01J8F6C4YTP8B2S9QK1M"
}

errorrequired

request_idstringrequired