---
title: "Wind reel motor"
method: PUT
path: "/api/v1/reel/wind"
tags: ["v1", "reel-movement"]
---

# Wind reel motor

`PUT /api/v1/reel/wind`

Initiates reel motor wind operation to retract cable at the specified speed percentage.

Wind operations pull cable back onto the reel drum and are subject to safeguard limits including zero point protection and emergency stop status. The motor maintains the specified speed until stopped, interrupted by safeguards, or superseded by another command.

Safety considerations include ensuring the operational area is clear of personnel and verifying that the zero point gutter setting provides adequate safety margin for automatic stopping.

## Request body

- ReelMotorControlRequest — Request data for reel motor control operations (wind, unwind, speed update).
  - `speed` integer, required — Motor speed as percentage of maximum rated speed. Valid range is 0-100 where 0 stops the motor and 100 provides maximum speed. Speed settings are applied immediately for active operations or stored for subsequent movement commands.

## Response `200`

Successful Response

- WindResponse — Response for wind motor operations.
  - `action` string, required — The action that was requested or performed by the endpoint
  - `error` boolean, required — Indicates whether the operation encountered an error
  - `error_msgs` string[] — List of error messages if the operation failed
  - `result` ReelMotorControlResult, required — Result data for motor control operations.
    - `speed` integer, required — Current or target motor speed percentage after operation. Represents the motor speed setting following the requested operation. For stop operations, this will be 0. For speed updates, this reflects the new target speed.

## Other responses

- `401` — Could not validate credentials
- `403` — Setup required before using this endpoint
- `422` — Validation Error
- `500` — Internal server error

---

[API](https://skmtc.net/reach-systems-tech/apis/reelapi-v1.md) · [All operations](https://skmtc.net/reach-systems-tech/apis/reelapi-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/reach-systems-tech/reelapi-v1/versions/1dd366a9c6a3/schema)