ApiAuth
Refresh access token
POST
Get a new access token using a valid refresh token. Rate limited to 20 requests per minute.
X-API-Version?stringAPI version for header-based versioning
Default
"1"Value in
"1""2"application/json- body
refreshToken*stringValid refresh token
Token refreshed successfully
response?unknownapplication/jsoncurl -X POST 'http://localhost:3001/api/v1/auth/refresh' \ -H 'Content-Type: application/json' \ -d '{ "refreshToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."}'Example Response
{ "status": "success", "statusCode": 200, "message": "Token refreshed successfully", "data": { "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...", "refreshToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, "meta": { "user_id": "123e4567-e89b-12d3-a456-426614174000", "refreshed_at": "2026-01-31T10:00:00.000Z" }, "timestamp": "2026-01-31T10:00:00.000Z", "path": "/api/v1/auth/refresh"}