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

# Update reel motor speed

`PUT /api/v1/reel/speed`

Updates the motor speed percentage for ongoing wind or unwind operations while maintaining current direction.

Speed updates allow real-time adjustment of motor velocity without interrupting the current operation. The new speed setting is applied immediately if the motor is currently moving, or stored for the next movement command if the motor is stopped.

This endpoint preserves the current motor direction (wind/unwind) and only modifies the velocity component of the operation.

## 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

- SpeedUpdateResponse — Response for speed update 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)