Verify

Cancel Verification

Stop a verification that has not finished.

A cancelled run is not charged and produces no verification: nothing is saved. Work already under way when you cancel (a model call in flight) is not billed to you, and the run itself stops at its next step. A run waiting on POST /verify/{task_id}/select is cancelled too.

The call is safe to repeat and answers 200 whatever the state, so a client that gives up never has to handle an error for losing a race:

  • cancelled: true, status: "cancelled": the run is cancelled, by this call or an earlier one.
  • cancelled: false, status: "completed": it finished first. The verification exists and was charged as usual.
  • cancelled: false, status: "failed": it had already failed.

GET /verify/status/{task_id} answers cancelled from then on, and a webhook_url receives verification.cancelled (a 2026-05-13 submission receives verification.failed with failure_class: "cancelled").

Another account's task, an unknown one, and a web task answer 404. A task that is a /review's deep check answers 409 use_review_cancel: cancel the review (POST /reviews/{review_id}/cancel), which cancels everything in it.

Versions. 200: 2026-10-11 receives CancelOut, 2026-05-13 receives CancelOutLegacy; default: 2026-10-11 receives ErrorOut, 2026-05-13 receives ErrorOutLegacy.

post/api/v1/verify/{task_id}/cancel

Request

  • Base URL: https://lenz.io
  • URL: https://lenz.io/api/v1/verify/{task_id}/cancel
  • Auth: HTTP bearer

Path parameters

task_idstring required

Headers

X-Lenz-API-Versionstring
Example:2026-05-13

The API version to answer in, as a date. A date before 2026-10-11 (or a value that is not a date) gets 2026-05-13. See https://lenz.io/docs/api-versions.

Response

OK

task_idstring required
cancelledboolean required
status'processing' | 'needs_input' | 'completed' | 'failed' | 'cancelled' required

Changes

No recorded changes to this operation across all 1 revision of this API.