Cancel a Box Sign request - Box Dev Docs

A Box Sign request that has not yet been signed or declined can be cancelled using the cancel Box Sign request endpoint. Any outstanding signers cannot sign the document. Only the requester (the user who created the request) can cancel it. You can’t cancel a request that was declined, fully signed, or where the document is still converting.

Cancel a request

curl -i -X POST "https://api.box.com/2.0/sign_requests/<SIGN_REQUEST_ID>/cancel" \
     -H "authorization: Bearer <ACCESS_TOKEN>"

await client.signRequests.cancelSignRequest(createdSignRequest.id!);

client.sign_requests.cancel_sign_request(created_sign_request.id)

await client.SignRequests.CancelSignRequestAsync(signRequestId: NullableUtils.Unwrap(createdSignRequest.Id));

try await client.signRequests.cancelSignRequest(signRequestId: createdSignRequest.id!)

client.getSignRequests().cancelSignRequest(createdSignRequest.getId())

BoxSignRequest signRequest = new BoxSignRequest(api, id);
BoxSignRequest.Info signRequestInfo = signRequest.getInfo();

signRequestInfo.cancel();

sign_request = client.sign_request(sign_request_id='12345')
cancelled_sign_request = sign_request.cancel()
print(f'Cancelled Sign Request status is {cancelled_sign_request.status}')

BoxSignRequest cancelledSignRequest = await client.SignRequestsManager.CancelSignRequestAsync("12345");

const signRequest = await client.signRequests.cancelById({
	sign_request_id: 12345,
});
console.log(`Sign request id ${sr.id} cancelled`);

Provide a cancellation reason

The request body accepts an optional reason field describing why the request was cancelled.

cURL

curl -i -X POST "https://api.box.com/2.0/sign_requests/<SIGN_REQUEST_ID>/cancel" \
     -H "authorization: Bearer <ACCESS_TOKEN>" \
     -H "content-type: application/json" \
     -d '{ "reason": "Project cancelled" }'

The v10 SDK methods shown above cancel a request without sending a body, so call the endpoint directly to set a cancellation reason.

Control signer notifications

Signer notifications are configured per signer when the request is created, not when it is cancelled, so the cancel endpoint takes no notification parameters. To turn the default emails off and send your own, see How signers get the request.

Last modified on September 18, 2026