Log out

Live
POST/api/v1/auth/logout

Log out — the current refresh token and access token stop working immediately

Headers

FieldTypeRequiredDescription
Authorizationstring—Not used — this endpoint is public; no member token required
X-Api-KeystringYesAgent API key (ak_…) from the bo screen
X-TimestampstringYesSigning time in unix milliseconds (±300s skew allowed)
X-NoncestringYesUnique per-request value (UUIDv4) for replay protection
X-SignaturestringYeshex(HMAC-SHA256(secret, canonical)) — see the Authentication page
X-Player-IPstring—The player's real IP (IPv4/IPv6) — recommended (used in login history)
X-Player-UAstring—The player's User-Agent (optional — recorded in login history)
X-Request-Idstring—Your correlation id — echoed back as request_uuid (recommended)
x-langstring—th (default) or en — the language of message

Request bodyapplication/json

FieldTypeRequiredDescription
refresh_tokenstring—The refresh token to revoke

Response

Fields in data

FieldTypeRequiredDescription
revokedboolean—Always true — the endpoint is idempotent; a missing/expired token still counts as logged out
Response example
{
  "success": true,
  "code": 0,
  "message": "สำเร็จ",
  "data": {
    "revoked": true
  },
  "request_uuid": "a92c4e17-8b53-4d06-9e71-3f5b0d8c2a64"
}

Possible error codes

codeNameHTTPMessage
9003TOO_MANY_REQUESTS429Too many requests. Please slow downAuth-group rate limit exceeded (10 req/min/IP)