Point your AI to this file to start the vibe coding. NB! This doc is AI generated and not verified.

TODO: Make a skill.md for API v3

Overview

The Handy API v2 is the REST API for The Handy by Ohdoki — a connected automatic stroker. The API allows you to:Maybe

• Control device motion (speed, position, stroke zone)
• Synchronize and play scripts (FunScript/CSV)
• Read device info and status
• Manage firmware updates
• Synchronize time with the HandyFeeling server for coordinated playback

Base URL (production): https://www.handyfeeling.com/api/handy/v2

Authentication

All device-specific endpoints require:

X-Connection-Key: <your_connection_key>

The connection key is the unique identifier for the device found in the Handy app or printed on the device. It is a short alphanumeric string (e.g., A1B2C3).

Exception: /servertime does NOT require a connection key.

Server Environments

Use the env var HANDY_API_BASE_URL in your apps to switch environments.