docs: update refresh token rotation description and examples

docs/swagger.json

@@ -484,7 +484,7 @@
         },
         "/api/auth/refresh": {
             "post": {
-                "description": "Use a refresh token to get a new access token. This endpoint allows clients to obtain a new access token using a valid refresh token without requiring user credentials.",
+                "description": "Use a refresh token to get a new access token. The refresh token is rotated on success, and the previous refresh token becomes invalid.",
                 "consumes": [
                     "application/json"
                 ],
@@ -1903,7 +1903,7 @@
             "properties": {
                 "refresh_token": {
                     "type": "string",
-                    "example": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
+                    "example": "f94d4ddc7d9b4fcb9d3a2c44c400b780c3e1f1a5c2b7d4e6a0b1c2d3e4f5a6b7"
                 }
             }
         },
@@ -1968,7 +1968,7 @@
             "properties": {
                 "refresh_token": {
                     "type": "string",
-                    "example": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
+                    "example": "f94d4ddc7d9b4fcb9d3a2c44c400b780c3e1f1a5c2b7d4e6a0b1c2d3e4f5a6b7"
                 }
             }
         },
@@ -2070,7 +2070,7 @@
                 },
                 "refresh_token": {
                     "type": "string",
-                    "example": "f94d4ddc7d9b4fcb9d3a2c44c400b780"
+                    "example": "f94d4ddc7d9b4fcb9d3a2c44c400b780c3e1f1a5c2b7d4e6a0b1c2d3e4f5a6b7"
                 },
                 "user": {
                     "$ref": "#/definitions/handlers.AuthUserSummary"