Skip to content

DocuSign: Deletes a specific version of a clickwrap

DocuSign click.clickClickwrapVersionsDeleteClickwrapVersion: arguments, response, policy and SDK examples.

← Click operations · Get started

Operation docusign.click_clickwrapversions_deleteclickwrapversion

Provider route: DELETE /clickapi/v1/accounts/{accountId}/clickwraps/{clickwrapId}/versions/{versionId}. Alter supplies the connection’s credentials and routing.

Install @alter-ai/sdk @alter-ai/docusign with npm, or alter-sdk-docusign with pip. Supply your connected customer’s grant ID and the arguments described below.

import { App } from "@alter-ai/sdk";
import { DocuSignIntegration } from "@alter-ai/docusign";
async function execute(input: Parameters<DocuSignIntegration["click"]["clickClickwrapVersionsDeleteClickwrapVersion"]>[0]) {
const app = new App({ apiKey: process.env.ALTER_API_KEY! });
try {
const provider = new DocuSignIntegration(app, { grantId: process.env.PROVIDER_GRANT_ID! });
const call = await provider.click.clickClickwrapVersionsDeleteClickwrapVersion(input);
const result = await call.wait();
return result.bodyJson();
} finally {
await app.close();
}
}
import os
from alter_sdk import App
from alter_sdk_docusign import DocuSignIntegration
async def execute(arguments):
async with App(api_key=os.environ["ALTER_API_KEY"]) as app:
provider = DocuSignIntegration(app, {"grant_id": os.environ["PROVIDER_GRANT_ID"]})
call = await provider.click.click_clickwrap_versions_delete_clickwrap_version(arguments)
result = await call.wait()
return result.body_json()
FieldTypePresenceDescription and constraints
$objectRootAdditional keys: not allowed
pathobjectRequired within parentAdditional keys: not allowed
path.accountIdstringRequired within parent
path.clickwrapIdstringRequired within parent
path.versionIdstringRequired within parent

Response media type: application/json. The table describes the pinned successful response. Referenced models link to their complete fields.

FieldTypePresenceDescription and constraints
$JSONRoot
$ (anyOf 1)ModelAlternativeExpand Deletes a specific version of a clickwrap — response body — clickwrap Version Id, created Time, deletion Message, deletion Success, last Modified, last Modified By, owner User Id, require Reacceptance, scheduled Date, scheduled Reacceptance, status, version Id, version Number
$ (anyOf 2)ModelAlternativeExpand Creates a new clickwrap version — response body

Referenced models: Deletes a specific version of a clickwrap — response body — clickwrap Version Id, created Time, deletion Message, deletion Success, last Modified, last Modified By, owner User Id, require Reacceptance, scheduled Date, scheduled Reacceptance, status, version Id, version Number, Creates a new clickwrap version — response body

Deletes a specific version of a clickwrap — response body — clickwrap Version Id, created Time, deletion Message, deletion Success, last Modified, last Modified By, owner User Id, require Reacceptance, scheduled Date, scheduled Reacceptance, status, version Id, version Number
FieldTypePresenceDescription and constraints
$objectRoot
clickwrapVersionIdstringOptionalThe unique version ID, a GUID, of this clickwrap version.
createdTimeobjectOptionalThe time that the clickwrap was created.
deletionMessagestringOptionalA message describing the result of deletion request. One of:

- `alreadyDeleted`: Clickwrap is already deleted.
- `deletionSuccess`: Successfully deleted the clickwrap.
- `deletionFailure`: Failed to delete the clickwrap.
- `cannotDelete`: Active clickwrap version cannot be deleted.
deletionSuccessbooleanOptional**True** if the clickwrap was deleted successfully. **False** otherwise.
lastModifiedobjectOptionalThe time that the clickwrap was last modified.
lastModifiedBystringOptionalThe user ID of the last user who modified this clickwrap.
ownerUserIdstringOptionalThe user ID of the owner of this clickwrap.
requireReacceptancebooleanOptionalWhen **true**, requires signers who have previously agreed to this
clickwrap to sign again. The version number is incremented.
scheduledDateobjectOptionalThe time and date when this clickwrap is activated.
scheduledReacceptanceModelOptionalExpand Creates a new clickwrap version — response body — scheduled Reacceptance
Specifies the interval between reacceptances in days, weeks, months, or years.
statusstringOptionalClickwrap status. Possible values:

- `active`
- `inactive`
- `deleted`
versionIdstringOptionalThe ID of the version.
versionNumberstringOptionalVersion of the clickwrap.

Referenced models: Creates a new clickwrap version — response body — scheduled Reacceptance

Creates a new clickwrap version — response body
FieldTypePresenceDescription and constraints
$objectRoot
accountIdstringOptionalA GUID that identifies your account.
This value is automatically generated by
DocuSign for any account you create. Copy the
value from the **API Account ID** field in
the **API and Keys** page in
eSignature Settings.
clickwrapIdstringOptionalThe ID of the clickwrap.
clickwrapNamestringOptionalThe name of the clickwrap.
clickwrapVersionIdstringOptionalThe unique version ID, a GUID, of this clickwrap version.
createdTimeobjectOptionalThe time that the clickwrap was created.
lastModifiedobjectOptionalThe time that the clickwrap was last modified.
lastModifiedBystringOptionalThe user ID of the last user who modified this clickwrap.
ownerUserIdstringOptionalThe user ID of the owner of this clickwrap.
requireReacceptancebooleanOptionalWhen **true**, requires signers who have previously agreed to this
clickwrap to sign again. The version number is incremented.
scheduledDateobjectOptionalThe time and date when this clickwrap is activated.
scheduledReacceptanceModelOptionalExpand Creates a new clickwrap version — response body — scheduled Reacceptance
Specifies the interval between reacceptances in days, weeks, months, or years.
statusstringOptionalClickwrap status. Possible values:

- `active`
- `inactive`
- `deleted`
versionIdstringOptionalThe ID of the version.
versionNumberstringOptionalVersion of the clickwrap.

Referenced models: Creates a new clickwrap version — response body — scheduled Reacceptance

Creates a new clickwrap version — response body — scheduled Reacceptance
FieldTypePresenceDescription and constraints
$objectRoot
recurrenceIntervalJSONOptional
recurrenceInterval (anyOf 1)integerAlternativeThe time between recurrences specified in `recurrenceIntervalType` units.

The minimum and maximum values depend on `recurrenceIntervalType`:

- `days`: 1 - 365
- `weeks`: 1 - 52
- `months`: 1 - 12
- `years`: 1
Format: int32
recurrenceInterval (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
recurrenceIntervalTypestringOptionalThe units of the `recurrenceInterval`. Must be one of:

- `days`
- `weeks`
- `month`
- `years`
startDateTimeobjectOptionalThe date when the recurrence interval starts.

SDK function policy ID: docusign.click_clickwrapversions_deleteclickwrapversion. Catalog operation: click:ClickwrapVersions_DeleteClickwrapVersion. Rules can name either ID; function rules distinguish managed calls and conservatively cover raw calls sharing the route. Existing grant permissions and policy rules apply. wait() returns an immediate result or waits for a required approval; it never approves the request itself. Persist the approval ID to resume after a restart.

Provider errors retain their response; JSON decoding raises ProviderAPIError for provider failures. ManagedOperationError identifies contract/input/retention errors. See error handling and provider-specific behavior. Sensitive input may be refused before approval storage. A decoding error never resubmits a write.

Official provider source

Report an issue with this page

Necessary

Required for sign-in, security, authorization, and remembering your choices.

Always active

Analytics

Helps us understand which product and documentation features are useful.

Performance diagnostics

Uses performance tracing and privacy-masked session replay to diagnose problems.

You can change these choices at any time from Cookie settings.