Documentation Index
Fetch the complete documentation index at: /docs/llms.txt
Use this file to discover all available pages before exploring further.
const options = {method: 'POST'};
fetch('http://{defaultHost}/api/v3/seller/auth/refresh', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));curl --request POST \
--url http://{defaultHost}/api/v3/seller/auth/refresh{
"token": "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJhZG1pbiIsImp0aSI6IjdjODEzNjdjLTBlYWEtNGUzOC1hNmRjLTJjMTYzOTIxY2Q1MiIsImlzcyI6InNwcmVlIiwiYXVkIjoic2VsbGVyX2FwaSIsImV4cCI6MTc2ODQ3ODcwMH0.N2ttey6pvsPoOdx0F9pdUNbdT1j25ejAzpghXTbB8zo",
"user": {
"id": "adm_UkLWZg9DAJ",
"email": "seller@example.com",
"first_name": "Magdalen",
"last_name": "Hayes",
"full_name": "Magdalen Hayes",
"created_at": "2026-01-15T12:00:00.000Z",
"avatar_url": null
},
"sellers": [
{
"id": "sel_UkLWZg9DAJ",
"name": "Seller 3",
"status": "approved"
}
]
}{
"error": {
"code": "invalid_refresh_token",
"message": "Refresh token cookie missing"
}
}Exchanges the HttpOnly refresh-token cookie for a new access JWT and a rotated refresh cookie. No request body or Authorization header is required — the cookie alone authenticates the call.
The lookup is narrowed by audience, so a refresh token minted for the storefront or the back office cannot be exchanged for a seller session. Membership is rechecked here too: a user whose last seller role was revoked mid-session is refused rather than renewed.
const options = {method: 'POST'};
fetch('http://{defaultHost}/api/v3/seller/auth/refresh', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));curl --request POST \
--url http://{defaultHost}/api/v3/seller/auth/refresh{
"token": "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJhZG1pbiIsImp0aSI6IjdjODEzNjdjLTBlYWEtNGUzOC1hNmRjLTJjMTYzOTIxY2Q1MiIsImlzcyI6InNwcmVlIiwiYXVkIjoic2VsbGVyX2FwaSIsImV4cCI6MTc2ODQ3ODcwMH0.N2ttey6pvsPoOdx0F9pdUNbdT1j25ejAzpghXTbB8zo",
"user": {
"id": "adm_UkLWZg9DAJ",
"email": "seller@example.com",
"first_name": "Magdalen",
"last_name": "Hayes",
"full_name": "Magdalen Hayes",
"created_at": "2026-01-15T12:00:00.000Z",
"avatar_url": null
},
"sellers": [
{
"id": "sel_UkLWZg9DAJ",
"name": "Seller 3",
"status": "approved"
}
]
}{
"error": {
"code": "invalid_refresh_token",
"message": "Refresh token cookie missing"
}
}Was this page helpful?