This repository is auto synced and readonly

Dambel API Documentation

Welcome to the Dambel API documentation. This guide provides a comprehensive, organized overview of all available API endpoints, grouped by resource and version. Use the navigation below to quickly find the endpoint you need.

---

Table of Contents

• Authentication
• Gyms
• Users
• Training
• AI
• Tracker
• Media
• Ratings
• Posts
• Comments
• Payments
• Notifications
• Reports
• Chats
• Admin
• Global Schemas & Errors

---

Usage Tips

• All endpoints are under /api/v1
• Click endpoint names to view detailed documentation, including parameters, permissions, request/response examples, and error handling.
• Resource endpoints are grouped for clarity. Nested resources are indented.
• Refer to Global Schemas & Errors for shared response formats and error types.
• Production API is hosted on https://api.dambel.io/api/v1 and Staging is hosted on https://api.staging.dambel.io/api/v1

---

Authentication

• POST /api/v1/auth/login
• POST /api/v1/auth/register
• GET /api/v1/auth/me
• PUT /api/v1/auth/me
• PUT /api/v1/auth/change-password
• POST /api/v1/auth/reset-password/request
• POST /api/v1/auth/reset-password/reset
• GET /api/v1/auth/verify-email/{user}

Gyms

• GET /api/v1/gyms
• POST /api/v1/gyms
• /api/v1/gyms/{gym-id}
  • PUT
  • DELETE
  • GET /working-periods
  • POST /working-periods
  • /working-periods/{working-period-id}
    • PUT
    • DELETE
  • GET /equipment
  • POST /equipment
  • /equipment/{gym-equipment-id}
    • PUT
    • DELETE
  • GET /equipment/compare/{workout-plan-id}
  • GET /plans
  • POST /plans
  • /plans/{plan-id}
    • PUT
    • DELETE
  • GET /buffet-items
  • POST /buffet-items
  • /buffet-items/{buffet-item-id}
    • PUT
    • DELETE
  • GET /admins
  • POST /admins
  • /admins/{admin-id}
    • PUT
    • DELETE
  • POST /subscriptions/subscribe/{plan-id}
  • GET /subscriptions/my-subscriptions
  • POST /subscriptions/checkin/{subscription-id}
  • POST /subscriptions/checkout/{subscription-id}
  • DELETE /subscriptions/delete-checkin/{subscription-id}/{checkin-id}
  • GET /subscriptions/manage
  • POST /subscriptions/manage
  • /subscriptions/manage/{gym-subscription-id}
    • PUT
    • DELETE
  • GET /data/peak-hours
  • GET /data/search-stats

Users

• GET /api/v1/users
• POST /api/v1/users
• /api/v1/users/{user-id}
  • PUT
  • DELETE
  • POST /attach-role/{role-id}
  • POST /detach-role/{role-id}
  • GET /championships
  • POST /championships
  • /championships/{championship-id}
    • PUT
    • DELETE
  • GET /education
  • POST /education
  • /education/{education-id}
    • PUT
    • DELETE

Training

• GET /api/v1/training/services
• POST /api/v1/training/services/{user-id}
• /api/v1/training/services/{training-service-id}
  • PUT
  • DELETE
• GET /api/v1/training/services/{training-service-id}/data/search-stats
• GET /api/v1/training/trainees
• POST /api/v1/training/trainees
• /api/v1/training/trainees/{trainee-id}
  • PUT
• GET /api/v1/training/diet-plans
• POST /api/v1/training/diet-plans
• /api/v1/training/diet-plans/{diet-plan-id}
  • PUT
  • DELETE
  • GET /meals
  • POST /meals
  • /meals/{meal-id}
    • PUT
    • DELETE
  • GET /supplements
  • POST /supplements
  • /supplements/{supplement-id}
    • PUT
    • DELETE
• GET /api/v1/training/workout-plans
• POST /api/v1/training/workout-plans
• /api/v1/training/workout-plans/{workout-plan-id}
  • PUT
  • DELETE
  • GET /sessions
  • POST /sessions
  • /sessions/{session-id}
    • PUT
    • DELETE
    • GET /exercises
    • POST /exercises
    • /exercises/{exercise-id}
      • PUT
      • DELETE

AI

• GET /api/v1/ai/threads
• POST /api/v1/ai/threads
• /api/v1/ai/threads/{thread-id}
  • DELETE
  • GET /messages
  • POST /messages
  • /messages/{message-id}
    • DELETE

Tracker

• GET /api/v1/tracker/data/averages
• GET /api/v1/tracker/data/charts
• GET /api/v1/tracker/data/records
• GET /api/v1/tracker/data/today
• GET /api/v1/tracker/wakeups
• POST /api/v1/tracker/wakeups
• /api/v1/tracker/wakeups/{tracker-wakeup-id}
  • PUT
  • DELETE
• GET /api/v1/tracker/sleeps
• POST /api/v1/tracker/sleeps
• /api/v1/tracker/sleeps/{tracker-sleep-id}
  • PUT
  • DELETE
• GET /api/v1/tracker/weights
• POST /api/v1/tracker/weights
• /api/v1/tracker/weights/{tracker-weight-id}
  • PUT
  • DELETE
• GET /api/v1/tracker/supplements
• POST /api/v1/tracker/supplements
• /api/v1/tracker/supplements/{tracker-supplement-id}
  • PUT
  • DELETE
• GET /api/v1/tracker/waters
• POST /api/v1/tracker/waters
• /api/v1/tracker/waters/{tracker-water-id}
  • PUT
  • DELETE
• GET /api/v1/tracker/meals
• POST /api/v1/tracker/meals
• /api/v1/tracker/meals/{tracker-meal-id}
  • PUT
  • DELETE
• GET /api/v1/tracker/workouts
• POST /api/v1/tracker/workouts
• /api/v1/tracker/workouts/{tracker-workout-id}
  • PUT
  • DELETE
  • GET /sets
  • POST /sets
  • /sets/{tracker-workout-set-id}
    • PUT
    • DELETE
• GET /api/v1/tracker/shares
• POST /api/v1/tracker/shares
• /api/v1/tracker/shares/{shared-tracker-id}
  • PUT
  • DELETE

Media

• POST /api/v1/media
• /api/v1/media/{media-id}
  • DELETE
  • GET

Ratings

• GET /api/v1/ratings
• POST /api/v1/ratings
• GET /api/v1/ratings/all
• DELETE /api/v1/ratings/{rating-id}

Posts

• GET /api/v1/posts
• GET /api/v1/posts/blog
• POST /api/v1/posts
• /api/v1/posts/{post-id}
  • PUT
  • DELETE
• GET /api/v1/posts/{post-id}/data/search-stats

Comments

• GET /api/v1/comments
• POST /api/v1/comments
• /api/v1/comments/{comment-id}
  • PUT
  • DELETE

Payments

• GET /api/v1/payments
• POST /api/v1/payments/deposit
• POST /api/v1/payments/verify-deposit
• GET /api/v1/payments/balance
• GET /api/v1/payments/prices
• POST /api/v1/payments/withdrawal
• POST /api/v1/payments/buy-premium
• POST /api/v1/payments/boost
• GET /api/v1/payments/data/stats
• GET /api/v1/payments/data/chart

Notifications

• GET /api/v1/notifications
• POST /api/v1/notifications/mark-read/{notification-id?}

Reports

• GET /api/v1/reports
• POST /api/v1/reports
• /api/v1/reports/{report-id}
  • PUT
  • DELETE

Chats

• GET /api/v1/chats
• POST /api/v1/chats
• /api/v1/chats/{chat-id}
  • PUT
  • DELETE
  • GET /messages
  • POST /messages
  • /messages/{message-id}
    • PUT
    • DELETE

Admin

• GET /api/v1/admin/stats
• GET /api/v1/admin/roles
• POST /api/v1/admin/roles
• /api/v1/admin/roles/{role-id}
  • PUT
  • DELETE
• GET /api/v1/admin/permissions
• GET /api/v1/admin/brands
• POST /api/v1/admin/brands
• /api/v1/admin/brands/{brand-id}
  • PUT
  • DELETE
• GET /api/v1/admin/countries
• POST /api/v1/admin/countries
• /api/v1/admin/countries/{country-id}
  • PUT
  • DELETE
• GET /api/v1/admin/states
• POST /api/v1/admin/states
• /api/v1/admin/states/{state-id}
  • PUT
  • DELETE
• GET /api/v1/admin/cities
• POST /api/v1/admin/cities
• /api/v1/admin/cities/{city-id}
  • PUT
  • DELETE
• GET /api/v1/admin/majors
• POST /api/v1/admin/majors
• /api/v1/admin/majors/{major-id}
  • PUT
  • DELETE
• GET /api/v1/admin/exercises
• POST /api/v1/admin/exercises
• /api/v1/admin/exercises/{exercise-id}
  • PUT
  • DELETE
• GET /api/v1/admin/equipment
• POST /api/v1/admin/equipment
• /api/v1/admin/equipment/{equipment-id}
  • PUT
  • DELETE
• GET /api/v1/admin/supplements
• POST /api/v1/admin/supplements
• /api/v1/admin/supplements/{supplement-id}
  • PUT
  • DELETE

Global Schemas & Errors

• Pagination data
• Broadcasting
• Localization
• Validation errors
• Authentication errors
• Server errors
• Rate-limit errors
• Method-not-allowed errors
• Not-found errors
• Permission errors