---
title: "Move to specific cable position"
method: PUT
path: "/api/v1/reel/go-to-position"
tags: ["v1", "reel-movement"]
---

# Move to specific cable position

`PUT /api/v1/reel/go-to-position`

Commands the reel motor to move to a specific cable position using encoder feedback for precise positioning.

Go-to operations automatically determine the required direction (wind or unwind) based on current position and target position. The system uses encoder calibration data to convert position measurements to motor movements with high accuracy.

Requires a properly calibrated encoder system and is subject to all standard safeguards including maximum cable length and zero point protection. Optional speed parameter allows control over positioning velocity.

## Request body

- GoToRequest — Request data for precision cable positioning operations.
  - `target_position` number, required — Target cable position in meters from the established zero point. Specifies the desired final cable position using the current encoder calibration. Position must be within operational limits defined by maximum cable length and zero point gutter settings.
  - `speed` integer, nullable — Optional speed percentage for positioning operation. If specified, the motor moves to target position at this speed. If None, uses the current motor speed setting. Slower speeds provide more precise positioning but longer operation time.

## Response `200`

Successful Response

- GoToResponse — Response for cable positioning operations. Provides position feedback and movement direction for go-to operations. Includes current and target positions with calculated movement direction for monitoring positioning progress.
  - `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` GoToResult, required — Result data for go-to positioning operations.
    - `target_position` number, required — The requested target position in meters. Confirms the position target that was specified in the request. Motor will move toward this position using encoder feedback for precise positioning.
    - `current_position` number, required — Current cable position in meters at operation start. Position reading from encoder at the time the go-to command was initiated. Provides reference point for calculating required movement direction and distance.
    - `reel_direction` string, required — Determined movement direction to reach target position. Automatically calculated based on current and target positions. WIND moves toward zero (retracts cable), UNWIND moves away from zero (extends cable).

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