Skip to content

DocuSign: Gets a specific version from a clickwrap

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

← Click operations · Get started

Operation docusign.click_clickwrapversions_getclickwrapversion

Provider route: GET /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"]["clickClickwrapVersionsGetClickwrapVersion"]>[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.clickClickwrapVersionsGetClickwrapVersion(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_get_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
$ModelRootExpand Gets a single clickwrap object — response body

Referenced models: Gets a single clickwrap object — response body

Gets a single clickwrap object — 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.
displaySettingsModelOptionalExpand Checks if a user has agreed to a clickwrap — response body — settings
Display settings for a clickwrap.
documentsarrayOptionalAn array of documents.
documents[]ModelEach itemExpand Gets a single clickwrap object — response body — documents item
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, Checks if a user has agreed to a clickwrap — response body — settings, Gets a single clickwrap object — response body — documents item

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.
Checks if a user has agreed to a clickwrap — response body — settings
FieldTypePresenceDescription and constraints
$objectRootInformation about how an agreement is displayed.
actionButtonAlignmentstringOptionalPosition of the Accept button in the agreement. One of

- `right`
- `left`
allowClientOnlybooleanOptionalWhen **true**, this agreement can be be used in client-only integrations
allowedHostsarrayOptionalHosts that can host the clickwrap.

It is an error if the clickwrap didn't come from one of these hosts.
allowedHosts[]stringEach item
brandIdstringOptionalThe signing brand ID.
consentButtonTextstringOptionalText on the agree button.
consentTextstringOptionalThe text on agree button.
declineButtonTextstringOptionalThe text on the decline button.
displayNamestringOptionalThe display name of the user agreement.
documentDisplaystringOptionalDisplay type: link or document
downloadablebooleanOptional**True** if the agreement is downloadable.
formatstringOptionalDisplay format: inline or modal.
hasDeclineButtonbooleanOptional**True** if the agreement has a decline checkbox.
hostOriginstringOptionalThe host origin.
mustReadbooleanOptional**True** if the user needs to scroll to the end of the document.
mustViewbooleanOptional**True** if the user must view the document.
recordDeclineResponsesbooleanOptionalWhen **true**, this agreement records decline actions.
requireAcceptbooleanOptional**True** if accept is required.
sendToEmailbooleanOptional**True** if send to email is applicable.
Gets a single clickwrap object — response body — documents item
FieldTypePresenceDescription and constraints
$objectRootInformation about a document.
documentBase64stringOptionalThe base64-encoded contents of the document.
documentHtmlstringOptionalThe HTML representation of the document.
documentNamestringOptionalThe name of the document.
fileExtensionstringOptionalThe file extension of the document.
orderJSONOptional
order (anyOf 1)integerAlternativeThe order of document layout.
Format: int32
order (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$

SDK function policy ID: docusign.click_clickwrapversions_getclickwrapversion. Catalog operation: click:ClickwrapVersions_GetClickwrapVersion. 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.