---
title: "Set cable position"
method: PUT
path: "/api/v1/reel/encoder/count"
tags: ["v1", "cable-position"]
---

# Set cable position

`PUT /api/v1/reel/encoder/count`

Sets the cable encoder position to a specific value in meters.

This operation manually assigns a specific position value to the current encoder reading, useful for correcting position readings or setting the encoder to match a known cable length. The position can be positive or negative depending on your reference system.

## Request body

- SetEncoderCountRequest — Request data for setting cable encoder position to a specific value.
  - `cable_position` number, required — Desired cable position in meters. Sets the encoder reading to this specific value. Can be positive or negative depending on your reference system. Use when the actual cable position is known and differs from current encoder reading.

## Response `200`

Successful Response

- SetEncoderCountResponse — Response for cable encoder position setting operations. Sets the cable encoder position to a specified value in meters. Useful for correcting position readings when the actual cable position is known.
  - `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` CablePositionOperationResult, required — Result data for cable position operations that modify encoder position.
    - `new_position` number, required — The updated encoder position in meters after the operation. Represents the cable position following the requested operation. Positive values typically indicate cable extended from the reel, while the zero point serves as the operational reference.

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