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

# Zero cable position

`PUT /api/v1/reel/encoder/zero`

Resets the cable encoder position to zero meters.

This operation establishes a new reference point for cable position measurements by setting the current encoder reading to zero. Use this endpoint when the cable is at a known reference position and you want to reset the position counter.

## Response `200`

Successful Response

- ZeroCablePositionResponse — Response for cable encoder zero operations. Resets the cable encoder position to zero meters at the current cable location. This establishes a new reference point for all subsequent position measurements.
  - `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
- `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)