POST
Admin refresh tokens

Overview

Rotates the admin refresh token. Present a valid, non-revoked, non-expired refresh token; receive a fresh accessToken + refreshToken pair. The presented refresh token is revoked as part of the rotation, so each refresh token is single-use. Tokens live in the dedicated admin_refresh_tokens collection (separate from the user refresh surface — see Admin auth and MFA).
No authentication header — the refresh token in the body is the credential. There is no burst limiter on this route (unlike /login and /mfa-verify).

Authentication

None. The refreshToken authenticates the request.

Path parameters

None.

Query parameters

None.

Request body

Example payload

Response — 200 OK

Error responses

Example error — 401 ADMIN_REFRESH_TOKEN_INVALID

See also

curl

Postman

See docs/postman/swappr.postman_collection.json → Admin Auth → Refresh.