🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/analytics/",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

No example written for this route yet.

❌ Common Errors

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/analytics/routes?limit=100&search=orders",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "success": true,
  "data": [
    {
      "route": "GET /orders/me",
      "count": 1842,
      "last_used": "2026-10-19T14:02:11.000Z",
      "last_used_formatted": "2026-10-19 14:02:11"
    }
  ],
  "metadata": {
    "limit": 100,
    "search": "orders",
    "count": 1
  }
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires head_developer permission(s)"
}

{
  "success": false,
  "error": "Internal server error while retrieving route analytics"
}

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/analytics/tokens?limit=100&search=Example",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "success": true,
  "data": [
    {
      "token_name": "123456789012345678",
      "count": 5210,
      "last_used": "2026-10-19T14:02:11.000Z",
      "last_used_formatted": "2026-10-19 14:02:11",
      "username": "ExampleUser"
    }
  ],
  "metadata": {
    "limit": 100,
    "search": "Example",
    "count": 1
  }
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires head_developer permission(s)"
}

{
  "success": false,
  "error": "Internal server error while retrieving token analytics"
}

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/analytics/token-routes?limit=100&token_name=123456789012345678&route=orders",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "success": true,
  "data": [
    {
      "token_name": "123456789012345678",
      "route": "GET /orders/me",
      "count": 912,
      "last_used": "2026-10-19T14:02:11.000Z",
      "last_used_formatted": "2026-10-19 14:02:11",
      "username": "ExampleUser"
    }
  ],
  "metadata": {
    "limit": 100,
    "token_name": "123456789012345678",
    "route": "orders",
    "count": 1
  }
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires head_developer permission(s)"
}

{
  "success": false,
  "error": "Internal server error while retrieving token-route analytics"
}

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/analytics/summary",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "success": true,
  "data": {
    "total_routes": 64,
    "total_route_requests": 48211,
    "total_tokens": 37,
    "total_token_requests": 48211,
    "total_token_route_combinations": 410,
    "total_detailed_requests": 48211,
    "max_route_usage": 1842,
    "most_used_route": "GET /orders/me",
    "max_token_usage": 5210,
    "most_active_token": "123456789012345678"
  },
  "metadata": {
    "timestamp": "2026-10-19T14:05:00.000Z",
    "requested_by": "ExampleUser"
  }
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires head_developer permission(s)"
}

{
  "success": false,
  "error": "Internal server error while retrieving summary analytics"
}

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/applications/can-apply",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

No example written for this route yet.

❌ Common Errors

🔧 Axios Example

axios({
  "method": "post",
  "url": "http://localhost:8080/applications/",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

No example written for this route yet.

❌ Common Errors

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/applications/mine",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

No example written for this route yet.

❌ Common Errors

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/applications/unposted",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

No example written for this route yet.

❌ Common Errors

🔧 Axios Example

axios({
  "method": "post",
  "url": "http://localhost:8080/applications/:id/posted",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

No example written for this route yet.

❌ Common Errors

🔧 Axios Example

axios({
  "method": "post",
  "url": "http://localhost:8080/applications/discord-posts/:messageId/deleted",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

No example written for this route yet.

❌ Common Errors

🔧 Axios Example

axios({
  "method": "post",
  "url": "http://localhost:8080/applications/:id/decide",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

No example written for this route yet.

❌ Common Errors

🔧 Axios Example

axios({
  "method": "put",
  "url": "http://localhost:8080/applications/inactive-grinders",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

No example written for this route yet.

❌ Common Errors

🔧 Axios Example

axios({
  "method": "post",
  "url": "http://localhost:8080/applications/inactive-grinders/:userId",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

No example written for this route yet.

❌ Common Errors

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/applications/:id/files/:publicId",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

No example written for this route yet.

❌ Common Errors

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/blacklist/"
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

No example written for this route yet.

❌ Common Errors

🔧 Axios Example

axios({
  "method": "post",
  "url": "http://localhost:8080/blacklist/ban",
  "headers": {
    "token": "your_api_token_here"
  },
  "data": {
    "user_id": "123456789012345678",
    "reason": "Did not pay for order #15102"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "success": true,
  "message": "User 123456789012345678 (ExampleUser) banned",
  "data": {
    "user_id": "123456789012345678",
    "username": "ExampleUser",
    "reason": "Did not pay for order #15102",
    "banned_by": "StaffMember",
    "banned_at": "2026-10-18T21:00:00.000Z"
  }
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires owner, manager, director, staff permission(s)"
}

{
  "success": false,
  "error": "user_id is required"
}

{
  "success": false,
  "error": "User not found in database"
}

{
  "success": false,
  "error": "User is already blacklisted"
}

{
  "success": false,
  "error": "Internal server error"
}

🔧 Axios Example

axios({
  "method": "post",
  "url": "http://localhost:8080/blacklist/unban",
  "headers": {
    "token": "your_api_token_here"
  },
  "data": {
    "user_id": "123456789012345678"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "success": true,
  "message": "User 123456789012345678 (ExampleUser) unbanned",
  "data": {
    "user_id": "123456789012345678",
    "username": "ExampleUser",
    "unbanned_by": "StaffMember",
    "unbanned_at": "2026-10-19T10:00:00.000Z"
  }
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires owner, manager, director, staff permission(s)"
}

{
  "success": false,
  "error": "user_id is required"
}

{
  "success": false,
  "error": "User not found in database"
}

{
  "success": false,
  "error": "User is not blacklisted"
}

{
  "success": false,
  "error": "Internal server error"
}

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/blacklist/check/:user_id",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "success": true,
  "data": {
    "user_id": "123456789012345678",
    "username": "ExampleUser",
    "blacklisted": 1,
    "exists_in_db": true,
    "reason": "Did not pay for order #15102",
    "banned_by": "StaffMember",
    "banned_at": "2026-10-18 21:00:00"
  }
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires owner, manager, director, staff permission(s)"
}

{
  "success": false,
  "error": "Internal server error"
}

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/blacklist/gblacklist?page=1",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "success": true,
  "data": [
    {
      "user_id": "876543210987654321",
      "username": "OtherGrinder",
      "avatar": "https://cdn.discordapp.com/avatars/123456789012345678/a1b2c3d4e5f6.png",
      "created_at": "2025-07-23 02:38:45",
      "updated_at": "2026-10-18 21:00:00",
      "reason": "Scammed a customer",
      "banned_by": "StaffMember",
      "banned_at": "2026-10-18 21:00:00"
    }
  ],
  "pagination": {
    "current_page": 1,
    "per_page": 5,
    "total_count": 1,
    "total_pages": 1,
    "has_next": false,
    "has_previous": false
  }
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires owner, manager, director, staff permission(s)"
}

{
  "success": false,
  "error": "Internal server error"
}

🔧 Axios Example

axios({
  "method": "post",
  "url": "http://localhost:8080/blacklist/gblacklist/gban",
  "headers": {
    "token": "your_api_token_here"
  },
  "data": {
    "user_id": "876543210987654321",
    "reason": "Scammed a customer"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "success": true,
  "message": "User 876543210987654321 (OtherGrinder) grinder banned",
  "data": {
    "user_id": "876543210987654321",
    "username": "OtherGrinder",
    "reason": "Scammed a customer",
    "banned_by": "StaffMember",
    "banned_at": "2026-10-18T21:00:00.000Z"
  }
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires owner, manager, director, staff permission(s)"
}

{
  "success": false,
  "error": "user_id is required"
}

{
  "success": false,
  "error": "User not found in database"
}

{
  "success": false,
  "error": "User is already grinder banned"
}

{
  "success": false,
  "error": "Internal server error"
}

🔧 Axios Example

axios({
  "method": "post",
  "url": "http://localhost:8080/blacklist/gblacklist/gunban",
  "headers": {
    "token": "your_api_token_here"
  },
  "data": {
    "user_id": "876543210987654321"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "success": true,
  "message": "User 876543210987654321 (OtherGrinder) grinder unbanned",
  "data": {
    "user_id": "876543210987654321",
    "username": "OtherGrinder",
    "unbanned_by": "StaffMember",
    "unbanned_at": "2026-10-19T10:00:00.000Z"
  }
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires owner, manager, director, staff permission(s)"
}

{
  "success": false,
  "error": "user_id is required"
}

{
  "success": false,
  "error": "User not found in database"
}

{
  "success": false,
  "error": "User is not grinder banned"
}

{
  "success": false,
  "error": "Internal server error"
}

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/blacklist/gblacklist/check/:user_id",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "success": true,
  "data": {
    "user_id": "876543210987654321",
    "username": "OtherGrinder",
    "gblacklisted": 1,
    "exists_in_db": true,
    "reason": "Scammed a customer",
    "banned_by": "StaffMember",
    "banned_at": "2026-10-18 21:00:00"
  }
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires owner, manager, director, staff permission(s)"
}

{
  "success": false,
  "error": "Internal server error"
}

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/blocked-ips/stats",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "success": true,
  "stats": {
    "total_records": 42,
    "permanently_blocked": 3,
    "temporarily_blocked": 5,
    "pending_block": 12,
    "manually_blocked": 1
  },
  "config": {
    "max_attempts": 5,
    "time_window_hours": 1,
    "block_duration_minutes": 10,
    "permanent_block_threshold": 3
  }
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires head_developer permission(s)"
}

{
  "error": "Internal server error"
}

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/blocked-ips/list?page=1&limit=50",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "success": true,
  "data": [
    {
      "type": "auto",
      "failed_attempts": 5,
      "first_attempt": "2026-10-19T09:12:44.000Z",
      "last_attempt": "2026-10-19T09:15:02.000Z",
      "blocked_at": "2026-10-19T09:15:02.000Z",
      "blocked_until": "2026-10-19T09:25:02.000Z",
      "is_permanently_blocked": false,
      "is_currently_blocked": true,
      "time_until_unblock": 412000,
      "reason": "Blocked for 5 failed authentication attempts"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 50,
    "total": 1,
    "total_pages": 1
  }
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires head_developer permission(s)"
}

{
  "error": "Internal server error"
}

🔧 Axios Example

axios({
  "method": "post",
  "url": "http://localhost:8080/blocked-ips/unblock"
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

No example written for this route yet.

❌ Common Errors

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/compensation/",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

No example written for this route yet.

❌ Common Errors

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/compensation/reimbursements/:payer_id",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "user_id": "123456789012345678",
  "amount": 85000,
  "payouts": 2
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires owner, manager permission(s)"
}

{
  "error": "Invalid user ID"
}

{
  "error": "Internal server error"
}

🔧 Axios Example

axios({
  "method": "post",
  "url": "http://localhost:8080/compensation/reimbursements/:payer_id/paidout",
  "headers": {
    "token": "your_api_token_here"
  },
  "data": {
    "paid_out_by": "111222333444555666"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "message": "Paid out",
  "user_id": "123456789012345678",
  "amount": 85000,
  "payouts": 2
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires owner, manager permission(s)"
}

{
  "error": "Invalid user ID"
}

{
  "error": "Nothing is owed to this user",
  "amount": 0
}

{
  "error": "Internal server error"
}

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/compensation/:user_id",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "user_id": "987654321098765432",
  "amount": 145000,
  "orders": 6,
  "old_balance": 25000,
  "reimbursement": {
    "amount": 0,
    "payouts": 0
  }
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires owner, manager permission(s)"
}

{
  "error": "Invalid user ID"
}

{
  "error": "Internal server error"
}

🔧 Axios Example

axios({
  "method": "post",
  "url": "http://localhost:8080/compensation/:user_id/pay",
  "headers": {
    "token": "your_api_token_here"
  },
  "data": {
    "paid_by": "123456789012345678",
    "reimburse": true
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "message": "Paid",
  "user_id": "987654321098765432",
  "amount": 145000,
  "orders": 6,
  "old_balance": 25000,
  "payout_id": 31,
  "reimburse": true
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires owner, manager permission(s)"
}

{
  "error": "Invalid user ID"
}

{
  "error": "This user has no compensation to pay out",
  "amount": 0
}

{
  "error": "Internal server error"
}

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/config/globaldiscount",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "globalDiscount": {
    "cargo": 10,
    "cargo_perk": 20
  },
  "details": [
    {
      "item": "cargo",
      "value": 10,
      "last_updated": "2026-10-18 21:14:03",
      "created": "2026-09-02 17:40:11"
    },
    {
      "item": "cargo_perk",
      "value": 20,
      "last_updated": "2026-10-18 21:14:09",
      "created": "2026-09-02 17:40:11"
    }
  ],
  "message": "Global discount data retrieved successfully"
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Internal server error"
}

🔧 Axios Example

axios({
  "method": "post",
  "url": "http://localhost:8080/config/globaldiscount",
  "headers": {
    "token": "your_api_token_here"
  },
  "data": {
    "item": "cargo_perk",
    "value": 20
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "item": "cargo_perk",
  "value": 20,
  "message": "Global discount item updated successfully"
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires owner, manager permission(s)"
}

{
  "error": "item and value are required"
}

{
  "error": "value must be a number"
}

{
  "error": "item must be one of: cargo, cargo_perk, exp, meat"
}

{
  "error": "Internal server error"
}

🔧 Axios Example

axios({
  "method": "delete",
  "url": "http://localhost:8080/config/globaldiscount/:item",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "item": "cargo_perk",
  "message": "Global discount item deleted successfully"
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires owner, manager permission(s)"
}

{
  "error": "Global discount item not found"
}

{
  "error": "Internal server error"
}

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/config/autodiscounts",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "autodiscounts": [
    {
      "limit_name": "loyal",
      "limit_value": 5
    },
    {
      "limit_name": "first_order",
      "limit_value": 10
    },
    {
      "limit_name": "boost",
      "limit_value": 5
    },
    {
      "limit_name": "gotm",
      "limit_value": 15
    }
  ]
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires owner, manager permission(s)"
}

{
  "error": "Internal server error"
}

🔧 Axios Example

axios({
  "method": "put",
  "url": "http://localhost:8080/config/autodiscounts/:perk",
  "headers": {
    "token": "your_api_token_here"
  },
  "data": {
    "value": 10
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "perk": "loyal",
  "value": 10,
  "old_value": 5,
  "message": "Automatic discount updated"
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires owner, manager permission(s)"
}

{
  "error": "perk must be one of: loyal, first_order, boost, gotm"
}

{
  "error": "value must be a whole number from 0 to 100"
}

{
  "error": "Internal server error"
}

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/config/department-limits",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "department_limits": [
    {
      "department": "cargo",
      "permission": "customer",
      "limit_value": 5
    },
    {
      "department": "cargo",
      "permission": "loyal_customer",
      "limit_value": 10
    },
    {
      "department": "cargo perk",
      "permission": "customer",
      "limit_value": 5
    },
    {
      "department": "cargo perk",
      "permission": "loyal_customer",
      "limit_value": 10
    },
    {
      "department": "exp",
      "permission": "customer",
      "limit_value": 5
    },
    {
      "department": "exp",
      "permission": "loyal_customer",
      "limit_value": 10
    },
    {
      "department": "meat",
      "permission": "customer",
      "limit_value": 3
    },
    {
      "department": "meat",
      "permission": "loyal_customer",
      "limit_value": 6
    }
  ]
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires owner, manager permission(s)"
}

{
  "error": "Internal server error"
}

🔧 Axios Example

axios({
  "method": "put",
  "url": "http://localhost:8080/config/department-limits/:department/:permission",
  "headers": {
    "token": "your_api_token_here"
  },
  "data": {
    "limit_value": 8
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "department": "cargo",
  "permission": "customer",
  "limit_value": 8,
  "old_value": 5,
  "message": "Department limit updated"
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires owner, manager permission(s)"
}

{
  "error": "department must be one of: cargo, meat, exp, cargo perk"
}

{
  "error": "permission must be one of: customer, loyal_customer"
}

{
  "error": "limit_value must be a whole number, 0 or more"
}

{
  "error": "Internal server error"
}

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/config/:table",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "channels": [
    {
      "id": 1,
      "channel_name": "orderhere",
      "channel_id": "741274180971921400",
      "description": null,
      "created_at": "2025-07-23 02:38:45"
    },
    {
      "id": 2,
      "channel_name": "tickets",
      "channel_id": "741274180971921401",
      "description": "Ticket channel",
      "created_at": "2025-07-23 02:38:45"
    }
  ]
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires owner, manager permission(s)"
}

{
  "error": "Invalid config table"
}

{
  "error": "Internal server error"
}

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/cooldown/status/:prefix/:identifier",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "cooldownActive": true,
  "prefix": "order_accept",
  "identifier": "987654321098765432",
  "remainingTime": 412000,
  "expiresAt": "2026-10-19T14:12:00.000Z",
  "createdAt": "2026-10-19T14:02:00.000Z",
  "orderId": 15408,
  "remainingMinutes": 7,
  "remainingSeconds": 412
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires owner, manager, director, staff, supervisor, head_developer permission(s)"
}

🔧 Axios Example

axios({
  "method": "delete",
  "url": "http://localhost:8080/cooldown/:prefix/:identifier",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "message": "Cooldown cleared successfully",
  "cleared": true,
  "prefix": "order_accept",
  "identifier": "987654321098765432"
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires owner, manager, director, staff, supervisor, head_developer permission(s)"
}

🔧 Axios Example

axios({
  "method": "post",
  "url": "http://localhost:8080/cooldown/:prefix/:identifier/:durationMs",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "message": "Cooldown set/reset successfully",
  "prefix": "order_accept",
  "identifier": "987654321098765432",
  "durationMs": 600000,
  "expiresAt": "2026-10-19T14:12:00.000Z"
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires owner, manager, director, staff, supervisor, head_developer permission(s)"
}

{
  "error": "Invalid durationMs"
}

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/cooldown/stats",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "totalActiveCooldowns": 2,
  "cooldownsByPrefix": {
    "order_accept": 1,
    "order": 1
  },
  "upcomingExpirations": [
    {
      "key": "order:123456789012345678",
      "expiresAt": "2026-10-19T14:05:30.000Z",
      "remainingTime": 30000
    },
    {
      "key": "order_accept:987654321098765432",
      "expiresAt": "2026-10-19T14:12:00.000Z",
      "remainingTime": 412000
    }
  ],
  "formattedExpirations": [
    {
      "key": "order:123456789012345678",
      "expiresAt": "2026-10-19T14:05:30.000Z",
      "remainingTime": 30000,
      "remainingMinutes": 1,
      "remainingSeconds": 30,
      "prefix": "order",
      "identifier": "123456789012345678"
    },
    {
      "key": "order_accept:987654321098765432",
      "expiresAt": "2026-10-19T14:12:00.000Z",
      "remainingTime": 412000,
      "remainingMinutes": 7,
      "remainingSeconds": 412,
      "prefix": "order_accept",
      "identifier": "987654321098765432"
    }
  ]
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires owner, manager, director, staff, supervisor, head_developer permission(s)"
}

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/cooldown/user/:userId",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "userId": "987654321098765432",
  "activeCooldowns": 1,
  "cooldowns": [
    {
      "prefix": "order_accept",
      "identifier": "987654321098765432",
      "expiresAt": "2026-10-19T14:12:00.000Z",
      "remainingTime": 412000,
      "remainingMinutes": 7,
      "remainingSeconds": 412
    }
  ]
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires owner, manager, director, staff, supervisor, head_developer permission(s)"
}

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/customers/me",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "customer": {
    "user_id": "123456789012345678",
    "username": "ExampleUser",
    "avatar": "https://cdn.discordapp.com/avatars/123456789012345678/a1b2c3d4e5f6.png",
    "created_at": "2025-07-23 02:38:45",
    "updated_at": "2026-10-12 18:21:07",
    "permissions": [
      "member",
      "customer"
    ]
  }
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires customer, loyal_customer permission(s)"
}

{
  "error": "Invalid user ID"
}

{
  "error": "Customer not found"
}

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/customers/me/orders?page=1",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "customerid": "123456789012345678",
  "orders": [
    {
      "id": 15408,
      "orderid": 2315,
      "customerid": 123456789012345680,
      "grinder": "987654321098765432",
      "item": "acid",
      "amount": 500,
      "status": "in_progress",
      "price": 6000000,
      "created_at": "2026-10-18 20:11:42",
      "lastModified": 1760818302000,
      "datetime": "1760818302000"
    }
  ],
  "pagination": {
    "current_page": 1,
    "per_page": 5,
    "total_count": 12,
    "total_pages": 3,
    "has_next": true,
    "has_previous": false
  }
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires customer, loyal_customer permission(s)"
}

{
  "error": "Invalid user ID"
}

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/dev/status"
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

No example written for this route yet.

❌ Common Errors

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/feedback-files/:public_id"
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

<binary image data>
Content-Type: image/png
Content-Disposition: inline; filename="screenshot.png"

❌ Common Errors

{
  "error": "File not found"
}

{
  "error": "Internal server error"
}

🔧 Axios Example

axios({
  "method": "post",
  "url": "http://localhost:8080/feedback/",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

No example written for this route yet.

❌ Common Errors

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/feedback/mine",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "success": true,
  "data": {
    "items": [
      {
        "id": 43,
        "kind": "bug",
        "user_id": "123456789012345678",
        "username": "ExampleUser",
        "title": "Order page shows the wrong price",
        "body": "The price on my order is 0 after I changed the amount.",
        "expected": "The price updates to the new amount.",
        "steps": "Create an order, edit the amount, refresh the page.",
        "extra": null,
        "bug_where": "website",
        "bug_severity": "broken",
        "bug_frequency": "always",
        "status": "new",
        "source": "site",
        "withdrawn_at": null,
        "forum_thread_id": null,
        "review_message_id": "1298765432109876544",
        "created_at": "2026-10-18 19:02:11",
        "updated_at": "2026-10-18 19:02:11"
      },
      {
        "id": 42,
        "kind": "website",
        "user_id": "123456789012345678",
        "username": "ExampleUser",
        "title": "Dark mode for the order page",
        "body": "The order page is very bright at night. A dark theme toggle would help.",
        "expected": null,
        "steps": null,
        "extra": null,
        "bug_where": null,
        "bug_severity": null,
        "bug_frequency": null,
        "status": "new",
        "source": "site",
        "withdrawn_at": null,
        "forum_thread_id": "1298765432109876543",
        "review_message_id": "1298765432109876544",
        "created_at": "2026-10-18 19:02:11",
        "updated_at": "2026-10-18 19:02:11"
      }
    ],
    "left_today": 3
  }
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "success": false,
  "error": "Internal server error"
}

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/feedback/public?kind=website&status=new",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "success": true,
  "data": {
    "items": [
      {
        "id": 42,
        "kind": "website",
        "title": "Dark mode for the order page",
        "status": "new",
        "forum_thread_id": "1298765432109876543",
        "created_at": "2026-10-18 19:02:11"
      }
    ]
  }
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "success": false,
  "error": "Internal server error"
}

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/feedback/",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

No example written for this route yet.

❌ Common Errors

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/feedback/:id/public",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "success": true,
  "data": {
    "id": 42,
    "kind": "website",
    "title": "Dark mode for the order page",
    "status": "new",
    "forum_thread_id": "1298765432109876543",
    "created_at": "2026-10-18 19:02:11",
    "body": "The order page is very bright at night. A dark theme toggle would help.",
    "closed": false,
    "comments": [
      {
        "id": 7,
        "feedback_id": 42,
        "user_id": "876543210987654321",
        "username": "OtherUser",
        "source": "site",
        "message": "Yes please, my eyes!",
        "created_at": "2026-10-18 19:30:00",
        "edited_at": null
      }
    ]
  }
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "success": false,
  "error": "Idea not found"
}

{
  "success": false,
  "error": "Internal server error"
}

🔧 Axios Example

axios({
  "method": "post",
  "url": "http://localhost:8080/feedback/:id/comments",
  "headers": {
    "token": "your_api_token_here"
  },
  "data": {
    "message": "Yes please, my eyes!"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (201)

{
  "success": true,
  "data": {
    "id": 7,
    "feedback_id": 42,
    "user_id": "876543210987654321",
    "username": "OtherUser",
    "source": "site",
    "message": "Yes please, my eyes!",
    "created_at": "2026-10-18 19:30:00",
    "edited_at": null
  }
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "success": false,
  "error": "You can't comment"
}

{
  "success": false,
  "error": "Idea not found"
}

{
  "success": false,
  "error": "This idea was withdrawn"
}

{
  "success": false,
  "error": "Comment is required"
}

{
  "success": false,
  "error": "Comment must be 1000 characters or less"
}

{
  "success": false,
  "error": "Please wait a few seconds between comments"
}

{
  "success": false,
  "error": "Internal server error"
}

🔧 Axios Example

axios({
  "method": "delete",
  "url": "http://localhost:8080/feedback/comments/:cid",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "success": true
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "success": false,
  "error": "Comment not found"
}

{
  "success": false,
  "error": "You can't delete this comment"
}

{
  "success": false,
  "error": "Internal server error"
}

🔧 Axios Example

axios({
  "method": "put",
  "url": "http://localhost:8080/feedback/comments/:cid/discord",
  "headers": {
    "token": "your_api_token_here"
  },
  "data": {
    "discord_message_id": "1298765432109876600",
    "username": "OtherUser"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "success": true
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Only specific users are allowed"
}

{
  "success": false,
  "error": "Comment not found"
}

{
  "success": false,
  "error": "discord_message_id is required"
}

{
  "success": false,
  "error": "Internal server error"
}

🔧 Axios Example

axios({
  "method": "put",
  "url": "http://localhost:8080/feedback/:id/discord-comments",
  "headers": {
    "token": "your_api_token_here"
  },
  "data": {
    "discord_message_id": "1298765432109876601",
    "user_id": "876543210987654321",
    "username": "OtherUser",
    "message": "Agreed, would love this."
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "success": true,
  "data": {
    "id": 8,
    "feedback_id": 42,
    "user_id": "876543210987654321",
    "username": "OtherUser",
    "source": "discord",
    "message": "Agreed, would love this.",
    "created_at": "2026-10-18 19:30:00",
    "edited_at": null
  }
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Only specific users are allowed"
}

{
  "success": false,
  "error": "Idea not found"
}

{
  "success": false,
  "error": "discord_message_id, user_id and message are required"
}

{
  "success": false,
  "error": "Internal server error"
}

🔧 Axios Example

axios({
  "method": "delete",
  "url": "http://localhost:8080/feedback/discord-comments/:messageId",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "success": true
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Only specific users are allowed"
}

{
  "success": false,
  "error": "Comment not found"
}

{
  "success": false,
  "error": "Internal server error"
}

🔧 Axios Example

axios({
  "method": "delete",
  "url": "http://localhost:8080/feedback/:id/everywhere",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "success": true
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "success": false,
  "error": "Only Directors and above, and Developers, can delete suggestions"
}

{
  "success": false,
  "error": "Suggestion not found"
}

{
  "success": false,
  "error": "Internal server error"
}

🔧 Axios Example

axios({
  "method": "delete",
  "url": "http://localhost:8080/feedback/discord-posts/:threadId",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "success": true
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Only specific users are allowed"
}

{
  "success": false,
  "error": "Suggestion not found"
}

{
  "success": false,
  "error": "Internal server error"
}

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/feedback/:id",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "success": true,
  "data": {
    "id": 43,
    "kind": "bug",
    "user_id": "123456789012345678",
    "username": "ExampleUser",
    "title": "Order page shows the wrong price",
    "body": "The price on my order is 0 after I changed the amount.",
    "expected": "The price updates to the new amount.",
    "steps": "Create an order, edit the amount, refresh the page.",
    "extra": null,
    "bug_where": "website",
    "bug_severity": "broken",
    "bug_frequency": "always",
    "status": "new",
    "source": "site",
    "withdrawn_at": null,
    "forum_thread_id": null,
    "review_message_id": "1298765432109876544",
    "created_at": "2026-10-18 19:02:11",
    "updated_at": "2026-10-18 19:02:11",
    "images": [
      {
        "url": "/feedback-files/9f86d081884c7d659a2feaa0c55ad015",
        "filename": "screenshot.png"
      }
    ],
    "replies": [
      {
        "id": 3,
        "feedback_id": 43,
        "user_id": "111222333444555666",
        "username": "StaffMember",
        "is_reviewer": true,
        "message": "Thanks, we can reproduce it.",
        "created_at": "2026-10-18 20:15:00"
      }
    ]
  }
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "success": false,
  "error": "Suggestion not found"
}

{
  "success": false,
  "error": "You can't see this suggestion"
}

{
  "success": false,
  "error": "Internal server error"
}

🔧 Axios Example

axios({
  "method": "post",
  "url": "http://localhost:8080/feedback/:id/replies",
  "headers": {
    "token": "your_api_token_here"
  },
  "data": {
    "message": "Thanks, we can reproduce it."
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (201)

{
  "success": true,
  "data": {
    "id": 3,
    "feedback_id": 43,
    "user_id": "111222333444555666",
    "username": "StaffMember",
    "is_reviewer": true,
    "message": "Thanks, we can reproduce it."
  }
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "success": false,
  "error": "Suggestion not found"
}

{
  "success": false,
  "error": "You can't see this suggestion"
}

{
  "success": false,
  "error": "This suggestion was withdrawn"
}

{
  "success": false,
  "error": "Reply is required"
}

{
  "success": false,
  "error": "Reply must be 2000 characters or less"
}

{
  "success": false,
  "error": "Internal server error"
}

🔧 Axios Example

axios({
  "method": "delete",
  "url": "http://localhost:8080/feedback/:id",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "success": true,
  "data": {
    "id": 42,
    "kind": "website",
    "user_id": "123456789012345678",
    "username": "ExampleUser",
    "title": "Dark mode for the order page",
    "body": "The order page is very bright at night. A dark theme toggle would help.",
    "expected": null,
    "steps": null,
    "extra": null,
    "bug_where": null,
    "bug_severity": null,
    "bug_frequency": null,
    "status": "new",
    "source": "site",
    "withdrawn_at": "2026-10-19 08:00:00",
    "forum_thread_id": "1298765432109876543",
    "review_message_id": "1298765432109876544",
    "created_at": "2026-10-18 19:02:11",
    "updated_at": "2026-10-19 08:00:00",
    "images": []
  }
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "success": false,
  "error": "Suggestion not found"
}

{
  "success": false,
  "error": "Only the person who sent it can withdraw it"
}

{
  "success": false,
  "error": "This suggestion was withdrawn"
}

{
  "success": false,
  "error": "Internal server error"
}

🔧 Axios Example

axios({
  "method": "put",
  "url": "http://localhost:8080/feedback/:id",
  "headers": {
    "token": "your_api_token_here"
  },
  "data": {
    "status": "in_progress",
    "priority": "high"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "success": true,
  "data": {
    "id": 43,
    "kind": "bug",
    "user_id": "123456789012345678",
    "username": "ExampleUser",
    "title": "Order page shows the wrong price",
    "body": "The price on my order is 0 after I changed the amount.",
    "expected": "The price updates to the new amount.",
    "steps": "Create an order, edit the amount, refresh the page.",
    "extra": null,
    "bug_where": "website",
    "bug_severity": "broken",
    "bug_frequency": "always",
    "status": "in_progress",
    "source": "site",
    "withdrawn_at": null,
    "forum_thread_id": null,
    "review_message_id": "1298765432109876544",
    "created_at": "2026-10-18 19:02:11",
    "updated_at": "2026-10-19 08:10:00",
    "priority": "high",
    "images": [],
    "status_changed": true
  }
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "success": false,
  "error": "Only reviewers can change suggestions"
}

{
  "success": false,
  "error": "Suggestion not found"
}

{
  "success": false,
  "error": "Nothing to change"
}

{
  "success": false,
  "error": "Unknown status"
}

{
  "success": false,
  "error": "Unknown priority"
}

{
  "success": false,
  "error": "Internal server error"
}

🔧 Axios Example

axios({
  "method": "put",
  "url": "http://localhost:8080/feedback/:id/discord",
  "headers": {
    "token": "your_api_token_here"
  },
  "data": {
    "forum_thread_id": "1298765432109876543",
    "review_message_id": "1298765432109876544"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "success": true
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Only specific users are allowed"
}

{
  "success": false,
  "error": "Suggestion not found"
}

{
  "success": false,
  "error": "Internal server error"
}

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/giveaways/",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

No example written for this route yet.

❌ Common Errors

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/giveaways/:id",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "giveaway": {
    "id": 5,
    "prize": "5,000,000 cash",
    "message_id": "1298765432109876543",
    "end_time": 1761004800,
    "winners": 2,
    "status": "active",
    "channel_id": "741274180971921402",
    "host_user_id": "111222333444555666",
    "user_who_enter": "[\"123456789012345678\",\"876543210987654321\"]",
    "winners_id": null,
    "created_at": "2026-10-19 12:00:00",
    "rerolled_ids": null
  },
  "message": "Giveaway retrieved successfully"
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Invalid giveaway ID"
}

{
  "error": "Giveaway not found"
}

{
  "error": "Internal server error"
}

🔧 Axios Example

axios({
  "method": "post",
  "url": "http://localhost:8080/giveaways/",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

No example written for this route yet.

❌ Common Errors

🔧 Axios Example

axios({
  "method": "put",
  "url": "http://localhost:8080/giveaways/:id",
  "headers": {
    "token": "your_api_token_here"
  },
  "data": {
    "prize": "10,000,000 cash",
    "end_time": 1761091200,
    "winners": 3,
    "status": "active"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "giveaway": {
    "id": 5,
    "prize": "10,000,000 cash",
    "message_id": "1298765432109876543",
    "end_time": 1761091200,
    "winners": 3,
    "status": "active",
    "channel_id": "741274180971921402",
    "host_user_id": "111222333444555666",
    "user_who_enter": "[\"123456789012345678\",\"876543210987654321\"]",
    "winners_id": null,
    "created_at": "2026-10-19 12:00:00",
    "rerolled_ids": null
  },
  "message": "Giveaway updated successfully"
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires owner, manager permission(s)"
}

{
  "error": "Invalid giveaway ID"
}

{
  "error": "Giveaway not found"
}

{
  "error": "end_time must be a valid timestamp"
}

{
  "error": "winners must be a positive number"
}

{
  "error": "status must be active, ended, or cancelled"
}

{
  "error": "No valid fields to update"
}

{
  "error": "Internal server error"
}

🔧 Axios Example

axios({
  "method": "post",
  "url": "http://localhost:8080/giveaways/:id/enter",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "message": "Successfully entered giveaway",
  "giveaway_id": 5,
  "total_entries": 3
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Invalid giveaway ID"
}

{
  "error": "Giveaway not found"
}

{
  "error": "Giveaway is not active"
}

{
  "error": "Giveaway has ended"
}

{
  "error": "You have already entered this giveaway"
}

{
  "error": "Internal server error"
}

🔧 Axios Example

axios({
  "method": "post",
  "url": "http://localhost:8080/giveaways/:id/leave",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "message": "Left the giveaway",
  "giveaway_id": 5,
  "total_entries": 1
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Invalid giveaway ID"
}

{
  "error": "Giveaway not found"
}

{
  "error": "Giveaway is not active"
}

{
  "error": "Internal server error"
}

🔧 Axios Example

axios({
  "method": "post",
  "url": "http://localhost:8080/giveaways/:id/draw-winners",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "message": "Winners drawn successfully",
  "giveaway_id": 5,
  "winners": [
    "876543210987654321",
    "123456789012345678"
  ],
  "winners_with_names": [
    {
      "user_id": "876543210987654321",
      "username": "OtherUser"
    },
    {
      "user_id": "123456789012345678",
      "username": "ExampleUser"
    }
  ],
  "total_entries": 2,
  "winners_count": 2
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires owner, manager permission(s)"
}

{
  "error": "Invalid giveaway ID"
}

{
  "error": "Giveaway not found"
}

{
  "error": "Winners are currently being drawn by another process. Please wait and try again."
}

{
  "error": "Winners already drawn for this giveaway",
  "winners": [
    "876543210987654321"
  ],
  "winners_with_names": [
    {
      "user_id": "876543210987654321",
      "username": "OtherUser"
    }
  ]
}

{
  "error": "Unable to draw winners for this giveaway"
}

{
  "error": "No entries found for this giveaway"
}

{
  "error": "Internal server error"
}

🔧 Axios Example

axios({
  "method": "put",
  "url": "http://localhost:8080/giveaways/:id/entries",
  "headers": {
    "token": "your_api_token_here"
  },
  "data": {
    "user_ids": [
      "123456789012345678",
      "876543210987654321"
    ]
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "message": "Entries updated",
  "giveaway_id": 5,
  "total_entries": 2
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires owner, manager permission(s)"
}

{
  "error": "Invalid giveaway ID"
}

{
  "error": "user_ids must be a list of Discord IDs"
}

{
  "error": "Giveaway not found"
}

{
  "error": "Giveaway is not active"
}

{
  "error": "Internal server error"
}

🔧 Axios Example

axios({
  "method": "post",
  "url": "http://localhost:8080/giveaways/:id/reroll",
  "headers": {
    "token": "your_api_token_here"
  },
  "data": {
    "user_id": "876543210987654321"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "message": "Winner re-rolled",
  "replaced": "876543210987654321",
  "new_winner": "765432109876543210",
  "winners": [
    "765432109876543210",
    "123456789012345678"
  ]
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires owner, manager permission(s)"
}

{
  "error": "Invalid giveaway ID"
}

{
  "error": "Giveaway not found"
}

{
  "error": "Winners can only be re-rolled after the giveaway has ended"
}

{
  "error": "That user is not a winner of this giveaway",
  "winners": [
    "123456789012345678"
  ]
}

{
  "error": "No other entrants left to pick from",
  "winners": [
    "876543210987654321",
    "123456789012345678"
  ]
}

{
  "error": "Internal server error"
}

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/grinder-limits/",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

No example written for this route yet.

❌ Common Errors

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/grinder-limits/:permission",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "permission": "grinder",
  "normal_limit": 3,
  "overlimit_limit": 1,
  "total_capacity": 4,
  "created_at": "2025-07-23 02:38:45",
  "updated_at": "2025-07-23 02:38:45",
  "message": "Limits retrieved for grinder permission level"
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Permission level is required"
}

{
  "error": "No limits found for permission level: vip",
  "available_permissions": [
    "trainees",
    "grinder",
    "expert_grinder",
    "loyal_grinder"
  ]
}

{
  "error": "Internal server error while retrieving permission limits"
}

🔧 Axios Example

axios({
  "method": "put",
  "url": "http://localhost:8080/grinder-limits/:permission",
  "headers": {
    "token": "your_api_token_here"
  },
  "data": {
    "normal_limit": 4,
    "overlimit_limit": 1
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "success": true,
  "message": "Grinder limits updated successfully",
  "permission": "grinder",
  "normal_limit": 4,
  "overlimit_limit": 1,
  "total_capacity": 5,
  "created_at": "2025-07-23 02:38:45",
  "updated_at": "2026-10-19 14:10:00",
  "action": "updated",
  "updated_by": "ExampleUser"
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: Requires owner, manager, director, staff, supervisor, head_developer permission(s)"
}

{
  "error": "Forbidden: Manager permission or higher required to update grinder limits"
}

{
  "error": "Permission level is required"
}

{
  "error": "Both normal_limit and overlimit_limit are required"
}

{
  "error": "Limits must be non-negative integers"
}

{
  "error": "Limits cannot exceed 100 orders"
}

{
  "error": "Internal server error while updating grinder limits"
}

🔧 Axios Example

axios({
  "method": "post",
  "url": "http://localhost:8080/grinder-management/:id/add-grinder",
  "headers": {
    "token": "your_api_token_here"
  },
  "data": {
    "grinder_id": "876543210987654321"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "message": "Grinder added successfully",
  "order": {
    "id": 15408,
    "orderid": 2315,
    "customerid": "123456789012345678",
    "grinder": "[\"987654321098765432\",\"876543210987654321\"]",
    "collector": null,
    "item": "acid",
    "amount": 500,
    "priority": "normal",
    "info": "Deliver to my house please",
    "price": 6000000,
    "rawprice": 6000000,
    "discount": 0,
    "points": 10,
    "status": "in_progress",
    "datetime": "1760818302000",
    "lastModified": 1760875200000,
    "customer_username": "ExampleUser",
    "customer_avatar": "https://cdn.discordapp.com/avatars/123456789012345678/a1b2c3d4e5f6.png"
  },
  "added_grinder": {
    "user_id": "876543210987654321",
    "username": "OtherGrinder"
  },
  "added_by": {
    "user_id": "987654321098765432",
    "username": "GrinderPro"
  },
  "grinder_info": {
    "total_grinders": 2,
    "points_per_grinder": 5,
    "remainder_points": 0
  }
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires trainee, grinder, expert_grinder, loyal_grinder permission(s)"
}

{
  "error": "Invalid order ID"
}

{
  "error": "grinder_id is required"
}

{
  "error": "Order not found"
}

{
  "error": "Cannot add grinder to order. Current status: pending. Only in_progress orders can have grinders added."
}

{
  "error": "Only existing grinders on this order can add additional grinders"
}

{
  "error": "Grinder is already assigned to this order"
}

{
  "error": "Grinder user not found"
}

{
  "error": "Cannot add grinder: account is blacklisted"
}

{
  "error": "Cannot add grinder: account is globally blacklisted"
}

{
  "error": "User does not have grinder permission"
}

{
  "error": "Cannot add more grinders. Total points (1) would result in 0 points per grinder, which is below minimum of 1 point per grinder.",
  "current_grinders": 1,
  "total_points": 1,
  "points_per_grinder_if_added": 0
}

🔧 Axios Example

axios({
  "method": "post",
  "url": "http://localhost:8080/grinder-management/:id/assign-collector",
  "headers": {
    "token": "your_api_token_here"
  },
  "data": {
    "collector_id": "765432109876543210"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "message": "Collector assigned successfully",
  "order": {
    "id": 15408,
    "orderid": 2315,
    "customerid": "123456789012345678",
    "grinder": "[\"987654321098765432\",\"876543210987654321\"]",
    "collector": "765432109876543210",
    "item": "acid",
    "amount": 500,
    "priority": "normal",
    "info": "Deliver to my house please",
    "price": 6000000,
    "rawprice": 6000000,
    "discount": 0,
    "points": 10,
    "status": "in_progress",
    "datetime": "1760818302000",
    "lastModified": 1760875200000,
    "customer_username": "ExampleUser",
    "customer_avatar": "https://cdn.discordapp.com/avatars/123456789012345678/a1b2c3d4e5f6.png"
  },
  "assigned_collector": {
    "user_id": "765432109876543210",
    "username": "CollectorUser"
  },
  "assigned_by": {
    "user_id": "987654321098765432",
    "username": "GrinderPro"
  }
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires trainee, grinder, expert_grinder, loyal_grinder permission(s)"
}

{
  "error": "Invalid order ID"
}

{
  "error": "collector_id is required"
}

{
  "error": "Order not found"
}

{
  "error": "Cannot assign collector to order. Current status: pending. Only in_progress orders can have collectors assigned."
}

{
  "error": "Only grinders assigned to this order can assign collectors"
}

{
  "error": "Collector user not found"
}

{
  "error": "Cannot assign collector: account is blacklisted"
}

{
  "error": "Cannot assign collector: account is globally blacklisted"
}

{
  "error": "User does not have collector permission"
}

🔧 Axios Example

axios({
  "method": "post",
  "url": "http://localhost:8080/grinder-management/:id/deliver",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "message": "Order delivered successfully",
  "order": {
    "id": 15408,
    "orderid": 2315,
    "customerid": "123456789012345678",
    "grinder": "[\"987654321098765432\",\"876543210987654321\"]",
    "collector": "765432109876543210",
    "item": "acid",
    "amount": 500,
    "priority": "normal",
    "info": "Deliver to my house please",
    "price": 6000000,
    "rawprice": 6000000,
    "discount": 0,
    "points": 10,
    "status": "delivered",
    "datetime": "1760818302000",
    "lastModified": 1760875200000,
    "customer_username": "ExampleUser",
    "customer_avatar": "https://cdn.discordapp.com/avatars/123456789012345678/a1b2c3d4e5f6.png"
  },
  "delivered_by": {
    "user_id": "765432109876543210",
    "username": "CollectorUser"
  },
  "grinder_stats": {
    "total_grinders": 2,
    "points_per_grinder": 5,
    "total_points": 10
  }
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires collector permission(s)"
}

{
  "error": "Invalid order ID"
}

{
  "error": "Order not found"
}

{
  "error": "Cannot deliver order. Current status: in_progress. Only completed orders can be delivered."
}

{
  "error": "Only the assigned collector can mark this order as delivered"
}

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/grinder-management/leaderboard?limit=10&month_year=2026-10",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "leaderboard": [
    {
      "grinder_id": "987654321098765432",
      "total_points": 184,
      "total_orders": 37,
      "position": 1,
      "username": "GrinderPro",
      "avatar": "https://cdn.discordapp.com/avatars/123456789012345678/a1b2c3d4e5f6.png"
    },
    {
      "grinder_id": "876543210987654321",
      "total_points": 121,
      "total_orders": 25,
      "position": 2,
      "username": "OtherGrinder",
      "avatar": null
    }
  ],
  "month_year": "2026-10",
  "total_entries": 2,
  "limit": 10
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/grinder-management/archive?limit=50",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "archive": {
    "2026-09": [
      {
        "month_year": "2026-09",
        "position": 1,
        "grinder_id": "987654321098765432",
        "total_points": 212,
        "total_orders": 41,
        "archived_at": "2026-10-01 00:00:05",
        "username": "GrinderPro",
        "avatar": "https://cdn.discordapp.com/avatars/123456789012345678/a1b2c3d4e5f6.png"
      },
      {
        "month_year": "2026-09",
        "position": 2,
        "grinder_id": "876543210987654321",
        "total_points": 150,
        "total_orders": 30,
        "archived_at": "2026-10-01 00:00:05",
        "username": "OtherGrinder",
        "avatar": null
      }
    ]
  },
  "total_entries": 2,
  "months_count": 1,
  "limit": 50
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

🔧 Axios Example

axios({
  "method": "post",
  "url": "http://localhost:8080/grinder-management/archive-month",
  "headers": {
    "token": "your_api_token_here"
  },
  "data": {
    "month_year": "2026-09"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "message": "Top 3 grinders archived successfully",
  "month_year": "2026-09",
  "archived_by": "ExampleUser"
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires owner, manager permission(s)"
}

{
  "error": "Failed to archive top 3 grinders",
  "month_year": "2026-09"
}

🔧 Axios Example

axios({
  "method": "post",
  "url": "http://localhost:8080/grinder-management/update-leaderboard",
  "headers": {
    "token": "your_api_token_here"
  },
  "data": {
    "month_year": "2026-10"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "message": "Monthly leaderboard updated successfully",
  "month_year": "2026-10",
  "updated_by": "ExampleUser"
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires owner, manager permission(s)"
}

{
  "error": "Failed to update monthly leaderboard",
  "month_year": "2026-10"
}

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/grinders/activity"
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

No example written for this route yet.

❌ Common Errors

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/grinders/rank-status",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "this_month": "2026-10",
  "last_month": "2026-09",
  "grinders": [
    {
      "user_id": "987654321098765432",
      "permissions": [
        "member",
        "grinder"
      ],
      "hired_at": "2025-07-02T14:37:00.000Z",
      "completed_orders": 54,
      "delivered_orders": 51,
      "completed_orders_all_time": 54,
      "delivered_orders_all_time": 51,
      "points_this_month": 184,
      "points_last_month": 212
    }
  ]
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires owner, manager, director, staff, supervisor, head_developer permission(s)"
}

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/grinders/:user_id/limit-status",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "user_id": "987654321098765432",
  "rank_used": "grinder",
  "in_progress": 2,
  "overlimit_in_progress": 0,
  "normal_limit": 3,
  "overlimit_limit": 1,
  "can_take_overlimit": true,
  "error": null
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires owner, manager, director, staff, supervisor, head_developer permission(s)"
}

{
  "error": "Invalid user ID"
}

🔧 Axios Example

axios({
  "method": "put",
  "url": "http://localhost:8080/grinders/:user_id/hired",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "user_id": "987654321098765432",
  "date_utc": "2026-10-19 14:10 UTC"
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires owner, manager, director, staff, supervisor, head_developer permission(s)"
}

{
  "error": "Invalid user ID"
}

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/grinders/me",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "grinder": {
    "user_id": "987654321098765432",
    "username": "GrinderPro",
    "avatar": "https://cdn.discordapp.com/avatars/123456789012345678/a1b2c3d4e5f6.png",
    "created_at": "2025-07-23 02:38:45",
    "updated_at": "2026-10-12 18:21:07",
    "permissions": [
      "member",
      "grinder"
    ]
  }
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires trainee, grinder, expert_grinder, loyal_grinder permission(s)"
}

{
  "error": "Invalid user ID"
}

{
  "error": "Grinder not found"
}

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/grinders/me/orders?status=in_progress&page=1",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "orders": [
    {
      "id": 15408,
      "orderid": 2315,
      "customerid": "123456789012345678",
      "grinder": "987654321098765432",
      "item": "acid",
      "amount": 500,
      "priority": "normal",
      "info": "Deliver to my house please",
      "price": 6000000,
      "rawprice": 6000000,
      "discount": 0,
      "points": 10,
      "status": "in_progress",
      "datetime": "1760818302000",
      "lastModified": 1760875200000,
      "customer_username": "ExampleUser",
      "customer_avatar": "https://cdn.discordapp.com/avatars/123456789012345678/a1b2c3d4e5f6.png",
      "grinder_username": "GrinderPro",
      "grinder_avatar": "https://cdn.discordapp.com/avatars/123456789012345678/a1b2c3d4e5f6.png",
      "progress": 250
    }
  ],
  "pagination": {
    "current_page": 1,
    "per_page": 5,
    "total_count": 1,
    "total_pages": 1,
    "has_next": false,
    "has_previous": false
  },
  "filter": {
    "status": "in_progress"
  }
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires trainee, grinder, expert_grinder, loyal_grinder permission(s)"
}

{
  "error": "Invalid grinder ID"
}

{
  "error": "Invalid status. Must be one of: pending, in_progress, completed, delivered, or progress:number"
}

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/grinders/:grinderid/orders?status=in_progress",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "orders": [
    {
      "id": 15408,
      "orderid": 2315,
      "customerid": "123456789012345678",
      "grinder": "987654321098765432",
      "item": "acid",
      "amount": 500,
      "priority": "normal",
      "info": "Deliver to my house please",
      "price": 6000000,
      "rawprice": 6000000,
      "discount": 0,
      "points": 10,
      "status": "in_progress",
      "datetime": "1760818302000",
      "lastModified": 1760875200000,
      "customer_username": "ExampleUser",
      "customer_avatar": "https://cdn.discordapp.com/avatars/123456789012345678/a1b2c3d4e5f6.png",
      "grinder_username": "GrinderPro",
      "grinder_avatar": "https://cdn.discordapp.com/avatars/123456789012345678/a1b2c3d4e5f6.png"
    }
  ],
  "count": 1,
  "filter": {
    "status": "in_progress"
  }
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires trainee, grinder, expert_grinder, loyal_grinder permission(s)"
}

{
  "error": "Invalid grinder ID"
}

{
  "error": "Invalid status. Must be one of: pending, in_progress, completed, delivered, or progress:number"
}

{
  "error": "Grinder not found"
}

🔧 Axios Example

axios({
  "method": "put",
  "url": "http://localhost:8080/grinders/me/orders/:order_id/status",
  "headers": {
    "token": "your_api_token_here"
  },
  "data": {
    "status": "in_progress",
    "progress": 500
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "message": "Order status updated successfully",
  "order": {
    "id": 15408,
    "customerid": 123456789012345680,
    "grinder": "987654321098765432",
    "item": "acid",
    "amount": 500,
    "status": "completed",
    "price": 6000000,
    "created_at": "2026-10-18 20:11:42",
    "lastModified": 1760889600000,
    "datetime": "1760818302000"
  },
  "updated_by": "GrinderPro"
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires trainee, grinder, expert_grinder, loyal_grinder permission(s)"
}

{
  "error": "Invalid grinder ID"
}

{
  "error": "Invalid order ID"
}

{
  "error": "Order not found or not assigned to you"
}

{
  "error": "This order was cancelled and can't be changed."
}

{
  "error": "This order is already delivered and can't be changed."
}

{
  "error": "Invalid status. Must be one of: pending, in_progress, completed, delivered, or progress:number (0-500)"
}

{
  "error": "Invalid progress. Must be a number between 0 and 500"
}

{
  "error": "Must provide either status or progress (or both)"
}

🔧 Axios Example

axios({
  "method": "put",
  "url": "http://localhost:8080/grinders/:grinderid/orders/:order_id/status",
  "headers": {
    "token": "your_api_token_here"
  },
  "data": {
    "status": "completed"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "message": "Order status updated successfully",
  "order": {
    "id": 15408,
    "customerid": 123456789012345680,
    "grinder": "987654321098765432",
    "item": "acid",
    "amount": 500,
    "status": "completed",
    "price": 6000000,
    "created_at": "2026-10-18 20:11:42",
    "lastModified": 1760889600000,
    "datetime": "1760818302000"
  },
  "updated_by": "StaffMember"
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires owner, manager, director, staff permission(s)"
}

{
  "error": "Invalid grinder ID"
}

{
  "error": "Invalid order ID"
}

{
  "error": "Order not found or not assigned to this grinder"
}

{
  "error": "This order was cancelled and can't be changed."
}

{
  "error": "This order is already delivered and can't be changed."
}

{
  "error": "Invalid status. Must be one of: pending, in_progress, completed, delivered, or progress:number (0-500)"
}

{
  "error": "Invalid progress. Must be a number between 0 and 500"
}

{
  "error": "Must provide either status or progress (or both)"
}

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/grinders/leaderboard?month=2026-10&limit=10",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "leaderboard": [
    {
      "rank": 1,
      "grinder_id": "987654321098765432",
      "username": "GrinderPro",
      "avatar": "https://cdn.discordapp.com/avatars/123456789012345678/a1b2c3d4e5f6.png",
      "stats": {
        "total_points": 184,
        "total_orders": 37
      }
    },
    {
      "rank": 2,
      "grinder_id": "876543210987654321",
      "username": "Unknown",
      "avatar": null,
      "stats": {
        "total_points": 121,
        "total_orders": 25
      }
    }
  ],
  "month_year": "2026-10",
  "limit": 10,
  "total_grinders": 2
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires trainee, grinder, expert_grinder, loyal_grinder permission(s)"
}

{
  "error": "Limit must be between 1 and 100"
}

{
  "error": "Failed to fetch leaderboard"
}

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/grinders/stats/me?month=2026-10",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "grinder_id": "987654321098765432",
  "username": "GrinderPro",
  "month_year": "2026-10",
  "monthly_stats": {
    "total_orders": 37,
    "total_points": 184,
    "avg_points_per_order": 4.97,
    "solo_orders": 33,
    "split_orders": 4,
    "leaderboard_rank": 1,
    "leaderboard_points": 184
  },
  "all_time_stats": {
    "total_orders": 412,
    "total_points": 1980,
    "avg_points_per_order": 4.81,
    "solo_orders": 380,
    "split_orders": 32
  },
  "top_items": [
    {
      "item": "acid",
      "orders_count": 12,
      "total_points": 80,
      "total_amount": 6000
    }
  ],
  "recent_activity": [
    {
      "id": 15408,
      "orderid": 2315,
      "item": "acid",
      "amount": 500,
      "price": 6000000,
      "points_earned": 10,
      "is_split": 0,
      "split_count": 1,
      "completion_date": "2026-10-19 13:40:00",
      "customer_username": "ExampleUser"
    }
  ]
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires trainee, grinder, expert_grinder, loyal_grinder permission(s)"
}

{
  "error": "Invalid grinder ID"
}

{
  "error": "Failed to fetch grinder stats"
}

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/grinders/stats/:grinderid?month=2026-10",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "grinder": {
    "id": "987654321098765432",
    "username": "GrinderPro",
    "avatar": "https://cdn.discordapp.com/avatars/123456789012345678/a1b2c3d4e5f6.png"
  },
  "month_year": "2026-10",
  "stats": {
    "total_orders": 37,
    "total_points": 184,
    "avg_points_per_order": 4.97,
    "solo_orders": 33,
    "split_orders": 4,
    "leaderboard_rank": 1,
    "leaderboard_points": 184
  },
  "top_items": [
    {
      "item": "acid",
      "orders_count": 12,
      "total_points": 80,
      "total_amount": 6000
    }
  ]
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires trainee, grinder, expert_grinder, loyal_grinder permission(s)"
}

{
  "error": "Invalid grinder ID"
}

{
  "error": "Grinder not found"
}

{
  "error": "Failed to fetch grinder stats"
}

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/grinders/archive/:month",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "month_year": "2026-09",
  "top_grinders": [
    {
      "position": 1,
      "grinder_id": "987654321098765432",
      "username": "GrinderPro",
      "avatar": "https://cdn.discordapp.com/avatars/123456789012345678/a1b2c3d4e5f6.png",
      "total_points": 212,
      "total_orders": 41,
      "archived_at": "2026-10-01 00:00:05"
    },
    {
      "position": 2,
      "grinder_id": "876543210987654321",
      "username": "Unknown",
      "avatar": null,
      "total_points": 150,
      "total_orders": 30,
      "archived_at": "2026-10-01 00:00:05"
    }
  ]
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires trainee, grinder, expert_grinder, loyal_grinder permission(s)"
}

{
  "error": "Invalid month format. Use YYYY-MM"
}

{
  "error": "Failed to fetch archive"
}

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/items/",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

No example written for this route yet.

❌ Common Errors

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/items/gotm-points",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "priorities": [
    {
      "priority_name": "normal",
      "points": 0
    },
    {
      "priority_name": "high",
      "points": 1
    }
  ],
  "items": [
    {
      "item": "acid",
      "department": "cargo",
      "gotm_points": 2
    },
    {
      "item": "refinedzinc",
      "department": "cargo",
      "gotm_points": 3
    }
  ]
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Internal server error"
}

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/items/:id",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "item": {
    "id": 25,
    "item": "refinedzinc",
    "cost": 14000,
    "item_limit": 800,
    "department": "cargo",
    "deleted": 0,
    "gotm_points": 3,
    "custom_limit": null,
    "created_at": "2025-07-23 02:38:45"
  },
  "message": "Item retrieved successfully"
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Invalid item ID"
}

{
  "error": "Item not found"
}

{
  "error": "Internal server error"
}

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/items/search/:name",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "items": [
    {
      "id": 25,
      "item": "refinedzinc",
      "cost": 14000,
      "item_limit": 800,
      "department": "cargo",
      "deleted": 0,
      "gotm_points": 3,
      "custom_limit": null,
      "created_at": "2025-07-23 02:38:45"
    }
  ],
  "count": 1,
  "search_term": "zinc",
  "message": "Item search completed successfully"
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Search name is required"
}

{
  "error": "Internal server error"
}

🔧 Axios Example

axios({
  "method": "post",
  "url": "http://localhost:8080/items/",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

No example written for this route yet.

❌ Common Errors

🔧 Axios Example

axios({
  "method": "put",
  "url": "http://localhost:8080/items/:id",
  "headers": {
    "token": "your_api_token_here"
  },
  "data": {
    "cost": 12500,
    "item_limit": 1600
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "item": {
    "id": 10,
    "item": "acid",
    "cost": 12500,
    "item_limit": 1600,
    "department": "cargo",
    "deleted": 0,
    "gotm_points": 2,
    "custom_limit": 3000,
    "created_at": "2025-07-23 02:38:45"
  },
  "updated_by": "ExampleUser",
  "message": "Item updated successfully"
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires owner, manager permission(s)"
}

{
  "error": "Invalid item ID"
}

{
  "error": "Item not found"
}

{
  "error": "Item with this name already exists"
}

{
  "error": "cost must be a non-negative number"
}

{
  "error": "item_limit must be a non-negative number"
}

{
  "error": "gotm_points must be a non-negative number"
}

{
  "error": "custom_limit must be a non-negative number"
}

{
  "error": "No valid fields to update"
}

{
  "error": "Internal server error"
}

🔧 Axios Example

axios({
  "method": "delete",
  "url": "http://localhost:8080/items/:id",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "message": "Item soft deleted successfully",
  "deleted_item": {
    "id": 10,
    "item": "acid",
    "cost": 12000,
    "item_limit": 1500,
    "department": "cargo",
    "deleted": 0,
    "gotm_points": 2,
    "custom_limit": 3000,
    "created_at": "2025-07-23 02:38:45"
  },
  "deleted_by": "ExampleUser"
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires owner, manager permission(s)"
}

{
  "error": "Invalid item ID"
}

{
  "error": "Item not found"
}

{
  "error": "Internal server error"
}

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/live-console/"
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

No example written for this route yet.

❌ Common Errors

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/live-console/stream",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

data: {"timestamp":"2026-10-19T14:02:00.000Z","message":"[SYSTEM] Connected to live console stream","id":"connection"}

data: {"timestamp":"2026-10-19T14:02:11.418Z","message":"[LOG] [orders] Order 15408 accepted by GrinderPro","id":1760882531418.734,"src":"backend","lvl":"info"}

: heartbeat

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: developers only"
}

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/live-console/api?limit=100",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "success": true,
  "total_messages": 1000,
  "returned_messages": 1,
  "messages": [
    {
      "timestamp": "2026-10-19T14:02:11.418Z",
      "message": "[LOG] [orders] Order 15408 accepted by GrinderPro",
      "id": 1760882531418.734,
      "src": "backend",
      "lvl": "info"
    }
  ],
  "buffer_info": {
    "max_size": 1000,
    "current_size": 1000
  }
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: developers only"
}

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/live-console/stats",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "total_connections": 1,
  "buffer_stats": {
    "total_messages": 1000,
    "max_buffer_size": 1000,
    "buffer_usage_percent": 100
  },
  "recent_activity": {
    "last_hour_messages": 412,
    "message_types": {
      "log": 380,
      "error": 3,
      "warn": 9,
      "info": 20,
      "stdout": 0,
      "stderr": 0
    }
  },
  "system_info": {
    "uptime": 86412.53,
    "memory_usage": {
      "rss": 98304000,
      "heapTotal": 52428800,
      "heapUsed": 41943040,
      "external": 2097152,
      "arrayBuffers": 524288
    },
    "node_version": "v20.18.0"
  }
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: developers only"
}

🔧 Axios Example

axios({
  "method": "post",
  "url": "http://localhost:8080/live-console/bot-lines",
  "headers": {
    "token": "your_api_token_here"
  },
  "data": {
    "lines": [
      {
        "t": "2026-10-19T14:02:11.000Z",
        "lvl": "info",
        "msg": "[bot] Posted order 15408 in #orders"
      },
      {
        "lvl": "error",
        "msg": "[bot] Could not DM user 123456789012345678"
      }
    ]
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "success": true,
  "stored": 2
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: bot only"
}

{
  "error": "lines must be a non-empty list"
}

{
  "error": "At most 500 lines per batch"
}

{
  "error": "Each line needs a text msg"
}

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/live-console/history?from=2026-10-18&to=2026-10-19&source=all&errors=0&search=order",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "lines": [
    {
      "t": "2026-10-19T14:02:11.418Z",
      "src": "backend",
      "lvl": "info",
      "msg": "[LOG] [orders] Order 15408 accepted by GrinderPro"
    }
  ],
  "next": "2026-10-18:5121"
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: developers only"
}

{
  "error": "Dates must be real days as YYYY-MM-DD"
}

{
  "error": "The From date must be on or before the To date"
}

{
  "error": "source must be all, backend or bot"
}

{
  "error": "errors must be 0 or 1"
}

{
  "error": "Search must be 200 characters or less"
}

{
  "error": "Bad \"load more\" position"
}

{
  "error": "Could not read the console history"
}

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/live-console/history/download?from=2026-10-18&to=2026-10-19&source=all&errors=0",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

Content-Disposition: attachment; filename="console-2026-10-18_2026-10-19.txt"

2026-10-19T14:02:11.418Z backend info [LOG] [orders] Order 15408 accepted by GrinderPro
...

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: developers only"
}

{
  "error": "Dates must be real days as YYYY-MM-DD"
}

{
  "error": "The From date must be on or before the To date"
}

{
  "error": "source must be all, backend or bot"
}

{
  "error": "errors must be 0 or 1"
}

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/live-console/history/days",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "all": [
    "2026-10-17",
    "2026-10-18",
    "2026-10-19"
  ],
  "errors": [
    "2026-10-18"
  ]
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: developers only"
}

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/manage/orders/search?q=acid&status=pending%2Cin_progress&sort=datetime&dir=desc&page=1",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "orders": [
    {
      "id": 15408,
      "orderid": 2315,
      "customerid": "123456789012345678",
      "grinder": "987654321098765432",
      "item": "acid",
      "amount": 500,
      "priority": "normal",
      "info": "Deliver to my house please",
      "price": 6000000,
      "rawprice": 6000000,
      "discount": 0,
      "points": 10,
      "status": "in_progress",
      "progress": 250,
      "datetime": "1760818302000",
      "lastModified": 1760875200000,
      "acceptance_time": 1760820000000,
      "completed_at": null,
      "created_at": "2026-10-18 20:11:42",
      "customer_username": "ExampleUser",
      "grinders": [
        {
          "id": "987654321098765432",
          "username": "GrinderPro"
        }
      ],
      "deadline": {
        "dueAt": 1762548000000,
        "daysLeft": 19
      },
      "attention": null
    }
  ],
  "page": 1,
  "pages": 1,
  "total": 1
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires staff permission(s)"
}

{
  "error": "Too many requests, try again in 42 seconds",
  "retry_after": 42
}

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/manage/orders/attention",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "orders": [
    {
      "id": 15390,
      "orderid": 2315,
      "customerid": "123456789012345678",
      "grinder": "987654321098765432",
      "item": "acid",
      "amount": 500,
      "priority": "normal",
      "info": "Deliver to my house please",
      "price": 6000000,
      "rawprice": 6000000,
      "discount": 0,
      "points": 10,
      "status": "in_progress",
      "progress": 250,
      "datetime": "1760818302000",
      "lastModified": 1760875200000,
      "acceptance_time": 1759000000000,
      "completed_at": null,
      "created_at": "2026-10-18 20:11:42",
      "customer_username": "ExampleUser",
      "grinders": [
        {
          "id": "987654321098765432",
          "username": "GrinderPro"
        }
      ],
      "deadline": {
        "dueAt": 1760728000000,
        "daysLeft": -2
      },
      "attention": {
        "type": "overdue",
        "days": 2,
        "rank": 1
      }
    }
  ],
  "count": 1
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires staff permission(s)"
}

{
  "error": "Too many requests, try again in 42 seconds",
  "retry_after": 42
}

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/manage/orders/export?status=delivered&from=2026-10-01&to=2026-10-19",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

Content-Disposition: attachment; filename="orders-2026-10-19.csv"

order,item,amount,priority,status,customer,grinder,price,discount,placed,claimed,completed,deadline
15408,acid,500,normal,delivered,ExampleUser,GrinderPro,6000000,0,2026-10-18T20:11:42.000Z,2026-10-18T20:40:00.000Z,2026-10-19T13:40:00.000Z,

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires staff permission(s)"
}

{
  "error": "Too many requests, try again in 42 seconds",
  "retry_after": 42
}

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/manage/orders/stats?period=this_month&department=cargo",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "period": {
    "name": "this_month",
    "from": "2026-10-01",
    "to": "2026-10-19"
  },
  "cards": {
    "placed": 142,
    "delivered": 118,
    "cancelled": 4,
    "valueDelivered": 512400000,
    "avgValue": 4342373,
    "avgToClaimHours": 3.2,
    "avgClaimToCompleteHours": 41.7,
    "avgCompleteToDeliverHours": 6.4,
    "onTimePct": 96.6,
    "onTimeMeasured": 88
  },
  "byMonth": [
    {
      "month": "2026-10",
      "orders": 142,
      "value": 512400000
    }
  ],
  "byDepartment": [
    {
      "department": "cargo",
      "orders": 142,
      "value": 512400000
    }
  ],
  "topItems": [
    {
      "item": "acid",
      "orders": 51,
      "value": 210000000
    }
  ],
  "topCustomers": [
    {
      "user_id": "123456789012345678",
      "username": "ExampleUser",
      "orders": 12,
      "spent": 48000000
    }
  ],
  "topGrinders": [
    {
      "user_id": "987654321098765432",
      "username": "GrinderPro",
      "delivered": 37,
      "avgClaimToCompleteHours": 30.5,
      "onTimePct": 100,
      "onTimeMeasured": 30
    }
  ]
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires staff permission(s)"
}

{
  "error": "Too many requests, try again in 42 seconds",
  "retry_after": 42
}

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/manage/orders/:id(\\d+)",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "order": {
    "id": 15408,
    "orderid": 2315,
    "customerid": "123456789012345678",
    "grinder": "987654321098765432",
    "item": "acid",
    "amount": 500,
    "priority": "normal",
    "info": "Deliver to my house please",
    "price": 6000000,
    "rawprice": 6000000,
    "discount": 0,
    "points": 10,
    "status": "in_progress",
    "progress": 250,
    "datetime": "1760818302000",
    "lastModified": 1760875200000,
    "acceptance_time": 1760820000000,
    "completed_at": null,
    "created_at": "2026-10-18 20:11:42",
    "customer_username": "ExampleUser",
    "grinders": [
      {
        "id": "987654321098765432",
        "username": "GrinderPro"
      }
    ],
    "deadline": {
      "dueAt": 1762548000000,
      "daysLeft": 19
    },
    "attention": null
  }
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires staff permission(s)"
}

{
  "error": "Order not found"
}

{
  "error": "Too many requests, try again in 42 seconds",
  "retry_after": 42
}

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/order-limits/",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

No example written for this route yet.

❌ Common Errors

🔧 Axios Example

axios({
  "method": "post",
  "url": "http://localhost:8080/order-limits/",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

No example written for this route yet.

❌ Common Errors

🔧 Axios Example

axios({
  "method": "put",
  "url": "http://localhost:8080/order-limits/:permission",
  "headers": {
    "token": "your_api_token_here"
  },
  "data": {
    "limit_value": 6
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "message": "Order limit updated successfully",
  "order_limit": {
    "id": 335,
    "permission": "customer",
    "limit_value": 6,
    "created_at": "2025-07-23 02:38:45",
    "updated_at": "2026-10-19 14:10:00"
  },
  "updated_by": "ExampleUser"
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires owner, manager permission(s)"
}

{
  "error": "Invalid permission parameter"
}

{
  "error": "Missing required field: limit_value"
}

{
  "error": "Limit value must be a non-negative number"
}

{
  "error": "Permission level not found"
}

🔧 Axios Example

axios({
  "method": "delete",
  "url": "http://localhost:8080/order-limits/:permission",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "message": "Order limit deleted successfully",
  "deleted_permission": "vip",
  "deleted_by": "ExampleUser"
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires owner, manager permission(s)"
}

{
  "error": "Invalid permission parameter"
}

{
  "error": "Permission level not found"
}

{
  "error": "Cannot delete core permission level. You can only update its limit."
}

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/order-limits/overlimit/limit",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "overlimit_settings": {
    "percentage": 200,
    "fee": -5,
    "updated_at": "2025-07-23 02:38:45"
  },
  "message": "Overlimit settings retrieved successfully"
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

🔧 Axios Example

axios({
  "method": "put",
  "url": "http://localhost:8080/order-limits/overlimit/limit",
  "headers": {
    "token": "your_api_token_here"
  },
  "data": {
    "percentage": 200,
    "fee": -5
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "message": "Overlimit settings updated successfully",
  "overlimit_settings": {
    "percentage": 200,
    "fee": -5,
    "updated_at": "2026-10-19 14:10:00"
  },
  "updated_by": "ExampleUser"
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires owner, manager permission(s)"
}

{
  "error": "Missing required fields: percentage, fee"
}

{
  "error": "Percentage must be a positive number"
}

{
  "error": "Fee must be a valid number (can be negative)"
}

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/orders/",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

No example written for this route yet.

❌ Common Errors

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/orders/me?status=in_progress",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "orders": [
    {
      "id": 15408,
      "orderid": 15408,
      "customerid": "123456789012345678",
      "grinder": "987654321098765432",
      "collector": null,
      "item": "acid",
      "amount": 500,
      "priority": "normal",
      "info": "Deliver to my house please",
      "price": 5400000,
      "rawprice": 6000000,
      "discount": 10,
      "points": 2,
      "status": "in_progress",
      "datetime": "1760818302000",
      "lastModified": 1760820000000,
      "customer_username": "ExampleUser",
      "customer_avatar": "https://cdn.discordapp.com/avatars/123456789012345678/a1b2c3d4e5f6.png",
      "grinder_id": "987654321098765432",
      "grinder_name": "GrinderPro",
      "grinder_avatar": "https://cdn.discordapp.com/avatars/123456789012345678/a1b2c3d4e5f6.png",
      "collector_details": null
    }
  ],
  "customer_details": {
    "customer_id": "123456789012345678",
    "customer_name": "ExampleUser"
  },
  "count": 1,
  "filter": {
    "status": "in_progress"
  }
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires customer, loyal_customer permission(s)"
}

{
  "error": "Invalid customer ID"
}

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/orders/customer/:userId",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "orders": [
    {
      "id": 15408,
      "orderid": 15408,
      "customerid": "123456789012345678",
      "grinder": "987654321098765432",
      "collector": null,
      "item": "acid",
      "amount": 500,
      "priority": "normal",
      "info": "Deliver to my house please",
      "price": 5400000,
      "rawprice": 6000000,
      "discount": 10,
      "points": 2,
      "status": "in_progress",
      "datetime": "1760818302000",
      "lastModified": 1760820000000,
      "customer_username": "ExampleUser",
      "customer_avatar": "https://cdn.discordapp.com/avatars/123456789012345678/a1b2c3d4e5f6.png",
      "grinder_id": "987654321098765432",
      "grinder_name": "GrinderPro",
      "grinder_avatar": "https://cdn.discordapp.com/avatars/123456789012345678/a1b2c3d4e5f6.png",
      "collector_details": null
    }
  ],
  "customer_details": {
    "customer_id": "123456789012345678",
    "customer_name": "ExampleUser"
  }
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires owner, manager, supervisor permission(s)"
}

{
  "error": "Invalid customer ID"
}

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/orders/:id",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "order": {
    "id": 15408,
    "orderid": 15408,
    "customerid": "123456789012345678",
    "grinder": "987654321098765432",
    "collector": null,
    "item": "acid",
    "amount": 500,
    "priority": "normal",
    "info": "Deliver to my house please",
    "price": 5400000,
    "rawprice": 6000000,
    "discount": 10,
    "points": 2,
    "status": "in_progress",
    "datetime": "1760818302000",
    "lastModified": 1760820000000,
    "customer_username": "ExampleUser",
    "customer_avatar": "https://cdn.discordapp.com/avatars/123456789012345678/a1b2c3d4e5f6.png",
    "grinder_id": "987654321098765432",
    "grinder_name": "GrinderPro",
    "grinder_avatar": "https://cdn.discordapp.com/avatars/123456789012345678/a1b2c3d4e5f6.png",
    "collector_details": null
  }
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Invalid order ID"
}

{
  "error": "Order not found"
}

{
  "error": "Access denied"
}

🔧 Axios Example

axios({
  "method": "post",
  "url": "http://localhost:8080/orders/",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

No example written for this route yet.

❌ Common Errors

🔧 Axios Example

axios({
  "method": "post",
  "url": "http://localhost:8080/orders/price-preview",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

No example written for this route yet.

❌ Common Errors

🔧 Axios Example

axios({
  "method": "put",
  "url": "http://localhost:8080/orders/:id",
  "headers": {
    "token": "your_api_token_here"
  },
  "data": {
    "amount": 600,
    "priority": "high",
    "info": "Updated info",
    "reason": "Customer asked"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "message": "Order updated successfully",
  "order": {
    "id": 15408,
    "orderid": 15408,
    "customerid": "123456789012345678",
    "grinder": "987654321098765432",
    "collector": null,
    "item": "acid",
    "amount": 600,
    "priority": "high",
    "info": "Updated info",
    "price": 7128000,
    "rawprice": 7920000,
    "discount": 10,
    "points": 3,
    "status": "in_progress",
    "datetime": "1760818302000",
    "lastModified": 1760820000000,
    "customer_username": "ExampleUser",
    "customer_avatar": "https://cdn.discordapp.com/avatars/123456789012345678/a1b2c3d4e5f6.png",
    "grinder_id": "987654321098765432",
    "grinder_name": "GrinderPro",
    "grinder_avatar": "https://cdn.discordapp.com/avatars/123456789012345678/a1b2c3d4e5f6.png",
    "collector_details": null
  },
  "updated_by": "StaffMember",
  "price_calculation": {
    "item_cost": 12000,
    "amount": 600,
    "raw_price": 7920000,
    "discount_percent": 10,
    "final_price": 7128000
  },
  "points_calculation": {
    "item_points": 2,
    "priority_points": 1,
    "total_points": 3
  }
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires owner, manager, supervisor permission(s)"
}

{
  "error": "Invalid order ID"
}

{
  "error": "Order not found"
}

{
  "error": "Access denied"
}

{
  "error": "Order #15408 is delivered and can't be edited"
}

{
  "error": "Invalid status. Must be one of: pending, in_progress, completed, delivered, cancelled"
}

{
  "error": "Invalid priority. Must be one of: normal, custom, high"
}

{
  "error": "Info cannot be empty"
}

{
  "error": "Invalid item. Item not found in items list"
}

{
  "error": "Current order item not found in items list"
}

{
  "error": "Amount exceeds item limit. Maximum allowed: 1500, requested: 2000"
}

{
  "error": "No valid fields to update"
}

🔧 Axios Example

axios({
  "method": "put",
  "url": "http://localhost:8080/orders/:id/dev-status"
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

No example written for this route yet.

❌ Common Errors

🔧 Axios Example

axios({
  "method": "post",
  "url": "http://localhost:8080/orders/:id/accept",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "message": "Order accepted successfully",
  "order": {
    "id": 15408,
    "orderid": 15408,
    "customerid": "123456789012345678",
    "grinder": "987654321098765432",
    "collector": null,
    "item": "acid",
    "amount": 500,
    "priority": "normal",
    "info": "Deliver to my house please",
    "price": 5400000,
    "rawprice": 6000000,
    "discount": 10,
    "points": 2,
    "status": "in_progress",
    "datetime": "1760818302000",
    "lastModified": 1760820000000,
    "customer_username": "ExampleUser",
    "customer_avatar": "https://cdn.discordapp.com/avatars/123456789012345678/a1b2c3d4e5f6.png",
    "grinder_id": "987654321098765432",
    "grinder_name": "GrinderPro",
    "grinder_avatar": "https://cdn.discordapp.com/avatars/123456789012345678/a1b2c3d4e5f6.png",
    "collector_details": null
  },
  "accepted_by": {
    "user_id": "987654321098765432",
    "username": "GrinderPro"
  },
  "status_change": {
    "from": "pending",
    "to": "in_progress"
  },
  "grinder_capacity": {
    "permission_level": "grinder",
    "limits": {
      "normal_limit": 3,
      "overlimit_limit": 1
    },
    "current_usage": {
      "normal_orders": 2,
      "overlimit_orders": 0
    },
    "remaining": {
      "normal_slots": 1,
      "overlimit_slots": 1
    }
  }
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires trainee, grinder, expert_grinder, loyal_grinder permission(s)"
}

{
  "error": "Rate Limited",
  "message": "You must wait 1 hour between accepting orders to give other grinders a chance.",
  "remainingTime": 2412000,
  "remainingSeconds": 2412,
  "expiresAt": "2026-10-19T15:02:00.000Z"
}

{
  "error": "Invalid order ID"
}

{
  "error": "Order not found"
}

{
  "error": "Grinders cannot accept their own orders"
}

{
  "error": "Cannot accept order. Current status: in_progress. Only pending orders can be accepted."
}

{
  "error": "Order already has grinder(s) assigned",
  "current_grinders": [
    "876543210987654321"
  ],
  "grinder_count": 1
}

{
  "error": "Grinder user not found"
}

{
  "error": "Cannot accept orders: grinder account is blacklisted"
}

{
  "error": "Cannot accept orders: grinder account is globally blacklisted"
}

{
  "error": "Access denied: grinder permission required"
}

{
  "error": "Someone else accepted this order first"
}

{
  "error": "You can't have more than 3 order(s) in progress at once. Mark one as complete (/progress max) first.",
  "grinder_limits": {
    "permission_level": "grinder",
    "normal_limit": 3,
    "overlimit_limit": 1,
    "current_normal_orders": 3,
    "current_overlimit_orders": 0,
    "limit_type_exceeded": "normal",
    "order_priority": "normal",
    "is_overlimit_order": false
  }
}

🔧 Axios Example

axios({
  "method": "post",
  "url": "http://localhost:8080/orders/custom",
  "headers": {
    "token": "your_api_token_here"
  },
  "data": {
    "user_id": "123456789012345678",
    "item": "acid",
    "amount": 2500,
    "info": "Overlimit order approved in ticket #88",
    "approved_overlimit": false
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (201)

{
  "message": "Custom order created successfully",
  "order": {
    "id": 15409,
    "orderid": 15409,
    "customerid": "123456789012345678",
    "grinder": null,
    "collector": null,
    "item": "acid",
    "amount": 2500,
    "priority": "custom",
    "info": "Overlimit order approved in ticket #88",
    "price": 28500000,
    "rawprice": 30000000,
    "discount": 0,
    "points": 2,
    "status": "pending",
    "datetime": "1760818302000",
    "lastModified": 1760818302000,
    "customer_username": "ExampleUser",
    "customer_avatar": "https://cdn.discordapp.com/avatars/123456789012345678/a1b2c3d4e5f6.png",
    "grinder_id": null,
    "grinder_name": null,
    "grinder_avatar": null,
    "collector_details": null
  },
  "created_by": {
    "staff_user_id": "111222333444555666",
    "staff_username": "StaffMember"
  },
  "created_for": {
    "customer_id": "123456789012345678",
    "customer_username": "ExampleUser",
    "is_different_user": true
  },
  "price_calculation": {
    "base_item_cost": 12000,
    "base_total_price": 30000000,
    "overlimit_fee_percent": -5,
    "overlimit_fee_applied_price": 28500000,
    "automatic_fee_applied": true,
    "department": "cargo",
    "amount": 2500,
    "raw_price": 30000000,
    "discount_percent": 0,
    "final_price": 28500000,
    "department_discount_applied": false,
    "pricing_note": "Custom orders only include overlimit fee, no department discounts applied"
  },
  "overlimit_info": {
    "item_limit": 1500,
    "item_overlimit": 3000,
    "overlimit_percentage": 200,
    "overlimit_fee": -5,
    "fee_automatically_applied": true,
    "note": "Custom orders always include overlimit fee regardless of quantity"
  },
  "points_calculation": {
    "item_points": 2,
    "priority": "custom",
    "priority_points": 0,
    "total_points": 2
  }
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires owner, manager, supervisor permission(s)"
}

{
  "error": "YOU NEED A USER ID"
}

{
  "error": "Target user not found"
}

{
  "error": "Cannot create order for blacklisted user"
}

{
  "error": "Missing required fields: item, amount, info"
}

{
  "error": "Invalid item name or amount must be greater than 0"
}

{
  "error": "Info cannot be empty"
}

{
  "error": "Invalid item. Item not found in items list"
}

{
  "error": "This customer can have at most 1 open custom order(s) at a time. Current: 1"
}

{
  "error": "Order amount (5000) is above the custom limit (3000) for acid. That needs an overlimit request first.",
  "limits": {
    "item_limit": 1500,
    "custom_limit": 3000,
    "requested_amount": 5000
  }
}

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/orders/count/order-count",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "total": 1547,
  "by_status": {
    "pending": 23,
    "in_progress": 15,
    "completed": 9,
    "delivered": 1489,
    "cancelled": 11
  },
  "unassigned": 2,
  "details": [
    {
      "status": "cancelled",
      "count": 11
    },
    {
      "status": "completed",
      "count": 9
    },
    {
      "status": "delivered",
      "count": 1489
    },
    {
      "status": "in_progress",
      "count": 15
    },
    {
      "status": "pending",
      "count": 23
    }
  ],
  "message": "Order count retrieved successfully"
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Internal server error"
}

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/orders/stats/me",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "message": "Stats retrieved successfully",
  "stats": {
    "user_info": {
      "user_id": "123456789012345678",
      "username": "ExampleUser",
      "permissions": [
        "member",
        "customer"
      ]
    },
    "customer_stats": {
      "total_orders": 12,
      "total_spent": "48000000.00",
      "order_breakdown": {
        "pending": 1,
        "in_progress": 1,
        "completed": 0,
        "delivered": 10
      }
    },
    "grinder_stats": null,
    "leaderboards": {
      "top_customers": [
        {
          "rank": 1,
          "user_id": "123456789012345678",
          "username": "ExampleUser",
          "avatar": "https://cdn.discordapp.com/avatars/123456789012345678/a1b2c3d4e5f6.png",
          "total_orders": 10,
          "total_spent": "46200000.00"
        }
      ],
      "top_grinders": [
        {
          "rank": 1,
          "user_id": "987654321098765432",
          "username": "GrinderPro",
          "avatar": "https://cdn.discordapp.com/avatars/123456789012345678/a1b2c3d4e5f6.png",
          "total_orders_worked": 37,
          "total_money_made": "160000000.00"
        }
      ]
    },
    "role_progression": {
      "current_permissions": [
        "member",
        "customer"
      ],
      "grinder_progression": {
        "current_earnings_dollars": "0.00",
        "next_milestone": {
          "role": "grinder",
          "threshold": 5000000,
          "threshold_dollars": "5000000.00",
          "threshold_formatted": "$5.0m",
          "remaining": 5000000,
          "remaining_dollars": "5000000.00",
          "remaining_formatted": "$5.0m"
        },
        "has_next_milestone": true
      },
      "customer_progression": {
        "current_spending_dollars": "48000000.00",
        "next_milestone": {
          "role": "loyal_customer",
          "threshold": 10000000000,
          "threshold_dollars": "10000000000.00",
          "threshold_formatted": "$10.0b",
          "remaining": 9952000000,
          "remaining_dollars": "9952000000.00",
          "remaining_formatted": "$10.0b"
        },
        "has_next_milestone": true
      }
    }
  },
  "generated_at": "2026-10-19T14:05:00.000Z"
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Failed to retrieve stats",
  "message": "SQLITE_BUSY: database is locked"
}

🔧 Axios Example

axios({
  "method": "post",
  "url": "http://localhost:8080/orders/role-progression/check",
  "headers": {
    "token": "your_api_token_here"
  },
  "data": {
    "user_id": "123456789012345678"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "message": "Role progression check completed",
  "target_user": {
    "user_id": "123456789012345678",
    "username": "ExampleUser"
  },
  "checked_by": {
    "user_id": "111222333444555666",
    "username": "ManagerUser"
  },
  "progression_results": {
    "user_id": "123456789012345678",
    "grinder_progression": {
      "success": false,
      "reason": "Auto-assign is disabled"
    },
    "customer_progression": {
      "success": false,
      "reason": "Auto-assign is disabled"
    },
    "grinder_specialty_progression": {
      "success": false,
      "reason": "Auto-assign is disabled"
    },
    "customer_specialty_progression": {
      "success": false,
      "reason": "Auto-assign is disabled"
    },
    "any_changes": false
  },
  "current_status": {
    "user_id": "123456789012345678",
    "current_permissions": [
      "member",
      "customer"
    ],
    "grinder": {
      "current_earnings": 0,
      "current_earnings_dollars": "0.00",
      "current_earnings_formatted": "$0",
      "next_milestone": {
        "role": "grinder",
        "threshold": 5000000,
        "threshold_dollars": "5000000.00",
        "threshold_formatted": "$5.0m",
        "remaining": 5000000,
        "remaining_dollars": "5000000.00",
        "remaining_formatted": "$5.0m"
      }
    },
    "customer": {
      "current_spending": 48000000,
      "current_spending_dollars": "48000000.00",
      "current_spending_formatted": "$48.0m",
      "next_milestone": {
        "role": "loyal_customer",
        "threshold": 10000000000,
        "threshold_dollars": "10000000000.00",
        "threshold_formatted": "$10.0b",
        "remaining": 9952000000,
        "remaining_dollars": "9952000000.00",
        "remaining_formatted": "$10.0b"
      }
    }
  },
  "timestamp": "2026-10-19T14:05:00.000Z"
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires owner, manager permission(s)"
}

{
  "error": "user_id is required"
}

{
  "error": "User not found"
}

{
  "error": "Failed to check role progression",
  "message": "SQLITE_BUSY: database is locked"
}

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/orders/role-progression/milestones",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "message": "Role progression milestones retrieved successfully",
  "data": {
    "user_info": {
      "user_id": "123456789012345678",
      "username": "ExampleUser",
      "current_permissions": [
        "member",
        "customer"
      ]
    },
    "current_status": {
      "user_id": "123456789012345678",
      "current_permissions": [
        "member",
        "customer"
      ],
      "grinder": {
        "current_earnings": 0,
        "current_earnings_dollars": "0.00",
        "current_earnings_formatted": "$0",
        "next_milestone": {
          "role": "grinder",
          "threshold": 5000000,
          "threshold_dollars": "5000000.00",
          "threshold_formatted": "$5.0m",
          "remaining": 5000000,
          "remaining_dollars": "5000000.00",
          "remaining_formatted": "$5.0m"
        }
      },
      "customer": {
        "current_spending": 48000000,
        "current_spending_dollars": "48000000.00",
        "current_spending_formatted": "$48.0m",
        "next_milestone": {
          "role": "loyal_customer",
          "threshold": 10000000000,
          "threshold_dollars": "10000000000.00",
          "threshold_formatted": "$10.0b",
          "remaining": 9952000000,
          "remaining_dollars": "9952000000.00",
          "remaining_formatted": "$10.0b"
        }
      }
    },
    "milestone_config": null
  }
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Failed to retrieve milestone information",
  "message": "SQLITE_BUSY: database is locked"
}

🔧 Axios Example

axios({
  "method": "post",
  "url": "http://localhost:8080/referrals/:id/confirm"
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

No example written for this route yet.

❌ Common Errors

🔧 Axios Example

axios({
  "method": "post",
  "url": "http://localhost:8080/referrals/:id/decline"
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

No example written for this route yet.

❌ Common Errors

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/referrals/unposted",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

No example written for this route yet.

❌ Common Errors

🔧 Axios Example

axios({
  "method": "post",
  "url": "http://localhost:8080/referrals/:id/posted",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

No example written for this route yet.

❌ Common Errors

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/referrals/user/:userId"
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

No example written for this route yet.

❌ Common Errors

🔧 Axios Example

axios({
  "method": "post",
  "url": "http://localhost:8080/referrals/give"
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

No example written for this route yet.

❌ Common Errors

🔧 Axios Example

axios({
  "method": "post",
  "url": "http://localhost:8080/referrals/remove"
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

No example written for this route yet.

❌ Common Errors

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/role-progression/config",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "message": "Role progression configuration retrieved successfully",
  "config": {
    "grinder_milestones": [
      {
        "role": "grinder",
        "remove_role": "trainee",
        "threshold": 5000000,
        "threshold_dollars": "5000000.00",
        "threshold_formatted": "$5.0m"
      },
      {
        "role": "expert_grinder",
        "remove_role": "grinder",
        "threshold": 50000000,
        "threshold_dollars": "50000000.00",
        "threshold_formatted": "$50.0m"
      },
      {
        "role": "loyal_grinder",
        "remove_role": null,
        "threshold": 100000000,
        "threshold_dollars": "100000000.00",
        "threshold_formatted": "$100.0m"
      }
    ],
    "customer_milestones": [
      {
        "role": "loyal_customer",
        "remove_role": "customer",
        "threshold": 10000000000,
        "threshold_dollars": "10000000000.00",
        "threshold_formatted": "$10.0b"
      }
    ],
    "settings": {
      "auto_assign": false,
      "preserve_higher_roles": true,
      "log_role_changes": true,
      "webhook_notifications": true
    },
    "permission_hierarchy": [
      "api_edit",
      "head_developer",
      "owner",
      "director",
      "manager",
      "supervisor",
      "developer",
      "staff",
      "vip",
      "loyal_grinder",
      "expert_grinder",
      "grinder",
      "trainee",
      "collector",
      "loyal_customer",
      "customer",
      "booster",
      "gotm",
      "member"
    ]
  }
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Failed to retrieve role progression configuration",
  "message": "Cannot read properties of undefined"
}

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/role-progression/stats",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "message": "Role progression statistics retrieved successfully",
  "statistics": {
    "role_distribution": {
      "api_edit": 0,
      "head_developer": 1,
      "owner": 1,
      "director": 2,
      "manager": 3,
      "supervisor": 4,
      "developer": 2,
      "staff": 9,
      "vip": 0,
      "loyal_grinder": 6,
      "expert_grinder": 12,
      "grinder": 41,
      "trainee": 8,
      "collector": 5,
      "loyal_customer": 37,
      "customer": 812,
      "booster": 22,
      "gotm": 3,
      "member": 1534
    },
    "total_active_users": 2502,
    "role_hierarchy": [
      "api_edit",
      "head_developer",
      "owner",
      "director",
      "manager",
      "supervisor",
      "developer",
      "staff",
      "vip",
      "loyal_grinder",
      "expert_grinder",
      "grinder",
      "trainee",
      "collector",
      "loyal_customer",
      "customer",
      "booster",
      "gotm",
      "member"
    ],
    "users_near_milestones": 100,
    "milestone_configs": {
      "grinder_milestone_count": 3,
      "customer_milestone_count": 1,
      "auto_assign_enabled": false
    }
  },
  "generated_at": "2026-10-19T14:05:00.000Z"
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Failed to retrieve role progression statistics",
  "message": "SQLITE_BUSY: database is locked"
}

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/events/staff?after=1200",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "success": true,
  "data": {
    "events": [
      {
        "type": "discount.set",
        "source": "site",
        "by": "111222333444555666",
        "by_username": "ManagerUser",
        "department": "cargo_perk",
        "value": 20,
        "old_value": 0,
        "event_id": 1201,
        "at": "2026-10-19T13:58:02Z"
      }
    ],
    "latest_id": 1201
  }
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Only specific users are allowed"
}

{
  "success": false,
  "error": "after must be an event_id (a whole number)"
}

{
  "success": false,
  "error": "Internal server error"
}

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/sticky-messages/",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

No example written for this route yet.

❌ Common Errors

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/sticky-messages/:id",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "message": {
    "id": 3,
    "message": "Read the pinned rules before ordering!",
    "channel_id": "741274180971921400",
    "last_message_id": "1298765432109876543",
    "created_at": "2026-09-02 17:40:11",
    "updated_at": "2026-10-19 13:00:00"
  }
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Sticky message not found"
}

{
  "error": "Internal server error"
}

🔧 Axios Example

axios({
  "method": "post",
  "url": "http://localhost:8080/sticky-messages/",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

No example written for this route yet.

❌ Common Errors

🔧 Axios Example

axios({
  "method": "put",
  "url": "http://localhost:8080/sticky-messages/:id",
  "headers": {
    "token": "your_api_token_here"
  },
  "data": {
    "last_message_id": "1298765432109876543"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "message": "Sticky message updated successfully",
  "sticky_message": {
    "id": 3,
    "message": "Read the pinned rules before ordering!",
    "channel_id": "741274180971921400",
    "last_message_id": "1298765432109876543",
    "created_at": "2026-09-02 17:40:11",
    "updated_at": "2026-10-19 13:00:00"
  },
  "updated_by": "ManagerUser"
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires owner, manager permission(s)"
}

{
  "error": "Sticky message not found"
}

{
  "error": "message cannot be empty"
}

{
  "error": "message cannot be longer than 1000 characters"
}

{
  "error": "channel_id cannot be empty"
}

{
  "error": "No valid fields to update"
}

{
  "error": "Internal server error"
}

🔧 Axios Example

axios({
  "method": "delete",
  "url": "http://localhost:8080/sticky-messages/:id",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "message": "Sticky message deleted successfully",
  "deleted_message": {
    "id": 3,
    "message": "Read the pinned rules before ordering!",
    "channel_id": "741274180971921400"
  },
  "deleted_by": "ManagerUser"
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "error": "Forbidden: Requires owner, manager permission(s)"
}

{
  "error": "Sticky message not found"
}

{
  "error": "Internal server error"
}

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/ticket-files/:public_id"
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

<binary file data>
Content-Type: image/png
Content-Disposition: inline; filename="screenshot.png"

❌ Common Errors

{
  "error": "File not found"
}

{
  "error": "File expired (ticket files are kept for 90 days)"
}

{
  "error": "File expired"
}

{
  "error": "Internal server error"
}

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/tickets/",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

No example written for this route yet.

❌ Common Errors

🔧 Axios Example

axios({
  "method": "post",
  "url": "http://localhost:8080/tickets/",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

No example written for this route yet.

❌ Common Errors

🔧 Axios Example

axios({
  "method": "get",
  "url": "http://localhost:8080/tickets/me?status=in_progress",
  "headers": {
    "token": "your_api_token_here"
  }
})
  .then(response => {
    console.log('Success:', response.data);
  })
  .catch(error => {
    console.log('Error:', error.response?.data);
  });

✅ Success Response (200)

{
  "success": true,
  "data": {
    "tickets": [
      {
        "id": 88,
        "title": "Order processing delay",
        "description": "My order #15408 has been in progress for 3 days.",
        "status": "in_progress",
        "priority": "normal",
        "category": "orders",
        "created_by": "123456789012345678",
        "assigned_to": "111222333444555666",
        "created_at": "2026-10-18 19:02:11",
        "updated_at": "2026-10-19 09:15:40",
        "closed_at": null,
        "closed_by": null,
        "discord_channel_id": "1298765432109876543",
        "created_by_username": "ExampleUser",
        "assigned_to_username": "StaffMember",
        "message_count": 2,
        "unread_staff_messages": 1,
        "messages": [
          {
            "id": 501,
            "ticket_id": 88,
            "message": "My order #15408 has been in progress for 3 days.",
            "sent_by": "123456789012345678",
            "is_staff_response": 0,
            "created_at": "2026-10-18 19:02:11",
            "is_internal": 0,
            "source": "site",
            "sent_by_username": "ExampleUser",
            "sent_by_permissions": "[\"member\",\"customer\"]"
          },
          {
            "id": 502,
            "ticket_id": 88,
            "message": "Thanks, I have pinged the grinder. It should be done today.",
            "sent_by": "111222333444555666",
            "is_staff_response": 1,
            "created_at": "2026-10-19 09:15:40",
            "is_internal": 0,
            "source": "discord",
            "sent_by_username": "StaffMember",
            "sent_by_permissions": "[\"member\",\"staff\"]"
          }
        ]
      }
    ],
    "count": 1,
    "summary": {
      "open": 0,
      "in_progress": 1,
      "closed": 3
    },
    "staff_responders": [
      {
        "user_id": "111222333444555666",
        "username": "StaffMember",
        "permissions": [
          "member",
          "staff"
        ]
      }
    ]
  }
}

❌ Common Errors

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden: User is blacklisted"
}

{
  "success": false,
  "error": "Internal server error"
}