{"openapi":"3.0.3","info":{"title":"FarmersOnly.Club API","description":"API documentation for FarmersOnly.Club - A Farming Simulator multiplayer economy dashboard\n\n## Authentication\n\nMost endpoints require authentication via JWT Bearer token obtained through Discord OAuth.\n\n### Getting a Token\n\n1. **Web/Mobile Users**: Login through Discord OAuth at `/api/v1/auth/login`\n2. **API Developers**: Contact FarmersOnly.Club team for API token access\n\n### Using Your Token in Swagger UI\n\n1. Click the **\"Authorize\"** button (🔓) at the top right\n2. Enter: `Bearer YOUR_JWT_TOKEN_HERE`\n3. Click **\"Authorize\"** and then **\"Close\"**\n4. All protected endpoints (🔒) will now include your token\n\n## Role-Based Access Control\n\nEndpoints are organized by the **minimum role required** to execute them. The role hierarchy is:\n\n**Public** → **Member** → **Realtor/Banker/Gatekeeper/Farm Manager** → **Moderator** → **Admin** → **Owner**\n\nHigher roles inherit all permissions from lower roles.","version":"1.0.0","contact":{"name":"FarmersOnly.Club","url":"https://farmersonly.club"}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"JWT token obtained from Discord OAuth login"}},"schemas":{}},"paths":{"/api":{"get":{"tags":["system"],"description":"Get API information including name and version","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"message":{"type":"string","description":"API name"},"version":{"type":"string","description":"API version"}}},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/health":{"get":{"tags":["system"],"description":"Health check endpoint for monitoring and load balancers","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"status":{"type":"string"},"timestamp":{"type":"number"}}},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/auth/discord":{"get":{"tags":["auth"],"description":"Initiate Discord OAuth flow (redirects to Discord)","parameters":[{"schema":{"type":"string"},"in":"query","name":"redirect","required":false,"description":"URL to redirect back to after OAuth (optional)"}],"responses":{"302":{"description":"Redirects to Discord OAuth authorization page"}}}},"/api/v1/auth/discord/mobile":{"get":{"tags":["auth"],"description":"Initiate Discord OAuth flow for mobile (redirects to Discord)","responses":{"302":{"description":"Redirects to Discord OAuth authorization page"}}}},"/api/v1/auth/discord/callback":{"post":{"summary":"Exchange Discord OAuth authorization code for JWT token","tags":["auth"],"description":"Exchange Discord OAuth authorization code for JWT token","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Discord OAuth authorization code"},"redirectUri":{"type":"string","description":"OAuth redirect URI (optional)"}}}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"token":{"type":"string","description":"Access token (15 minutes)"},"refreshToken":{"type":"string","description":"Refresh token (7 days)"},"expiresIn":{"type":"number","description":"Access token expiration in seconds"},"userInfo":{"type":"object","description":"User information","additionalProperties":true}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Invalid authorization code","content":{"application/json":{"schema":{"description":"Invalid authorization code"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"description":"Rate limit exceeded"}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/auth/me":{"get":{"summary":"Get current authenticated user information","tags":["auth"],"description":"Get current authenticated user information","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"userInfo":{"type":"object","additionalProperties":true,"description":"User profile and game data"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/auth/logout":{"post":{"summary":"Logout user and revoke JWT token immediately","tags":["auth"],"description":"Logout user and revoke JWT token immediately","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}},"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"message":{"type":"string","description":"Logout confirmation message"},"tokenRevoked":{"type":"boolean","description":"Whether the current access token was revoked server-side"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/auth/refresh":{"post":{"summary":"Refresh access token using refresh token","tags":["auth"],"description":"Refresh access token using refresh token","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["refreshToken"],"properties":{"refreshToken":{"type":"string","description":"Refresh token"}}}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"token":{"type":"string","description":"New access token"},"expiresIn":{"type":"number","description":"Token expiration in seconds"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Invalid or expired refresh token","content":{"application/json":{"schema":{"description":"Invalid or expired refresh token"}}}},"403":{"description":"Device mismatch","content":{"application/json":{"schema":{"description":"Device mismatch"}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/auth/verification-code":{"post":{"summary":"Store verification code for user registration","tags":["auth"],"description":"Store verification code for user registration","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["code","serverId","license"],"properties":{"code":{"type":"string","description":"Verification code"},"serverId":{"type":"number","description":"Server ID"},"license":{"type":"string","description":"FS25 license ID"},"ttlSeconds":{"type":"number","default":300,"description":"Time to live in seconds"}}}}}},"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"message":{"type":"string"},"expiresAt":{"type":"string","format":"date-time"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/auth/verification-code/{code}":{"get":{"summary":"Get verification code data for the authenticated registration flow","tags":["auth"],"description":"Get verification code data for the authenticated registration flow","parameters":[{"schema":{"type":"string"},"in":"path","name":"code","required":true,"description":"Verification code"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"serverId":{"type":"number"},"license":{"type":"string"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"404":{"description":"Verification code not found","content":{"application/json":{"schema":{"description":"Verification code not found"}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/auth/register":{"post":{"summary":"Complete user registration with verification code","tags":["auth"],"description":"Complete user registration with verification code","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["registrationCode"],"properties":{"registrationCode":{"type":"string","description":"Verification code from game server"}}}}}},"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"message":{"type":"string"},"serverId":{"type":"number"},"license":{"type":"string"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/users/me":{"get":{"summary":"Get current authenticated user information (no permissions required)","tags":["users"],"description":"Get current authenticated user information (no permissions required)","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"discordId":{"type":"string"},"username":{"type":"string","nullable":true},"nickname":{"type":"string","nullable":true},"image":{"type":"string","nullable":true},"farmName":{"type":"string","nullable":true},"topRole":{"type":"string","nullable":true},"roles":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"color":{"type":"string","nullable":true},"position":{"type":"integer"}}}},"color":{"type":"string","nullable":true},"createdAt":{"type":"string","nullable":true},"lastLogin":{"type":"string","nullable":true},"fmHistory":{"type":"array","items":{"type":"object","properties":{"status":{"type":"string"},"serverId":{"type":"number"},"farmName":{"type":"string"},"startDate":{"anyOf":[{"type":"number"},{"type":"string"}]},"endDate":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"null"}]}},"additionalProperties":true},"nullable":true},"checking":{"type":"number","nullable":true},"landTokens":{"type":"integer","nullable":true},"eventPoints":{"type":"integer","nullable":true},"prestigePoints":{"type":"integer","nullable":true},"server":{"type":"integer","nullable":true},"license":{"type":"string","nullable":true},"aiPersonality":{"type":"string","nullable":true},"banned":{"type":"boolean","nullable":true},"bannedAt":{"type":"string","nullable":true},"suspended":{"type":"boolean","nullable":true},"suspendedUntil":{"type":"string","nullable":true},"suspendedReason":{"type":"string","nullable":true}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}},"patch":{"summary":"Update current user profile","tags":["users"],"description":"Update current user profile","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"personality":{"type":"object","properties":{"bio":{"type":"string"},"image":{"type":"string"}}},"fsRegistration":{"type":"object","properties":{"license":{"type":"string"},"serverId":{"type":"number"},"nickname":{"type":"string"}}}}}}}},"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"message":{"type":"string"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/users/search":{"get":{"summary":"Search users by username or Discord ID","tags":["users"],"description":"Search users by username or Discord ID","parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"q","required":true,"description":"Search query (username, nickname, farm name, or Discord ID)"},{"schema":{"type":"number","minimum":1,"maximum":20,"default":10},"in":"query","name":"limit","required":false}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"users":{"type":"array","items":{"type":"object","properties":{"discordId":{"type":"string"},"username":{"type":"string"},"nickname":{"type":"string","nullable":true},"farmName":{"type":"string","nullable":true},"image":{"type":"string","nullable":true},"color":{"type":"string","nullable":true},"topRole":{"type":"string","nullable":true}}}}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/users/me/balance":{"get":{"summary":"Get current user complete balance information","tags":["users"],"description":"Get current user complete balance information","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"userInfo":{"type":"object","properties":{"discordId":{"type":"string"},"username":{"type":"string"},"checking":{"type":"number"},"landTokens":{"type":"number"},"eventPoints":{"type":"number"},"points":{"type":"number"},"farmName":{"type":"string","nullable":true},"server":{"type":"number","nullable":true}}},"loans":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"currentBalance":{"type":"number"},"active":{"type":"boolean"}}}},"ingameBalance":{"type":"object","nullable":true,"properties":{"balance":{"type":"number"},"loan":{"type":"number"},"serverId":{"type":"number"},"farmName":{"type":"string"}}}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/users/{userId}":{"get":{"summary":"Get public user information","tags":["users"],"description":"Get public user information","parameters":[{"schema":{"type":"string"},"in":"path","name":"userId","required":true,"description":"Discord user ID"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"discordId":{"type":"string"},"username":{"type":"string"},"nickname":{"type":"string","nullable":true},"image":{"type":"string","nullable":true},"farmName":{"type":"string","nullable":true},"topRole":{"type":"string","nullable":true},"roles":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"color":{"type":"string","nullable":true},"position":{"type":"number"}}}},"color":{"type":"string","nullable":true},"createdAt":{"type":"string","nullable":true},"lastLogin":{"type":"string","nullable":true},"fmHistory":{"type":"array","items":{"type":"object","properties":{"status":{"type":"string"},"serverId":{"type":"number"},"farmName":{"type":"string"},"startDate":{"anyOf":[{"type":"number"},{"type":"string"}]},"endDate":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"null"}]}},"additionalProperties":true},"nullable":true}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/users/{userId}/server":{"get":{"summary":"Get user server ID (internal/bot use)","tags":["users"],"description":"Get user server ID (internal/bot use)","parameters":[{"schema":{"type":"string"},"in":"path","name":"userId","required":true,"description":"Discord user ID"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"discordId":{"type":"string"},"server":{"type":"number","nullable":true}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/users/{userId}/field-stats":{"get":{"summary":"Get user field ownership statistics","tags":["users"],"description":"Get user field ownership statistics","parameters":[{"schema":{"type":"string"},"in":"path","name":"userId","required":true,"description":"Discord user ID"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"fieldsOwned":{"type":"number","description":"Number of fields owned"},"totalAcreage":{"type":"number","description":"Total acreage owned"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/users/{userId}/balance":{"get":{"summary":"Get user financial information (requires money:view:others permission)","tags":["users"],"description":"Get user financial information (requires money:view:others permission)","parameters":[{"schema":{"type":"string"},"in":"path","name":"userId","required":true,"description":"Discord user ID"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"userInfo":{"type":"object","properties":{"discordId":{"type":"string"},"username":{"type":"string"},"checking":{"type":"number"},"landTokens":{"type":"number"},"eventPoints":{"type":"number"},"points":{"type":"number"},"farmName":{"type":"string","nullable":true},"server":{"type":"number","nullable":true}}},"loans":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"loanId":{"type":"string"},"currentBalance":{"type":"number"},"active":{"type":"boolean"}}}},"ingameBalance":{"type":"object","nullable":true,"properties":{"balance":{"type":"number","description":"In-game money balance"},"loan":{"type":"number","description":"In-game loan balance"},"serverId":{"type":"number","description":"Server ID"},"farmName":{"type":"string","description":"Farm name"}}}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/users/statistics":{"get":{"summary":"Get current user statistics","tags":["users"],"description":"Get current user statistics","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"ownedFields":{"type":"number","description":"Number of owned fields"},"totalTransactions":{"type":"number","description":"Total transaction count"},"activeLoans":{"type":"number","description":"Number of active loans"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/users/balance/ingame":{"get":{"summary":"Get current in-game balance from FS server","tags":["users"],"description":"Get current in-game balance from FS server","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"balance":{"type":"number","description":"In-game money balance from FS server"},"loan":{"type":"number","description":"In-game loan balance from FS server"},"serverId":{"type":"number","description":"Server ID"},"farmName":{"type":"string","description":"Farm name"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"User must have farm name and server configured","content":{"application/json":{"schema":{"description":"User must have farm name and server configured"}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/users/personality":{"post":{"tags":["users"],"description":"Set user personality (bio and image)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["bio","image"],"properties":{"bio":{"type":"string"},"image":{"type":"string"}}}}}},"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"success":{"type":"boolean","enum":[true]}},"required":["success"]},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}},"required":["timestamp"]}},"required":["success","data","meta"]}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/users/me/fs-registration":{"put":{"summary":"Register or update Farming Simulator server credentials","tags":["users"],"description":"Register or update Farming Simulator server credentials","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["license","serverId","nickname"],"properties":{"license":{"type":"string","minLength":1,"description":"FS server license key"},"serverId":{"type":"number","description":"Server ID to register on"},"nickname":{"type":"string","minLength":1,"description":"In-game nickname"}}}}}},"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"message":{"type":"string","description":"Registration result message"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Invalid registration data","content":{"application/json":{"schema":{"description":"Invalid registration data"}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/users/apply-farm":{"post":{"summary":"Check eligibility for Farm Manager application","tags":["users"],"description":"Check eligibility for Farm Manager application","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["serverId"],"properties":{"serverId":{"type":"number","description":"Server ID to apply for FM role"}}}}}},"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"eligible":{"type":"boolean","description":"Whether user is eligible to apply"},"serverId":{"type":"number","description":"Server ID"},"reason":{"type":"string","description":"Reason if not eligible"},"eligibleTimestamp":{"type":"number","description":"Unix timestamp when user becomes eligible (if not yet eligible)"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/users/{userId}/activity":{"get":{"summary":"Get unified activity feed for a user (transactions, vehicle transfers, crop transfers)","tags":["users"],"description":"Get unified activity feed for a user (transactions, vehicle transfers, crop transfers)","parameters":[{"schema":{"type":"number","minimum":1,"maximum":100,"default":50},"in":"query","name":"limit","required":false,"description":"Number of items to return"},{"schema":{"type":"number","minimum":0,"default":0},"in":"query","name":"offset","required":false,"description":"Number of items to skip"},{"schema":{"type":"string"},"in":"path","name":"userId","required":true,"description":"Discord user ID"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"array","items":{"type":"object","required":["type","timestamp","data"],"properties":{"type":{"type":"string","enum":["transaction","vehicle_transfer","crop_transfer"],"description":"Activity type discriminator"},"timestamp":{"type":"string","description":"Activity timestamp"},"data":{"anyOf":[{"type":"object","required":["id","account","amount"],"properties":{"id":{"type":"string"},"type":{"type":"string"},"account":{"type":"string"},"amount":{"type":"number"},"before":{"type":"number","nullable":true},"after":{"type":"number","nullable":true},"memo":{"type":"string","nullable":true},"fromId":{"type":"string","nullable":true},"toId":{"type":"string","nullable":true},"sender":{"anyOf":[{"type":"object","properties":{"username":{"type":"string","nullable":true},"image":{"type":"string","nullable":true}}},{"type":"null"}]},"recipient":{"anyOf":[{"type":"object","properties":{"username":{"type":"string","nullable":true},"image":{"type":"string","nullable":true}}},{"type":"null"}]}}},{"type":"object","required":["id","vehicleId"],"properties":{"id":{"type":"string"},"vehicleId":{"type":"string"},"fromUserId":{"type":"string"},"toUserId":{"type":"string"},"fromServerId":{"type":"number"},"toServerId":{"type":"number"},"transferFee":{"type":"number"},"memo":{"type":"string","nullable":true},"fromUser":{"anyOf":[{"type":"object","properties":{"username":{"type":"string","nullable":true},"image":{"type":"string","nullable":true}}},{"type":"null"}]},"toUser":{"anyOf":[{"type":"object","properties":{"username":{"type":"string","nullable":true},"image":{"type":"string","nullable":true}}},{"type":"null"}]},"fromServer":{"anyOf":[{"type":"object","properties":{"name":{"type":"string","nullable":true}}},{"type":"null"}]},"toServer":{"anyOf":[{"type":"object","properties":{"name":{"type":"string","nullable":true}}},{"type":"null"}]}}},{"type":"object","required":["id","cropType","quantity"],"properties":{"id":{"type":"string"},"cropType":{"type":"string"},"quantity":{"type":"number"},"fromUserId":{"type":"string"},"toUserId":{"type":"string"},"fromServerId":{"type":"number"},"toServerId":{"type":"number"},"fromBuildingId":{"type":"string","nullable":true},"toBuildingId":{"type":"string","nullable":true},"transferFee":{"type":"number"},"memo":{"type":"string","nullable":true},"fromUser":{"anyOf":[{"type":"object","properties":{"username":{"type":"string","nullable":true},"image":{"type":"string","nullable":true}}},{"type":"null"}]},"toUser":{"anyOf":[{"type":"object","properties":{"username":{"type":"string","nullable":true},"image":{"type":"string","nullable":true}}},{"type":"null"}]},"fromServer":{"anyOf":[{"type":"object","properties":{"name":{"type":"string","nullable":true}}},{"type":"null"}]},"toServer":{"anyOf":[{"type":"object","properties":{"name":{"type":"string","nullable":true}}},{"type":"null"}]}}}]}}}},"meta":{"type":"object","required":["timestamp","pagination"],"properties":{"timestamp":{"type":"number"},"pagination":{"type":"object","required":["total","limit","offset","hasMore"],"properties":{"total":{"type":"number"},"limit":{"type":"number"},"offset":{"type":"number"},"hasMore":{"type":"boolean"}}}}},"_links":{"type":"object","additionalProperties":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string"},"type":{"type":"string"}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}},"patch":{"summary":"Update user activity timestamps","tags":["users"],"description":"Update user activity timestamps","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"lastLogin":{"type":"number","description":"Last login timestamp (ms)"},"lastSeen":{"type":"number","description":"Last seen timestamp (ms)"},"lastServer":{"type":"number","description":"Last server ID"}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"userId","required":true,"description":"Discord user ID"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"message":{"type":"string"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/users/{userId}/accept":{"post":{"summary":"Accept a user's application (gatekeeper function)","tags":["users"],"description":"Accept a user's application (gatekeeper function)","parameters":[{"schema":{"type":"string"},"in":"path","name":"userId","required":true,"description":"Discord user ID"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"userInfo":{"type":"object","properties":{"discordId":{"type":"string"},"username":{"type":"string"},"nickname":{"type":"string"},"farmName":{"type":"string"},"checking":{"type":"number"},"landTokens":{"type":"number"},"points":{"type":"number"},"created":{"type":"boolean","description":"Whether user was newly created"}}}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/users/{userId}/deny":{"post":{"summary":"Deny a user's application (gatekeeper function)","tags":["users"],"description":"Deny a user's application (gatekeeper function)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string","description":"Reason for denial (will be sent to user)"}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"userId","required":true,"description":"Discord user ID"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"userInfo":{"type":"object","properties":{"discordId":{"type":"string"},"username":{"type":"string"},"reason":{"type":"string"}}}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/users/tokens/remove":{"post":{"summary":"Legacy alias for removing land tokens from a user's account (realtor/admin only). Prefer /api/v1/realtor/tokens/remove.","tags":["users"],"description":"Legacy alias for removing land tokens from a user's account (realtor/admin only). Prefer /api/v1/realtor/tokens/remove.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["targetUserId","amount","memo"],"properties":{"targetUserId":{"type":"string","description":"Discord ID of user to remove tokens from"},"amount":{"type":"number","minimum":1,"maximum":1000,"description":"Number of land tokens to remove"},"memo":{"type":"string","description":"Reason for removing land tokens"}}}}}},"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"userId":{"type":"string","description":"Discord ID of user whose tokens were removed"},"amountRemoved":{"type":"number","description":"Number of land tokens removed"},"newBalance":{"type":"number","description":"User's new land token balance"},"message":{"type":"string","description":"Success message"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/transactions/":{"get":{"summary":"Get transaction history for authenticated user with pagination, filtering, sorting, and field selection","tags":["transactions"],"description":"Get transaction history for authenticated user with pagination, filtering, sorting, and field selection","parameters":[{"schema":{"type":"number","default":50,"minimum":1,"maximum":500},"in":"query","name":"limit","required":false,"description":"Maximum number of results to return"},{"schema":{"type":"number","default":0,"minimum":0},"in":"query","name":"offset","required":false,"description":"Number of results to skip for pagination"},{"schema":{"type":"string"},"in":"query","name":"startDate","required":false,"description":"Filter transactions after this timestamp (epoch seconds)"},{"schema":{"type":"string"},"in":"query","name":"endDate","required":false,"description":"Filter transactions before this timestamp (epoch seconds)"},{"schema":{"type":"string","enum":["Checking","Savings","LandTokens","Points","PrestigePoints"]},"in":"query","name":"account","required":false,"description":"Filter by account type"},{"schema":{"type":"string"},"in":"query","name":"fields","required":false,"description":"Comma-separated list of fields to return (e.g., id,amount,timestamp)"},{"schema":{"type":"string"},"in":"query","name":"sort","required":false,"description":"Sort by field(s), prefix with - for descending (e.g., -timestamp,amount)"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","required":["transactions"],"properties":{"transactions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"Transaction ID"},"type":{"type":"string","description":"Transaction type"},"account":{"type":"string","description":"Account type"},"amount":{"type":"number","description":"Transaction amount"},"before":{"type":"number","description":"Balance before"},"after":{"type":"number","description":"Balance after"},"memo":{"type":"string","description":"Transaction memo"},"timestamp":{"type":"string","description":"Transaction timestamp"},"fromId":{"type":"string","nullable":true,"description":"Sender Discord ID"},"toId":{"type":"string","nullable":true,"description":"Recipient Discord ID"},"sender":{"type":"object","nullable":true,"description":"Sender information","properties":{"username":{"type":"string","description":"Sender username"},"image":{"type":"string","description":"Sender avatar"}}},"recipient":{"type":"object","nullable":true,"description":"Recipient information","properties":{"username":{"type":"string","description":"Recipient username"},"image":{"type":"string","description":"Recipient avatar"}}},"_links":{"type":"object","additionalProperties":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}}}}}}}},"meta":{"type":"object","required":["timestamp","pagination"],"properties":{"timestamp":{"type":"number"},"pagination":{"type":"object","required":["total","limit","offset","hasMore"],"properties":{"total":{"type":"number"},"limit":{"type":"number"},"offset":{"type":"number"},"hasMore":{"type":"boolean"}}}}},"_links":{"type":"object","description":"HATEOAS pagination links","properties":{"self":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"first":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"prev":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"next":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"last":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}}}}}}}}},"400":{"description":"Invalid query parameters","content":{"application/json":{"schema":{"description":"Invalid query parameters"}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/checking/":{"get":{"summary":"Get checking account balance for authenticated user","tags":["checking"],"description":"Get checking account balance for authenticated user","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"balance":{"type":"number","description":"Checking account balance"},"userId":{"type":"string","description":"User Discord ID"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/checking/transactions":{"get":{"summary":"Get transaction history for checking account","tags":["checking"],"description":"Get transaction history for checking account","parameters":[{"schema":{"type":"number","default":50,"minimum":1,"maximum":500},"in":"query","name":"limit","required":false,"description":"Maximum number of results to return"},{"schema":{"type":"number","default":0,"minimum":0},"in":"query","name":"offset","required":false,"description":"Number of results to skip for pagination"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","required":["transactions"],"properties":{"transactions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"Transaction ID"},"type":{"type":"string","description":"Transaction type"},"account":{"type":"string","description":"Account type"},"amount":{"type":"number","description":"Transaction amount"},"before":{"type":"number","description":"Balance before"},"after":{"type":"number","description":"Balance after"},"memo":{"type":"string","description":"Transaction memo"},"timestamp":{"type":"string","description":"Transaction timestamp"},"fromId":{"type":"string","nullable":true,"description":"Sender Discord ID"},"toId":{"type":"string","nullable":true,"description":"Recipient Discord ID"},"sender":{"type":"object","nullable":true,"description":"Sender information","properties":{"username":{"type":"string","description":"Sender username"},"image":{"type":"string","description":"Sender avatar"}}},"recipient":{"type":"object","nullable":true,"description":"Recipient information","properties":{"username":{"type":"string","description":"Recipient username"},"image":{"type":"string","description":"Recipient avatar"}}},"_links":{"type":"object","additionalProperties":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"description":"HATEOAS links for this resource"}}}}}},"meta":{"type":"object","required":["timestamp","pagination"],"properties":{"timestamp":{"type":"number"},"pagination":{"type":"object","required":["total","limit","offset","hasMore"],"properties":{"total":{"type":"number"},"limit":{"type":"number"},"offset":{"type":"number"},"hasMore":{"type":"boolean"}}}}},"_links":{"type":"object","description":"HATEOAS pagination links","properties":{"self":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"first":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"prev":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"next":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"last":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/checking/transfers":{"post":{"summary":"Transfer money from your checking account to another user","tags":["checking"],"description":"Transfer money from your checking account to another user","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["toUserId","amount"],"properties":{"toUserId":{"type":"string","description":"Recipient Discord ID"},"amount":{"type":"integer","minimum":1,"description":"Amount to transfer (whole dollars only)"},"memo":{"type":"string","description":"Optional memo"}}}}}},"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"message":{"type":"string","description":"Success message"},"transactionId":{"type":"string","description":"Transaction ID"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"description":"Invalid request"}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"422":{"description":"Business rule violation, such as insufficient funds or self-transfer","content":{"application/json":{"schema":{"description":"Business rule violation, such as insufficient funds or self-transfer"}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/contracts/":{"get":{"summary":"Get contracts for authenticated user (as owner or claimer) with pagination and optional status filtering","tags":["contracts"],"description":"Get contracts for authenticated user (as owner or claimer) with pagination and optional status filtering","parameters":[{"schema":{"type":"number","default":50,"minimum":1,"maximum":500},"in":"query","name":"limit","required":false,"description":"Maximum number of results to return"},{"schema":{"type":"number","default":0,"minimum":0},"in":"query","name":"offset","required":false,"description":"Number of results to skip for pagination"},{"schema":{"type":"string","enum":["all","active","completed","cancelled"]},"in":"query","name":"status","required":false,"description":"Filter by contract status"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","required":["contracts"],"properties":{"contracts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"serverId":{"type":"number"},"fieldId":{"type":"string","nullable":true},"ownerId":{"type":"string"},"claimerId":{"type":"string","nullable":true},"payment":{"type":"number","nullable":true},"paymentType":{"type":"string","nullable":true},"contractType":{"type":"string","nullable":true},"description":{"type":"string","nullable":true},"contractStatus":{"type":"string"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"owner":{"type":"object","properties":{"discordId":{"type":"string"},"username":{"type":"string","nullable":true},"nickname":{"type":"string","nullable":true},"image":{"type":"string","nullable":true}}},"claimer":{"type":"object","properties":{"discordId":{"type":"string"},"username":{"type":"string","nullable":true},"nickname":{"type":"string","nullable":true},"image":{"type":"string","nullable":true}},"nullable":true},"field":{"type":"object","nullable":true,"properties":{"fieldNumber":{"type":"number"}}},"_links":{"type":"object","additionalProperties":true}}}}}},"meta":{"type":"object","required":["timestamp","pagination"],"properties":{"timestamp":{"type":"number"},"pagination":{"type":"object","required":["total","limit","offset","hasMore"],"properties":{"total":{"type":"number"},"limit":{"type":"number"},"offset":{"type":"number"},"hasMore":{"type":"boolean"}}}}},"_links":{"type":"object","description":"HATEOAS pagination links","properties":{"self":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"first":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"prev":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"next":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"last":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}}}}}}}}},"400":{"description":"Invalid query parameters","content":{"application/json":{"schema":{"description":"Invalid query parameters"}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}},"post":{"tags":["contracts"],"description":"Create a new player contract","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["serverId","fieldId","payment","paymentType","jobType","description"],"properties":{"serverId":{"type":"number","description":"Server ID"},"fieldId":{"type":"number","description":"Field/Parcel ID"},"payment":{"type":"number","description":"Payment amount"},"paymentType":{"type":"string","enum":["fixed","per hour"],"description":"Payment type"},"jobType":{"type":"string","description":"Type of job (e.g., Harvesting, Plowing)"},"description":{"type":"string","description":"Contract description"}}}}}},"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","additionalProperties":true,"properties":{"contract":{"type":"object","additionalProperties":true}}},"meta":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/contracts/{id}/claim":{"post":{"summary":"Claim a contract","tags":["contracts"],"description":"Claim a contract","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true,"description":"Resource ID (UUID)"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","additionalProperties":true,"properties":{"contract":{"type":"object","additionalProperties":true}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/contracts/{id}/complete":{"post":{"summary":"Complete a contract and transfer payment","tags":["contracts"],"description":"Complete a contract and transfer payment","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true,"description":"Resource ID (UUID)"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","additionalProperties":true,"properties":{"message":{"type":"string"},"contract":{"type":"object","additionalProperties":true}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/contracts/{id}":{"delete":{"summary":"Cancel a contract","tags":["contracts"],"description":"Cancel a contract","parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true,"description":"Resource ID (UUID)"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"message":{"type":"string"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/loans/":{"get":{"summary":"Get loans for authenticated user with pagination, filtering, sorting, and field selection. Bankers can use viewAll=true to see all loans.","tags":["loans"],"description":"Get loans for authenticated user with pagination, filtering, sorting, and field selection. Bankers can use viewAll=true to see all loans.","parameters":[{"schema":{"type":"number","default":50,"minimum":1,"maximum":500},"in":"query","name":"limit","required":false,"description":"Maximum number of results to return"},{"schema":{"type":"number","default":0,"minimum":0},"in":"query","name":"offset","required":false,"description":"Number of results to skip for pagination"},{"schema":{"type":"string","enum":["true","false"]},"in":"query","name":"active","required":false,"description":"Filter by active status (true/false)"},{"schema":{"type":"string"},"in":"query","name":"status","required":false,"description":"Filter by status (active, paid, defaulted, etc.)"},{"schema":{"type":"string"},"in":"query","name":"borrowerId","required":false,"description":"Filter by borrower Discord ID (requires viewAll=true)"},{"schema":{"type":"string","enum":["true","false"]},"in":"query","name":"viewAll","required":false,"description":"View all loans (requires loans:view:others permission)"},{"schema":{"type":"string"},"in":"query","name":"fields","required":false,"description":"Comma-separated list of fields to return (e.g., id,total,apr)"},{"schema":{"type":"string"},"in":"query","name":"sort","required":false,"description":"Sort by field(s), prefix with - for descending (e.g., -createdAt,total)"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","required":["loans"],"properties":{"loans":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"borrowerId":{"type":"string"},"bankerId":{"type":"string","nullable":true},"total":{"type":"number"},"currentBalance":{"type":"number"},"originalAmount":{"type":"number"},"interestPaid":{"type":"number"},"apr":{"type":"number"},"term":{"type":"number"},"paymentsMade":{"type":"number"},"active":{"type":"boolean"},"status":{"type":"string"},"reason":{"type":"string","nullable":true},"createdAt":{"type":"string"},"borrower":{"type":"object","nullable":true,"properties":{"discordId":{"type":"string"},"username":{"type":"string","nullable":true},"farmName":{"type":"string","nullable":true},"nickname":{"type":"string","nullable":true},"image":{"type":"string","nullable":true},"color":{"type":"string","nullable":true}}},"_links":{"type":"object","additionalProperties":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}}}}}}}},"meta":{"type":"object","required":["timestamp","pagination"],"properties":{"timestamp":{"type":"number"},"pagination":{"type":"object","required":["total","limit","offset","hasMore"],"properties":{"total":{"type":"number"},"limit":{"type":"number"},"offset":{"type":"number"},"hasMore":{"type":"boolean"}}}}},"_links":{"type":"object","description":"HATEOAS pagination links","properties":{"self":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"first":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"prev":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"next":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"last":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}}}}}}}}},"400":{"description":"Invalid query parameters","content":{"application/json":{"schema":{"description":"Invalid query parameters"}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}},"post":{"summary":"Apply for a new loan","tags":["loans"],"description":"Apply for a new loan","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["amount","term"],"properties":{"amount":{"type":"number","description":"Loan amount"},"term":{"type":"number","enum":[48,60,72,84,96],"description":"Loan term in months (48, 60, 72, 84, or 96)"},"reason":{"type":"string","maxLength":200,"description":"Purpose of the loan"},"source":{"type":"string","enum":["web","discord"],"description":"Submission source used to prevent duplicate banker-channel notices."}}}}}},"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"message":{"type":"string"},"loanId":{"type":"number"},"status":{"type":"string"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/loans/{id}/schedule":{"get":{"summary":"Get actual loan payment history plus a projected remaining payment schedule. The projection is based on current balance and recorded manual payments instead of trusting the stored paymentsMade counter.","tags":["loans"],"description":"Get actual loan payment history plus a projected remaining payment schedule. The projection is based on current balance and recorded manual payments instead of trusting the stored paymentsMade counter.","parameters":[{"schema":{"type":"number","minimum":1,"maximum":60},"in":"query","name":"limit","required":false,"description":"Maximum number of upcoming projected payments to return"},{"schema":{"type":"string","pattern":"^[0-9]+$"},"in":"path","name":"id","required":true,"description":"Numeric resource ID"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"loan":{"type":"object","properties":{"id":{"type":"number"},"borrowerId":{"type":"string"},"borrower":{"type":"object","nullable":true,"properties":{"discordId":{"type":"string"},"username":{"type":"string","nullable":true},"farmName":{"type":"string","nullable":true},"nickname":{"type":"string","nullable":true},"image":{"type":"string","nullable":true},"color":{"type":"string","nullable":true}}},"originalAmount":{"type":"number"},"currentBalance":{"type":"number"},"apr":{"type":"number"},"term":{"type":"number"},"paymentsMade":{"type":"number"},"actualPaymentsMade":{"type":"number"},"active":{"type":"boolean"},"status":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"lastPaymentDate":{"type":"string","format":"date-time","nullable":true}}},"summary":{"type":"object","properties":{"principalPaid":{"type":"number"},"interestPaid":{"type":"number"},"paymentCount":{"type":"number"},"recordedPaymentsMade":{"type":"number"},"lastPaymentDate":{"type":"string","format":"date-time","nullable":true}}},"paymentHistory":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"paymentAmount":{"type":"number"},"principalAmount":{"type":"number"},"interestAmount":{"type":"number"},"balanceBefore":{"type":"number"},"balanceAfter":{"type":"number"},"paidAt":{"type":"string","format":"date-time"},"paidBy":{"type":"string"}}}},"upcomingPayments":{"type":"array","items":{"type":"object","properties":{"paymentNumber":{"type":"number"},"amount":{"type":"number"},"principal":{"type":"number"},"interest":{"type":"number"},"remainingBalance":{"type":"number"}}}}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/loans/banker/stats":{"get":{"summary":"Get banker dashboard statistics","tags":["loans"],"description":"Get banker dashboard statistics","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"totalLoans":{"type":"number"},"pendingCount":{"type":"number"},"offeredCount":{"type":"number"},"activeCount":{"type":"number"},"completedCount":{"type":"number"},"totalOutstanding":{"type":"number"},"totalInterestEarned":{"type":"number"},"averageApr":{"type":"number"},"defaultRate":{"type":"number"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/loans/pending":{"get":{"summary":"Get all pending and offered loans","tags":["loans"],"description":"Get all pending and offered loans\n\n**Required Permissions:** loans:offer","parameters":[{"schema":{"type":"number"},"in":"query","name":"serverId","required":false,"description":"Filter by server ID"},{"schema":{"type":"number","minimum":1,"maximum":100,"default":50},"in":"query","name":"limit","required":false,"description":"Maximum number of results to return"},{"schema":{"type":"number","minimum":0,"default":0},"in":"query","name":"offset","required":false,"description":"Number of results to skip for pagination"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"loans":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"borrowerId":{"type":"string"},"borrower":{"type":"object","properties":{"discordId":{"type":"string"},"username":{"type":"string","nullable":true},"farmName":{"type":"string","nullable":true},"nickname":{"type":"string","nullable":true},"image":{"type":"string","nullable":true},"color":{"type":"string","nullable":true}}},"amount":{"type":"number"},"term":{"type":"number"},"apr":{"type":"number"},"reason":{"type":"string","nullable":true},"status":{"type":"string"},"createdAt":{"type":"string"}}}},"total":{"type":"number"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/loans/{id}/offer":{"post":{"summary":"Offer a loan (Banker action)","tags":["loans"],"description":"Offer a loan (Banker action)\n\n**Required Permissions:** loans:approve:others","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["apr"],"properties":{"apr":{"type":"number","description":"Annual Percentage Rate (0-100)"},"amount":{"type":"number","description":"Adjusted loan amount (optional)"},"term":{"type":"number","description":"Adjusted term in months (optional)"}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true,"description":"Loan ID"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"message":{"type":"string"},"loanId":{"type":"number"},"status":{"type":"string"},"borrower":{"type":"object","properties":{"discordId":{"type":"string"},"username":{"type":"string"},"image":{"type":"string","nullable":true}}}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/loans/{id}/deny":{"post":{"summary":"Deny a loan application (Banker action)","tags":["loans"],"description":"Deny a loan application (Banker action)\n\n**Required Permissions:** loans:approve:others","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string","description":"Reason for denial"}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true,"description":"Loan ID"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"message":{"type":"string"},"loanId":{"type":"number"},"status":{"type":"string"},"borrower":{"type":"object","properties":{"discordId":{"type":"string"},"username":{"type":"string"},"image":{"type":"string","nullable":true}}}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/loans/{id}/accept":{"post":{"summary":"Accept a loan offer and receive funds","tags":["loans"],"description":"Accept a loan offer and receive funds","parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true,"description":"Loan ID"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"message":{"type":"string"},"loanId":{"type":"number"},"amount":{"type":"number"},"newBalance":{"type":"number"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/loans/{id}/rescind":{"post":{"summary":"Rescind a loan offer (Banker action)","tags":["loans"],"description":"Rescind a loan offer (Banker action)\n\n**Required Permissions:** loans:approve:others","parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true,"description":"Loan ID"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"message":{"type":"string"},"loanId":{"type":"number"},"status":{"type":"string"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/loans/{id}/decline":{"post":{"summary":"Decline a loan offer","tags":["loans"],"description":"Decline a loan offer","parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true,"description":"Loan ID"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"message":{"type":"string"},"loanId":{"type":"number"},"status":{"type":"string"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/loans/{id}/modify":{"post":{"summary":"Modify an active loan (Banker action)","tags":["loans"],"description":"Modify an active loan (Banker action)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["reason"],"properties":{"apr":{"type":"number","description":"New APR"},"amount":{"type":"number","description":"New Balance"},"term":{"type":"number","description":"New Term"},"reason":{"type":"string","description":"Reason for modification"}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true,"description":"Loan ID"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"message":{"type":"string"},"loanId":{"type":"number"},"updates":{"type":"array","items":{"type":"string"}}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/loans/equity":{"get":{"summary":"Get equity information for authenticated user","tags":["loans"],"description":"Get equity information for authenticated user","parameters":[{"schema":{"type":"string"},"in":"query","name":"fields","required":false,"description":"Comma-separated list of fields to return (e.g., checking,landValue,ownedAcres,garageValue)"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"checking":{"type":"number"},"activeLoansCount":{"type":"number"},"activeLoansBalance":{"type":"number"},"activeLoansTotal":{"type":"number"},"lastLoanDate":{"type":"string","nullable":true},"landValue":{"type":"number"},"ownedAcres":{"type":"number"},"garageValue":{"type":"number"},"fmHistory":{"type":"array","nullable":true,"items":{"type":"object","properties":{"serverId":{"type":"number","nullable":true},"farmName":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"startDate":{"type":"number","nullable":true},"endDate":{"type":"number","nullable":true}},"additionalProperties":true}},"serverData":{"type":"object","nullable":true,"properties":{"serverId":{"type":"number"},"balance":{"type":"number"},"loan":{"type":"number"},"equity":{"type":"number"},"income":{"type":"number"}}},"totalAssets":{"type":"number"},"totalLiabilities":{"type":"number"},"netEquity":{"type":"number"},"maxLoanAmount":{"type":"number"},"_links":{"type":"object","additionalProperties":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}}}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/loans/equity/{userId}":{"get":{"summary":"Get user equity information with field selection","tags":["loans"],"description":"Get user equity information with field selection","parameters":[{"schema":{"type":"string"},"in":"query","name":"fields","required":false,"description":"Comma-separated list of fields to return (e.g., checking,landValue,ownedAcres,garageValue)"},{"schema":{"type":"number"},"in":"query","name":"serverId","required":false,"description":"Optional server ID to use for admin server-specific farm data"},{"schema":{"type":"string"},"in":"path","name":"userId","required":true,"description":"User Discord ID"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"checking":{"type":"number"},"activeLoansCount":{"type":"number"},"activeLoansBalance":{"type":"number"},"activeLoansTotal":{"type":"number"},"activeLoansDetails":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"originalAmount":{"type":"number"},"currentBalance":{"type":"number"}}}},"lastLoanDate":{"type":"string","nullable":true},"landValue":{"type":"number"},"ownedAcres":{"type":"number"},"garageValue":{"type":"number"},"fmHistory":{"type":"array","nullable":true,"items":{"type":"object","properties":{"serverId":{"type":"number","nullable":true},"farmName":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"startDate":{"type":"number","nullable":true},"endDate":{"type":"number","nullable":true}},"additionalProperties":true}},"serverData":{"type":"object","nullable":true,"properties":{"serverId":{"type":"number"},"balance":{"type":"number"},"loan":{"type":"number"},"equity":{"type":"number"},"income":{"type":"number"}}},"totalAssets":{"type":"number"},"totalLiabilities":{"type":"number"},"netEquity":{"type":"number"},"maxLoanAmount":{"type":"number"},"_links":{"type":"object","additionalProperties":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}}}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/loans/{loanId}/payments":{"post":{"summary":"Make a payment on a loan","tags":["loans"],"description":"Make a payment on a loan","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["amount"],"properties":{"amount":{"type":"integer","minimum":1,"description":"Payment amount (whole numbers only, no cents)"}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"loanId","required":true,"description":"Loan ID"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"message":{"type":"string"},"transactionId":{"type":"string"},"newBalance":{"type":"number"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/loans/{loanId}/close-small-balance":{"post":{"summary":"Close an active loan with a remaining balance under $1.00","tags":["loans"],"description":"Close an active loan with a remaining balance under $1.00","parameters":[{"schema":{"type":"string"},"in":"path","name":"loanId","required":true,"description":"Loan ID"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"message":{"type":"string"},"loanId":{"type":"number"},"forgivenBalance":{"type":"number"},"newBalance":{"type":"number"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/loans/{loanId}/missed-payment":{"post":{"summary":"Record a missed payment and add interest to loan balance","tags":["loans"],"description":"Record a missed payment and add interest to loan balance","parameters":[{"schema":{"type":"string"},"in":"path","name":"loanId","required":true,"description":"Loan ID"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"message":{"type":"string"},"interestAdded":{"type":"number"},"newBalance":{"type":"number"},"newInterestPaid":{"type":"number"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/economy/status":{"get":{"summary":"Economy worker heartbeat and backlog","tags":["economy-admin"],"description":"Economy worker heartbeat and backlog","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"workerOnline":{"type":"boolean"},"lastHeartbeat":{"type":"string","format":"date-time","nullable":true},"pendingDeliveries":{"type":"integer"},"failedRuns":{"type":"integer"},"queuedRuns":{"type":"integer"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/economy/schedules":{"get":{"summary":"List economy schedules (system administrators)","tags":["economy-admin"],"description":"List economy schedules (system administrators)","parameters":[{"schema":{"type":"number","default":50,"minimum":1,"maximum":500},"in":"query","name":"limit","required":false,"description":"Maximum number of results to return"},{"schema":{"type":"number","default":0,"minimum":0},"in":"query","name":"offset","required":false,"description":"Number of results to skip for pagination"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","required":["schedules"],"properties":{"schedules":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"hour":{"type":"integer"},"minute":{"type":"integer"},"dayOfMonth":{"type":"integer"},"enabled":{"type":"boolean"},"revision":{"type":"integer"},"nextAt":{"type":"string","format":"date-time"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"latestRun":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"periodKey":{"type":"string"},"scheduledAt":{"type":"string","format":"date-time"},"createdAt":{"type":"string","format":"date-time"},"completedAt":{"type":"string","format":"date-time","nullable":true},"status":{"type":"string"},"trigger":{"type":"string"},"triggeredBy":{"type":"string","nullable":true},"running":{"type":"boolean"},"completed":{"type":"integer"},"failed":{"type":"integer"},"pending":{"type":"integer"}},"nullable":true}}}}}},"meta":{"type":"object","required":["timestamp","pagination"],"properties":{"timestamp":{"type":"number"},"pagination":{"type":"object","required":["total","limit","offset","hasMore"],"properties":{"total":{"type":"number"},"limit":{"type":"number"},"offset":{"type":"number"},"hasMore":{"type":"boolean"}}}}},"_links":{"type":"object","description":"HATEOAS pagination links","properties":{"self":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"first":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"prev":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"next":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"last":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/economy/schedules/{name}/runs":{"get":{"summary":"List run history for a job","tags":["economy-admin"],"description":"List run history for a job","parameters":[{"schema":{"type":"number","default":50,"minimum":1,"maximum":500},"in":"query","name":"limit","required":false,"description":"Maximum number of results to return"},{"schema":{"type":"number","default":0,"minimum":0},"in":"query","name":"offset","required":false,"description":"Number of results to skip for pagination"},{"schema":{"type":"string","enum":["daily-loans","community-payments","land-draw","monthly-tokens","weekly-inactivity-report"]},"in":"path","name":"name","required":true}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","required":["runs"],"properties":{"runs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"periodKey":{"type":"string"},"scheduledAt":{"type":"string","format":"date-time"},"createdAt":{"type":"string","format":"date-time"},"completedAt":{"type":"string","format":"date-time","nullable":true},"status":{"type":"string"},"trigger":{"type":"string"},"triggeredBy":{"type":"string","nullable":true},"running":{"type":"boolean"},"completed":{"type":"integer"},"failed":{"type":"integer"},"pending":{"type":"integer"}}}}}},"meta":{"type":"object","required":["timestamp","pagination"],"properties":{"timestamp":{"type":"number"},"pagination":{"type":"object","required":["total","limit","offset","hasMore"],"properties":{"total":{"type":"number"},"limit":{"type":"number"},"offset":{"type":"number"},"hasMore":{"type":"boolean"}}}}},"_links":{"type":"object","description":"HATEOAS pagination links","properties":{"self":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"first":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"prev":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"next":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"last":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/economy/runs/{id}/items":{"get":{"summary":"List run item outcomes and errors","tags":["economy-admin"],"description":"List run item outcomes and errors","parameters":[{"schema":{"type":"number","default":50,"minimum":1,"maximum":500},"in":"query","name":"limit","required":false,"description":"Maximum number of results to return"},{"schema":{"type":"number","default":0,"minimum":0},"in":"query","name":"offset","required":false,"description":"Number of results to skip for pagination"},{"schema":{"type":"string","minLength":1},"in":"path","name":"id","required":true}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","required":["items"],"properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"runId":{"type":"string"},"entityId":{"type":"string"},"status":{"type":"string"},"attempts":{"type":"integer"},"availableAt":{"type":"string","format":"date-time"},"completedAt":{"type":"string","format":"date-time","nullable":true},"error":{"type":"string","nullable":true},"result":{"type":"object","nullable":true,"additionalProperties":true,"description":"Persisted accounting outcome: amounts, payment IDs, selected field IDs, or skip reason."}}}}}},"meta":{"type":"object","required":["timestamp","pagination"],"properties":{"timestamp":{"type":"number"},"pagination":{"type":"object","required":["total","limit","offset","hasMore"],"properties":{"total":{"type":"number"},"limit":{"type":"number"},"offset":{"type":"number"},"hasMore":{"type":"boolean"}}}}},"_links":{"type":"object","description":"HATEOAS pagination links","properties":{"self":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"first":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"prev":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"next":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"last":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/economy/schedules/{name}/run-now":{"post":{"summary":"Execute the next occurrence early; replaying expectedNextAt returns the same run","tags":["economy-admin"],"description":"Execute the next occurrence early; replaying expectedNextAt returns the same run","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["expectedNextAt"],"additionalProperties":false,"properties":{"expectedNextAt":{"type":"string","format":"date-time"}}}}}},"parameters":[{"schema":{"type":"string","enum":["daily-loans","community-payments","land-draw","monthly-tokens","weekly-inactivity-report"]},"in":"path","name":"name","required":true}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"periodKey":{"type":"string"},"scheduledAt":{"type":"string","format":"date-time"},"createdAt":{"type":"string","format":"date-time"},"completedAt":{"type":"string","format":"date-time","nullable":true},"status":{"type":"string"},"trigger":{"type":"string"},"triggeredBy":{"type":"string","nullable":true},"running":{"type":"boolean"},"completed":{"type":"integer"},"failed":{"type":"integer"},"pending":{"type":"integer"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/economy/schedules/{name}/reschedule":{"post":{"summary":"Edit UTC schedule; previously queued periods are not charged again","tags":["economy-admin"],"description":"Edit UTC schedule; previously queued periods are not charged again","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["hour","minute","dayOfMonth","enabled","revision"],"additionalProperties":false,"properties":{"hour":{"type":"integer","minimum":0,"maximum":23},"minute":{"type":"integer","minimum":0,"maximum":59},"dayOfMonth":{"type":"integer","minimum":1,"maximum":28},"enabled":{"type":"boolean"},"revision":{"type":"integer","minimum":0}}}}}},"parameters":[{"schema":{"type":"string","enum":["daily-loans","community-payments","land-draw","monthly-tokens","weekly-inactivity-report"]},"in":"path","name":"name","required":true}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"name":{"type":"string"},"hour":{"type":"integer"},"minute":{"type":"integer"},"dayOfMonth":{"type":"integer"},"enabled":{"type":"boolean"},"revision":{"type":"integer"},"nextAt":{"type":"string","format":"date-time"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"latestRun":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"periodKey":{"type":"string"},"scheduledAt":{"type":"string","format":"date-time"},"createdAt":{"type":"string","format":"date-time"},"completedAt":{"type":"string","format":"date-time","nullable":true},"status":{"type":"string"},"trigger":{"type":"string"},"triggeredBy":{"type":"string","nullable":true},"running":{"type":"boolean"},"completed":{"type":"integer"},"failed":{"type":"integer"},"pending":{"type":"integer"}},"nullable":true}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/economy/runs/{id}/retry":{"post":{"summary":"Retry failed items without replaying completed accounting","tags":["economy-admin"],"description":"Retry failed items without replaying completed accounting","parameters":[{"schema":{"type":"string","minLength":1},"in":"path","name":"id","required":true}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"message":{"type":"string"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/farms/availability":{"get":{"summary":"Check if a farm name is available","tags":["farms"],"description":"Check if a farm name is available","parameters":[{"schema":{"type":"string","minLength":3},"in":"query","name":"name","required":true,"description":"Farm name to check"},{"schema":{"type":"string"},"in":"query","name":"excludeApplicationId","required":false,"description":"Application ID to exclude from similarity check"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"available":{"type":"boolean"},"name":{"type":"string"},"reason":{"type":"string"},"conflictingName":{"type":"string"},"similarNames":{"type":"array","items":{"type":"object","properties":{"farmName":{"type":"string"},"similarity":{"type":"number"},"username":{"type":"string"},"source":{"type":"string","enum":["user","application"]}}}}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Farm name must be at least 3 characters","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}},"description":"Farm name must be at least 3 characters"}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/servers/{serverId}/farms/me":{"get":{"summary":"Get your farm information","tags":["farms"],"description":"Get your farm information","parameters":[{"schema":{"type":"string"},"in":"path","name":"serverId","required":true,"description":"Server ID"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","additionalProperties":true,"properties":{"farmName":{"type":"string"},"serverId":{"type":"number"},"hasPassword":{"type":"boolean"},"balance":{"type":"number"},"loan":{"type":"number"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Farm not found","content":{"application/json":{"schema":{"description":"Farm not found"}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}},"patch":{"summary":"Update your farm name or password","tags":["farms"],"description":"Update your farm name or password","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":3,"description":"New farm name"},"password":{"type":"string","description":"Farm password (empty string to remove)"}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"serverId","required":true,"description":"Server ID"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"message":{"type":"string"},"farmName":{"type":"string"},"serverId":{"type":"number"},"balance":{"type":"number","description":"Farm balance on server (for delete operations)"},"equity":{"type":"number","description":"Value of sold assets (for delete operations)"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Farm not found or invalid update","content":{"application/json":{"schema":{"description":"Farm not found or invalid update"}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/servers/{serverId}/farms/me/deposit":{"post":{"summary":"Deposit money from checking account to your in-game farm","tags":["farms"],"description":"Deposit money from checking account to your in-game farm","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["amount"],"properties":{"amount":{"type":"number","minimum":1,"description":"Amount to deposit/withdraw"}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"serverId","required":true,"description":"Server ID"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"message":{"type":"string"},"transactionId":{"type":"number"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/servers/{serverId}/farms/me/withdraw":{"post":{"summary":"Withdraw money from your in-game farm to checking account","tags":["farms"],"description":"Withdraw money from your in-game farm to checking account","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["amount"],"properties":{"amount":{"type":"number","minimum":1,"description":"Amount to deposit/withdraw"}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"serverId","required":true,"description":"Server ID"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"message":{"type":"string"},"transactionId":{"type":"number"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/realtor/fields":{"get":{"summary":"List all fields with optional filtering (realtor only)","tags":["realtor"],"description":"List all fields with optional filtering (realtor only)","parameters":[{"schema":{"type":"number","default":50,"minimum":1,"maximum":500},"in":"query","name":"limit","required":false,"description":"Maximum number of results to return"},{"schema":{"type":"number","default":0,"minimum":0},"in":"query","name":"offset","required":false,"description":"Number of results to skip for pagination"},{"schema":{"type":"number"},"in":"query","name":"serverId","required":false,"description":"Filter by server ID"},{"schema":{"type":"string"},"in":"query","name":"ownerId","required":false,"description":"Filter by owner Discord ID"},{"schema":{"type":"boolean"},"in":"query","name":"available","required":false,"description":"Filter by availability (owned by SERVICE_ACCOUNT_ID)"},{"schema":{"type":"string","maxLength":100},"in":"query","name":"search","required":false,"description":"Search by field number or owner name"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","required":["fields"],"properties":{"fields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"serverId":{"type":"number"},"fieldNumber":{"type":"number"},"ownerId":{"type":"string"},"price":{"type":"number","nullable":true},"fieldSize":{"type":"number","nullable":true},"fieldDescription":{"type":"string","nullable":true},"holdByUserId":{"type":"string","nullable":true},"holdUntil":{"type":"string","nullable":true},"server":{"type":"object","nullable":true,"properties":{"id":{"type":"number"},"name":{"type":"string"}}},"owner":{"type":"object","nullable":true,"properties":{"discordId":{"type":"string"},"username":{"type":"string"},"image":{"type":"string","nullable":true},"nickname":{"type":"string","nullable":true},"farmName":{"type":"string","nullable":true}}}}}}}},"meta":{"type":"object","required":["timestamp","pagination"],"properties":{"timestamp":{"type":"number"},"pagination":{"type":"object","required":["total","limit","offset","hasMore"],"properties":{"total":{"type":"number"},"limit":{"type":"number"},"offset":{"type":"number"},"hasMore":{"type":"boolean"}}}}},"_links":{"type":"object","description":"HATEOAS pagination links","properties":{"self":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"first":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"prev":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"next":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"last":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/realtor/buy":{"post":{"summary":"Buy a parcel from a user (System buys from User)","tags":["parcels","realtor"],"description":"Buy a parcel from a user (System buys from User)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["serverId","parcelId","amount"],"properties":{"serverId":{"type":"number"},"parcelId":{"type":"number"},"amount":{"type":"number"},"force":{"type":"boolean","description":"Skip game server update if offline"}}}}}},"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"message":{"type":"string"},"gameServerAssigned":{"type":"boolean"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/realtor/sell":{"post":{"summary":"Sell a parcel to a user (System sells to User)","tags":["parcels","realtor"],"description":"Sell a parcel to a user (System sells to User)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["serverId","parcelId","buyerId","amount"],"properties":{"serverId":{"type":"number","description":"Server ID"},"parcelId":{"type":"number","description":"Field Number"},"buyerId":{"type":"string","description":"Discord ID of the buyer"},"amount":{"type":"number","description":"Sale amount"},"force":{"type":"boolean","description":"Force sale even if game server command fails"},"auctionId":{"type":"string","description":"Optional: Auction ID if this is finalizing an auction"}}}}}},"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"message":{"type":"string"},"gameServerAssigned":{"type":"boolean"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/realtor/tokens/remove":{"post":{"summary":"Remove land tokens from a user","tags":["parcels","realtor"],"description":"Remove land tokens from a user","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["userId","amount","memo"],"properties":{"userId":{"type":"string","description":"Discord ID of user"},"amount":{"type":"number","minimum":1,"description":"Number of tokens to remove"},"memo":{"type":"string","description":"Reason for removal"}}}}}},"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","required":["message","userId","amountRemoved","newBalance"],"properties":{"message":{"type":"string"},"userId":{"type":"string"},"amountRemoved":{"type":"number"},"newBalance":{"type":"number"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/realtor/appraise":{"post":{"summary":"Appraise a property for purchasing from a player","tags":["parcels","realtor"],"description":"Appraise a property for purchasing from a player","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["serverId","parcelId","condition","extraValue"],"properties":{"serverId":{"type":"number","description":"Server ID"},"parcelId":{"type":"number","description":"Field/parcel number"},"condition":{"type":"number","description":"Condition percentage (75-92)"},"extraValue":{"type":"number","description":"Additional value from buildings"}}}}}},"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"npcValue":{"type":"number"},"modifier":{"type":"number"},"extraValue":{"type":"number"},"appraisedValue":{"type":"number"},"serverId":{"type":"number"},"parcelId":{"type":"number"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/realtor/fields/{fieldId}/transfer":{"post":{"summary":"Transfer field between players (realtor only)","tags":["realtor"],"description":"Transfer field between players (realtor only)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["newOwnerId","amount","serverId"],"properties":{"newOwnerId":{"type":"string","description":"Discord ID of new owner"},"amount":{"type":"number","description":"Transfer amount (buyer pays this)","minimum":0},"serverId":{"type":"number","description":"Server ID"}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"fieldId","required":true,"description":"Field UUID"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"field":{"type":"object","properties":{"id":{"type":"string"},"serverId":{"type":"number"},"fieldNumber":{"type":"number"},"ownerId":{"type":"string"},"price":{"type":"number","nullable":true},"fieldSize":{"type":"number","nullable":true},"parcelSize":{"type":"number","nullable":true},"fieldDescription":{"type":"string","nullable":true},"mapName":{"type":"string","nullable":true},"image":{"type":"string","nullable":true},"updatedAt":{"type":"string"},"owner":{"type":"object","properties":{"discordId":{"type":"string"},"username":{"type":"string","nullable":true},"farmName":{"type":"string","nullable":true},"image":{"type":"string","nullable":true}}}}},"buyerTransaction":{"type":"object","properties":{"id":{"type":"number"},"userId":{"type":"string"},"fromId":{"type":"string","nullable":true},"toId":{"type":"string","nullable":true},"amount":{"type":"number"},"before":{"type":"number","nullable":true},"after":{"type":"number","nullable":true},"account":{"type":"string"},"type":{"type":"string","nullable":true},"memo":{"type":"string","nullable":true},"timestamp":{"type":"string"}}},"sellerTransaction":{"type":"object","properties":{"id":{"type":"number"},"userId":{"type":"string"},"fromId":{"type":"string","nullable":true},"toId":{"type":"string","nullable":true},"amount":{"type":"number"},"before":{"type":"number","nullable":true},"after":{"type":"number","nullable":true},"account":{"type":"string"},"type":{"type":"string","nullable":true},"memo":{"type":"string","nullable":true},"timestamp":{"type":"string"}}},"feeTransaction":{"type":"object","properties":{"id":{"type":"number"},"userId":{"type":"string"},"fromId":{"type":"string","nullable":true},"toId":{"type":"string","nullable":true},"amount":{"type":"number"},"before":{"type":"number","nullable":true},"after":{"type":"number","nullable":true},"account":{"type":"string"},"type":{"type":"string","nullable":true},"memo":{"type":"string","nullable":true},"timestamp":{"type":"string"}}},"transferFee":{"type":"number"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/parcels/auctions":{"get":{"summary":"Get active land auctions","tags":["parcels","auctions"],"description":"Get active land auctions","parameters":[{"schema":{"type":"number","default":50,"minimum":1,"maximum":500},"in":"query","name":"limit","required":false,"description":"Maximum number of results to return"},{"schema":{"type":"number","default":0,"minimum":0},"in":"query","name":"offset","required":false,"description":"Number of results to skip for pagination"},{"schema":{"type":"number"},"in":"query","name":"serverId","required":false,"description":"Filter by server ID"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","required":["auctions"],"properties":{"auctions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"parcelId":{"type":"string"},"startingPrice":{"type":"number"},"currentBid":{"type":"number","nullable":true},"highestBidderId":{"type":"string","nullable":true},"startTime":{"type":"string"},"endTime":{"type":"string"},"status":{"type":"string"},"serverId":{"type":"number"},"bidCount":{"type":"number","nullable":true},"parcel":{"type":"object","additionalProperties":true},"highestBidder":{"type":"object","nullable":true,"properties":{"discordId":{"type":"string"},"username":{"type":"string","nullable":true},"nickname":{"type":"string","nullable":true},"image":{"type":"string","nullable":true}}}}}}}},"meta":{"type":"object","required":["timestamp","pagination"],"properties":{"timestamp":{"type":"number"},"pagination":{"type":"object","required":["total","limit","offset","hasMore"],"properties":{"total":{"type":"number"},"limit":{"type":"number"},"offset":{"type":"number"},"hasMore":{"type":"boolean"}}}}},"_links":{"type":"object","description":"HATEOAS pagination links","properties":{"self":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"first":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"prev":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"next":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"last":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/parcels/available":{"get":{"summary":"Get available parcels for purchase or interest","tags":["parcels"],"description":"Get available parcels for purchase or interest","parameters":[{"schema":{"type":"number","default":50,"minimum":1,"maximum":500},"in":"query","name":"limit","required":false,"description":"Maximum number of results to return"},{"schema":{"type":"number","default":0,"minimum":0},"in":"query","name":"offset","required":false,"description":"Number of results to skip for pagination"},{"schema":{"type":"number"},"in":"query","name":"serverId","required":false,"description":"Filter by server ID"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","required":["parcels"],"properties":{"parcels":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"fieldNumber":{"type":"number"},"serverId":{"type":"number"},"ownerId":{"type":"string","nullable":true},"price":{"type":"number","nullable":true},"fieldSize":{"type":"number","nullable":true},"parcelSize":{"type":"number","nullable":true},"fieldDescription":{"type":"string","nullable":true},"mapName":{"type":"string","nullable":true},"image":{"type":"string","nullable":true},"owner":{"type":"object","nullable":true,"properties":{"discordId":{"type":"string"},"username":{"type":"string","nullable":true},"nickname":{"type":"string","nullable":true},"image":{"type":"string","nullable":true}}},"holdBy":{"type":"object","nullable":true,"properties":{"discordId":{"type":"string"},"username":{"type":"string","nullable":true},"nickname":{"type":"string","nullable":true},"image":{"type":"string","nullable":true}}}}}}}},"meta":{"type":"object","required":["timestamp","pagination"],"properties":{"timestamp":{"type":"number"},"pagination":{"type":"object","required":["total","limit","offset","hasMore"],"properties":{"total":{"type":"number"},"limit":{"type":"number"},"offset":{"type":"number"},"hasMore":{"type":"boolean"}}}}},"_links":{"type":"object","description":"HATEOAS pagination links","properties":{"self":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"first":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"prev":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"next":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"last":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/parcels/my-land":{"get":{"summary":"Get authenticated user's owned parcels","tags":["parcels"],"description":"Get authenticated user's owned parcels","parameters":[{"schema":{"type":"number","default":50,"minimum":1,"maximum":500},"in":"query","name":"limit","required":false,"description":"Maximum number of results to return"},{"schema":{"type":"number","default":0,"minimum":0},"in":"query","name":"offset","required":false,"description":"Number of results to skip for pagination"},{"schema":{"type":"number"},"in":"query","name":"serverId","required":false,"description":"Filter by server ID"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","required":["parcels"],"properties":{"parcels":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"fieldNumber":{"type":"number"},"serverId":{"type":"number"},"ownerId":{"type":"string","nullable":true},"price":{"type":"number","nullable":true},"fieldSize":{"type":"number","nullable":true},"parcelSize":{"type":"number","nullable":true},"fieldDescription":{"type":"string","nullable":true},"mapName":{"type":"string","nullable":true},"image":{"type":"string","nullable":true},"owner":{"type":"object","nullable":true,"properties":{"discordId":{"type":"string"},"username":{"type":"string","nullable":true},"nickname":{"type":"string","nullable":true},"image":{"type":"string","nullable":true}}},"holdBy":{"type":"object","nullable":true,"properties":{"discordId":{"type":"string"},"username":{"type":"string","nullable":true},"nickname":{"type":"string","nullable":true},"image":{"type":"string","nullable":true}}}}}}}},"meta":{"type":"object","required":["timestamp","pagination"],"properties":{"timestamp":{"type":"number"},"pagination":{"type":"object","required":["total","limit","offset","hasMore"],"properties":{"total":{"type":"number"},"limit":{"type":"number"},"offset":{"type":"number"},"hasMore":{"type":"boolean"}}}}},"_links":{"type":"object","description":"HATEOAS pagination links","properties":{"self":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"first":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"prev":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"next":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"last":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/parcels/{parcelId}/request-interest":{"post":{"summary":"Request parcel auction or hold (authenticated users)","tags":["parcels","interest-requests"],"description":"Request parcel auction or hold (authenticated users)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["interestType"],"properties":{"interestType":{"type":"string","enum":["AUCTION","HOLD"],"description":"Type of interest request"}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"parcelId","required":true,"description":"Parcel ID"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"request":{"type":"object","properties":{"id":{"type":"string"},"parcelId":{"type":"string"},"userId":{"type":"string"},"serverId":{"type":"number"},"interestType":{"type":"string"},"status":{"type":"string"},"createdAt":{"type":"string"},"expiresAt":{"type":"string","nullable":true},"reviewedAt":{"type":"string","nullable":true},"reviewedBy":{"type":"string","nullable":true},"realtorNotes":{"type":"string","nullable":true},"server":{"type":"object","nullable":true,"properties":{"id":{"type":"number"},"name":{"type":"string"},"mapName":{"type":"string","nullable":true}}},"user":{"type":"object","nullable":true,"properties":{"discordId":{"type":"string"},"username":{"type":"string","nullable":true},"nickname":{"type":"string","nullable":true},"image":{"type":"string","nullable":true}}},"parcel":{"type":"object","properties":{"id":{"type":"string"},"fieldNumber":{"type":"number"},"serverId":{"type":"number"},"ownerId":{"type":"string","nullable":true},"price":{"type":"number","nullable":true},"fieldSize":{"type":"number","nullable":true},"parcelSize":{"type":"number","nullable":true},"fieldDescription":{"type":"string","nullable":true},"mapName":{"type":"string","nullable":true},"image":{"type":"string","nullable":true},"owner":{"type":"object","nullable":true,"properties":{"discordId":{"type":"string"},"username":{"type":"string","nullable":true},"nickname":{"type":"string","nullable":true},"image":{"type":"string","nullable":true}}},"holdBy":{"type":"object","nullable":true,"properties":{"discordId":{"type":"string"},"username":{"type":"string","nullable":true},"nickname":{"type":"string","nullable":true},"image":{"type":"string","nullable":true}}}}},"reviewer":{"type":"object","nullable":true,"properties":{"discordId":{"type":"string"},"username":{"type":"string","nullable":true},"nickname":{"type":"string","nullable":true},"image":{"type":"string","nullable":true}}}}}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/parcels/{parcelId}/bid":{"post":{"summary":"Place bid on an active auction","tags":["parcels","auctions"],"description":"Place bid on an active auction","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["amount"],"properties":{"amount":{"type":"number","minimum":1,"description":"Bid amount"}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"parcelId","required":true,"description":"Parcel ID"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"auction":{"type":"object","properties":{"id":{"type":"string"},"parcelId":{"type":"string"},"startingPrice":{"type":"number"},"currentBid":{"type":"number","nullable":true},"highestBidderId":{"type":"string","nullable":true},"startTime":{"type":"string"},"endTime":{"type":"string"},"status":{"type":"string"},"serverId":{"type":"number"},"bidCount":{"type":"number","nullable":true},"parcel":{"type":"object","additionalProperties":true},"highestBidder":{"type":"object","nullable":true,"properties":{"discordId":{"type":"string"},"username":{"type":"string","nullable":true},"nickname":{"type":"string","nullable":true},"image":{"type":"string","nullable":true}}}}},"bid":{"type":"object","additionalProperties":true}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/parcels/realtor/requests":{"get":{"summary":"Get interest requests (Realtor-only)","tags":["realtor","parcels"],"description":"Get interest requests (Realtor-only)","parameters":[{"schema":{"type":"number","default":50,"minimum":1,"maximum":500},"in":"query","name":"limit","required":false,"description":"Maximum number of results to return"},{"schema":{"type":"number","default":0,"minimum":0},"in":"query","name":"offset","required":false,"description":"Number of results to skip for pagination"},{"schema":{"type":"number"},"in":"query","name":"serverId","required":false,"description":"Filter by server ID"},{"schema":{"type":"string","enum":["PENDING","APPROVED","REJECTED","EXPIRED"]},"in":"query","name":"status","required":false,"description":"Filter by status"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","required":["requests"],"properties":{"requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"parcelId":{"type":"string"},"userId":{"type":"string"},"serverId":{"type":"number"},"interestType":{"type":"string"},"status":{"type":"string"},"createdAt":{"type":"string"},"expiresAt":{"type":"string","nullable":true},"reviewedAt":{"type":"string","nullable":true},"reviewedBy":{"type":"string","nullable":true},"realtorNotes":{"type":"string","nullable":true},"server":{"type":"object","nullable":true,"properties":{"id":{"type":"number"},"name":{"type":"string"},"mapName":{"type":"string","nullable":true}}},"user":{"type":"object","nullable":true,"properties":{"discordId":{"type":"string"},"username":{"type":"string","nullable":true},"nickname":{"type":"string","nullable":true},"image":{"type":"string","nullable":true}}},"parcel":{"type":"object","properties":{"id":{"type":"string"},"fieldNumber":{"type":"number"},"serverId":{"type":"number"},"ownerId":{"type":"string","nullable":true},"price":{"type":"number","nullable":true},"fieldSize":{"type":"number","nullable":true},"parcelSize":{"type":"number","nullable":true},"fieldDescription":{"type":"string","nullable":true},"mapName":{"type":"string","nullable":true},"image":{"type":"string","nullable":true},"owner":{"type":"object","nullable":true,"properties":{"discordId":{"type":"string"},"username":{"type":"string","nullable":true},"nickname":{"type":"string","nullable":true},"image":{"type":"string","nullable":true}}},"holdBy":{"type":"object","nullable":true,"properties":{"discordId":{"type":"string"},"username":{"type":"string","nullable":true},"nickname":{"type":"string","nullable":true},"image":{"type":"string","nullable":true}}}}},"reviewer":{"type":"object","nullable":true,"properties":{"discordId":{"type":"string"},"username":{"type":"string","nullable":true},"nickname":{"type":"string","nullable":true},"image":{"type":"string","nullable":true}}}}}}}},"meta":{"type":"object","required":["timestamp","pagination"],"properties":{"timestamp":{"type":"number"},"pagination":{"type":"object","required":["total","limit","offset","hasMore"],"properties":{"total":{"type":"number"},"limit":{"type":"number"},"offset":{"type":"number"},"hasMore":{"type":"boolean"}}}}},"_links":{"type":"object","description":"HATEOAS pagination links","properties":{"self":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"first":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"prev":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"next":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"last":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/parcels/realtor/requests/{requestId}/approve":{"post":{"summary":"Approve interest request (Realtor-only)","tags":["realtor","parcels"],"description":"Approve interest request (Realtor-only)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"realtorNotes":{"type":"string","description":"Optional realtor review notes"}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"requestId","required":true,"description":"Request ID"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"request":{"type":"object","properties":{"id":{"type":"string"},"parcelId":{"type":"string"},"userId":{"type":"string"},"serverId":{"type":"number"},"interestType":{"type":"string"},"status":{"type":"string"},"createdAt":{"type":"string"},"expiresAt":{"type":"string","nullable":true},"reviewedAt":{"type":"string","nullable":true},"reviewedBy":{"type":"string","nullable":true},"realtorNotes":{"type":"string","nullable":true},"server":{"type":"object","nullable":true,"properties":{"id":{"type":"number"},"name":{"type":"string"},"mapName":{"type":"string","nullable":true}}},"user":{"type":"object","nullable":true,"properties":{"discordId":{"type":"string"},"username":{"type":"string","nullable":true},"nickname":{"type":"string","nullable":true},"image":{"type":"string","nullable":true}}},"parcel":{"type":"object","properties":{"id":{"type":"string"},"fieldNumber":{"type":"number"},"serverId":{"type":"number"},"ownerId":{"type":"string","nullable":true},"price":{"type":"number","nullable":true},"fieldSize":{"type":"number","nullable":true},"parcelSize":{"type":"number","nullable":true},"fieldDescription":{"type":"string","nullable":true},"mapName":{"type":"string","nullable":true},"image":{"type":"string","nullable":true},"owner":{"type":"object","nullable":true,"properties":{"discordId":{"type":"string"},"username":{"type":"string","nullable":true},"nickname":{"type":"string","nullable":true},"image":{"type":"string","nullable":true}}},"holdBy":{"type":"object","nullable":true,"properties":{"discordId":{"type":"string"},"username":{"type":"string","nullable":true},"nickname":{"type":"string","nullable":true},"image":{"type":"string","nullable":true}}}}},"reviewer":{"type":"object","nullable":true,"properties":{"discordId":{"type":"string"},"username":{"type":"string","nullable":true},"nickname":{"type":"string","nullable":true},"image":{"type":"string","nullable":true}}}}}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/parcels/realtor/requests/{requestId}/create-auction":{"post":{"summary":"Create an auction from a pending auction interest request (Realtor-only)","tags":["realtor","parcels","auctions"],"description":"Create an auction from a pending auction interest request (Realtor-only)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["startingPrice","durationHours"],"properties":{"startingPrice":{"type":"number","minimum":1,"description":"Starting price for the auction"},"durationHours":{"type":"number","minimum":1,"maximum":168,"description":"Auction duration in hours (1-168)"}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"requestId","required":true,"description":"Interest request ID"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"auction":{"type":"object","additionalProperties":true}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/parcels/realtor/requests/{requestId}/reject":{"post":{"summary":"Reject interest request (Realtor-only)","tags":["realtor","parcels"],"description":"Reject interest request (Realtor-only)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"realtorNotes":{"type":"string","description":"Optional realtor review notes"}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"requestId","required":true,"description":"Request ID"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"request":{"type":"object","properties":{"id":{"type":"string"},"parcelId":{"type":"string"},"userId":{"type":"string"},"serverId":{"type":"number"},"interestType":{"type":"string"},"status":{"type":"string"},"createdAt":{"type":"string"},"expiresAt":{"type":"string","nullable":true},"reviewedAt":{"type":"string","nullable":true},"reviewedBy":{"type":"string","nullable":true},"realtorNotes":{"type":"string","nullable":true},"server":{"type":"object","nullable":true,"properties":{"id":{"type":"number"},"name":{"type":"string"},"mapName":{"type":"string","nullable":true}}},"user":{"type":"object","nullable":true,"properties":{"discordId":{"type":"string"},"username":{"type":"string","nullable":true},"nickname":{"type":"string","nullable":true},"image":{"type":"string","nullable":true}}},"parcel":{"type":"object","properties":{"id":{"type":"string"},"fieldNumber":{"type":"number"},"serverId":{"type":"number"},"ownerId":{"type":"string","nullable":true},"price":{"type":"number","nullable":true},"fieldSize":{"type":"number","nullable":true},"parcelSize":{"type":"number","nullable":true},"fieldDescription":{"type":"string","nullable":true},"mapName":{"type":"string","nullable":true},"image":{"type":"string","nullable":true},"owner":{"type":"object","nullable":true,"properties":{"discordId":{"type":"string"},"username":{"type":"string","nullable":true},"nickname":{"type":"string","nullable":true},"image":{"type":"string","nullable":true}}},"holdBy":{"type":"object","nullable":true,"properties":{"discordId":{"type":"string"},"username":{"type":"string","nullable":true},"nickname":{"type":"string","nullable":true},"image":{"type":"string","nullable":true}}}}},"reviewer":{"type":"object","nullable":true,"properties":{"discordId":{"type":"string"},"username":{"type":"string","nullable":true},"nickname":{"type":"string","nullable":true},"image":{"type":"string","nullable":true}}}}}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/parcels/realtor/on-hold":{"get":{"summary":"Get parcels on hold (Realtor-only)","tags":["realtor","parcels"],"description":"Get parcels on hold (Realtor-only)","parameters":[{"schema":{"type":"number","default":50,"minimum":1,"maximum":500},"in":"query","name":"limit","required":false,"description":"Maximum number of results to return"},{"schema":{"type":"number","default":0,"minimum":0},"in":"query","name":"offset","required":false,"description":"Number of results to skip for pagination"},{"schema":{"type":"number"},"in":"query","name":"serverId","required":false,"description":"Filter by server ID"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","required":["parcels"],"properties":{"parcels":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"fieldNumber":{"type":"number"},"serverId":{"type":"number"},"ownerId":{"type":"string","nullable":true},"price":{"type":"number","nullable":true},"fieldSize":{"type":"number","nullable":true},"parcelSize":{"type":"number","nullable":true},"fieldDescription":{"type":"string","nullable":true},"mapName":{"type":"string","nullable":true},"image":{"type":"string","nullable":true},"owner":{"type":"object","nullable":true,"properties":{"discordId":{"type":"string"},"username":{"type":"string","nullable":true},"nickname":{"type":"string","nullable":true},"image":{"type":"string","nullable":true}}},"holdBy":{"type":"object","nullable":true,"properties":{"discordId":{"type":"string"},"username":{"type":"string","nullable":true},"nickname":{"type":"string","nullable":true},"image":{"type":"string","nullable":true}}}}}}}},"meta":{"type":"object","required":["timestamp","pagination"],"properties":{"timestamp":{"type":"number"},"pagination":{"type":"object","required":["total","limit","offset","hasMore"],"properties":{"total":{"type":"number"},"limit":{"type":"number"},"offset":{"type":"number"},"hasMore":{"type":"boolean"}}}}},"_links":{"type":"object","description":"HATEOAS pagination links","properties":{"self":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"first":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"prev":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"next":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"last":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/parcels/realtor/auctions":{"post":{"summary":"Create a manual auction for a system-owned parcel","tags":["realtor","parcels","auctions"],"description":"Create a manual auction for a system-owned parcel","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["serverId","fieldNumber","startingPrice","durationHours"],"properties":{"serverId":{"type":"number","description":"Server ID"},"fieldNumber":{"type":"number","description":"Field/parcel number"},"startingPrice":{"type":"number","minimum":1,"description":"Starting price for the auction"},"durationHours":{"type":"number","minimum":1,"maximum":168,"description":"Auction duration in hours (1-168)"}}}}}},"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"auction":{"type":"object","additionalProperties":true}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/parcels/realtor/parcels/{parcelId}/activate":{"post":{"summary":"Activate an On-Hold parcel into an active auction","tags":["realtor"],"description":"Activate an On-Hold parcel into an active auction","parameters":[{"schema":{"type":"string"},"in":"path","name":"parcelId","required":true,"description":"Parcel ID"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"auction":{"type":"object","properties":{"id":{"type":"string"},"parcelId":{"type":"string"},"startingPrice":{"type":"number"},"currentBid":{"type":"number","nullable":true},"highestBidderId":{"type":"string","nullable":true},"startTime":{"type":"string"},"endTime":{"type":"string"},"status":{"type":"string"},"serverId":{"type":"number"},"bidCount":{"type":"number","nullable":true},"parcel":{"type":"object","additionalProperties":true},"highestBidder":{"type":"object","nullable":true,"properties":{"discordId":{"type":"string"},"username":{"type":"string","nullable":true},"nickname":{"type":"string","nullable":true},"image":{"type":"string","nullable":true}}}}}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/parcels/realtor/auctions/{auctionId}/cancel":{"post":{"summary":"Cancel an active auction without charging bidders or transferring the parcel","tags":["realtor","parcels","auctions"],"description":"Cancel an active auction without charging bidders or transferring the parcel","parameters":[{"schema":{"type":"string"},"in":"path","name":"auctionId","required":true,"description":"Auction ID"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"auction":{"type":"object","properties":{"id":{"type":"string"},"parcelId":{"type":"string"},"startingPrice":{"type":"number"},"currentBid":{"type":"number","nullable":true},"highestBidderId":{"type":"string","nullable":true},"startTime":{"type":"string"},"endTime":{"type":"string"},"status":{"type":"string"},"serverId":{"type":"number"},"bidCount":{"type":"number","nullable":true},"parcel":{"type":"object","additionalProperties":true},"highestBidder":{"type":"object","nullable":true,"properties":{"discordId":{"type":"string"},"username":{"type":"string","nullable":true},"nickname":{"type":"string","nullable":true},"image":{"type":"string","nullable":true}}}}}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/parcels/realtor/ended-auctions":{"get":{"summary":"Get ended auctions that need processing (Realtor-only)","tags":["realtor","parcels"],"description":"Get ended auctions that need processing (Realtor-only)","parameters":[{"schema":{"type":"number","default":50,"minimum":1,"maximum":500},"in":"query","name":"limit","required":false,"description":"Maximum number of results to return"},{"schema":{"type":"number","default":0,"minimum":0},"in":"query","name":"offset","required":false,"description":"Number of results to skip for pagination"},{"schema":{"type":"number"},"in":"query","name":"serverId","required":false,"description":"Filter by server ID"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","required":["auctions"],"properties":{"auctions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"parcelId":{"type":"string"},"startingPrice":{"type":"number"},"currentBid":{"type":"number","nullable":true},"highestBidderId":{"type":"string","nullable":true},"startTime":{"type":"string"},"endTime":{"type":"string"},"status":{"type":"string"},"serverId":{"type":"number"},"bidCount":{"type":"number","nullable":true},"parcel":{"type":"object","additionalProperties":true},"highestBidder":{"type":"object","nullable":true,"properties":{"discordId":{"type":"string"},"username":{"type":"string","nullable":true},"nickname":{"type":"string","nullable":true},"image":{"type":"string","nullable":true}}}}}}}},"meta":{"type":"object","required":["timestamp","pagination"],"properties":{"timestamp":{"type":"number"},"pagination":{"type":"object","required":["total","limit","offset","hasMore"],"properties":{"total":{"type":"number"},"limit":{"type":"number"},"offset":{"type":"number"},"hasMore":{"type":"boolean"}}}}},"_links":{"type":"object","description":"HATEOAS pagination links","properties":{"self":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"first":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"prev":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"next":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"last":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/parcels/realtor/auctions/{auctionId}/finalize":{"post":{"summary":"Finalize an ended auction (Realtor-only)","tags":["realtor","parcels","auctions"],"description":"Finalize an ended auction (Realtor-only)","parameters":[{"schema":{"type":"string"},"in":"path","name":"auctionId","required":true}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","required":["message"],"properties":{"message":{"type":"string"},"outcome":{"type":"string","enum":["COMPLETED","INSUFFICIENT_FUNDS","FIELD_UNAVAILABLE","NO_BIDS","CANCELLED"]},"gameServerAssigned":{"type":"boolean"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/invoices/{id}/respond":{"post":{"summary":"Respond to an invoice (accept or decline)","tags":["invoices"],"description":"Respond to an invoice (accept or decline)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["action"],"properties":{"action":{"type":"string","enum":["accept","decline"]}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true,"description":"Invoice ID"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"message":{"type":"string"},"invoiceId":{"type":"number"},"status":{"type":"string"},"transactionId":{"type":"number"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Invalid invoice ID","content":{"application/json":{"schema":{"description":"Invalid invoice ID"}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"404":{"description":"Invoice not found","content":{"application/json":{"schema":{"description":"Invoice not found"}}}},"422":{"description":"Invoice cannot be accepted or declined in its current state","content":{"application/json":{"schema":{"description":"Invoice cannot be accepted or declined in its current state"}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/invoices/":{"post":{"summary":"Create a new invoice","tags":["invoices"],"description":"Create a new invoice","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["recipientId","amount","memo"],"properties":{"recipientId":{"type":"string","description":"Discord ID of recipient"},"amount":{"type":"number","minimum":1,"description":"Invoice amount"},"memo":{"type":"string","minLength":1,"description":"Invoice description"},"expiresInHours":{"type":"number","minimum":1,"maximum":720,"default":168,"description":"Hours until expiration (default: 7 days)"}}}}}},"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"invoiceId":{"type":"number"},"message":{"type":"string"},"warning":{"type":"string"},"expiresAt":{"type":"string"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Malformed invoice request","content":{"application/json":{"schema":{"description":"Malformed invoice request"}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"404":{"description":"Invoicer or recipient not found","content":{"application/json":{"schema":{"description":"Invoicer or recipient not found"}}}},"422":{"description":"Invoice cannot be created because of a business rule","content":{"application/json":{"schema":{"description":"Invoice cannot be created because of a business rule"}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}},"get":{"summary":"Get user's invoices with pagination and filtering","tags":["invoices"],"description":"Get user's invoices with pagination and filtering","parameters":[{"schema":{"type":"number","default":50,"minimum":1,"maximum":500},"in":"query","name":"limit","required":false,"description":"Maximum number of results to return"},{"schema":{"type":"number","default":0,"minimum":0},"in":"query","name":"offset","required":false,"description":"Number of results to skip for pagination"},{"schema":{"type":"string","enum":["sent","received","all"],"default":"all"},"in":"query","name":"type","required":false,"description":"Filter by invoice type"},{"schema":{"type":"string"},"in":"query","name":"status","required":false,"description":"Filter by status"},{"schema":{"type":"string"},"in":"query","name":"fields","required":false,"description":"Comma-separated list of fields to return"},{"schema":{"type":"string"},"in":"query","name":"sort","required":false,"description":"Sort by field(s), prefix with - for descending"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","required":["invoices"],"properties":{"invoices":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"invoicerId":{"type":"string"},"recipientId":{"type":"string"},"amount":{"type":"number"},"memo":{"type":"string","nullable":true},"status":{"type":"string"},"createdAt":{"type":"string"},"expiresAt":{"type":"string"},"invoicer":{"type":"object","required":["discordId"],"properties":{"discordId":{"type":"string"},"username":{"type":"string","nullable":true},"farmName":{"type":"string","nullable":true},"image":{"type":"string","nullable":true}}},"recipient":{"type":"object","required":["discordId"],"properties":{"discordId":{"type":"string"},"username":{"type":"string","nullable":true},"farmName":{"type":"string","nullable":true},"image":{"type":"string","nullable":true}}},"_links":{"type":"object","additionalProperties":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}}}}}}}},"meta":{"type":"object","required":["timestamp","pagination"],"properties":{"timestamp":{"type":"number"},"pagination":{"type":"object","required":["total","limit","offset","hasMore"],"properties":{"total":{"type":"number"},"limit":{"type":"number"},"offset":{"type":"number"},"hasMore":{"type":"boolean"}}}}},"_links":{"type":"object","description":"HATEOAS pagination links","properties":{"self":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"first":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"prev":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"next":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"last":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/invoices/{id}":{"delete":{"summary":"Cancel a pending invoice","tags":["invoices"],"description":"Cancel a pending invoice","parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true,"description":"Invoice ID"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"message":{"type":"string"},"invoiceId":{"type":"number"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Invalid invoice ID","content":{"application/json":{"schema":{"description":"Invalid invoice ID"}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"404":{"description":"Invoice not found","content":{"application/json":{"schema":{"description":"Invoice not found"}}}},"422":{"description":"Invoice cannot be cancelled in its current state","content":{"application/json":{"schema":{"description":"Invoice cannot be cancelled in its current state"}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/permissions/my-permissions":{"get":{"summary":"Get current user's permissions based on their roles","tags":["permissions"],"description":"Get current user's permissions based on their roles","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"userId":{"type":"string"},"roles":{"type":"array","items":{"type":"string"}},"permissions":{"type":"array","items":{"type":"string"}},"total":{"type":"number"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/permissions/check/{permission}":{"get":{"summary":"Check if user has a specific permission","tags":["permissions"],"description":"Check if user has a specific permission","parameters":[{"schema":{"type":"string"},"in":"path","name":"permission","required":true,"description":"Permission name to check"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"permission":{"type":"string"},"has":{"type":"boolean"},"userRoles":{"type":"array","items":{"type":"string"}}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/servers/":{"get":{"summary":"Get all game servers. Use ?fields=id,name for minimal response.","tags":["servers"],"description":"Get all game servers. Use ?fields=id,name for minimal response.","parameters":[{"schema":{"type":"string"},"in":"query","name":"fields","required":false,"description":"Comma-separated list of fields to return (e.g., id,name)"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"servers":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"name":{"type":"string"},"channel":{"type":"string","nullable":true},"image":{"type":"string","nullable":true},"sponsor":{"type":"string","nullable":true},"slots":{"type":"number","nullable":true},"region":{"type":"string","nullable":true},"timezone":{"type":"number","nullable":true},"seasonGroup":{"type":"number","nullable":true},"sponsorDetails":{"type":"object","nullable":true,"properties":{"discordId":{"type":"string"},"username":{"type":"string","nullable":true},"nickname":{"type":"string","nullable":true},"color":{"type":"string","nullable":true},"image":{"type":"string","nullable":true}}},"farmManagers":{"type":"array","items":{"type":"object","properties":{"user":{"type":"object","properties":{"discordId":{"type":"string"},"username":{"type":"string"},"nickname":{"type":"string","nullable":true},"image":{"type":"string","nullable":true},"color":{"type":"string","nullable":true}}}}}},"onlinePlayers":{"type":"array","items":{"type":"object","properties":{"user":{"type":"object","properties":{"discordId":{"type":"string"},"username":{"type":"string"},"image":{"type":"string","nullable":true}}}}}}}}}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/servers/{serverId}/restart":{"post":{"summary":"Restart a game server (farm manager+)","tags":["servers"],"description":"Restart a game server (farm manager+)","parameters":[{"schema":{"type":"string","pattern":"^[0-9]+$"},"in":"path","name":"serverId","required":true,"description":"Server ID"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"message":{"type":"string"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Bad request - invalid server ID","content":{"application/json":{"schema":{"description":"Bad request - invalid server ID"}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"404":{"description":"Server not found","content":{"application/json":{"schema":{"description":"Server not found"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"description":"Internal server error"}}}},"501":{"description":"Server restart integration is not implemented","content":{"application/json":{"schema":{"description":"Server restart integration is not implemented"}}}}}}},"/api/v1/servers/{serverId}/kick":{"post":{"summary":"Kick a player from the game server (farm manager+)","tags":["servers"],"description":"Kick a player from the game server (farm manager+)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["userId"],"properties":{"userId":{"type":"string","description":"Discord ID of user to kick"}}}}}},"parameters":[{"schema":{"type":"string","pattern":"^[0-9]+$"},"in":"path","name":"serverId","required":true,"description":"Server ID"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"message":{"type":"string"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/servers/{serverId}/live-info":{"get":{"summary":"Get live information from the game server","tags":["servers"],"description":"Get live information from the game server","parameters":[{"schema":{"type":"string","pattern":"^[0-9]+$"},"in":"path","name":"serverId","required":true,"description":"Server ID"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"status":{"type":"string"},"name":{"type":"string"},"slots":{"type":"object","additionalProperties":true},"players":{"type":"array","items":{"type":"object","additionalProperties":true}},"memory":{"type":"number"},"cpu":{"type":"number"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/servers/{serverId}":{"get":{"summary":"Get detailed information about a specific server including fields and online players","tags":["servers"],"description":"Get detailed information about a specific server including fields and online players","parameters":[{"schema":{"type":"string","pattern":"^[0-9]+$"},"in":"path","name":"serverId","required":true,"description":"Server ID"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"server":{"type":"object","additionalProperties":true,"properties":{"id":{"type":"number"},"name":{"type":"string"},"region":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"slots":{"type":"number","nullable":true},"guid":{"type":"string"},"image":{"type":"string","nullable":true},"timezone":{"type":"number","nullable":true},"seasonGroup":{"type":"number","nullable":true},"channel":{"type":"string","nullable":true},"serverMeta":{"type":"object","nullable":true,"additionalProperties":true},"lastHealthCheck":{"type":"string","nullable":true},"lastSaveAt":{"type":"string","nullable":true},"lastBackupAt":{"type":"string","nullable":true},"healthStatus":{"type":"array","nullable":true,"items":{"type":"object","properties":{"online":{"type":"boolean"},"timestamp":{"type":"string"},"responseTime":{"type":"number"}}}},"sponsor":{"type":"object","nullable":true,"additionalProperties":true},"farmManagers":{"type":"array","items":{"type":"object","additionalProperties":true}},"onlinePlayers":{"type":"array","items":{"type":"object","additionalProperties":true}}}},"fields":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"fieldNumber":{"type":"number"},"serverId":{"type":"number"},"fieldDescription":{"type":"string","nullable":true},"fieldSize":{"type":"number"},"parcelSize":{"type":"number"},"price":{"type":"number","nullable":true},"owner":{"type":"string","nullable":true},"ownerNickname":{"type":"string","nullable":true},"ownerColor":{"type":"string","nullable":true},"image":{"type":"string","nullable":true},"mapName":{"type":"string","nullable":true}}}}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/servers/{serverId}/managers":{"get":{"summary":"Get server managers (FM)","tags":["servers"],"description":"Get server managers (FM)","parameters":[{"schema":{"type":"string","pattern":"^[0-9]+$"},"in":"path","name":"serverId","required":true,"description":"Server ID"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"managers":{"type":"array","items":{"type":"object","additionalProperties":true}}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/servers/{serverId}/fields":{"get":{"summary":"Get all fields for a specific server with pagination, filtering, and field selection","tags":["fields","servers"],"description":"Get all fields for a specific server with pagination, filtering, and field selection","parameters":[{"schema":{"type":"number","default":50,"minimum":1,"maximum":500},"in":"query","name":"limit","required":false,"description":"Maximum number of results to return"},{"schema":{"type":"number","default":0,"minimum":0},"in":"query","name":"offset","required":false,"description":"Number of results to skip for pagination"},{"schema":{"type":"string"},"in":"query","name":"fields","required":false,"description":"Comma-separated list of fields to return"},{"schema":{"type":"string"},"in":"query","name":"sort","required":false,"description":"Sort by field(s), prefix with - for descending"},{"schema":{"type":"string","pattern":"^[0-9]+$"},"in":"path","name":"serverId","required":true,"description":"Server ID"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","required":["fields"],"properties":{"fields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"fieldNumber":{"type":"number"},"serverId":{"type":"number"},"ownerId":{"type":"string"},"fieldDescription":{"type":"string"},"mapName":{"type":"string"},"image":{"type":"string"},"fieldSize":{"type":"string"},"parcelSize":{"type":"string"},"price":{"type":"number"},"holdByUserId":{"type":["null","string"]},"holdUntil":{"type":["null","string"]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"owner":{"type":"object","properties":{"discordId":{"type":"string"},"username":{"type":"string"},"image":{"type":"string"}}},"_links":{"type":"object","additionalProperties":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}}}}}}}},"meta":{"type":"object","required":["timestamp","pagination"],"properties":{"timestamp":{"type":"number"},"pagination":{"type":"object","required":["total","limit","offset","hasMore"],"properties":{"total":{"type":"number"},"limit":{"type":"number"},"offset":{"type":"number"},"hasMore":{"type":"boolean"}}}}},"_links":{"type":"object","description":"HATEOAS pagination links","properties":{"self":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"first":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"prev":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"next":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"last":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/servers/{serverId}/fields/{fieldId}":{"get":{"summary":"Get detailed information about a specific field","tags":["fields","servers"],"description":"Get detailed information about a specific field","parameters":[{"schema":{"type":"string","pattern":"^[0-9]+$"},"in":"path","name":"serverId","required":true,"description":"Server ID"},{"schema":{"type":"string","pattern":"^[0-9]+$"},"in":"path","name":"fieldId","required":true,"description":"Field/Parcel ID"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"field":{"type":"object","additionalProperties":true,"properties":{"fieldNumber":{"type":"number"},"serverId":{"type":"number"},"fieldDescription":{"type":"string","nullable":true},"fieldSize":{"type":"number"},"parcelSize":{"type":"number"},"price":{"type":"number","nullable":true},"owner":{"type":"string","nullable":true},"ownerNickname":{"type":"string","nullable":true},"ownerColor":{"type":"string","nullable":true},"image":{"type":"string","nullable":true},"mapName":{"type":"string","nullable":true}}},"server":{"type":"object","additionalProperties":true,"properties":{"id":{"type":"number"},"name":{"type":"string"},"image":{"type":"string","nullable":true}}}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/servers/{serverId}/save":{"post":{"summary":"Save the game server","tags":["servers"],"description":"Save the game server","parameters":[{"schema":{"type":"string","pattern":"^[0-9]+$"},"in":"path","name":"serverId","required":true,"description":"Server ID"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"message":{"type":"string"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/servers/{serverId}/online-players":{"patch":{"summary":"Update server online players list","tags":["servers"],"description":"Update server online players list","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["onlinePlayers"],"properties":{"onlinePlayers":{"type":"array","items":{"type":"string"},"description":"Array of Discord IDs currently online"}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"serverId","required":true,"description":"Server ID"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"message":{"type":"string"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/servers/{serverId}/health":{"get":{"summary":"Get server health status (public endpoint, no auth required)","tags":["servers"],"description":"Get server health status (public endpoint, no auth required)","parameters":[{"schema":{"type":"string"},"in":"path","name":"serverId","required":true,"description":"Server ID"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"title":{"type":"string","description":"Display title for the server (e.g., \"Server 1\" or \"Community Server 1001\")"},"status":{"type":"string","enum":["healthy","degraded","unhealthy"],"description":"Overall server health status"},"online":{"type":"boolean","description":"Current online status based on recent health checks"},"lastHealthCheck":{"type":"string","nullable":true,"description":"Timestamp of last health check"},"lastSaveAt":{"type":"string","nullable":true,"description":"Timestamp of last game save"},"lastBackupAt":{"type":"string","nullable":true,"description":"Timestamp of last backup"},"issues":{"type":"array","items":{"type":"string"},"nullable":true,"description":"List of health issues if any"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}},"patch":{"summary":"Update server health monitoring data","tags":["servers"],"description":"Update server health monitoring data","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["health"],"properties":{"health":{"type":"object","required":["timestamp","online","responseTime"],"properties":{"timestamp":{"type":"string","format":"date-time"},"online":{"type":"boolean"},"responseTime":{"type":"number"},"lastSave":{"type":"string","format":"date-time","nullable":true},"lastBackup":{"type":"string","format":"date-time","nullable":true}}}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"serverId","required":true,"description":"Server ID"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"message":{"type":"string"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/servers/{serverId}/stats":{"post":{"tags":["servers","statistics"],"description":"Store server statistics from livemap data","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["gameVersion","modVersion","mapName","paused","progress","lastUpdate","vehicles","players","weather"],"properties":{"gameVersion":{"type":"string"},"modVersion":{"type":"string"},"mapName":{"type":"string"},"mapSize":{"type":"number"},"paused":{"type":"boolean"},"progress":{"type":"number"},"lastUpdate":{"type":"string"},"vehicles":{"type":"array","items":{"type":"object","required":["id","name","type","x","z","rotation"],"properties":{"id":{"type":"number"},"name":{"type":"string"},"type":{"type":"string"},"x":{"type":"number"},"z":{"type":"number"},"rotation":{"type":"number"}}}},"players":{"type":"array","items":{"type":"object","required":["uuid","name","x","z","rotation","idleTime","activeTime"],"properties":{"uuid":{"type":"string"},"name":{"type":"string"},"x":{"type":"number"},"z":{"type":"number"},"rotation":{"type":"number"},"idleTime":{"type":"number"},"activeTime":{"type":"number"}}}},"weather":{"type":"array","items":{"type":"object","required":["id","label","type","isHourly"],"properties":{"id":{"type":"number"},"label":{"type":"string"},"type":{"type":"string"},"isHourly":{"type":"boolean"},"temperature":{"type":"number"},"lowTemp":{"type":"number"},"highTemp":{"type":"number"},"windRotation":{"type":"number"},"windVelocity":{"type":"number"}}}},"fields":{"type":"array","items":{"type":"object","required":["id"],"properties":{"id":{"type":"number"},"fruitName":{"type":"string"},"fruitColor":{"type":"string"},"farmland":{"type":"number"},"farmlandPrice":{"type":"number"},"farmlandArea":{"type":"number"},"farmlandOwner":{"type":"string"},"polygon":{"anyOf":[{"type":"array","items":{"type":"object","required":["x","z"],"properties":{"x":{"type":"number"},"z":{"type":"number"}}}},{"type":"null"}]}}}},"hotspots":{"type":"array","items":{"type":"object","required":["id","name","type","x","z"],"properties":{"id":{"type":"number"},"name":{"type":"string"},"type":{"type":"string"},"x":{"type":"number"},"z":{"type":"number"}}}},"cropCalendar":{"type":"array","items":{"type":"object","required":["id","name","periodicities"],"properties":{"id":{"type":"number"},"name":{"type":"string"},"periodicities":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"name":{"type":"string"},"bePlanted":{"type":"boolean"},"beHarvested":{"type":"boolean"}}}}}}}}}}}},"parameters":[{"schema":{"type":"string","pattern":"^[0-9]+$"},"in":"path","name":"serverId","required":true,"description":"Server ID"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"id":{"type":"string"},"serverId":{"type":"number"},"lastUpdate":{"type":"string"}}},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/servers/{serverId}/stats/latest":{"get":{"tags":["servers","statistics"],"description":"Get latest server statistics","parameters":[{"schema":{"type":"string","pattern":"^[0-9]+$"},"in":"path","name":"serverId","required":true}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"id":{"type":"string"},"serverId":{"type":"number"},"gameVersion":{"type":"string"},"modVersion":{"type":"string"},"mapName":{"type":"string"},"mapSize":{"type":"number"},"paused":{"type":"boolean"},"progress":{"type":"number"},"lastUpdate":{"type":"string"},"createdAt":{"type":"string"},"vehicles":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"snapshotId":{"type":"string"},"vehicleId":{"type":"number"},"name":{"type":"string"},"type":{"type":"string"},"x":{"type":"number"},"z":{"type":"number"},"rotation":{"type":"number"}}}},"players":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"snapshotId":{"type":"string"},"uuid":{"type":"string"},"name":{"type":"string"},"x":{"type":"number"},"z":{"type":"number"},"rotation":{"type":"number"},"idleTime":{"type":"number"},"activeTime":{"type":"number"}}}},"weather":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"snapshotId":{"type":"string"},"weatherId":{"type":"number"},"label":{"type":"string"},"type":{"type":"string"},"isHourly":{"type":"boolean"},"temperature":{"type":["null","number"]},"lowTemp":{"type":["null","number"]},"highTemp":{"type":["null","number"]},"windRotation":{"type":["null","number"]},"windVelocity":{"type":["null","number"]}}}},"fields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"snapshotId":{"type":"string"},"fieldId":{"type":"number"},"fruitName":{"type":["null","string"]},"fruitColor":{"type":["null","string"]},"farmland":{"type":["null","number"]},"farmlandPrice":{"type":["null","number"]},"farmlandArea":{"type":["null","number"]},"farmlandOwner":{"type":["null","string"]},"polygon":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"x":{"type":"number"},"z":{"type":"number"}}}},{"type":"null"}]}}}},"hotspots":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"snapshotId":{"type":"string"},"hotspotId":{"type":"number"},"name":{"type":"string"},"type":{"type":"string"},"x":{"type":"number"},"z":{"type":"number"}}}},"cropCalendar":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"snapshotId":{"type":"string"},"fruitId":{"type":"number"},"fruitName":{"type":"string"},"periodicities":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"name":{"type":"string"},"bePlanted":{"type":"boolean"},"beHarvested":{"type":"boolean"}}}}}}}}},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/servers/{serverId}/stats/history":{"get":{"tags":["servers","statistics"],"description":"Get server statistics history","parameters":[{"schema":{"type":"number","minimum":1,"maximum":100,"default":10},"in":"query","name":"limit","required":false},{"schema":{"type":"string","pattern":"^[0-9]+$"},"in":"path","name":"serverId","required":true}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"gameVersion":{"type":"string"},"modVersion":{"type":"string"},"mapName":{"type":"string"},"paused":{"type":"boolean"},"progress":{"type":"number"},"lastUpdate":{"type":"string"},"createdAt":{"type":"string"}}}},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/notifications/websocket-docs":{"get":{"tags":["notifications","websocket"],"description":"\n## WebSocket Events\n\nThe notification system uses WebSocket (Socket.IO) for real-time bidirectional communication.\n\n### Connection\n\n**Endpoint:** `ws://localhost:3000` (or wss:// in production)\n\n**Authentication:**\n1. Connect to WebSocket server\n2. Emit `authenticate` event with JWT token\n3. Server responds with `authenticated` or `unauthorized`\n\n```javascript\nconst socket = io('ws://localhost:3000');\nsocket.emit('authenticate', { token: 'your-jwt-token' });\n\nsocket.on('authenticated', () => {\n  console.log('Connected and authenticated');\n});\n\nsocket.on('unauthorized', (error) => {\n  console.error('Authentication failed:', error);\n});\n```\n\n### Client Events (Client → Server)\n\n- **authenticate**: Authenticate WebSocket connection\n  - Payload: `{ token: string }`\n  - Response: `authenticated` or `unauthorized` event\n\n- **notification:read**: Mark notification as read (deprecated, use REST API)\n  - Payload: `{ notificationId: string }`\n\n- **notification:read-all**: Mark all notifications as read (deprecated, use REST API)\n  - Payload: none\n\n### Server Events (Server → Client)\n\n- **notification:new**: New notification created\n  - Payload: Notification object with all fields\n  - Emitted to all user connections when notification is created\n\n- **notification:read**: Notification marked as read\n  - Payload: `{ notificationId: string, readAt: string }`\n  - Emitted to all user connections when notification is marked as read\n\n- **notification:unread**: Notification marked as unread\n  - Payload: `{ notificationId: string }`\n  - Emitted to all user connections when notification is marked as unread\n\n- **notification:count**: Unread notification count update\n  - Payload: `number` (unread count)\n  - Emitted when count changes (new notification, mark as read, mark all as read/unread)\n\n- **notification:all-read**: All notifications marked as read\n  - Payload: `{ timestamp: string }`\n  - Emitted when user marks all notifications as read\n\n- **notification:all-unread**: All read notifications marked as unread\n  - Payload: `{ timestamp: string, unreadCount: number }`\n  - Emitted when user marks read notifications as unread\n\n### Bot Events (Server ↔ Bot)\n\n- **bot:deliver** (Server → Bot): Deliver notification via Discord\n  - Payload: BotDeliveryPayload with notification data and template\n  - Bot should send Discord message and report status\n\n- **bot:delivery-status** (Bot → Server): Report delivery status\n  - Payload: `{ notificationId: string, success: boolean, discordMessageId?: string, error?: string }`\n  - Bot reports success or failure of Discord message delivery\n\n### Example Usage\n\n```javascript\n// Listen for new notifications\nsocket.on('notification:new', (notification) => {\n  console.log('New notification:', notification);\n  // Update UI with new notification\n});\n\n// Listen for count updates\nsocket.on('notification:count', (count) => {\n  console.log('Unread count:', count);\n  // Update badge count in UI\n});\n\n// Listen for read status updates\nsocket.on('notification:read', ({ notificationId, readAt }) => {\n  console.log('Notification marked as read:', notificationId);\n  // Update notification UI to show as read\n});\n\n// Listen for unread status updates\nsocket.on('notification:unread', ({ notificationId }) => {\n  console.log('Notification marked as unread:', notificationId);\n  // Update notification UI to show as unread\n});\n\n// Listen for mark all as read\nsocket.on('notification:all-read', ({ timestamp }) => {\n  console.log('All notifications marked as read at:', timestamp);\n  // Update UI to show all as read\n});\n\n// Listen for mark all as unread\nsocket.on('notification:all-unread', ({ timestamp, unreadCount }) => {\n  console.log('All read notifications marked as unread at:', timestamp, unreadCount);\n  // Update UI to show affected notifications as unread\n});\n```\n\n### Reconnection\n\nThe client should implement automatic reconnection with exponential backoff:\n\n```javascript\nlet reconnectAttempts = 0;\nconst maxReconnectDelay = 30000; // 30 seconds\n\nsocket.on('disconnect', () => {\n  const delay = Math.min(1000 * Math.pow(2, reconnectAttempts), maxReconnectDelay);\n  reconnectAttempts++;\n  \n  setTimeout(() => {\n    socket.connect();\n  }, delay);\n});\n\nsocket.on('connect', () => {\n  reconnectAttempts = 0;\n  // Re-authenticate on reconnect\n  socket.emit('authenticate', { token: getToken() });\n});\n```\n\n### Offline Notifications\n\nWhen a user reconnects after being offline, the server automatically sends all unread notifications created while offline via the `notification:new` event.\n  ","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"documentation":{"type":"string"}}}}}}}}},"/api/v1/notifications/":{"get":{"summary":"Get user notifications with pagination, filtering, and field selection","tags":["notifications"],"description":"Get user notifications with pagination, filtering, and field selection","parameters":[{"schema":{"type":"number","default":50,"minimum":1,"maximum":500},"in":"query","name":"limit","required":false,"description":"Maximum number of results to return"},{"schema":{"type":"number","default":0,"minimum":0},"in":"query","name":"offset","required":false,"description":"Number of results to skip for pagination"},{"schema":{"type":"boolean"},"in":"query","name":"unreadOnly","required":false,"description":"Filter to only unread notifications"},{"schema":{"type":"string"},"in":"query","name":"type","required":false,"description":"Filter by notification type"},{"schema":{"type":"string"},"in":"query","name":"fields","required":false,"description":"Comma-separated list of fields to return"},{"schema":{"type":"string"},"in":"query","name":"sort","required":false,"description":"Sort by field(s), prefix with - for descending"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","required":["notifications"],"properties":{"notifications":{"type":"array","items":{"type":"object","required":["id","userId","type","title","message","read","createdAt"],"properties":{"id":{"type":"string","description":"Notification ID"},"userId":{"type":"string","description":"User Discord ID"},"type":{"type":"string","description":"Notification type"},"title":{"type":"string","description":"Notification title"},"message":{"type":"string","description":"Notification message"},"data":{"type":"object","description":"Additional data payload","additionalProperties":true},"read":{"type":"boolean","description":"Read status"},"readAt":{"type":"string","format":"date-time","description":"Read timestamp"},"channel":{"type":"string","description":"Delivery channel"},"sentToDiscord":{"type":"boolean","description":"Discord delivery status"},"discordMessageId":{"type":"string","description":"Discord message ID"},"discordError":{"type":"string","description":"Discord delivery error"},"createdAt":{"type":"string","format":"date-time","description":"Creation timestamp"},"_links":{"type":"object","description":"HATEOAS links","additionalProperties":{"type":"object","required":["href"],"properties":{"href":{"type":"string","description":"Link URL"},"method":{"type":"string","description":"HTTP method for the link"}},"additionalProperties":true}}}}}}},"meta":{"type":"object","required":["timestamp","pagination"],"properties":{"timestamp":{"type":"number"},"pagination":{"type":"object","required":["total","limit","offset","hasMore"],"properties":{"total":{"type":"number"},"limit":{"type":"number"},"offset":{"type":"number"},"hasMore":{"type":"boolean"}}}}},"_links":{"type":"object","description":"HATEOAS pagination links","properties":{"self":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"first":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"prev":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"next":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"last":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}},"patch":{"summary":"Mark all notifications as read","tags":["notifications"],"description":"Mark all notifications as read","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["read","unread"],"description":"Status to apply to all"}}}}}},"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"message":{"type":"string","description":"Success message"},"count":{"type":"number","description":"Number of notifications marked as read"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/notifications/unread":{"get":{"summary":"Get unread notification count","tags":["notifications"],"description":"Get unread notification count","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","required":["count"],"properties":{"count":{"type":"number","description":"Number of unread notifications","minimum":0}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/notifications/{id}":{"patch":{"summary":"Update notification status","tags":["notifications"],"description":"Update notification status","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["read","unread"],"description":"Notification status"}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true,"description":"Notification ID"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"message":{"type":"string","description":"Success message"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"404":{"description":"Notification not found","content":{"application/json":{"schema":{"description":"Notification not found"}}}},"500":{"description":"Failed to update notification status","content":{"application/json":{"schema":{"description":"Failed to update notification status"}}}}}}},"/api/v1/notifications/preferences":{"get":{"summary":"Get notification preferences","tags":["notifications"],"description":"Get notification preferences","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"loanUpdates":{"type":"object","properties":{"web":{"type":"boolean"},"discord":{"type":"boolean"},"push":{"type":"boolean"}},"description":"Loan update notification channel preferences"},"invoiceUpdates":{"type":"object","properties":{"web":{"type":"boolean"},"discord":{"type":"boolean"},"push":{"type":"boolean"}},"description":"Invoice update notification channel preferences"},"paymentUpdates":{"type":"object","properties":{"web":{"type":"boolean"},"discord":{"type":"boolean"},"push":{"type":"boolean"}},"description":"Payment update notification channel preferences"},"systemMessages":{"type":"object","properties":{"web":{"type":"boolean"},"discord":{"type":"boolean"},"push":{"type":"boolean"}},"description":"System message notification channel preferences"},"realtyUpdates":{"type":"object","properties":{"web":{"type":"boolean"},"discord":{"type":"boolean"},"push":{"type":"boolean"}},"description":"Realty update notification channel preferences"},"enableWebNotifications":{"type":"boolean","description":"Web notifications enabled"},"enableDiscordNotifications":{"type":"boolean","description":"Discord notifications enabled"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}},"put":{"summary":"Update notification preferences","tags":["notifications"],"description":"Update notification preferences","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"loanUpdates":{"type":"object","properties":{"web":{"type":"boolean"},"discord":{"type":"boolean"},"push":{"type":"boolean"}},"description":"Loan update channel preferences"},"invoiceUpdates":{"type":"object","properties":{"web":{"type":"boolean"},"discord":{"type":"boolean"},"push":{"type":"boolean"}},"description":"Invoice update channel preferences"},"paymentUpdates":{"type":"object","properties":{"web":{"type":"boolean"},"discord":{"type":"boolean"},"push":{"type":"boolean"}},"description":"Payment update channel preferences"},"systemMessages":{"type":"object","properties":{"web":{"type":"boolean"},"discord":{"type":"boolean"},"push":{"type":"boolean"}},"description":"System message channel preferences"},"realtyUpdates":{"type":"object","properties":{"web":{"type":"boolean"},"discord":{"type":"boolean"},"push":{"type":"boolean"}},"description":"Realty update channel preferences"},"enableWebNotifications":{"type":"boolean","description":"Enable web notifications"},"enableDiscordNotifications":{"type":"boolean","description":"Enable Discord notifications"}}}}}},"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"message":{"type":"string","description":"Success message"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/logs/client-error":{"post":{"summary":"Ingest a dashboard client-side error log","tags":["client-logs"],"description":"Ingest a dashboard client-side error log","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["message","timestamp"],"properties":{"message":{"type":"string","minLength":1,"maxLength":1000},"stack":{"type":"string","maxLength":10000},"componentStack":{"type":"string","maxLength":10000},"url":{"type":"string","maxLength":2048},"userAgent":{"type":"string","maxLength":1000},"timestamp":{"type":"number"}},"additionalProperties":false}}}},"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","required":["accepted"],"properties":{"accepted":{"type":"boolean"}},"additionalProperties":false},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/logs/client-info":{"post":{"summary":"Ingest a dashboard client-side informational log","tags":["client-logs"],"description":"Ingest a dashboard client-side informational log","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["message","timestamp"],"properties":{"message":{"type":"string","minLength":1,"maxLength":1000},"data":{"anyOf":[{"type":"object","additionalProperties":true},{"type":"array","items":true},{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"}]},"timestamp":{"type":"number"}},"additionalProperties":false}}}},"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","required":["accepted"],"properties":{"accepted":{"type":"boolean"}},"additionalProperties":false},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/push/tokens":{"post":{"tags":["push-notifications"],"description":"Register a device token for push notifications","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["token","platform"],"properties":{"token":{"type":"string","description":"Device push token from APNs or FCM","minLength":32},"platform":{"type":"string","enum":["ios","android"],"description":"Device platform"}}}}}},"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"userId":{"type":"string"},"token":{"type":"string"},"platform":{"type":"string","enum":["ios","android"]},"createdAt":{"type":"string","format":"date-time"},"lastUsed":{"type":"string","format":"date-time"}}},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}},"delete":{"tags":["push-notifications"],"description":"Remove a device token","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["token"],"properties":{"token":{"type":"string","description":"Device push token to remove"}}}}}},"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"message":{"type":"string"}}},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}},"get":{"tags":["push-notifications"],"description":"Get all device tokens for the current user","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"tokens":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"userId":{"type":"string"},"token":{"type":"string"},"platform":{"type":"string","enum":["ios","android"]},"createdAt":{"type":"string","format":"date-time"},"lastUsed":{"type":"string","format":"date-time"}}}},"count":{"type":"number"}}},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/push/tokens/all":{"delete":{"tags":["push-notifications"],"description":"Remove all device tokens for the current user","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"message":{"type":"string"}}},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/users/{userId}/garage/vehicles":{"get":{"summary":"Get vehicles stored in user garage","tags":["garage"],"description":"Get vehicles stored in user garage","parameters":[{"schema":{"type":"number","default":50,"minimum":1,"maximum":500},"in":"query","name":"limit","required":false,"description":"Maximum number of results to return"},{"schema":{"type":"number","default":0,"minimum":0},"in":"query","name":"offset","required":false,"description":"Number of results to skip for pagination"},{"schema":{"type":"string"},"in":"query","name":"fields","required":false,"description":"Comma-separated list of fields to return"},{"schema":{"type":"string"},"in":"query","name":"sort","required":false,"description":"Sort by field(s), prefix with - for descending"},{"schema":{"type":"string"},"in":"path","name":"userId","required":true,"description":"Discord user ID (use \"me\" for current user)"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","required":["vehicles"],"properties":{"vehicles":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"ownerId":{"type":"string"},"vehicleId":{"type":"string"},"filename":{"type":"string"},"vehicle":{"type":"string"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"_links":{"type":"object","additionalProperties":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}}}}}}}},"meta":{"type":"object","required":["timestamp","pagination"],"properties":{"timestamp":{"type":"number"},"pagination":{"type":"object","required":["total","limit","offset","hasMore"],"properties":{"total":{"type":"number"},"limit":{"type":"number"},"offset":{"type":"number"},"hasMore":{"type":"boolean"}}}}},"_links":{"type":"object","description":"HATEOAS pagination links","properties":{"self":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"first":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"prev":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"next":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"last":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}},"post":{"summary":"Store a vehicle in garage","tags":["garage"],"description":"Store a vehicle in garage","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["serverId","vehicleId"],"properties":{"serverId":{"type":"number","description":"Server ID"},"vehicleId":{"type":"string","description":"Vehicle ID (e.g., ABCD1234)"}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"userId","required":true,"description":"Discord user ID (use \"me\" for current user)"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"id":{"type":"string"},"vehicleId":{"type":"string"},"filename":{"type":"string"},"createdAt":{"type":"string"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/users/{userId}/garage/vehicles/{vehicleId}":{"delete":{"summary":"Remove a vehicle from garage (retrieve to server)","tags":["garage"],"description":"Remove a vehicle from garage (retrieve to server)","parameters":[{"schema":{"type":"number"},"in":"query","name":"serverId","required":true,"description":"Server ID to retrieve vehicle to"},{"schema":{"type":"string"},"in":"path","name":"userId","required":true,"description":"Discord user ID (use \"me\" for current user)"},{"schema":{"type":"string"},"in":"path","name":"vehicleId","required":true,"description":"Vehicle ID (e.g., ABCD1234)"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"message":{"type":"string"},"vehicleId":{"type":"string"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/servers/{serverId}/vehicles/{vehicleId}/reset":{"post":{"summary":"Reset vehicle on server","tags":["vehicles"],"description":"Reset vehicle on server","parameters":[{"schema":{"type":"number"},"in":"path","name":"serverId","required":true},{"schema":{"type":"string"},"in":"path","name":"vehicleId","required":true}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"message":{"type":"string"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"404":{"description":"Vehicle not found","content":{"application/json":{"schema":{"description":"Vehicle not found"}}}},"422":{"description":"Vehicle reset could not be completed","content":{"application/json":{"schema":{"description":"Vehicle reset could not be completed"}}}},"500":{"description":"Unexpected vehicle reset failure","content":{"application/json":{"schema":{"description":"Unexpected vehicle reset failure"}}}}}}},"/api/v1/servers/{serverId}/vehicles/{vehicleId}/recover":{"post":{"summary":"Recover a previously removed vehicle","tags":["vehicles"],"description":"Recover a previously removed vehicle","parameters":[{"schema":{"type":"number"},"in":"path","name":"serverId","required":true},{"schema":{"type":"string"},"in":"path","name":"vehicleId","required":true}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"message":{"type":"string"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"404":{"description":"Vehicle not found in cache","content":{"application/json":{"schema":{"description":"Vehicle not found in cache"}}}},"422":{"description":"User farm state does not allow recovery","content":{"application/json":{"schema":{"description":"User farm state does not allow recovery"}}}},"500":{"description":"Unexpected vehicle recovery failure","content":{"application/json":{"schema":{"description":"Unexpected vehicle recovery failure"}}}}}}},"/api/v1/servers/{serverId}/vehicles/{vehicleId}/transfers":{"post":{"summary":"Transfer vehicle to another user/server","tags":["vehicles"],"description":"Transfer vehicle to another user/server","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["toUserId","toServerId"],"properties":{"toUserId":{"type":"string","description":"Discord ID of recipient"},"toServerId":{"type":"number"},"memo":{"type":"string","description":"Transfer memo"},"fromUserId":{"type":"string","description":"Source user ID (Admin only)"}}}}}},"parameters":[{"schema":{"type":"number"},"in":"path","name":"serverId","required":true},{"schema":{"type":"string"},"in":"path","name":"vehicleId","required":true}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"message":{"type":"string"},"feeCharged":{"type":"boolean"},"transferFee":{"type":"number"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Invalid transfer request","content":{"application/json":{"schema":{"description":"Invalid transfer request"}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"404":{"description":"Vehicle not found","content":{"application/json":{"schema":{"description":"Vehicle not found"}}}},"422":{"description":"Vehicle transfer business rule failed","content":{"application/json":{"schema":{"description":"Vehicle transfer business rule failed"}}}},"500":{"description":"Unexpected vehicle transfer failure","content":{"application/json":{"schema":{"description":"Unexpected vehicle transfer failure"}}}}}}},"/api/v1/servers/{serverId}/vehicles/transfers":{"get":{"summary":"Get vehicle transfer history for a server","tags":["vehicles"],"description":"Get vehicle transfer history for a server","parameters":[{"schema":{"type":"number","default":50,"minimum":1,"maximum":500},"in":"query","name":"limit","required":false,"description":"Maximum number of results to return"},{"schema":{"type":"number","default":0,"minimum":0},"in":"query","name":"offset","required":false,"description":"Number of results to skip for pagination"},{"schema":{"type":"number"},"in":"path","name":"serverId","required":true}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","required":["transfers"],"properties":{"transfers":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"vehicleId":{"type":"string"},"fromUserId":{"type":"string"},"toUserId":{"type":"string","nullable":true},"fromServerId":{"type":"number"},"toServerId":{"type":"number","nullable":true},"transferFee":{"type":"number"},"transferredAt":{"type":"string"},"fromUser":{"type":"object","properties":{"username":{"type":"string","nullable":true}}},"toUser":{"type":"object","properties":{"username":{"type":"string","nullable":true}},"nullable":true},"_links":{"type":"object","additionalProperties":true}}}}}},"meta":{"type":"object","required":["timestamp","pagination"],"properties":{"timestamp":{"type":"number"},"pagination":{"type":"object","required":["total","limit","offset","hasMore"],"properties":{"total":{"type":"number"},"limit":{"type":"number"},"offset":{"type":"number"},"hasMore":{"type":"boolean"}}}}},"_links":{"type":"object","description":"HATEOAS pagination links","properties":{"self":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"first":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"prev":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"next":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"last":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/users/{userId}/vehicles/transfers":{"get":{"summary":"Get vehicle transfer history for a user","tags":["vehicles"],"description":"Get vehicle transfer history for a user","parameters":[{"schema":{"type":"number","default":50,"minimum":1,"maximum":500},"in":"query","name":"limit","required":false,"description":"Maximum number of results to return"},{"schema":{"type":"number","default":0,"minimum":0},"in":"query","name":"offset","required":false,"description":"Number of results to skip for pagination"},{"schema":{"type":"string"},"in":"path","name":"userId","required":true}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","required":["transfers"],"properties":{"transfers":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"vehicleId":{"type":"string"},"fromUserId":{"type":"string"},"toUserId":{"type":"string","nullable":true},"fromServerId":{"type":"number"},"toServerId":{"type":"number","nullable":true},"transferFee":{"type":"number"},"transferredAt":{"type":"string"},"fromUser":{"type":"object","properties":{"username":{"type":"string","nullable":true}}},"toUser":{"type":"object","properties":{"username":{"type":"string","nullable":true}},"nullable":true},"_links":{"type":"object","additionalProperties":true}}}}}},"meta":{"type":"object","required":["timestamp","pagination"],"properties":{"timestamp":{"type":"number"},"pagination":{"type":"object","required":["total","limit","offset","hasMore"],"properties":{"total":{"type":"number"},"limit":{"type":"number"},"offset":{"type":"number"},"hasMore":{"type":"boolean"}}}}},"_links":{"type":"object","description":"HATEOAS pagination links","properties":{"self":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"first":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"prev":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"next":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"last":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/vehicles/transfers":{"get":{"summary":"Get global vehicle transfer history","tags":["vehicles"],"description":"Get global vehicle transfer history","parameters":[{"schema":{"type":"number","default":50,"minimum":1,"maximum":500},"in":"query","name":"limit","required":false,"description":"Maximum number of results to return"},{"schema":{"type":"number","default":0,"minimum":0},"in":"query","name":"offset","required":false,"description":"Number of results to skip for pagination"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","required":["transfers"],"properties":{"transfers":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"vehicleId":{"type":"string"},"fromUserId":{"type":"string"},"toUserId":{"type":"string","nullable":true},"fromServerId":{"type":"number"},"toServerId":{"type":"number","nullable":true},"transferFee":{"type":"number"},"transferredAt":{"type":"string"},"fromUser":{"type":"object","properties":{"username":{"type":"string","nullable":true}}},"toUser":{"type":"object","properties":{"username":{"type":"string","nullable":true}},"nullable":true},"_links":{"type":"object","additionalProperties":true}}}}}},"meta":{"type":"object","required":["timestamp","pagination"],"properties":{"timestamp":{"type":"number"},"pagination":{"type":"object","required":["total","limit","offset","hasMore"],"properties":{"total":{"type":"number"},"limit":{"type":"number"},"offset":{"type":"number"},"hasMore":{"type":"boolean"}}}}},"_links":{"type":"object","description":"HATEOAS pagination links","properties":{"self":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"first":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"prev":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"next":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"last":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/community/time-entries":{"post":{"summary":"Create a new time entry (clock in)","tags":["community"],"description":"Create a new time entry (clock in)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["serverId","clockIn"],"properties":{"serverId":{"type":"number","description":"Server ID"},"clockIn":{"type":"string","format":"date-time","description":"Clock in timestamp (ISO 8601)"}}}}}},"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"id":{"type":"string","description":"UUID of the timesheet entry"},"date":{"type":"string"},"startTime":{"type":"string"},"endTime":{"type":"string","nullable":true},"serverId":{"type":"number"},"serverName":{"type":"string"},"rate":{"type":"number"},"durationHours":{"type":"number","nullable":true,"description":"Total hours (active + idle)"},"activeHours":{"type":"number","nullable":true,"description":"Active hours (paid time)"},"idleHours":{"type":"number","nullable":true,"description":"Idle hours (unpaid time)"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"404":{"description":"Server not found","content":{"application/json":{"schema":{"description":"Server not found"}}}},"422":{"description":"Already clocked in to another server","content":{"application/json":{"schema":{"description":"Already clocked in to another server"}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}},"get":{"summary":"Get user time entries","tags":["community"],"description":"Get user time entries","parameters":[{"schema":{"type":"number","minimum":1,"maximum":365,"default":7},"in":"query","name":"days","required":false,"description":"Number of days to retrieve"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"UUID of the timesheet entry"},"date":{"type":"string"},"startTime":{"type":"string"},"endTime":{"type":"string","nullable":true},"serverId":{"type":"number"},"serverName":{"type":"string"},"rate":{"type":"number"},"durationHours":{"type":"number","nullable":true,"description":"Total hours (active + idle)"},"activeHours":{"type":"number","nullable":true,"description":"Active hours (paid time)"},"idleHours":{"type":"number","nullable":true,"description":"Idle hours (unpaid time)"}}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/community/time-entries/record":{"post":{"summary":"Update timesheet entry with current active/idle time from game server","tags":["community"],"description":"Update timesheet entry with current active/idle time from game server","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["userId","serverId","date","activeTime","idleTime"],"properties":{"userId":{"type":"string","description":"Discord user ID"},"serverId":{"type":"number","description":"Server ID"},"date":{"type":"string","format":"date","description":"Date (YYYY-MM-DD)"},"activeTime":{"type":"number","description":"Active time in seconds"},"idleTime":{"type":"number","description":"Idle time in seconds"}}}}}},"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"message":{"type":"string"},"updated":{"type":"number"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/community/time-entries/{id}":{"patch":{"summary":"Update time entry with clock out time","tags":["community"],"description":"Update time entry with clock out time","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["clockOut"],"properties":{"clockOut":{"type":"string","format":"date-time","description":"Clock out timestamp (ISO 8601)"}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true,"description":"Time entry ID"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"id":{"type":"string","description":"UUID of the timesheet entry"},"date":{"type":"string"},"startTime":{"type":"string"},"endTime":{"type":"string","nullable":true},"serverId":{"type":"number"},"serverName":{"type":"string"},"rate":{"type":"number"},"durationHours":{"type":"number","nullable":true,"description":"Total hours (active + idle)"},"activeHours":{"type":"number","nullable":true,"description":"Active hours (paid time)"},"idleHours":{"type":"number","nullable":true,"description":"Idle hours (unpaid time)"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"422":{"description":"No active time entry to clock out","content":{"application/json":{"schema":{"description":"No active time entry to clock out"}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/community/rates":{"get":{"summary":"Get community work rates","tags":["community"],"description":"Get community work rates","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"currentRate":{"type":"number"},"minRate":{"type":"number"},"maxRate":{"type":"number"},"openPlayerContractCount":{"type":"number"},"countedContractPaymentFloor":{"type":"number"},"lockPolicy":{"type":"string"},"encouragementNote":{"type":"string"},"rateTable":{"type":"array","items":{"type":"object","properties":{"minOpenPlayerContracts":{"type":"number"},"maxOpenPlayerContracts":{"type":"number","nullable":true},"rate":{"type":"number"}}}},"rates":{"type":"array","items":{"type":"object","properties":{"serverId":{"type":"number"},"name":{"type":"string"},"description":{"type":"string"},"rate":{"type":"number"}}}}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/community/hours":{"get":{"summary":"Get your community work hours summary","tags":["community"],"description":"Get your community work hours summary","parameters":[{"schema":{"type":"number","minimum":1,"maximum":365,"default":30},"in":"query","name":"days","required":false,"description":"Number of days to calculate hours for"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"totalHours":{"type":"number","description":"Total active hours worked"},"payableHours":{"type":"number","description":"Payable hours (capped at 8 hours per day)"},"totalEarnings":{"type":"number","description":"Total earnings from community work (based on payable hours)"},"shiftCount":{"type":"number","description":"Number of completed shifts"},"periodDays":{"type":"number","description":"Number of days in the period"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/community/hours/{userId}":{"get":{"summary":"[ADMIN] Get community work hours summary for a specific user","tags":["community"],"description":"[ADMIN] Get community work hours summary for a specific user","parameters":[{"schema":{"type":"number","minimum":1,"maximum":365,"default":30},"in":"query","name":"days","required":false,"description":"Number of days to calculate hours for"},{"schema":{"type":"string"},"in":"path","name":"userId","required":true,"description":"Discord user ID"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"totalHours":{"type":"number","description":"Total active hours worked"},"payableHours":{"type":"number","description":"Payable hours (capped at 8 hours per day)"},"totalEarnings":{"type":"number","description":"Total earnings from community work (based on payable hours)"},"shiftCount":{"type":"number","description":"Number of completed shifts"},"periodDays":{"type":"number","description":"Number of days in the period"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/servers/{serverId}/buildings/{buildingId}/crops":{"get":{"summary":"List crops in a building","tags":["crops"],"description":"List crops in a building","parameters":[{"schema":{"type":"string"},"in":"path","name":"serverId","required":true,"description":"Server ID"},{"schema":{"type":"string"},"in":"path","name":"buildingId","required":true,"description":"Building ID"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"crops":{"type":"array","description":"List of crops in building","items":{"type":"object","properties":{"crop":{"type":"string","description":"Crop type"},"amount":{"type":"number","description":"Crop amount"}}}},"buildingId":{"type":"string","description":"Building ID"},"serverId":{"type":"number","description":"Server ID"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/servers/{serverId}/buildings/{buildingId}/crops/{cropId}":{"get":{"summary":"Get details of a specific crop in a building","tags":["crops"],"description":"Get details of a specific crop in a building","parameters":[{"schema":{"type":"string"},"in":"path","name":"serverId","required":true,"description":"Server ID"},{"schema":{"type":"string"},"in":"path","name":"buildingId","required":true,"description":"Building ID"},{"schema":{"type":"string"},"in":"path","name":"cropId","required":true,"description":"Crop Type (ID)"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"crop":{"type":"string","description":"Crop type"},"amount":{"type":"number","description":"Crop amount"},"buildingId":{"type":"string","description":"Building ID"},"serverId":{"type":"number","description":"Server ID"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/servers/{serverId}/buildings/{buildingId}/crops/{cropId}/transfers":{"post":{"summary":"Transfer crops to another building/user","tags":["crops"],"description":"Transfer crops to another building/user","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["toUserId","toServerId","toBuildingId","amount"],"properties":{"toUserId":{"type":"string","description":"Destination user Discord ID"},"toServerId":{"type":"number","description":"Destination server ID"},"toBuildingId":{"type":"string","description":"Destination building ID"},"amount":{"type":"number","minimum":1,"description":"Amount to transfer"},"memo":{"type":"string","description":"Transfer memo"}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"serverId","required":true,"description":"Source Server ID"},{"schema":{"type":"string"},"in":"path","name":"buildingId","required":true,"description":"Source Building ID"},{"schema":{"type":"string"},"in":"path","name":"cropId","required":true,"description":"Crop Type"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"success":{"type":"boolean","description":"Transfer operation success flag"},"message":{"type":"string","description":"Success message"},"transferCost":{"type":"number","description":"Transfer cost"},"costBreakdown":{"type":"object","nullable":true,"properties":{"totalCost":{"type":"number","description":"Total transfer cost"},"totalKg":{"type":"number","description":"Total crop weight in kilograms"},"tierRate":{"type":"number","description":"Base rate for the crop tier"},"tierName":{"type":"string","description":"Crop pricing tier name"},"breakdown":{"type":"array","description":"Per-volume-tier cost breakdown","items":{"type":"object","properties":{"tierLabel":{"type":"string","description":"Volume discount tier label"},"kg":{"type":"number","description":"Kilograms charged in this tier"},"rate":{"type":"number","description":"Base per-kg transfer rate"},"multiplier":{"type":"number","description":"Tier discount multiplier"},"cost":{"type":"number","description":"Calculated cost for this tier"}}}}}}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/crops/cost":{"get":{"summary":"Calculate crop transfer cost","tags":["crops"],"description":"Calculate crop transfer cost","parameters":[{"schema":{"type":"string"},"in":"query","name":"crop","required":true,"description":"Crop type"},{"schema":{"type":"number","minimum":1},"in":"query","name":"amount","required":true,"description":"Amount to transfer"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"crop":{"type":"string","description":"Crop type"},"amount":{"type":"number","description":"Transfer amount"},"totalCost":{"type":"number","description":"Total cost"},"totalKg":{"type":"number","description":"Total transfer weight in kilograms"},"tierRate":{"type":"number","description":"Tier rate"},"tierName":{"type":"string","description":"Tier name"},"breakdown":{"type":"array","description":"Per-volume-tier cost breakdown","items":{"type":"object","properties":{"tierLabel":{"type":"string","description":"Volume discount tier label"},"kg":{"type":"number","description":"Kilograms charged in this tier"},"rate":{"type":"number","description":"Base per-kg transfer rate"},"multiplier":{"type":"number","description":"Tier discount multiplier"},"cost":{"type":"number","description":"Calculated cost for this tier"}}}}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/tokens/":{"post":{"summary":"Create a new API token","tags":["tokens"],"description":"Create a new API token","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["name"],"properties":{"name":{"type":"string","minLength":1,"maxLength":100,"description":"Token name"},"tokenType":{"type":"string","enum":["USER_API_TOKEN","BOT_TOKEN","SERVICE_TOKEN","WEBHOOK_TOKEN"],"description":"Type of token to create"},"scopes":{"type":"array","items":{"type":"string"},"description":"Token scopes/permissions"},"allowedIps":{"type":"array","items":{"type":"string"},"description":"IP whitelist for token"},"rateLimit":{"type":"integer","minimum":1,"description":"Rate limit per minute"},"expiresInDays":{"type":"integer","minimum":1,"maximum":365,"description":"Token expiration in days"}}}}}},"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"token":{"type":"string","description":"Full token (only shown once)"},"tokenId":{"type":"string","description":"Token ID"},"tokenPrefix":{"type":"string","description":"Token prefix"},"warning":{"type":"string","description":"Security warning"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}},"get":{"summary":"Get all API tokens for authenticated user","tags":["tokens"],"description":"Get all API tokens for authenticated user","parameters":[{"schema":{"type":"number","default":50,"minimum":1,"maximum":500},"in":"query","name":"limit","required":false,"description":"Maximum number of results to return"},{"schema":{"type":"number","default":0,"minimum":0},"in":"query","name":"offset","required":false,"description":"Number of results to skip for pagination"},{"schema":{"type":"string"},"in":"query","name":"includeRevoked","required":false,"description":"Include revoked tokens (true/false)"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","required":["tokens"],"properties":{"tokens":{"type":"array","items":{"type":"object","properties":{"tokenId":{"type":"string","description":"Token ID"},"tokenPrefix":{"type":"string","description":"Token prefix (first 8 chars)"},"name":{"type":"string","description":"Token name"},"tokenType":{"type":"string","enum":["USER_API_TOKEN","BOT_TOKEN","SERVICE_TOKEN","WEBHOOK_TOKEN"],"description":"Token type"},"scopes":{"type":"array","items":{"type":"string"},"description":"Token scopes"},"isRevoked":{"type":"boolean","description":"Revocation status"},"createdAt":{"type":"string","format":"date-time","description":"Creation timestamp"},"expiresAt":{"type":"string","format":"date-time","nullable":true,"description":"Expiration timestamp"}}}}}},"meta":{"type":"object","required":["timestamp","pagination"],"properties":{"timestamp":{"type":"number"},"pagination":{"type":"object","required":["total","limit","offset","hasMore"],"properties":{"total":{"type":"number"},"limit":{"type":"number"},"offset":{"type":"number"},"hasMore":{"type":"boolean"}}}}},"_links":{"type":"object","description":"HATEOAS pagination links","properties":{"self":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"first":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"prev":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"next":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"last":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/tokens/{tokenId}":{"get":{"summary":"Get details for a specific API token","tags":["tokens"],"description":"Get details for a specific API token","parameters":[{"schema":{"type":"string"},"in":"path","name":"tokenId","required":true,"description":"API Token ID (UUID)"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"tokenId":{"type":"string","description":"Token ID"},"tokenPrefix":{"type":"string","description":"Token prefix (first 8 chars)"},"name":{"type":"string","description":"Token name"},"tokenType":{"type":"string","enum":["USER_API_TOKEN","BOT_TOKEN","SERVICE_TOKEN","WEBHOOK_TOKEN"],"description":"Token type"},"scopes":{"type":"array","items":{"type":"string"},"description":"Token scopes"},"isRevoked":{"type":"boolean","description":"Revocation status"},"createdAt":{"type":"string","format":"date-time","description":"Creation timestamp"},"expiresAt":{"type":"string","format":"date-time","nullable":true,"description":"Expiration timestamp"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}},"delete":{"summary":"Revoke an API token","tags":["tokens"],"description":"Revoke an API token","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string","description":"Reason for revocation"}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"tokenId","required":true,"description":"API Token ID (UUID)"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"message":{"type":"string"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/tokens/{tokenId}/stats":{"get":{"summary":"Get usage statistics for an API token","tags":["tokens"],"description":"Get usage statistics for an API token","parameters":[{"schema":{"type":"string"},"in":"path","name":"tokenId","required":true,"description":"API Token ID (UUID)"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"totalRequests":{"type":"number","description":"Total API requests made with this token"},"lastUsed":{"type":"string","format":"date-time","nullable":true,"description":"Last usage timestamp"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/login-history":{"post":{"summary":"Log player join/leave event","tags":["login-history"],"description":"Log player join/leave event","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["serverId","discordId","type","timestamp"],"properties":{"serverId":{"type":"number","description":"Server ID"},"discordId":{"type":"string","description":"Discord user ID"},"type":{"type":"string","enum":["join","leave","auto-logout"],"description":"Event type"},"timestamp":{"type":"number","description":"Event timestamp (ms)"},"activeTime":{"type":"number","description":"Active time in seconds (for leave events)"},"idleTime":{"type":"number","description":"Idle time in seconds (for leave events)"}}}}}},"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"id":{"type":"string","description":"Login history UUID"},"message":{"type":"string"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}},"get":{"summary":"Get login history","tags":["login-history"],"description":"Get login history","parameters":[{"schema":{"type":"number","default":50,"minimum":1,"maximum":500},"in":"query","name":"limit","required":false,"description":"Maximum number of results to return"},{"schema":{"type":"number","default":0,"minimum":0},"in":"query","name":"offset","required":false,"description":"Number of results to skip for pagination"},{"schema":{"type":"number"},"in":"query","name":"serverId","required":false,"description":"Filter by server ID"},{"schema":{"type":"string"},"in":"query","name":"userId","required":false,"description":"Filter by user Discord ID"},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"startDate","required":false,"description":"Start date filter"},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"endDate","required":false,"description":"End date filter"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","required":["items"],"properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Login history UUID"},"serverId":{"type":"number"},"playerId":{"type":"string"},"type":{"type":"string"},"timestamp":{"type":"string"},"activeTime":{"type":"number","nullable":true},"idleTime":{"type":"number","nullable":true}}}}}},"meta":{"type":"object","required":["timestamp","pagination"],"properties":{"timestamp":{"type":"number"},"pagination":{"type":"object","required":["total","limit","offset","hasMore"],"properties":{"total":{"type":"number"},"limit":{"type":"number"},"offset":{"type":"number"},"hasMore":{"type":"boolean"}}}}},"_links":{"type":"object","description":"HATEOAS pagination links","properties":{"self":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"first":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"prev":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"next":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}},"last":{"type":"object","required":["href","rel"],"properties":{"href":{"type":"string"},"rel":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"type":{"type":"string"}}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/applications/":{"post":{"summary":"Submit a new whitelist application","tags":["applications"],"description":"Submit a new whitelist application","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["nickname","farmName","whyJoin","fsHistory","idealCommunity","communityExperience","extremeSeverityAnswer","balanceCommandAnswer","farmWaitTimeAnswer","terraformingAnswer","pmStaffAnswer","referralSource"],"properties":{"nickname":{"type":"string","minLength":1,"maxLength":32},"farmName":{"type":"string","minLength":1,"maxLength":32},"whyJoin":{"type":"string","minLength":200,"maxLength":10000},"fsHistory":{"type":"string","minLength":200,"maxLength":10000},"idealCommunity":{"type":"string","minLength":200,"maxLength":10000},"communityExperience":{"type":"string","minLength":200,"maxLength":10000},"extremeSeverityAnswer":{"type":"string","minLength":10,"maxLength":500},"balanceCommandAnswer":{"type":"string","minLength":5,"maxLength":500},"farmWaitTimeAnswer":{"type":"string","minLength":5,"maxLength":500},"terraformingAnswer":{"type":"string","minLength":10,"maxLength":500},"pmStaffAnswer":{"type":"string","minLength":10,"maxLength":500},"referralSource":{"type":"string","minLength":5,"maxLength":1000}}}}}},"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"application":{"type":"object","properties":{"id":{"type":"string"},"discordId":{"type":"string"},"discordUsername":{"type":"string"},"hasJoinedDiscord":{"type":"boolean"},"nickname":{"type":"string","nullable":true},"farmName":{"type":"string","nullable":true},"whyJoin":{"type":"string"},"fsHistory":{"type":"string"},"idealCommunity":{"type":"string"},"communityExperience":{"type":"string"},"extremeSeverityAnswer":{"type":"string"},"balanceCommandAnswer":{"type":"string"},"farmWaitTimeAnswer":{"type":"string"},"terraformingAnswer":{"type":"string"},"pmStaffAnswer":{"type":"string"},"referralSource":{"type":"string"},"status":{"type":"string"},"reviewedBy":{"type":"string","nullable":true},"reviewedAt":{"type":"string","nullable":true},"reviewNotes":{"type":"string","nullable":true},"ipAddress":{"type":"string","nullable":true},"userAgent":{"type":"string","nullable":true},"submittedAt":{"type":"string"},"updatedAt":{"type":"string"}}}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Error code"},"message":{"type":"string","description":"Human-readable error message"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number","description":"Unix timestamp of response"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Error code"},"message":{"type":"string","description":"Human-readable error message"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number","description":"Unix timestamp of response"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Error code"},"message":{"type":"string","description":"Human-readable error message"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number","description":"Unix timestamp of response"}}}}}}}}}},"get":{"tags":["applications"],"description":"List all applications (gatekeeper only)","parameters":[{"schema":{"type":"string","enum":["PENDING","APPROVED","DENIED","WITHDRAWN"]},"in":"query","name":"status","required":false},{"schema":{"type":"number","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"number","minimum":0,"default":0},"in":"query","name":"offset","required":false}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","required":["applications"],"properties":{"applications":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"discordId":{"type":"string"},"discordUsername":{"type":"string"},"hasJoinedDiscord":{"type":"boolean"},"nickname":{"type":"string","nullable":true},"farmName":{"type":"string","nullable":true},"whyJoin":{"type":"string"},"fsHistory":{"type":"string"},"idealCommunity":{"type":"string"},"communityExperience":{"type":"string"},"extremeSeverityAnswer":{"type":"string"},"balanceCommandAnswer":{"type":"string"},"farmWaitTimeAnswer":{"type":"string"},"terraformingAnswer":{"type":"string"},"pmStaffAnswer":{"type":"string"},"referralSource":{"type":"string"},"status":{"type":"string"},"reviewedBy":{"type":"string","nullable":true},"reviewedAt":{"type":"string","nullable":true},"reviewNotes":{"type":"string","nullable":true},"ipAddress":{"type":"string","nullable":true},"userAgent":{"type":"string","nullable":true},"submittedAt":{"type":"string"},"updatedAt":{"type":"string"}}}}}},"meta":{"type":"object","required":["timestamp","pagination"],"properties":{"timestamp":{"type":"number"},"pagination":{"type":"object","properties":{"total":{"type":"number"},"limit":{"type":"number"},"offset":{"type":"number"},"hasMore":{"type":"boolean"}}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Error code"},"message":{"type":"string","description":"Human-readable error message"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number","description":"Unix timestamp of response"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Error code"},"message":{"type":"string","description":"Human-readable error message"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number","description":"Unix timestamp of response"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Error code"},"message":{"type":"string","description":"Human-readable error message"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number","description":"Unix timestamp of response"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Error code"},"message":{"type":"string","description":"Human-readable error message"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number","description":"Unix timestamp of response"}}}}}}}}}}},"/api/v1/applications/me":{"get":{"summary":"Get current user's application status","tags":["applications"],"description":"Get current user's application status","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","required":["application"],"properties":{"application":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"discordId":{"type":"string"},"discordUsername":{"type":"string"},"hasJoinedDiscord":{"type":"boolean"},"nickname":{"type":"string","nullable":true},"farmName":{"type":"string","nullable":true},"whyJoin":{"type":"string"},"fsHistory":{"type":"string"},"idealCommunity":{"type":"string"},"communityExperience":{"type":"string"},"extremeSeverityAnswer":{"type":"string"},"balanceCommandAnswer":{"type":"string"},"farmWaitTimeAnswer":{"type":"string"},"terraformingAnswer":{"type":"string"},"pmStaffAnswer":{"type":"string"},"referralSource":{"type":"string"},"status":{"type":"string"},"reviewedBy":{"type":"string","nullable":true},"reviewedAt":{"type":"string","nullable":true},"reviewNotes":{"type":"string","nullable":true},"ipAddress":{"type":"string","nullable":true},"userAgent":{"type":"string","nullable":true},"submittedAt":{"type":"string"},"updatedAt":{"type":"string"}}},{"type":"null"}]},"requiresReapplication":{"type":"boolean"},"banned":{"type":"boolean"},"reason":{"type":"string"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Error code"},"message":{"type":"string","description":"Human-readable error message"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number","description":"Unix timestamp of response"}}}}}}}}}}},"/api/v1/applications/{id}":{"get":{"summary":"Get a specific application (gatekeeper only)","tags":["applications"],"description":"Get a specific application (gatekeeper only)","parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","required":["application"],"properties":{"application":{"type":"object","properties":{"id":{"type":"string"},"discordId":{"type":"string"},"discordUsername":{"type":"string"},"hasJoinedDiscord":{"type":"boolean"},"nickname":{"type":"string","nullable":true},"farmName":{"type":"string","nullable":true},"whyJoin":{"type":"string"},"fsHistory":{"type":"string"},"idealCommunity":{"type":"string"},"communityExperience":{"type":"string"},"extremeSeverityAnswer":{"type":"string"},"balanceCommandAnswer":{"type":"string"},"farmWaitTimeAnswer":{"type":"string"},"terraformingAnswer":{"type":"string"},"pmStaffAnswer":{"type":"string"},"referralSource":{"type":"string"},"status":{"type":"string"},"reviewedBy":{"type":"string","nullable":true},"reviewedAt":{"type":"string","nullable":true},"reviewNotes":{"type":"string","nullable":true},"ipAddress":{"type":"string","nullable":true},"userAgent":{"type":"string","nullable":true},"submittedAt":{"type":"string"},"updatedAt":{"type":"string"}}}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Error code"},"message":{"type":"string","description":"Human-readable error message"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number","description":"Unix timestamp of response"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Error code"},"message":{"type":"string","description":"Human-readable error message"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number","description":"Unix timestamp of response"}}}}}}}}}}},"/api/v1/applications/{id}/review":{"post":{"summary":"Review an application (approve/deny) - gatekeeper only","tags":["applications"],"description":"Review an application (approve/deny) - gatekeeper only","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["status"],"properties":{"status":{"type":"string","enum":["APPROVED","DENIED"]},"reviewNotes":{"type":"string","maxLength":2000},"discordNickname":{"type":"string","maxLength":32}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","required":["application"],"properties":{"application":{"type":"object","properties":{"id":{"type":"string"},"discordId":{"type":"string"},"discordUsername":{"type":"string"},"hasJoinedDiscord":{"type":"boolean"},"nickname":{"type":"string","nullable":true},"farmName":{"type":"string","nullable":true},"whyJoin":{"type":"string"},"fsHistory":{"type":"string"},"idealCommunity":{"type":"string"},"communityExperience":{"type":"string"},"extremeSeverityAnswer":{"type":"string"},"balanceCommandAnswer":{"type":"string"},"farmWaitTimeAnswer":{"type":"string"},"terraformingAnswer":{"type":"string"},"pmStaffAnswer":{"type":"string"},"referralSource":{"type":"string"},"status":{"type":"string"},"reviewedBy":{"type":"string","nullable":true},"reviewedAt":{"type":"string","nullable":true},"reviewNotes":{"type":"string","nullable":true},"ipAddress":{"type":"string","nullable":true},"userAgent":{"type":"string","nullable":true},"submittedAt":{"type":"string"},"updatedAt":{"type":"string"}}}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Error code"},"message":{"type":"string","description":"Human-readable error message"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number","description":"Unix timestamp of response"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Error code"},"message":{"type":"string","description":"Human-readable error message"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number","description":"Unix timestamp of response"}}}}}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Error code"},"message":{"type":"string","description":"Human-readable error message"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number","description":"Unix timestamp of response"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Error code"},"message":{"type":"string","description":"Human-readable error message"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number","description":"Unix timestamp of response"}}}}}}}}}}},"/api/v1/stats/marketing":{"get":{"summary":"Get aggregated statistics for marketing/landing page (public endpoint)","tags":["stats","public"],"description":"Get aggregated statistics for marketing/landing page (public endpoint)","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"servers":{"type":"object","properties":{"total":{"type":"number"},"active":{"type":"number"},"globalPlayers":{"type":"number"},"onlinePlayers":{"type":"number"},"mapDistribution":{"type":"array","items":{"type":"object","properties":{"map":{"type":"string"},"count":{"type":"number"},"status":{"type":"string"}}}},"serverLoad":{"type":"array","items":{"type":"number"}},"serverList":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"name":{"type":"string"},"players":{"type":"number"},"slots":{"type":"number"},"status":{"type":"string"}}}}}},"economy":{"type":"object","properties":{"totalValue":{"type":"number"},"topFarmBalance":{"type":"number"}}},"assets":{"type":"object","properties":{"totalVehicles":{"type":"number"},"totalAcreage":{"type":"number"}}},"activity":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string"},"text":{"type":"string"},"timestamp":{"type":"string"}}}}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/stats/activity-feed":{"get":{"summary":"Get recent activity feed for live updates (public endpoint)","tags":["stats","public"],"description":"Get recent activity feed for live updates (public endpoint)","parameters":[{"schema":{"type":"number","minimum":1,"maximum":50,"default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"since","required":false,"description":"ISO timestamp to get activity since"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"activity":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string"},"text":{"type":"string"},"timestamp":{"type":"string"}}}}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/stats/network-activity":{"get":{"summary":"Get network activity events for visualization (public endpoint)","tags":["stats","public"],"description":"Get network activity events for visualization (public endpoint)","parameters":[{"schema":{"type":"number","minimum":1,"maximum":200,"default":100},"in":"query","name":"limit","required":false}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"events":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["transfer","login","logout","vehicle_transfer"]},"fromServerId":{"type":["null","number"]},"toServerId":{"type":["null","number"]},"timestamp":{"type":"string"}}}},"servers":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"name":{"type":"string"},"position":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}}}}}}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/ticket-kb/search":{"post":{"tags":["ticket-kb"],"description":"Search for similar historical tickets using semantic search","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["query"],"properties":{"query":{"type":"string","description":"Search query (user issue description)"},"limit":{"type":"number","default":3,"description":"Number of results to return"}}}}}},"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object","properties":{"ticketId":{"type":"string"},"similarity":{"type":"number"},"text":{"type":"string"}}}}}},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/api/v1/ticket-kb/stats":{"get":{"tags":["ticket-kb"],"description":"Get ticket knowledge base statistics","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"indexed":{"type":"boolean"},"documentCount":{"type":"number"},"vocabularySize":{"type":"number"}}},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/api/v1/ticket-kb/reindex":{"post":{"tags":["ticket-kb"],"description":"Trigger ticket knowledge base re-indexing","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"indexed":{"type":"number"},"skipped":{"type":"number"},"duration":{"type":"number"}}},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/api/v1/ticket-kb/index":{"delete":{"tags":["ticket-kb"],"description":"Clear ticket knowledge base index","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"message":{"type":"string"}}},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/api/v1/mods/":{"get":{"tags":["mods"],"description":"Get cached public FS25 mod download listing","parameters":[{"schema":{"type":"string","enum":["true","false"]},"in":"query","name":"refresh","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","required":["baseUrl","mods","cachedAt","expiresAt","cacheTtlSeconds","stale"],"properties":{"baseUrl":{"type":"string"},"mods":{"type":"array","items":{"type":"object","required":["name","key","url","size","lastModified"],"properties":{"name":{"type":"string"},"key":{"type":"string"},"url":{"type":"string"},"size":{"type":"number"},"lastModified":{"type":"string"},"etag":{"type":"string"}}}},"cachedAt":{"type":"string"},"expiresAt":{"type":"string"},"cacheTtlSeconds":{"type":"number"},"stale":{"type":"boolean"},"warning":{"type":"string"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Error code"},"message":{"type":"string","description":"Human-readable error message"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number","description":"Unix timestamp of response"}}}}}}}}}}},"/api/v1/mods/refresh":{"post":{"tags":["mods"],"description":"Refresh cached public FS25 mod download listing","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","required":["baseUrl","mods","cachedAt","expiresAt","cacheTtlSeconds","stale"],"properties":{"baseUrl":{"type":"string"},"mods":{"type":"array","items":{"type":"object","required":["name","key","url","size","lastModified"],"properties":{"name":{"type":"string"},"key":{"type":"string"},"url":{"type":"string"},"size":{"type":"number"},"lastModified":{"type":"string"},"etag":{"type":"string"}}}},"cachedAt":{"type":"string"},"expiresAt":{"type":"string"},"cacheTtlSeconds":{"type":"number"},"stale":{"type":"boolean"},"warning":{"type":"string"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Error code"},"message":{"type":"string","description":"Human-readable error message"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number","description":"Unix timestamp of response"}}}}}}}}}}},"/api/v1/ticket-notifications/{userId}/status":{"get":{"summary":"Check if user has opted out of ticket notifications","tags":["tickets"],"description":"Check if user has opted out of ticket notifications","parameters":[{"schema":{"type":"string"},"in":"path","name":"userId","required":true,"description":"Discord user ID"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","required":["userId","optedOut","hasActiveTicket"],"properties":{"userId":{"type":"string"},"optedOut":{"type":"boolean"},"hasActiveTicket":{"type":"boolean"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/ticket-notifications/{userId}/opt-out":{"post":{"summary":"Opt out of ticket activity notifications","tags":["tickets"],"description":"Opt out of ticket activity notifications","parameters":[{"schema":{"type":"string"},"in":"path","name":"userId","required":true,"description":"Discord user ID"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","required":["userId","optedOut","message"],"properties":{"userId":{"type":"string"},"optedOut":{"type":"boolean"},"message":{"type":"string"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/api/v1/ticket-notifications/{userId}/opt-in":{"post":{"summary":"Opt in to ticket activity notifications","tags":["tickets"],"description":"Opt in to ticket activity notifications","parameters":[{"schema":{"type":"string"},"in":"path","name":"userId","required":true,"description":"Discord user ID"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","data","meta"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","required":["userId","optedOut","message"],"properties":{"userId":{"type":"string"},"optedOut":{"type":"boolean"},"message":{"type":"string"}}},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["success","error","meta"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"additionalProperties":true},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/health/websocket":{"get":{"tags":["health"],"description":"Get WebSocket server health and connection metrics","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"status":{"type":"string","enum":["healthy","degraded","unhealthy"],"description":"Overall WebSocket server health status"},"initialized":{"type":"boolean","description":"Whether WebSocket server is initialized"},"connections":{"type":"object","properties":{"total":{"type":"number","description":"Total number of socket connections"},"users":{"type":"number","description":"Number of unique users connected"},"bot":{"type":"boolean","description":"Whether Discord bot is connected"}}},"timestamp":{"type":"number"}}},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/health/bot":{"get":{"tags":["health"],"description":"Get Discord bot connection health status","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"status":{"type":"string","enum":["healthy","unhealthy"],"description":"Bot connection health status"},"connected":{"type":"boolean","description":"Whether Discord bot is connected via WebSocket"},"timestamp":{"type":"number"}}},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/health/queue":{"get":{"tags":["health"],"description":"Get notification queue health and depth metrics","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"status":{"type":"string","enum":["healthy","degraded","unhealthy"],"description":"Queue health status based on depth"},"queues":{"type":"object","properties":{"discord":{"type":"number","description":"Number of pending Discord notifications"},"push":{"type":"number","description":"Number of pending push notifications"},"failed":{"type":"number","description":"Number of permanently failed notifications"}}},"thresholds":{"type":"object","properties":{"warning":{"type":"number","description":"Queue depth threshold for degraded status"},"critical":{"type":"number","description":"Queue depth threshold for unhealthy status"}}},"timestamp":{"type":"number"}}},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}},"/health/fsapi":{"get":{"tags":["health"],"description":"Get FS25 API WebSocket namespace health status","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"status":{"type":"string","enum":["healthy","unhealthy"],"description":"FS API health status"},"initialized":{"type":"boolean","description":"Whether FS25 namespace is initialized"},"connections":{"type":"number","description":"Number of connected game servers"},"timestamp":{"type":"number"}}},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}},"meta":{"type":"object","properties":{"timestamp":{"type":"number"}}}}}}}}}}}},"servers":[{"url":"http://localhost:3000","description":"Development server"},{"url":"https://api.farmersonly.club","description":"Production server"}],"tags":[{"name":"public","description":"🌐 Public - No authentication"},{"name":"stats","description":"🌐 Public - Stats & activity"},{"name":"auth","description":"🔓 Auth - OAuth & tokens"},{"name":"users","description":"👤 Member - Profile & settings"},{"name":"transactions","description":"👤 Member - Transactions"},{"name":"servers","description":"👤 Member - Game servers"},{"name":"fields","description":"👤 Member - Field ownership"},{"name":"parcels","description":"👤 Member - Land & auctions"},{"name":"loans","description":"👤 Member - Loans"},{"name":"contracts","description":"👤 Member - Contracts"},{"name":"invoices","description":"👤 Member - Invoices"},{"name":"crops","description":"👤 Member - Crops"},{"name":"vehicles","description":"👤 Member - Vehicles"},{"name":"garage","description":"👤 Member - Garage"},{"name":"community","description":"👤 Member - Community & timesheet"},{"name":"notifications","description":"👤 Member - Notifications"},{"name":"audit","description":"👤 Member - Activity logs"},{"name":"tokens","description":"👤 Member - API tokens"},{"name":"realtor","description":"🏡 Realtor - Land operations"},{"name":"banker","description":"🏦 Banker - Loan operations"},{"name":"applications","description":"🚪 Gatekeeper - Application management"},{"name":"moderation","description":"👮 Moderator - Moderation actions"},{"name":"websocket","description":"🔌 WebSocket - Real-time events"}]}