Discard an instruction

Withdraw a pending instruction before it is confirmed. It answers 204 with no body, and the code cannot be used again.

DELETE

/confirmations/{code}LIVE

No scope of its ownConnected apps only

Path parameter

REQUIRED

codestring

The cnf_ code a connected app’s write returned. URL-encode it as a single path segment.

Response fields

204 No Content

No body. The X-Request-Id header is still sent.

Errors

A code that is unknown or was staged by another app, customer or market returns CONFIRMATION_NOT_FOUND / 404. A code that is no longer pending — executing, completed, failed, expired or already discarded — returns CONFIRMATION_EXPIRED / 410. A code past its 15 minutes is marked expired only when it is next read or confirmed, so until then discarding it still answers 204. Missing or invalid credentials return AUTH_INVALID_CREDENTIALS / 401. View all error codes →

UP NEXT Writes & confirmations

REQUEST EXAMPLE Choose your language

cancel-confirmation.php

<?php

$baseUrl = 'https://us.cruworldwine.com/api/v1';
$code = 'cnf_5DT4rt0U-KyEjnQUzHPTGKw86dNTZ8uZud_zQFdTa-k';

$curl = curl_init($baseUrl . '/confirmations/' . rawurlencode($code));
curl_setopt_array($curl, [
    CURLOPT_CUSTOMREQUEST => 'DELETE',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('CRU_ACCESS_TOKEN'),
        'Accept: application/json',
    ],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_FOLLOWLOCATION => false,
    CURLOPT_TIMEOUT => 30,
]);

$body = curl_exec($curl);
if (curl_getinfo($curl, CURLINFO_RESPONSE_CODE) !== 204) {
    $payload = json_decode($body, true);
    throw new RuntimeException($payload['errors'][0]['code'] ?? 'Unexpected response');
}
echo 'Discarded' . PHP_EOL;

RESPONSE EXAMPLE application/json

(no body)

Prices are decimal amounts in the market’s currency.
30780.5 GBP = £30,780.50. Learn more ↗

Not testable here. Confirmations need a connected app’s token; the console sends partner credentials.

Documented from the API as built on 15 October 2026.

Discard an instruction

Path parameter

Response fields

Errors

API credentials

Request API access