VORQ DocsGuides
Cancel a job
Cancel an open job with a signed Cancel message.
The owner can cancel a job while it is still open. Once a provider has claimed it, cancelling is refused and the job runs to settlement, failure or reclaim.
Cancelling needs no session. The authority is the owner's signature.
1. Sign Cancel
Sign this EIP-712 message with the order's owner wallet:
| Domain | { "name": "VORQ Jobs", "version": "2", "chainId": <chain_id>, "verifyingContract": <job_registry> } |
| Type | Cancel(bytes32 jobId,uint64 issuedAt) |
| Message | { "jobId": <job_id>, "issuedAt": <now, unix seconds> } |
issuedAt must be within 600 seconds of the coordinator's clock, so sign right before sending.
2. Send it
curl -s -X POST "$VORQ/v1/jobs/$JOB_ID/cancel" \
-H 'content-type: application/json' \
-d "{\"issued_at\": $ISSUED_AT, \"signature\": \"$CANCEL_SIG\"}"{ "job_id": "0x…", "tx_hash": "0x…" }The job then reads status: "cancelled". No payment was collected: funds move only at claim.
Cancelling a job that has already settled or ended succeeds without changing anything, so a retry of a cancel you could not observe is safe. An open job past its expires_at can still be cancelled.
When it is refused
| Answer | Cause |
|---|---|
409, code: "NotCancellable" | A provider has claimed the job. |
409, code: "NotTheOwner" | The signature does not recover to the job's owner, or the job does not exist. |
409, code: "StaleOp" | issued_at is more than 600 seconds from the node's clock. Sign again. |
409, other code | The contract refused it; code is the contract error name. |