Skip to navigation

Cancel a colour Assessment

No body and no Idempotency-Key: the operation is naturally idempotent. A queued or running assessment is cancelled now, and a measurement already under way writes nothing. One already cancelled answers itself; a finished one answers 409 ASSESSMENT_NOT_CANCELLABLE. Requires the digitisation.write scope, which your account operator provisions; served only where digitisation is enabled for your environment.

Authentication

X-API-Keystring

API key for one environment of your account. Keep server-side; never expose in browser clients.

Path parameters

assessment_idstringRequired

Response

The assessment, cancelled (now, or by an earlier request)

attemptsinteger>=0
colour_contract_versioninteger
created_atdatetime
failure_codeenum or null
Allowed values:
finished_atdatetime or null
idstring
outputobject or null

The canonical result; result_sha256 is its digest.

output_sha256string or nullformat: "^[0-9a-f]{64}$"
requestobject

The canonical request; request_sha256 is its digest.

request_sha256stringformat: "^[0-9a-f]{64}$"
started_atdatetime or null
statusenum
Allowed values:

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error
503
Service Unavailable Error