← Back to Support

Local API Reference

Your Annaboto runs a local HTTP server that exposes a REST API for monitoring, configuration, and control. This lets you build your own tools, scripts, or integrations — no cloud required.

Base URL: http://<device-ip>:8080/annaboto/api/

Your device IP depends on your network. Find it in the Annaboto app under Settings, or check your router's connected devices list.

Interactive API Explorer

The device includes a built-in Swagger UI where you can browse and test all available endpoints directly in your browser:

http://<device-ip>:8080/annaboto/api/ui/

Open this URL while connected to the same network as your Annaboto to explore the full API interactively.

API Endpoints

The API is organized into the following groups. Click through for detailed documentation, request/response formats, and examples.

📊 Device Status

Real-time device state — sensor readings, grow progress, plant info, and operational status.

  • GET /status — Full device state snapshot

📈 Sensor History

Historical temperature, humidity, and water level data. Supports raw readings and pre-computed hourly summaries for charting.

  • GET /sensor_history — Raw sensor readings
  • GET /sensor_history/summary — Hourly averages for full-grow charts

🌱 Recipe Management

Read and customize grow recipes — nutrient schedules, light settings, and growth parameters across 16 weeks.

  • GET /recipe_base — Default recipe template
  • GET /recipe_overlay/{name} — Current custom recipe
  • PUT /recipe_overlay — Save a custom recipe

⚙️ Device Configuration & Control

WiFi setup, user preferences, version info, and device control commands.

  • PUT /config/wifi — Set WiFi credentials
  • PUT /config/user — Update user settings (plant name, etc.)
  • GET /version — Device firmware version
  • POST /control/reload — Reload device configuration

📸 Media (Photos & Timelapses)

Access the latest plant photos and timelapse videos captured by your Annaboto's camera.

  • GET /pictures/latest — Latest plant photo
  • GET /timelapses/latest — Latest timelapse video

General Notes