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

# Unwind reel motor

`PUT /api/v1/reel/unwind`

Initiates reel motor unwind operation to extend cable at the specified speed percentage.

Unwind operations deploy cable from the reel drum and are subject to safeguard limits including maximum cable length protection and emergency stop status. The motor maintains the specified speed until stopped, interrupted by safeguards, or superseded by another command.

Safety considerations include monitoring cable tension and ensuring the maximum cable length setting prevents over-extension beyond operational limits.

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

- UnwindResponse — Response for unwind 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)