---
title: "Cancel PID Controller Calibration"
method: POST
path: "/api/v1/reel/pid-calibration/cancel"
tags: ["v1", "pid-calibration"]
---

# Cancel PID Controller Calibration

`POST /api/v1/reel/pid-calibration/cancel`

Cancels an active PID controller calibration process for the active hold position feature. 
This endpoint immediately terminates any ongoing calibration routine and returns the system 
to normal operational mode.

The cancellation stops the automated tuning sequence and preserves any previously configured 
PID parameters. Use this endpoint if the calibration process needs to be interrupted due to 
operational requirements or safety concerns. The system will safely halt all calibration 
movements and restore normal motor control functionality.

Cancellation requires the same system prerequisites as starting calibration, including an 
installed motor position encoder and enabled active hold position feature. After cancellation, 
the system returns to its previous PID configuration state without applying any partially 
completed calibration results.

## Response `200`

Successful Response

- CancelPIDCalibrationResponse — Response from cancelling active PID controller calibration
  - `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` PIDCalibrationResult, required — PID calibration operation result containing current calibration status
    - `calibrating` boolean, required — Indicates whether the PID controller is currently in calibration mode. True when PID calibration is active and tuning parameters, False when calibration is completed, cancelled, or not running.

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