Refresh Token
Exchange a refresh token for a new access token and refresh token pair.
Refresh Token
POST
/api/v1/auth/refreshExchange a refresh token for a new access token and refresh token pair.
Authentication:No Auth Required
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
refresh_token | string | Required | The refresh token obtained from a previous login, register, or refresh response. |
Code Examples
curl -X POST https://api.orbai.world/api/v1/auth/refresh \
-H "Content-Type: application/json" \
-d '{
"refresh_token": "dGhpcyBpcyBhIHJlZnJlc2..."
}'Responses
200Token refresh successful. Returns new access and refresh tokens.
{
"success": true,
"data": {
"access_token": "eyJhbGciOiJIUzI1NiIs...",
"refresh_token": "bmV3IHJlZnJlc2ggdG9rZW4...",
"access_token_expires_at": "2026-02-09T12:00:00Z",
"refresh_token_expires_at": "2026-03-08T12:00:00Z",
"token_type": "Bearer"
}
}401The refresh token is invalid, expired, or has already been used.
{
"success": false,
"error": {
"code": "INVALID_REFRESH_TOKEN",
"message": "The refresh token is invalid or has expired. Please log in again."
}
}