diff --git a/docs/Account.md b/docs/Account.md new file mode 100644 index 0000000..b475ac1 --- /dev/null +++ b/docs/Account.md @@ -0,0 +1,39 @@ + +# Account + +## Properties +Name | Type | Description | Notes +------------ | ------------- | ------------- | ------------- +**created** | [**Date**](Date.md) | Date when the account was created. This is a server generated attributed and can not be provided in POST/PUT calls. Format would be yyyy-MM-dd'T'HH:mm:ssZ. For example, e.g 2016-02-25T18:46:19Z represents UTC time | [optional] +**accountType** | [**AccountTypeEnum**](#AccountTypeEnum) | The provisioned type of the account. This is a server generated attributed and can not be provided in POST/PUT calls. | [optional] +**name** | **String** | The name which the account is known. This is a server generated attributed and can not be provided in POST/PUT calls. | [optional] +**modified** | [**Date**](Date.md) | The last date that the account information was updated. This is a server generated attributed and can not be provided in POST/PUT calls. Format would be yyyy-MM-dd'T'HH:mm:ssZ. For example, e.g 2016-02-25T18:46:19Z represents UTC time | [optional] +**company** | **String** | The company associated with the account. This is a server generated attributed and can not be provided in POST/PUT calls. | [optional] +**id** | **String** | Identifier of the account. This is a server generated attributed and can not be provided in POST/PUT calls. | [optional] + + + +## Enum: AccountTypeEnum +Name | Value +---- | ----- +FREE | "FREE" +FREE_LEGACY | "FREE_LEGACY" +TEAM_TRIAL | "TEAM_TRIAL" +TEAM | "TEAM" +TEAM_LEGACY | "TEAM_LEGACY" +ENTERPRISE_TRIAL | "ENTERPRISE_TRIAL" +ENTERPRISE | "ENTERPRISE" +ENTERPRISE_LEGACY | "ENTERPRISE_LEGACY" +GLOBAL_TRIAL | "GLOBAL_TRIAL" +GLOBAL | "GLOBAL" +DEVELOPER | "DEVELOPER" +PRO_DOC_CLOUD | "PRO_DOC_CLOUD" +TEAM_DOC_CLOUD | "TEAM_DOC_CLOUD" +TRIAL_EXPIRED | "TRIAL_EXPIRED" +ANONYMOUS | "ANONYMOUS" +PRO_DOC_CLOUD_MULTI | "PRO_DOC_CLOUD_MULTI" +PRO_PLUS_DOC_CLOUD | "PRO_PLUS_DOC_CLOUD" +PRO_PLUS_DOC_CLOUD_MULTI | "PRO_PLUS_DOC_CLOUD_MULTI" + + + diff --git a/docs/AccountSharerInfo.md b/docs/AccountSharerInfo.md new file mode 100644 index 0000000..4aa2d6f --- /dev/null +++ b/docs/AccountSharerInfo.md @@ -0,0 +1,22 @@ + +# AccountSharerInfo + +## Properties +Name | Type | Description | Notes +------------ | ------------- | ------------- | ------------- +**permissions** | [**List<PermissionsEnum>**](#List<PermissionsEnum>) | A list of permissions given for this account sharing. | [optional] +**fullName** | **String** | Full name of this account sharer. | [optional] +**userId** | **String** | A unique identifier of the user resource for REST APIs as issued by Sign. | [optional] +**email** | **String** | The email address of the user | [optional] + + + +## Enum: List<PermissionsEnum> +Name | Value +---- | ----- +VIEW | "VIEW" +SEND | "SEND" +MODIFY | "MODIFY" + + + diff --git a/docs/AccountsApi.md b/docs/AccountsApi.md new file mode 100644 index 0000000..79bcc24 --- /dev/null +++ b/docs/AccountsApi.md @@ -0,0 +1,56 @@ +# AccountsApi + +All URIs are relative to *https://secure.au1.echosign.com/api/rest/v6* + +Method | HTTP request | Description +------------- | ------------- | ------------- +[**getAccount**](AccountsApi.md#getAccount) | **GET** /accounts/{accountId} | Retrieves the information for an account. + + + +# **getAccount** +> Account getAccount(authorization, accountId, xApiUser) + +Retrieves the information for an account. + +### Example +```java +// Import classes: +//import io.swagger.client.model.ApiException; +//import io.swagger.client.api.AccountsApi; + + +AccountsApi apiInstance = new AccountsApi(); +String authorization = "authorization_example"; // String | An OAuth Access Token with scopes:
in the format 'Bearer {accessToken}'. +String accountId = "accountId_example"; // String | The account identifier. +String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. +try { + Account result = apiInstance.getAccount(authorization, accountId, xApiUser); + System.out.println(result); +} catch (ApiException e) { + System.err.println("Exception when calling AccountsApi#getAccount"); + e.printStackTrace(); +} +``` + +### Parameters + +Name | Type | Description | Notes +------------- | ------------- | ------------- | ------------- + **authorization** | **String**| An <a href=\"#\" onclick=\"this.href=oauthDoc()\" oncontextmenu=\"this.href=oauthDoc()\" target=\"oauthDoc\">OAuth Access Token</a> with scopes:<ul><li style='list-style-type: square'><a href=\"#\" onclick=\"this.href=oauthDoc('user_read')\" oncontextmenu=\"this.href=oauthDoc('user_read')\" target=\"oauthDoc\">user_read</a></li></ul>in the format <b>'Bearer {accessToken}'. | + **accountId** | **String**| The account identifier. | + **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] + +### Return type + +[**Account**](Account.md) + +### Authorization + +No authorization required + +### HTTP request headers + + - **Content-Type**: Not defined + - **Accept**: application/json + diff --git a/docs/AgreementCcInfo.md b/docs/AgreementCcInfo.md index 16af449..e282bbf 100755 --- a/docs/AgreementCcInfo.md +++ b/docs/AgreementCcInfo.md @@ -4,9 +4,9 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**email** | **String** | Email of the CC participant of the agreement | [optional] -**label** | **String** | Label of the CC list as returned in workflow description | [optional] **visiblePages** | **List<String>** | When you enable limited document visibility (documentVisibilityEnabled), you can specify which file (fileInfo) should be made visible to which specific participant set.<br>Specify one or more label values of a fileInfos element.<br>Each signer participant sets must contain at least one required signature field in at least one visible file included in this API call; if not a page with a signature field is automatically appended for any missing participant sets. If there is a possibility that one or more participant sets do not have a required signature field in the files included in the API call, all signer participant sets should include a special index value of '0' to make this automatically appended signature page visible to the signer. Not doing so may result in an error. For all other roles, you may omit this value to exclude this page. | [optional] +**label** | **String** | Label of the CC list as returned in workflow description | [optional] +**email** | **String** | Email of the CC participant of the agreement | [optional] diff --git a/docs/AgreementCreationInfo.md b/docs/AgreementCreationInfo.md index 0cca001..3a5f1b0 100755 --- a/docs/AgreementCreationInfo.md +++ b/docs/AgreementCreationInfo.md @@ -4,44 +4,56 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- +**groupId** | **String** | The unique identifier of the group to which the agreement belongs to. If not provided during agreement creation, primary group of the creator will be used | [optional] +**locale** | **String** | The locale associated with this agreement - specifies the language for the signing page and emails, for example en_US or fr_FR. If none specified, defaults to the language configured for the agreement sender | [optional] +**type** | [**TypeEnum**](#TypeEnum) | The kind of agreement | [optional] +**vaultingInfo** | [**VaultingInfo**](VaultingInfo.md) | Vaulting properties that allows Adobe Sign to securely store documents with a vault provider | [optional] +**securityOption** | [**SecurityOption**](SecurityOption.md) | Optional secondary security parameters for the agreement. Should not be provided in offline agreement creation. | [optional] +**postSignOption** | [**PostSignOption**](PostSignOption.md) | URL and associated properties for the success page the user will be taken to after completing the signing process. Should not be provided in offline agreement creation. | [optional] **ccs** | [**List<AgreementCcInfo>**](AgreementCcInfo.md) | A list of one or more CCs that will be copied in the agreement transaction. The CCs will each receive an email at the beginning of the transaction and also when the final document is signed. The email addresses will also receive a copy of the document, attached as a PDF file. Should not be provided in offline agreement creation. | [optional] -**createdDate** | [**Date**](Date.md) | Date when agreement was created. This is a server generated attributed and can not be provided in POST/PUT calls. Format would be yyyy-MM-dd'T'HH:mm:ssZ. For example, e.g 2016-02-25T18:46:19Z represents UTC time | [optional] -**deviceInfo** | [**OfflineDeviceInfo**](OfflineDeviceInfo.md) | Device info of the offline device. It should only be provided in case of offline agreement creation. | [optional] **documentVisibilityEnabled** | **Boolean** | If set to true, enable limited document visibility. Should not be provided in offline agreement creation. | [optional] -**emailOption** | [**EmailOption**](EmailOption.md) | Email configurations for the agreement. Should not be provided in offline agreement creation or when updating a non draft agreement. | [optional] -**expirationTime** | [**Date**](Date.md) | Time after which Agreement expires and needs to be signed before it. Format should be yyyy-MM-dd'T'HH:mm:ssZ. For example, e.g 2016-02-25T18:46:19Z represents UTC time. Should not be provided in offline agreement creation. | [optional] -**externalId** | [**ExternalId**](ExternalId.md) | An arbitrary value from your system, which can be specified at sending time and then later returned or queried. Should not be provided in offline agreement creation. | [optional] -**fileInfos** | [**List<FileInfo>**](FileInfo.md) | A list of one or more files (or references to files) that will be sent out for signature. If more than one file is provided, they will be combined into one PDF before being sent out. Note: Only one of the four parameters in every FileInfo object must be specified | [optional] -**firstReminderDelay** | **Integer** | Integer which specifies the delay in hours before sending the first reminder.<br>This is an optional field. The minimum value allowed is 1 hour and the maximum value can’t be more than the difference of agreement creation and expiry time of the agreement in hours.<br>If this is not specified but the reminder frequency is specified, then the first reminder will be sent based on frequency.<br>i.e. if the reminder is created with frequency specified as daily, the firstReminderDelay will be 24 hours. Should not be provided in offline agreement creation. | [optional] -**formFieldLayerTemplates** | [**List<FileInfo>**](FileInfo.md) | Specifies the form field layer template or source of form fields to apply on the files in this transaction. If specified, the FileInfo for this parameter must refer to a form field layer template via libraryDocumentId or libraryDocumentName, or if specified via transientDocumentId or documentURL, it must be of a supported file type. Note: Only one of the four parameters in every FileInfo object must be specified | [optional] +**isDocumentRetentionApplied** | **Boolean** | Is document retention applied for this resource. If provided in POST or PUT, it will simply be ignored. | [optional] +**hasSignerIdentityReport** | **Boolean** | True if agreement has signer identity report available. If provided in POST or PUT, it will simply be ignored. | [optional] +**lastEventDate** | [**Date**](Date.md) | The date of the last event that occurred for this agreement. Format would be yyyy-MM-dd'T'HH:mm:ssZ. For example, e.g 2016-02-25T18:46:19Z represents UTC time | [optional] +**senderEmail** | **String** | Email of agreement sender. Only provided in GET. Can not be provided in POST/PUT request. If provided in POST/PUT, it will be ignored | [optional] **id** | **String** | The unique identifier of the agreement.If provided in POST, it will simply be ignored | [optional] -**locale** | **String** | The locale associated with this agreement - specifies the language for the signing page and emails, for example en_US or fr_FR. If none specified, defaults to the language configured for the agreement sender | [optional] +**state** | [**StateEnum**](#StateEnum) | The state in which the agreement should land. The state field can only be provided in POST calls, will never get returned in GET /agreements/{ID} and will be ignored if provided in PUT /agreements/{ID} call. The eventual status of the agreement can be obtained from GET /agreements/ID | [optional] **mergeFieldInfo** | [**List<MergefieldInfo>**](MergefieldInfo.md) | Optional default values for fields to merge into the document. The values will be presented to the signers for editable fields; for read-only fields the provided values will not be editable during the signing process. Merging data into fields is currently not supported when used with libraryDocumentId or libraryDocumentName. Only file and url are currently supported | [optional] +**firstReminderDelay** | **Integer** | Integer which specifies the delay in hours before sending the first reminder.<br>This is an optional field. The minimum value allowed is 1 hour and the maximum value can’t be more than the difference of agreement creation and expiry time of the agreement in hours.<br>If this is not specified but the reminder frequency is specified, then the first reminder will be sent based on frequency.<br>i.e. if the reminder is created with frequency specified as daily, the firstReminderDelay will be 24 hours. Should not be provided in offline agreement creation. | [optional] +**emailOption** | [**EmailOption**](EmailOption.md) | Email configurations for the agreement. Should not be provided in offline agreement creation or when updating a non draft agreement. | [optional] +**signatureType** | [**SignatureTypeEnum**](#SignatureTypeEnum) | Specifies the type of signature you would like to request - written or e-signature. The possible values are <br> ESIGN : Agreement needs to be signed electronically <br>, WRITTEN : Agreement will be signed using handwritten signature and signed document will be uploaded into the system | [optional] +**externalId** | [**ExternalId**](ExternalId.md) | An arbitrary value from your system, which can be specified at sending time and then later returned or queried. Should not be provided in offline agreement creation. | [optional] **message** | **String** | An optional message to the participants, describing what is being sent or why their signature is required | [optional] -**name** | **String** | The name of the agreement that will be used to identify it, in emails, website and other places | [optional] -**participantSetsInfo** | [**List<ParticipantSetInfo>**](ParticipantSetInfo.md) | A list of one or more participant set. A participant set may have one or more participant. If any member of the participant set takes the action that has been assigned to the set(Sign/Approve/Acknowledge etc ), the action is considered as the action taken by whole participation set. For regular (non-MegaSign) documents, there is no limit on the number of electronic signatures in a single document. Written signatures are limited to four per document | [optional] -**postSignOption** | [**PostSignOption**](PostSignOption.md) | URL and associated properties for the success page the user will be taken to after completing the signing process. Should not be provided in offline agreement creation. | [optional] +**deviceInfo** | [**OfflineDeviceInfo**](OfflineDeviceInfo.md) | Device info of the offline device. It should only be provided in case of offline agreement creation. | [optional] +**parentId** | **String** | The parent id of a megaSign child *OR* the originating id of a widget agreement instance | [optional] **reminderFrequency** | [**ReminderFrequencyEnum**](#ReminderFrequencyEnum) | Optional parameter that sets how often you want to send reminders to the participants. If it is not specified, the default frequency set for the account will be used. Should not be provided in offline agreement creation. If provided in PUT as a different value than the current one, an error will be thrown. | [optional] -**securityOption** | [**SecurityOption**](SecurityOption.md) | Optional secondary security parameters for the agreement. Should not be provided in offline agreement creation. | [optional] -**senderEmail** | **String** | Email of agreement sender. Only provided in GET. Can not be provided in POST/PUT request. If provided in POST/PUT, it will be ignored | [optional] -**signatureType** | [**SignatureTypeEnum**](#SignatureTypeEnum) | Specifies the type of signature you would like to request - written or e-signature. The possible values are <br> ESIGN : Agreement needs to be signed electronically <br>, WRITTEN : Agreement will be signed using handwritten signature and signed document will be uploaded into the system | [optional] -**state** | [**StateEnum**](#StateEnum) | The state in which the agreement should land. The state field can only be provided in POST calls, will never get returned in GET /agreements/{ID} and will be ignored if provided in PUT /agreements/{ID} call. The eventual status of the agreement can be obtained from GET /agreements/ID | [optional] -**status** | [**StatusEnum**](#StatusEnum) | This is a server generated attribute which provides the detailed status of an agreement. | [optional] -**vaultingInfo** | [**VaultingInfo**](VaultingInfo.md) | Vaulting properties that allows Adobe Sign to securely store documents with a vault provider | [optional] +**createdDate** | [**Date**](Date.md) | Date when agreement was created. This is a server generated attributed and can not be provided in POST/PUT calls. Format would be yyyy-MM-dd'T'HH:mm:ssZ. For example, e.g 2016-02-25T18:46:19Z represents UTC time | [optional] +**participantSetsInfo** | [**List<ParticipantSetInfo>**](ParticipantSetInfo.md) | A list of one or more participant set. A participant set may have one or more participant. If any member of the participant set takes the action that has been assigned to the set(Sign/Approve/Acknowledge etc), the action is considered as the action taken by whole participation set. For regular (non-MegaSign) documents, there is no limit on the number of electronic signatures in a single document. Written signatures are limited to four per document | [optional] +**hasFormFieldData** | **Boolean** | True if form field data is present. If provided in POST or PUT, it will simply be ignored. | [optional] +**expirationTime** | [**Date**](Date.md) | Time after which Agreement expires and needs to be signed before it. Format should be yyyy-MM-dd'T'HH:mm:ssZ. For example, e.g 2016-02-25T18:46:19Z represents UTC time. Should not be provided in offline agreement creation. | [optional] +**formFieldLayerTemplates** | [**List<FileInfo>**](FileInfo.md) | Specifies the form field layer template or source of form fields to apply on the files in this transaction. If specified, the FileInfo for this parameter must refer to a form field layer template via libraryDocumentId or libraryDocumentName, or if specified via transientDocumentId or documentURL, it must be of a supported file type. Note: Only one of the four parameters in every FileInfo object must be specified | [optional] +**name** | **String** | The name of the agreement that will be used to identify it, in emails, website and other places | [optional] +**fileInfos** | [**List<FileInfo>**](FileInfo.md) | A list of one or more files (or references to files) that will be sent out for signature. If more than one file is provided, they will be combined into one PDF before being sent out. Note: Only one of the four parameters in every FileInfo object must be specified | [optional] **workflowId** | **String** | The identifier of custom workflow which defines the routing path of an agreement. Should not be provided in offline agreement creation. | [optional] +**status** | [**StatusEnum**](#StatusEnum) | This is a server generated attribute which provides the detailed status of an agreement. | [optional] - -## Enum: ReminderFrequencyEnum + +## Enum: TypeEnum Name | Value ---- | ----- -DAILY_UNTIL_SIGNED | "DAILY_UNTIL_SIGNED" -WEEKDAILY_UNTIL_SIGNED | "WEEKDAILY_UNTIL_SIGNED" -EVERY_OTHER_DAY_UNTIL_SIGNED | "EVERY_OTHER_DAY_UNTIL_SIGNED" -EVERY_THIRD_DAY_UNTIL_SIGNED | "EVERY_THIRD_DAY_UNTIL_SIGNED" -EVERY_FIFTH_DAY_UNTIL_SIGNED | "EVERY_FIFTH_DAY_UNTIL_SIGNED" -WEEKLY_UNTIL_SIGNED | "WEEKLY_UNTIL_SIGNED" -ONCE | "ONCE" +AGREEMENT | "AGREEMENT" +MEGASIGN_CHILD | "MEGASIGN_CHILD" +WIDGET_INSTANCE | "WIDGET_INSTANCE" + + + +## Enum: StateEnum +Name | Value +---- | ----- +AUTHORING | "AUTHORING" +DRAFT | "DRAFT" +IN_PROCESS | "IN_PROCESS" @@ -52,13 +64,17 @@ ESIGN | "ESIGN" WRITTEN | "WRITTEN" - -## Enum: StateEnum + +## Enum: ReminderFrequencyEnum Name | Value ---- | ----- -AUTHORING | "AUTHORING" -DRAFT | "DRAFT" -IN_PROCESS | "IN_PROCESS" +DAILY_UNTIL_SIGNED | "DAILY_UNTIL_SIGNED" +WEEKDAILY_UNTIL_SIGNED | "WEEKDAILY_UNTIL_SIGNED" +EVERY_OTHER_DAY_UNTIL_SIGNED | "EVERY_OTHER_DAY_UNTIL_SIGNED" +EVERY_THIRD_DAY_UNTIL_SIGNED | "EVERY_THIRD_DAY_UNTIL_SIGNED" +EVERY_FIFTH_DAY_UNTIL_SIGNED | "EVERY_FIFTH_DAY_UNTIL_SIGNED" +WEEKLY_UNTIL_SIGNED | "WEEKLY_UNTIL_SIGNED" +ONCE | "ONCE" diff --git a/docs/AgreementDocumentImageUrlsInfo.md b/docs/AgreementDocumentImageUrlsInfo.md index d40303a..31efba1 100755 --- a/docs/AgreementDocumentImageUrlsInfo.md +++ b/docs/AgreementDocumentImageUrlsInfo.md @@ -4,8 +4,8 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**documentId** | **String** | Id of the document | [optional] **documentImageUrlsList** | [**List<DocumentImageUrls>**](DocumentImageUrls.md) | A list of documents image URLs. | [optional] +**documentId** | **String** | Id of the document | [optional] diff --git a/docs/AgreementDocuments.md b/docs/AgreementDocuments.md index b0a82d2..b66e108 100755 --- a/docs/AgreementDocuments.md +++ b/docs/AgreementDocuments.md @@ -5,7 +5,6 @@ Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- **documents** | [**List<Document>**](Document.md) | A list of documents | [optional] -**supportingDocuments** | [**List<SupportingDocument>**](SupportingDocument.md) | A list of supporting documents | [optional] diff --git a/docs/AgreementEvent.md b/docs/AgreementEvent.md index 8b2414f..2779d95 100755 --- a/docs/AgreementEvent.md +++ b/docs/AgreementEvent.md @@ -4,43 +4,26 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**actingUserEmail** | **String** | Email address of the user that created the event | [optional] -**actingUserIpAddress** | **String** | The IP address of the user that created the event | [optional] -**actingUserName** | **String** | The name of the acting user | [optional] -**comment** | **String** | The event comment. For RECALLED or REJECTED, the reason given by the user that initiates the event. For DELEGATE or SHARE, the message from the acting user to the participant | [optional] **date** | [**Date**](Date.md) | The date of the audit event. Format would be yyyy-MM-dd'T'HH:mm:ssZ. For example, e.g 2016-02-25T18:46:19Z represents UTC time | [optional] -**description** | **String** | A description of the audit event | [optional] -**deviceLocation** | [**DeviceLocation**](DeviceLocation.md) | Location of the device that generated the event (This value may be null due to limited privileges) | [optional] -**devicePhoneNumber** | **String** | Phone number from the device used when the participation is completed on a mobile phone | [optional] -**digitalSignatureInfo** | [**DigitalSignatureInfo**](DigitalSignatureInfo.md) | This is present for ESIGNED events when the participation is signed digitally | [optional] -**initiatingUserEmail** | **String** | Email address of the user that initiated the event on behalf of the acting user when the account is shared. Will be empty if there is no account sharing in effect | [optional] **initiatingUserName** | **String** | Full name of the user that initiated the event on behalf of the acting user when the account is shared. Will be empty if there is no account sharing in effect | [optional] +**description** | **String** | A description of the audit event | [optional] +**actingUserName** | **String** | The name of the acting user | [optional] +**actingUserIpAddress** | **String** | The IP address of the user that created the event | [optional] **participantEmail** | **String** | Email address of the user that is the participant for the event. This may be different than the acting user for certain event types. For example, for a DELEGATION event, this is the user who was delegated to | [optional] -**participantId** | **String** | The unique identifier of the participant for the event. This may be different than the acting user for certain event types. For example, for a DELEGATION event, this is the user who was delegated to | [optional] -**participantRole** | [**ParticipantRoleEnum**](#ParticipantRoleEnum) | Role assumed by all participants in the participant set the participant belongs to (signer, approver etc.). | [optional] -**synchronizationId** | **String** | A unique identifier linking offline events to synchronization events (specified for offline signing events and synchronization events, else null) | [optional] **type** | [**TypeEnum**](#TypeEnum) | Type of agreement event | [optional] +**participantRole** | [**ParticipantRoleEnum**](#ParticipantRoleEnum) | Role assumed by all participants in the participant set the participant belongs to (signer, approver etc.). | [optional] **vaultEventId** | **String** | The identifier assigned by the vault provider for the vault event (if vaulted, otherwise null) | [optional] -**vaultProviderName** | **String** | Name of the vault provider for the vault event (if vaulted, otherwise null) | [optional] +**participantId** | **String** | The unique identifier of the participant for the event. This may be different than the acting user for certain event types. For example, for a DELEGATION event, this is the user who was delegated to | [optional] **versionId** | **String** | An ID which uniquely identifies the version of the document associated with this audit event | [optional] - - - -## Enum: ParticipantRoleEnum -Name | Value ----- | ----- -SIGNER | "SIGNER" -DELEGATE_TO_SIGNER | "DELEGATE_TO_SIGNER" -APPROVER | "APPROVER" -DELEGATE_TO_APPROVER | "DELEGATE_TO_APPROVER" -ACCEPTOR | "ACCEPTOR" -DELEGATE_TO_ACCEPTOR | "DELEGATE_TO_ACCEPTOR" -FORM_FILLER | "FORM_FILLER" -DELEGATE_TO_FORM_FILLER | "DELEGATE_TO_FORM_FILLER" -CERTIFIED_RECIPIENT | "CERTIFIED_RECIPIENT" -DELEGATE_TO_CERTIFIED_RECIPIENT | "DELEGATE_TO_CERTIFIED_RECIPIENT" -SHARE | "SHARE" -SENDER | "SENDER" +**actingUserEmail** | **String** | Email address of the user that created the event | [optional] +**devicePhoneNumber** | **String** | Phone number from the device used when the participation is completed on a mobile phone | [optional] +**initiatingUserEmail** | **String** | Email address of the user that initiated the event on behalf of the acting user when the account is shared. Will be empty if there is no account sharing in effect | [optional] +**digitalSignatureInfo** | [**DigitalSignatureInfo**](DigitalSignatureInfo.md) | This is present for ESIGNED events when the participation is signed digitally | [optional] +**vaultProviderName** | **String** | Name of the vault provider for the vault event (if vaulted, otherwise null) | [optional] +**comment** | **String** | The event comment. For RECALLED or REJECTED, the reason given by the user that initiates the event. For DELEGATE or SHARE, the message from the acting user to the participant | [optional] +**id** | **String** | The identifier for the event. | [optional] +**synchronizationId** | **String** | A unique identifier linking offline events to synchronization events (specified for offline signing events and synchronization events, else null) | [optional] +**deviceLocation** | [**DeviceLocation**](DeviceLocation.md) | Location of the device that generated the event (This value may be null due to limited privileges) | [optional] @@ -96,6 +79,7 @@ SIGNED | "SIGNED" SIGNING_URL_REQUESTED | "SIGNING_URL_REQUESTED" UPLOADED_BY_SENDER | "UPLOADED_BY_SENDER" USER_ACK_AGREEMENT_MODIFIED | "USER_ACK_AGREEMENT_MODIFIED" +READY_TO_VAULT | "READY_TO_VAULT" VAULTED | "VAULTED" WEB_IDENTITY_AUTHENTICATED | "WEB_IDENTITY_AUTHENTICATED" WEB_IDENTITY_SPECIFIED | "WEB_IDENTITY_SPECIFIED" @@ -103,4 +87,22 @@ WRITTEN_DOWNLOAD | "WRITTEN_DOWNLOAD" WRITTEN_SIGNED | "WRITTEN_SIGNED" + +## Enum: ParticipantRoleEnum +Name | Value +---- | ----- +SIGNER | "SIGNER" +DELEGATE_TO_SIGNER | "DELEGATE_TO_SIGNER" +APPROVER | "APPROVER" +DELEGATE_TO_APPROVER | "DELEGATE_TO_APPROVER" +ACCEPTOR | "ACCEPTOR" +DELEGATE_TO_ACCEPTOR | "DELEGATE_TO_ACCEPTOR" +FORM_FILLER | "FORM_FILLER" +DELEGATE_TO_FORM_FILLER | "DELEGATE_TO_FORM_FILLER" +CERTIFIED_RECIPIENT | "CERTIFIED_RECIPIENT" +DELEGATE_TO_CERTIFIED_RECIPIENT | "DELEGATE_TO_CERTIFIED_RECIPIENT" +SHARE | "SHARE" +SENDER | "SENDER" + + diff --git a/docs/AgreementInfo.md b/docs/AgreementInfo.md index 9f68857..d8906ff 100755 --- a/docs/AgreementInfo.md +++ b/docs/AgreementInfo.md @@ -4,44 +4,56 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- +**groupId** | **String** | The unique identifier of the group to which the agreement belongs to. If not provided during agreement creation, primary group of the creator will be used | [optional] +**locale** | **String** | The locale associated with this agreement - specifies the language for the signing page and emails, for example en_US or fr_FR. If none specified, defaults to the language configured for the agreement sender | [optional] +**type** | [**TypeEnum**](#TypeEnum) | The kind of agreement | [optional] +**vaultingInfo** | [**VaultingInfo**](VaultingInfo.md) | Vaulting properties that allows Adobe Sign to securely store documents with a vault provider | [optional] +**securityOption** | [**SecurityOption**](SecurityOption.md) | Optional secondary security parameters for the agreement. Should not be provided in offline agreement creation. | [optional] +**postSignOption** | [**PostSignOption**](PostSignOption.md) | URL and associated properties for the success page the user will be taken to after completing the signing process. Should not be provided in offline agreement creation. | [optional] **ccs** | [**List<AgreementCcInfo>**](AgreementCcInfo.md) | A list of one or more CCs that will be copied in the agreement transaction. The CCs will each receive an email at the beginning of the transaction and also when the final document is signed. The email addresses will also receive a copy of the document, attached as a PDF file. Should not be provided in offline agreement creation. | [optional] -**createdDate** | [**Date**](Date.md) | Date when agreement was created. This is a server generated attributed and can not be provided in POST/PUT calls. Format would be yyyy-MM-dd'T'HH:mm:ssZ. For example, e.g 2016-02-25T18:46:19Z represents UTC time | [optional] -**deviceInfo** | [**OfflineDeviceInfo**](OfflineDeviceInfo.md) | Device info of the offline device. It should only be provided in case of offline agreement creation. | [optional] **documentVisibilityEnabled** | **Boolean** | If set to true, enable limited document visibility. Should not be provided in offline agreement creation. | [optional] -**emailOption** | [**EmailOption**](EmailOption.md) | Email configurations for the agreement. Should not be provided in offline agreement creation or when updating a non draft agreement. | [optional] -**expirationTime** | [**Date**](Date.md) | Time after which Agreement expires and needs to be signed before it. Format should be yyyy-MM-dd'T'HH:mm:ssZ. For example, e.g 2016-02-25T18:46:19Z represents UTC time. Should not be provided in offline agreement creation. | [optional] -**externalId** | [**ExternalId**](ExternalId.md) | An arbitrary value from your system, which can be specified at sending time and then later returned or queried. Should not be provided in offline agreement creation. | [optional] -**fileInfos** | [**List<FileInfo>**](FileInfo.md) | A list of one or more files (or references to files) that will be sent out for signature. If more than one file is provided, they will be combined into one PDF before being sent out. Note: Only one of the four parameters in every FileInfo object must be specified | [optional] -**firstReminderDelay** | **Integer** | Integer which specifies the delay in hours before sending the first reminder.<br>This is an optional field. The minimum value allowed is 1 hour and the maximum value can’t be more than the difference of agreement creation and expiry time of the agreement in hours.<br>If this is not specified but the reminder frequency is specified, then the first reminder will be sent based on frequency.<br>i.e. if the reminder is created with frequency specified as daily, the firstReminderDelay will be 24 hours. Should not be provided in offline agreement creation. | [optional] -**formFieldLayerTemplates** | [**List<FileInfo>**](FileInfo.md) | Specifies the form field layer template or source of form fields to apply on the files in this transaction. If specified, the FileInfo for this parameter must refer to a form field layer template via libraryDocumentId or libraryDocumentName, or if specified via transientDocumentId or documentURL, it must be of a supported file type. Note: Only one of the four parameters in every FileInfo object must be specified | [optional] +**isDocumentRetentionApplied** | **Boolean** | Is document retention applied for this resource. If provided in POST or PUT, it will simply be ignored. | [optional] +**hasSignerIdentityReport** | **Boolean** | True if agreement has signer identity report available. If provided in POST or PUT, it will simply be ignored. | [optional] +**lastEventDate** | [**Date**](Date.md) | The date of the last event that occurred for this agreement. Format would be yyyy-MM-dd'T'HH:mm:ssZ. For example, e.g 2016-02-25T18:46:19Z represents UTC time | [optional] +**senderEmail** | **String** | Email of agreement sender. Only provided in GET. Can not be provided in POST/PUT request. If provided in POST/PUT, it will be ignored | [optional] **id** | **String** | The unique identifier of the agreement.If provided in POST, it will simply be ignored | [optional] -**locale** | **String** | The locale associated with this agreement - specifies the language for the signing page and emails, for example en_US or fr_FR. If none specified, defaults to the language configured for the agreement sender | [optional] +**state** | [**StateEnum**](#StateEnum) | The state in which the agreement should land. The state field can only be provided in POST calls, will never get returned in GET /agreements/{ID} and will be ignored if provided in PUT /agreements/{ID} call. The eventual status of the agreement can be obtained from GET /agreements/ID | [optional] **mergeFieldInfo** | [**List<MergefieldInfo>**](MergefieldInfo.md) | Optional default values for fields to merge into the document. The values will be presented to the signers for editable fields; for read-only fields the provided values will not be editable during the signing process. Merging data into fields is currently not supported when used with libraryDocumentId or libraryDocumentName. Only file and url are currently supported | [optional] +**firstReminderDelay** | **Integer** | Integer which specifies the delay in hours before sending the first reminder.<br>This is an optional field. The minimum value allowed is 1 hour and the maximum value can’t be more than the difference of agreement creation and expiry time of the agreement in hours.<br>If this is not specified but the reminder frequency is specified, then the first reminder will be sent based on frequency.<br>i.e. if the reminder is created with frequency specified as daily, the firstReminderDelay will be 24 hours. Should not be provided in offline agreement creation. | [optional] +**emailOption** | [**EmailOption**](EmailOption.md) | Email configurations for the agreement. Should not be provided in offline agreement creation or when updating a non draft agreement. | [optional] +**signatureType** | [**SignatureTypeEnum**](#SignatureTypeEnum) | Specifies the type of signature you would like to request - written or e-signature. The possible values are <br> ESIGN : Agreement needs to be signed electronically <br>, WRITTEN : Agreement will be signed using handwritten signature and signed document will be uploaded into the system | [optional] +**externalId** | [**ExternalId**](ExternalId.md) | An arbitrary value from your system, which can be specified at sending time and then later returned or queried. Should not be provided in offline agreement creation. | [optional] **message** | **String** | An optional message to the participants, describing what is being sent or why their signature is required | [optional] -**name** | **String** | The name of the agreement that will be used to identify it, in emails, website and other places | [optional] -**participantSetsInfo** | [**List<ParticipantSetInfo>**](ParticipantSetInfo.md) | A list of one or more participant set. A participant set may have one or more participant. If any member of the participant set takes the action that has been assigned to the set(Sign/Approve/Acknowledge etc ), the action is considered as the action taken by whole participation set. For regular (non-MegaSign) documents, there is no limit on the number of electronic signatures in a single document. Written signatures are limited to four per document | [optional] -**postSignOption** | [**PostSignOption**](PostSignOption.md) | URL and associated properties for the success page the user will be taken to after completing the signing process. Should not be provided in offline agreement creation. | [optional] +**deviceInfo** | [**OfflineDeviceInfo**](OfflineDeviceInfo.md) | Device info of the offline device. It should only be provided in case of offline agreement creation. | [optional] +**parentId** | **String** | The parent id of a megaSign child *OR* the originating id of a widget agreement instance | [optional] **reminderFrequency** | [**ReminderFrequencyEnum**](#ReminderFrequencyEnum) | Optional parameter that sets how often you want to send reminders to the participants. If it is not specified, the default frequency set for the account will be used. Should not be provided in offline agreement creation. If provided in PUT as a different value than the current one, an error will be thrown. | [optional] -**securityOption** | [**SecurityOption**](SecurityOption.md) | Optional secondary security parameters for the agreement. Should not be provided in offline agreement creation. | [optional] -**senderEmail** | **String** | Email of agreement sender. Only provided in GET. Can not be provided in POST/PUT request. If provided in POST/PUT, it will be ignored | [optional] -**signatureType** | [**SignatureTypeEnum**](#SignatureTypeEnum) | Specifies the type of signature you would like to request - written or e-signature. The possible values are <br> ESIGN : Agreement needs to be signed electronically <br>, WRITTEN : Agreement will be signed using handwritten signature and signed document will be uploaded into the system | [optional] -**state** | [**StateEnum**](#StateEnum) | The state in which the agreement should land. The state field can only be provided in POST calls, will never get returned in GET /agreements/{ID} and will be ignored if provided in PUT /agreements/{ID} call. The eventual status of the agreement can be obtained from GET /agreements/ID | [optional] -**status** | [**StatusEnum**](#StatusEnum) | This is a server generated attribute which provides the detailed status of an agreement. | [optional] -**vaultingInfo** | [**VaultingInfo**](VaultingInfo.md) | Vaulting properties that allows Adobe Sign to securely store documents with a vault provider | [optional] +**createdDate** | [**Date**](Date.md) | Date when agreement was created. This is a server generated attributed and can not be provided in POST/PUT calls. Format would be yyyy-MM-dd'T'HH:mm:ssZ. For example, e.g 2016-02-25T18:46:19Z represents UTC time | [optional] +**participantSetsInfo** | [**List<ParticipantSetInfo>**](ParticipantSetInfo.md) | A list of one or more participant set. A participant set may have one or more participant. If any member of the participant set takes the action that has been assigned to the set(Sign/Approve/Acknowledge etc), the action is considered as the action taken by whole participation set. For regular (non-MegaSign) documents, there is no limit on the number of electronic signatures in a single document. Written signatures are limited to four per document | [optional] +**hasFormFieldData** | **Boolean** | True if form field data is present. If provided in POST or PUT, it will simply be ignored. | [optional] +**expirationTime** | [**Date**](Date.md) | Time after which Agreement expires and needs to be signed before it. Format should be yyyy-MM-dd'T'HH:mm:ssZ. For example, e.g 2016-02-25T18:46:19Z represents UTC time. Should not be provided in offline agreement creation. | [optional] +**formFieldLayerTemplates** | [**List<FileInfo>**](FileInfo.md) | Specifies the form field layer template or source of form fields to apply on the files in this transaction. If specified, the FileInfo for this parameter must refer to a form field layer template via libraryDocumentId or libraryDocumentName, or if specified via transientDocumentId or documentURL, it must be of a supported file type. Note: Only one of the four parameters in every FileInfo object must be specified | [optional] +**name** | **String** | The name of the agreement that will be used to identify it, in emails, website and other places | [optional] +**fileInfos** | [**List<FileInfo>**](FileInfo.md) | A list of one or more files (or references to files) that will be sent out for signature. If more than one file is provided, they will be combined into one PDF before being sent out. Note: Only one of the four parameters in every FileInfo object must be specified | [optional] **workflowId** | **String** | The identifier of custom workflow which defines the routing path of an agreement. Should not be provided in offline agreement creation. | [optional] +**status** | [**StatusEnum**](#StatusEnum) | This is a server generated attribute which provides the detailed status of an agreement. | [optional] - -## Enum: ReminderFrequencyEnum + +## Enum: TypeEnum Name | Value ---- | ----- -DAILY_UNTIL_SIGNED | "DAILY_UNTIL_SIGNED" -WEEKDAILY_UNTIL_SIGNED | "WEEKDAILY_UNTIL_SIGNED" -EVERY_OTHER_DAY_UNTIL_SIGNED | "EVERY_OTHER_DAY_UNTIL_SIGNED" -EVERY_THIRD_DAY_UNTIL_SIGNED | "EVERY_THIRD_DAY_UNTIL_SIGNED" -EVERY_FIFTH_DAY_UNTIL_SIGNED | "EVERY_FIFTH_DAY_UNTIL_SIGNED" -WEEKLY_UNTIL_SIGNED | "WEEKLY_UNTIL_SIGNED" -ONCE | "ONCE" +AGREEMENT | "AGREEMENT" +MEGASIGN_CHILD | "MEGASIGN_CHILD" +WIDGET_INSTANCE | "WIDGET_INSTANCE" + + + +## Enum: StateEnum +Name | Value +---- | ----- +AUTHORING | "AUTHORING" +DRAFT | "DRAFT" +IN_PROCESS | "IN_PROCESS" @@ -52,13 +64,17 @@ ESIGN | "ESIGN" WRITTEN | "WRITTEN" - -## Enum: StateEnum + +## Enum: ReminderFrequencyEnum Name | Value ---- | ----- -AUTHORING | "AUTHORING" -DRAFT | "DRAFT" -IN_PROCESS | "IN_PROCESS" +DAILY_UNTIL_SIGNED | "DAILY_UNTIL_SIGNED" +WEEKDAILY_UNTIL_SIGNED | "WEEKDAILY_UNTIL_SIGNED" +EVERY_OTHER_DAY_UNTIL_SIGNED | "EVERY_OTHER_DAY_UNTIL_SIGNED" +EVERY_THIRD_DAY_UNTIL_SIGNED | "EVERY_THIRD_DAY_UNTIL_SIGNED" +EVERY_FIFTH_DAY_UNTIL_SIGNED | "EVERY_FIFTH_DAY_UNTIL_SIGNED" +WEEKLY_UNTIL_SIGNED | "WEEKLY_UNTIL_SIGNED" +ONCE | "ONCE" diff --git a/docs/AgreementView.md b/docs/AgreementView.md index 0016d68..c8ad4d8 100755 --- a/docs/AgreementView.md +++ b/docs/AgreementView.md @@ -4,10 +4,10 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**embeddedCode** | **String** | Embedded code of url of resource | [optional] -**expiration** | [**Date**](Date.md) | Expiration of user url | [optional] **isCurrent** | **Boolean** | True if this view is the current view | [optional] +**embeddedCode** | **String** | Embedded code of url of resource | [optional] **name** | [**NameEnum**](#NameEnum) | Name of the requested agreement view | [optional] +**expiration** | [**Date**](Date.md) | Expiration of user url | [optional] **url** | **String** | Url of resource location | [optional] diff --git a/docs/AgreementViewInfo.md b/docs/AgreementViewInfo.md index d3f4ab5..e1e842d 100755 --- a/docs/AgreementViewInfo.md +++ b/docs/AgreementViewInfo.md @@ -4,8 +4,8 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**commonViewConfiguration** | [**CommonViewConfiguration**](CommonViewConfiguration.md) | Common view configuration for all the available views | [optional] **composeViewConfiguration** | [**ComposeViewConfiguration**](ComposeViewConfiguration.md) | Compose page view configuration | [optional] +**commonViewConfiguration** | [**CommonViewConfiguration**](CommonViewConfiguration.md) | Common view configuration for all the available views | [optional] **name** | [**NameEnum**](#NameEnum) | Name of the requested agreement view | [optional] diff --git a/docs/AgreementsApi.md b/docs/AgreementsApi.md index cedc725..56a12b2 100755 --- a/docs/AgreementsApi.md +++ b/docs/AgreementsApi.md @@ -1,6 +1,6 @@ # AgreementsApi -All URIs are relative to *http://localhost/api/rest/v6* +All URIs are relative to *https://secure.au1.echosign.com/api/rest/v6* Method | HTTP request | Description ------------- | ------------- | ------------- @@ -10,8 +10,10 @@ Method | HTTP request | Description [**createDelegatedParticipantSets**](AgreementsApi.md#createDelegatedParticipantSets) | **POST** /agreements/{agreementId}/members/participantSets/{participantSetId}/delegatedParticipantSets | Creates a participantSet to which the agreement is forwarded for taking appropriate action. [**createReminderOnParticipant**](AgreementsApi.md#createReminderOnParticipant) | **POST** /agreements/{agreementId}/reminders | Creates a reminder on the specified participants of an agreement identified by agreementId in the path. [**createShareOnAgreement**](AgreementsApi.md#createShareOnAgreement) | **POST** /agreements/{agreementId}/members/share | Share an agreement with someone. +[**createSignerIdentityReport**](AgreementsApi.md#createSignerIdentityReport) | **POST** /agreements/{agreementId}/signerIdentityReport | Retrieves the signer identity report of an agreement identified by agreementId. [**deleteDocuments**](AgreementsApi.md#deleteDocuments) | **DELETE** /agreements/{agreementId}/documents | Deletes all the documents of an agreement. [**getAgreementInfo**](AgreementsApi.md#getAgreementInfo) | **GET** /agreements/{agreementId} | Retrieves the current status of an agreement. +[**getAgreementInfoForUser**](AgreementsApi.md#getAgreementInfoForUser) | **GET** /agreements/{agreementId}/me | Retrieves the agreement information related to the api caller [**getAgreementNoteForApiUser**](AgreementsApi.md#getAgreementNoteForApiUser) | **GET** /agreements/{agreementId}/me/note | Retrieves the latest note associated with an agreement. [**getAgreementReminder**](AgreementsApi.md#getAgreementReminder) | **GET** /agreements/{agreementId}/reminders/{reminderId} | Retrieves a specific reminder associated with an agreement [**getAgreementReminders**](AgreementsApi.md#getAgreementReminders) | **GET** /agreements/{agreementId}/reminders | Retrieves the reminders of an agreement, identified by agreementId in the path. @@ -39,6 +41,7 @@ Method | HTTP request | Description [**updateAgreementReminder**](AgreementsApi.md#updateAgreementReminder) | **PUT** /agreements/{agreementId}/reminders/{reminderId} | Updates an existing reminder for an agreement [**updateAgreementSecurityOptionsForParticipation**](AgreementsApi.md#updateAgreementSecurityOptionsForParticipation) | **PUT** /agreements/{agreementId}/members/participantSets/{participantSetId}/participants/{participantId}/securityOptions | Updates the security options for a particular participant. [**updateAgreementState**](AgreementsApi.md#updateAgreementState) | **PUT** /agreements/{agreementId}/state | Updates the state of an agreement identified by agreementId in the path. +[**updateAgreementVaulted**](AgreementsApi.md#updateAgreementVaulted) | **PUT** /agreements/{agreementId}/vaulted | Complete the vaulting process and update the agreement as vaulted. [**updateAgreementVisibility**](AgreementsApi.md#updateAgreementVisibility) | **PUT** /agreements/{agreementId}/me/visibility | Updates the visibility of an agreement. [**updateFormFields**](AgreementsApi.md#updateFormFields) | **PUT** /agreements/{agreementId}/formFields | Updates form fields of an agreement. This will replace all fields in AUTHORING mode agreements, and will replace all fields except for text tag generated fields in DRAFT mode agreements. [**updateParticipantSet**](AgreementsApi.md#updateParticipantSet) | **PUT** /agreements/{agreementId}/members/participantSets/{participantSetId} | Updates the participant set of an agreement identified by agreementId in the path. @@ -46,7 +49,7 @@ Method | HTTP request | Description # **addTemplateFieldsToAgreement** -> AgreementFormFields addTemplateFieldsToAgreement(authorization, ifMatch, agreementId, formFieldPostInfo, xApiUser, xOnBehalfOfUser) +> AgreementFormFields addTemplateFieldsToAgreement(authorization, agreementId, formFieldPostInfo, xApiUser, xOnBehalfOfUser, ifMatch) Adds template fields to an agreement @@ -59,13 +62,13 @@ Adds template fields to an agreement AgreementsApi apiInstance = new AgreementsApi(); String authorization = "authorization_example"; // String | An OAuth Access Token with scopes:in the format 'Bearer {accessToken}'. -String ifMatch = "ifMatch_example"; // String | The server will only update the resource if it matches the listed ETag otherwise error RESOURCE_MODIFIED(412) is returned. String agreementId = "agreementId_example"; // String | The agreement identifier, as returned by the agreement creation API or retrieved from the API to fetch agreements. FormFieldPostInfo formFieldPostInfo = new FormFieldPostInfo(); // FormFieldPostInfo | List of form fields to add or replace String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or email in the format userid:{userId} OR email:{email}. of the user that has shared his/her account +String ifMatch = "ifMatch_example"; // String | The server will only update the resource if it matches the listed ETag otherwise error RESOURCE_MODIFIED(412) is returned. try { - AgreementFormFields result = apiInstance.addTemplateFieldsToAgreement(authorization, ifMatch, agreementId, formFieldPostInfo, xApiUser, xOnBehalfOfUser); + AgreementFormFields result = apiInstance.addTemplateFieldsToAgreement(authorization, agreementId, formFieldPostInfo, xApiUser, xOnBehalfOfUser, ifMatch); System.out.println(result); } catch (ApiException e) { System.err.println("Exception when calling AgreementsApi#addTemplateFieldsToAgreement"); @@ -78,11 +81,11 @@ try { Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **authorization** | **String**| An <a href=\"#\" onclick=\"this.href=oauthDoc()\" oncontextmenu=\"this.href=oauthDoc()\" target=\"oauthDoc\">OAuth Access Token</a> with scopes:<ul><li style='list-style-type: square'><a href=\"#\" onclick=\"this.href=oauthDoc('agreement_write')\" oncontextmenu=\"this.href=oauthDoc('agreement_write')\" target=\"oauthDoc\">agreement_write</a></li></ul>in the format <b>'Bearer {accessToken}'. | - **ifMatch** | **String**| The server will only update the resource if it matches the listed ETag otherwise error RESOURCE_MODIFIED(412) is returned. | **agreementId** | **String**| The agreement identifier, as returned by the agreement creation API or retrieved from the API to fetch agreements. | **formFieldPostInfo** | [**FormFieldPostInfo**](FormFieldPostInfo.md)| List of form fields to add or replace | **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] **xOnBehalfOfUser** | **String**| The userId or email in the format <b>userid:{userId} OR email:{email}.</b> of the user that has shared his/her account | [optional] + **ifMatch** | **String**| The server will only update the resource if it matches the listed ETag otherwise error RESOURCE_MODIFIED(412) is returned. | [optional] ### Return type @@ -354,9 +357,60 @@ No authorization required - **Content-Type**: Not defined - **Accept**: application/json + +# **createSignerIdentityReport** +> byte[] createSignerIdentityReport(authorization, agreementId, xApiUser, signerIdentityReportInfo) + +Retrieves the signer identity report of an agreement identified by agreementId. + +PDF file stream containing signer identify information + +### Example +```java +// Import classes: +//import io.swagger.client.model.ApiException; +//import io.swagger.client.api.AgreementsApi; + + +AgreementsApi apiInstance = new AgreementsApi(); +String authorization = "authorization_example"; // String | An OAuth Access Token with scopes:in the format 'Bearer {accessToken}'. +String agreementId = "agreementId_example"; // String | The agreement identifier, as returned by the agreement creation API or retrieved from the API to fetch agreements. +String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. +SignerIdentityReportInfo signerIdentityReportInfo = new SignerIdentityReportInfo(); // SignerIdentityReportInfo | Information about the agreement for which you want to create signer identity report. +try { + byte[] result = apiInstance.createSignerIdentityReport(authorization, agreementId, xApiUser, signerIdentityReportInfo); + System.out.println(result); +} catch (ApiException e) { + System.err.println("Exception when calling AgreementsApi#createSignerIdentityReport"); + e.printStackTrace(); +} +``` + +### Parameters + +Name | Type | Description | Notes +------------- | ------------- | ------------- | ------------- + **authorization** | **String**| An <a href=\"#\" onclick=\"this.href=oauthDoc()\" oncontextmenu=\"this.href=oauthDoc()\" target=\"oauthDoc\">OAuth Access Token</a> with scopes:<ul><li style='list-style-type: square'><a href=\"#\" onclick=\"this.href=oauthDoc('agreement_read')\" oncontextmenu=\"this.href=oauthDoc('agreement_read')\" target=\"oauthDoc\">agreement_read</a></li></ul>in the format <b>'Bearer {accessToken}'. | + **agreementId** | **String**| The agreement identifier, as returned by the agreement creation API or retrieved from the API to fetch agreements. | + **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] + **signerIdentityReportInfo** | [**SignerIdentityReportInfo**](SignerIdentityReportInfo.md)| Information about the agreement for which you want to create signer identity report. | [optional] + +### Return type + +**byte[]** + +### Authorization + +No authorization required + +### HTTP request headers + + - **Content-Type**: Not defined + - **Accept**: application/pdf, application/pdf;encoding=base64 + # **deleteDocuments** -> deleteDocuments(authorization, ifMatch, agreementId, xApiUser, xOnBehalfOfUser) +> deleteDocuments(authorization, agreementId, xApiUser, xOnBehalfOfUser, ifMatch) Deletes all the documents of an agreement. @@ -369,12 +423,12 @@ Deletes all the documents of an agreement. AgreementsApi apiInstance = new AgreementsApi(); String authorization = "authorization_example"; // String | An OAuth Access Token with scopes:in the format 'Bearer {accessToken}'. -String ifMatch = "ifMatch_example"; // String | The server will only update the resource if it matches the listed ETag otherwise error RESOURCE_MODIFIED(412) is returned. String agreementId = "agreementId_example"; // String | The agreement identifier, as returned by the agreement creation API or retrieved from the API to fetch agreements. String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or email in the format userid:{userId} OR email:{email}. of the user that has shared his/her account +String ifMatch = "ifMatch_example"; // String | The server will only update the resource if it matches the listed ETag otherwise error RESOURCE_MODIFIED(412) is returned. try { - apiInstance.deleteDocuments(authorization, ifMatch, agreementId, xApiUser, xOnBehalfOfUser); + apiInstance.deleteDocuments(authorization, agreementId, xApiUser, xOnBehalfOfUser, ifMatch); } catch (ApiException e) { System.err.println("Exception when calling AgreementsApi#deleteDocuments"); e.printStackTrace(); @@ -386,10 +440,10 @@ try { Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **authorization** | **String**| An <a href=\"#\" onclick=\"this.href=oauthDoc()\" oncontextmenu=\"this.href=oauthDoc()\" target=\"oauthDoc\">OAuth Access Token</a> with scopes:<ul><li style='list-style-type: square'><a href=\"#\" onclick=\"this.href=oauthDoc('agreement_retention')\" oncontextmenu=\"this.href=oauthDoc('agreement_retention')\" target=\"oauthDoc\">agreement_retention</a></li></ul>in the format <b>'Bearer {accessToken}'. | - **ifMatch** | **String**| The server will only update the resource if it matches the listed ETag otherwise error RESOURCE_MODIFIED(412) is returned. | **agreementId** | **String**| The agreement identifier, as returned by the agreement creation API or retrieved from the API to fetch agreements. | **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] **xOnBehalfOfUser** | **String**| The userId or email in the format <b>userid:{userId} OR email:{email}.</b> of the user that has shared his/her account | [optional] + **ifMatch** | **String**| The server will only update the resource if it matches the listed ETag otherwise error RESOURCE_MODIFIED(412) is returned. | [optional] ### Return type @@ -406,7 +460,7 @@ No authorization required # **getAgreementInfo** -> AgreementInfo getAgreementInfo(authorization, agreementId, xApiUser, xOnBehalfOfUser, ifNoneMatch) +> FetchedAgreementInfo getAgreementInfo(authorization, agreementId, xApiUser, xOnBehalfOfUser, ifNoneMatch) Retrieves the current status of an agreement. @@ -424,7 +478,7 @@ String xApiUser = "xApiUser_example"; // String | The userId or email of API cal String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or email in the format userid:{userId} OR email:{email}. of the user that has shared his/her account String ifNoneMatch = "ifNoneMatch_example"; // String | Pass the value of the e-tag header obtained from the previous response to the same request to get a RESOURCE_NOT_MODIFIED(304) if the resource hasn't changed. try { - AgreementInfo result = apiInstance.getAgreementInfo(authorization, agreementId, xApiUser, xOnBehalfOfUser, ifNoneMatch); + FetchedAgreementInfo result = apiInstance.getAgreementInfo(authorization, agreementId, xApiUser, xOnBehalfOfUser, ifNoneMatch); System.out.println(result); } catch (ApiException e) { System.err.println("Exception when calling AgreementsApi#getAgreementInfo"); @@ -444,7 +498,54 @@ Name | Type | Description | Notes ### Return type -[**AgreementInfo**](AgreementInfo.md) +[**FetchedAgreementInfo**](FetchedAgreementInfo.md) + +### Authorization + +No authorization required + +### HTTP request headers + + - **Content-Type**: Not defined + - **Accept**: application/json + + +# **getAgreementInfoForUser** +> MyAgreementInfo getAgreementInfoForUser(authorization, agreementId, xApiUser) + +Retrieves the agreement information related to the api caller + +### Example +```java +// Import classes: +//import io.swagger.client.model.ApiException; +//import io.swagger.client.api.AgreementsApi; + + +AgreementsApi apiInstance = new AgreementsApi(); +String authorization = "authorization_example"; // String | An OAuth Access Token with scopes:in the format 'Bearer {accessToken}'. +String agreementId = "agreementId_example"; // String | The agreement identifier, as returned by the agreement creation API or retrieved from the API to fetch agreements. +String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. +try { + MyAgreementInfo result = apiInstance.getAgreementInfoForUser(authorization, agreementId, xApiUser); + System.out.println(result); +} catch (ApiException e) { + System.err.println("Exception when calling AgreementsApi#getAgreementInfoForUser"); + e.printStackTrace(); +} +``` + +### Parameters + +Name | Type | Description | Notes +------------- | ------------- | ------------- | ------------- + **authorization** | **String**| An <a href=\"#\" onclick=\"this.href=oauthDoc()\" oncontextmenu=\"this.href=oauthDoc()\" target=\"oauthDoc\">OAuth Access Token</a> with scopes:<ul><li style='list-style-type: square'><a href=\"#\" onclick=\"this.href=oauthDoc('agreement_read')\" oncontextmenu=\"this.href=oauthDoc('agreement_read')\" target=\"oauthDoc\">agreement_read</a></li></ul>in the format <b>'Bearer {accessToken}'. | + **agreementId** | **String**| The agreement identifier, as returned by the agreement creation API or retrieved from the API to fetch agreements. | + **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] + +### Return type + +[**MyAgreementInfo**](MyAgreementInfo.md) ### Authorization @@ -573,7 +674,7 @@ String authorization = "authorization_example"; // String | An userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or email in the format userid:{userId} OR email:{email}. of the user that has shared his/her account -String status = "status_example"; // String | A comma-separated list of reminder statuses of the reminders which should be returned in the response. Currently supported values are ACTIVE, CANCELLED, COMPLETE +String status = "status_example"; // String | A comma-separated list of reminder statuses of the reminders which should be returned in the response. Currently supported values are ACTIVE, CANCELED, COMPLETE try { RemindersResponse result = apiInstance.getAgreementReminders(authorization, agreementId, xApiUser, xOnBehalfOfUser, status); System.out.println(result); @@ -591,7 +692,7 @@ Name | Type | Description | Notes **agreementId** | **String**| The agreement identifier, as returned by the agreement creation API or retrieved from the API to fetch agreements. | **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] **xOnBehalfOfUser** | **String**| The userId or email in the format <b>userid:{userId} OR email:{email}.</b> of the user that has shared his/her account | [optional] - **status** | **String**| A comma-separated list of reminder statuses of the reminders which should be returned in the response. Currently supported values are ACTIVE, CANCELLED, COMPLETE | [optional] + **status** | **String**| A comma-separated list of reminder statuses of the reminders which should be returned in the response. Currently supported values are ACTIVE, CANCELED, COMPLETE | [optional] ### Return type @@ -608,7 +709,7 @@ No authorization required # **getAgreementSecurityOptionsForParticipation** -> ParticipantSecurityOption getAgreementSecurityOptionsForParticipation(authorization, agreementId, participantSetId, participantId, ifNoneMatch, xApiUser) +> ParticipantSecurityOption getAgreementSecurityOptionsForParticipation(authorization, agreementId, participantSetId, participantId, ifNoneMatch, xApiUser, xOnBehalfOfUser) Retrieves the security options for a particular participant. @@ -626,8 +727,9 @@ String participantSetId = "participantSetId_example"; // String | The participan String participantId = "participantId_example"; // String | The participant identifier String ifNoneMatch = "ifNoneMatch_example"; // String | Pass the value of the e-tag header obtained from the previous response to the same request to get a RESOURCE_NOT_MODIFIED(304) if the resource hasn't changed. String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. +String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or email in the format userid:{userId} OR email:{email}. of the user that has shared his/her account try { - ParticipantSecurityOption result = apiInstance.getAgreementSecurityOptionsForParticipation(authorization, agreementId, participantSetId, participantId, ifNoneMatch, xApiUser); + ParticipantSecurityOption result = apiInstance.getAgreementSecurityOptionsForParticipation(authorization, agreementId, participantSetId, participantId, ifNoneMatch, xApiUser, xOnBehalfOfUser); System.out.println(result); } catch (ApiException e) { System.err.println("Exception when calling AgreementsApi#getAgreementSecurityOptionsForParticipation"); @@ -645,6 +747,7 @@ Name | Type | Description | Notes **participantId** | **String**| The participant identifier | **ifNoneMatch** | **String**| Pass the value of the e-tag header obtained from the previous response to the same request to get a RESOURCE_NOT_MODIFIED(304) if the resource hasn't changed. | [optional] **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] + **xOnBehalfOfUser** | **String**| The userId or email in the format <b>userid:{userId} OR email:{email}.</b> of the user that has shared his/her account | [optional] ### Return type @@ -661,7 +764,7 @@ No authorization required # **getAgreements** -> UserAgreements getAgreements(authorization, xApiUser, xOnBehalfOfUser, externalId, showHiddenAgreements, cursor, pageSize) +> UserAgreements getAgreements(authorization, xApiUser, xOnBehalfOfUser, externalId, groupId, showHiddenAgreements, cursor, pageSize) Retrieves agreements for the user. @@ -677,11 +780,12 @@ String authorization = "authorization_example"; // String | An userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or email in the format userid:{userId} OR email:{email}. of the user that has shared his/her account String externalId = "externalId_example"; // String | Case-sensitive ExternalID for which you would like to retrieve agreement information. ExternalId is passed in the call to the agreement creation API. +String groupId = "groupId_example"; // String | The group identifier, as returned by the group creation API or retrieved from the API to fetch groups. Boolean showHiddenAgreements = true; // Boolean | A query parameter to fetch all the hidden agreements along with the visible agreements. Default value is false. String cursor = "cursor_example"; // String | Used to navigate through the pages. If not provided, returns the first page. Integer pageSize = 56; // Integer | Number of intended items in the response page. If not provided, it is decided by the application settings. try { - UserAgreements result = apiInstance.getAgreements(authorization, xApiUser, xOnBehalfOfUser, externalId, showHiddenAgreements, cursor, pageSize); + UserAgreements result = apiInstance.getAgreements(authorization, xApiUser, xOnBehalfOfUser, externalId, groupId, showHiddenAgreements, cursor, pageSize); System.out.println(result); } catch (ApiException e) { System.err.println("Exception when calling AgreementsApi#getAgreements"); @@ -697,6 +801,7 @@ Name | Type | Description | Notes **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] **xOnBehalfOfUser** | **String**| The userId or email in the format <b>userid:{userId} OR email:{email}.</b> of the user that has shared his/her account | [optional] **externalId** | **String**| Case-sensitive ExternalID for which you would like to retrieve agreement information. ExternalId is passed in the call to the agreement creation API. | [optional] + **groupId** | **String**| The group identifier, as returned by the group creation API or retrieved from the API to fetch groups. | [optional] **showHiddenAgreements** | **Boolean**| A query parameter to fetch all the hidden agreements along with the visible agreements. Default value is false. | [optional] **cursor** | **String**| Used to navigate through the pages. If not provided, returns the first page. | [optional] **pageSize** | **Integer**| Number of intended items in the response page. If not provided, it is decided by the application settings. | [optional] @@ -958,7 +1063,7 @@ String ifNoneMatch = "ifNoneMatch_example"; // String | Pass the value of the e- String versionId = "versionId_example"; // String | The version identifier of agreement as provided by the API which retrieves information of a specific agreement. If not provided then latest version will be used. String participantId = "participantId_example"; // String | The participant identifier to be used to retrieve documents. If not mentioned, the participation of api caller is used. Boolean attachSupportingDocuments = true; // Boolean | When set to true, attach corresponding supporting documents to the signed agreement PDF. Default value of this parameter is true. -Boolean attachAuditReport = true; // Boolean | When set to true, attach an audit report to the signed agreement PDF. Default value is false +Boolean attachAuditReport = true; // Boolean | When set to true, attach an audit report to the signed agreement PDF. The default value is false. try { byte[] result = apiInstance.getCombinedDocument(authorization, agreementId, xApiUser, xOnBehalfOfUser, ifNoneMatch, versionId, participantId, attachSupportingDocuments, attachAuditReport); System.out.println(result); @@ -980,7 +1085,7 @@ Name | Type | Description | Notes **versionId** | **String**| The version identifier of agreement as provided by the API which retrieves information of a specific agreement. If not provided then latest version will be used. | [optional] **participantId** | **String**| The participant identifier to be used to retrieve documents. If not mentioned, the participation of api caller is used. | [optional] **attachSupportingDocuments** | **Boolean**| When set to true, attach corresponding supporting documents to the signed agreement PDF. Default value of this parameter is true. | [optional] - **attachAuditReport** | **Boolean**| When set to true, attach an audit report to the signed agreement PDF. Default value is false | [optional] + **attachAuditReport** | **Boolean**| When set to true, attach an audit report to the signed agreement PDF. The default value is false. | [optional] ### Return type @@ -1069,7 +1174,7 @@ String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or em String versionId = "versionId_example"; // String | The version identifier of agreement as provided by the API which retrieves information of a specific agreement. If not provided then latest version will be used. String participantId = "participantId_example"; // String | The participant identifier to be used to retrieve documents. If not mentioned, the participation of api caller is used. Boolean attachSupportingDocuments = true; // Boolean | When set to true, attach corresponding supporting documents to the signed agreement PDF. Default value of this parameter is true. -Boolean attachAuditReport = true; // Boolean | When set to true, attach an audit report to the signed agreement PDF. Default value is false +Boolean attachAuditReport = true; // Boolean | When set to true, attach an audit report to the signed agreement PDF. The default value is false. try { DocumentUrl result = apiInstance.getCombinedDocumentUrl(authorization, agreementId, xApiUser, xOnBehalfOfUser, versionId, participantId, attachSupportingDocuments, attachAuditReport); System.out.println(result); @@ -1090,7 +1195,7 @@ Name | Type | Description | Notes **versionId** | **String**| The version identifier of agreement as provided by the API which retrieves information of a specific agreement. If not provided then latest version will be used. | [optional] **participantId** | **String**| The participant identifier to be used to retrieve documents. If not mentioned, the participation of api caller is used. | [optional] **attachSupportingDocuments** | **Boolean**| When set to true, attach corresponding supporting documents to the signed agreement PDF. Default value of this parameter is true. | [optional] - **attachAuditReport** | **Boolean**| When set to true, attach an audit report to the signed agreement PDF. Default value is false | [optional] + **attachAuditReport** | **Boolean**| When set to true, attach an audit report to the signed agreement PDF. The default value is false. | [optional] ### Return type @@ -1478,7 +1583,7 @@ No authorization required # **getSigningUrl** -> SigningUrlResponse getSigningUrl(authorization, agreementId, xApiUser, ifNoneMatch) +> SigningUrlResponse getSigningUrl(authorization, agreementId, xApiUser, ifNoneMatch, expiry) Retrieves the URL for the e-sign page for the current signer(s) of an agreement. @@ -1494,8 +1599,9 @@ String authorization = "authorization_example"; // String | An userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. String ifNoneMatch = "ifNoneMatch_example"; // String | Pass the value of the e-tag header obtained from the previous response to the same request to get a RESOURCE_NOT_MODIFIED(304) if the resource hasn't changed. +Integer expiry = 56; // Integer | Lifetime of the esignUrl, between 30 and 315360000 seconds. If not provided, it is decided by the application settings. try { - SigningUrlResponse result = apiInstance.getSigningUrl(authorization, agreementId, xApiUser, ifNoneMatch); + SigningUrlResponse result = apiInstance.getSigningUrl(authorization, agreementId, xApiUser, ifNoneMatch, expiry); System.out.println(result); } catch (ApiException e) { System.err.println("Exception when calling AgreementsApi#getSigningUrl"); @@ -1511,6 +1617,7 @@ Name | Type | Description | Notes **agreementId** | **String**| The agreement identifier, as returned by the agreement creation API or retrieved from the API to fetch agreements. | **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] **ifNoneMatch** | **String**| Pass the value of the e-tag header obtained from the previous response to the same request to get a RESOURCE_NOT_MODIFIED(304) if the resource hasn't changed. | [optional] + **expiry** | **Integer**| Lifetime of the esignUrl, between 30 and 315360000 seconds. If not provided, it is decided by the application settings. | [optional] ### Return type @@ -1527,7 +1634,7 @@ No authorization required # **rejectAgreementForParticipation** -> rejectAgreementForParticipation(authorization, ifMatch, agreementId, participantSetId, participantId, agreementRejectionInfo, xApiUser) +> rejectAgreementForParticipation(authorization, agreementId, participantSetId, participantId, agreementRejectionInfo, ifMatch, xApiUser) Rejects the agreement for a participant. @@ -1540,14 +1647,14 @@ Rejects the agreement for a participant. AgreementsApi apiInstance = new AgreementsApi(); String authorization = "authorization_example"; // String | An OAuth Access Token with scopes:in the format 'Bearer {accessToken}'. -String ifMatch = "ifMatch_example"; // String | The server will only update the resource if it matches the listed ETag otherwise error RESOURCE_MODIFIED(412) is returned. String agreementId = "agreementId_example"; // String | The agreement identifier, as returned by the agreement creation API or retrieved from the API to fetch agreements. String participantSetId = "participantSetId_example"; // String | The participant set identifier String participantId = "participantId_example"; // String | The participant identifier AgreementRejectionInfo agreementRejectionInfo = new AgreementRejectionInfo(); // AgreementRejectionInfo | Participant rejection information required for rejecting the agreement +String ifMatch = "ifMatch_example"; // String | The server will only update the resource if it matches the listed ETag otherwise error RESOURCE_MODIFIED(412) is returned. String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. try { - apiInstance.rejectAgreementForParticipation(authorization, ifMatch, agreementId, participantSetId, participantId, agreementRejectionInfo, xApiUser); + apiInstance.rejectAgreementForParticipation(authorization, agreementId, participantSetId, participantId, agreementRejectionInfo, ifMatch, xApiUser); } catch (ApiException e) { System.err.println("Exception when calling AgreementsApi#rejectAgreementForParticipation"); e.printStackTrace(); @@ -1559,11 +1666,11 @@ try { Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **authorization** | **String**| An <a href=\"#\" onclick=\"this.href=oauthDoc()\" oncontextmenu=\"this.href=oauthDoc()\" target=\"oauthDoc\">OAuth Access Token</a> with scopes:<ul><li style='list-style-type: square'><a href=\"#\" onclick=\"this.href=oauthDoc('agreement_write')\" oncontextmenu=\"this.href=oauthDoc('agreement_write')\" target=\"oauthDoc\">agreement_write</a></li></ul>in the format <b>'Bearer {accessToken}'. | - **ifMatch** | **String**| The server will only update the resource if it matches the listed ETag otherwise error RESOURCE_MODIFIED(412) is returned. | **agreementId** | **String**| The agreement identifier, as returned by the agreement creation API or retrieved from the API to fetch agreements. | **participantSetId** | **String**| The participant set identifier | **participantId** | **String**| The participant identifier | **agreementRejectionInfo** | [**AgreementRejectionInfo**](AgreementRejectionInfo.md)| Participant rejection information required for rejecting the agreement | + **ifMatch** | **String**| The server will only update the resource if it matches the listed ETag otherwise error RESOURCE_MODIFIED(412) is returned. | [optional] **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] ### Return type @@ -1581,7 +1688,7 @@ No authorization required # **updateAgreement** -> updateAgreement(authorization, ifMatch, agreementId, agreementInfo, xApiUser, xOnBehalfOfUser) +> updateAgreement(authorization, agreementId, agreementInfo, xApiUser, xOnBehalfOfUser, ifMatch) Updates the agreement in draft state, or update the expirationTime on an existing agreement that is already out for signature. @@ -1594,13 +1701,13 @@ Updates the agreement in draft state, or update the expirationTime on an existin AgreementsApi apiInstance = new AgreementsApi(); String authorization = "authorization_example"; // String | An OAuth Access Token with scopes:in the format 'Bearer {accessToken}'. -String ifMatch = "ifMatch_example"; // String | The server will only update the resource if it matches the listed ETag otherwise error RESOURCE_MODIFIED(412) is returned. String agreementId = "agreementId_example"; // String | The agreement identifier, as returned by the agreement creation API or retrieved from the API to fetch agreements. AgreementInfo agreementInfo = new AgreementInfo(); // AgreementInfo | Information necessary to update a modifiable agreement that is presently out for signature. String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or email in the format userid:{userId} OR email:{email}. of the user that has shared his/her account +String ifMatch = "ifMatch_example"; // String | The server will only update the resource if it matches the listed ETag otherwise error RESOURCE_MODIFIED(412) is returned. try { - apiInstance.updateAgreement(authorization, ifMatch, agreementId, agreementInfo, xApiUser, xOnBehalfOfUser); + apiInstance.updateAgreement(authorization, agreementId, agreementInfo, xApiUser, xOnBehalfOfUser, ifMatch); } catch (ApiException e) { System.err.println("Exception when calling AgreementsApi#updateAgreement"); e.printStackTrace(); @@ -1612,11 +1719,11 @@ try { Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **authorization** | **String**| An <a href=\"#\" onclick=\"this.href=oauthDoc()\" oncontextmenu=\"this.href=oauthDoc()\" target=\"oauthDoc\">OAuth Access Token</a> with scopes:<ul><li style='list-style-type: square'><a href=\"#\" onclick=\"this.href=oauthDoc('agreement_write')\" oncontextmenu=\"this.href=oauthDoc('agreement_write')\" target=\"oauthDoc\">agreement_write</a></li></ul>in the format <b>'Bearer {accessToken}'. | - **ifMatch** | **String**| The server will only update the resource if it matches the listed ETag otherwise error RESOURCE_MODIFIED(412) is returned. | **agreementId** | **String**| The agreement identifier, as returned by the agreement creation API or retrieved from the API to fetch agreements. | **agreementInfo** | [**AgreementInfo**](AgreementInfo.md)| Information necessary to update a modifiable agreement that is presently out for signature. | **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] **xOnBehalfOfUser** | **String**| The userId or email in the format <b>userid:{userId} OR email:{email}.</b> of the user that has shared his/her account | [optional] + **ifMatch** | **String**| The server will only update the resource if it matches the listed ETag otherwise error RESOURCE_MODIFIED(412) is returned. | [optional] ### Return type @@ -1633,7 +1740,7 @@ No authorization required # **updateAgreementMergeInfo** -> updateAgreementMergeInfo(authorization, ifMatch, agreementId, formFieldMergeInfo, xApiUser, xOnBehalfOfUser) +> updateAgreementMergeInfo(authorization, agreementId, formFieldMergeInfo, xApiUser, xOnBehalfOfUser, ifMatch) Set the merge info for an agreement. @@ -1646,13 +1753,13 @@ Set the merge info for an agreement. AgreementsApi apiInstance = new AgreementsApi(); String authorization = "authorization_example"; // String | An OAuth Access Token with scopes:in the format 'Bearer {accessToken}'. -String ifMatch = "ifMatch_example"; // String | The server will only update the resource if it matches the listed ETag otherwise error RESOURCE_MODIFIED(412) is returned. String agreementId = "agreementId_example"; // String | The agreement identifier, as returned by the agreement creation API or retrieved from the API to fetch agreements. FormFieldMergeInfo formFieldMergeInfo = new FormFieldMergeInfo(); // FormFieldMergeInfo | A mapping indicating the default values to set for form fields String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or email in the format userid:{userId} OR email:{email}. of the user that has shared his/her account +String ifMatch = "ifMatch_example"; // String | The server will only update the resource if it matches the listed ETag otherwise error RESOURCE_MODIFIED(412) is returned. try { - apiInstance.updateAgreementMergeInfo(authorization, ifMatch, agreementId, formFieldMergeInfo, xApiUser, xOnBehalfOfUser); + apiInstance.updateAgreementMergeInfo(authorization, agreementId, formFieldMergeInfo, xApiUser, xOnBehalfOfUser, ifMatch); } catch (ApiException e) { System.err.println("Exception when calling AgreementsApi#updateAgreementMergeInfo"); e.printStackTrace(); @@ -1664,11 +1771,11 @@ try { Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **authorization** | **String**| An <a href=\"#\" onclick=\"this.href=oauthDoc()\" oncontextmenu=\"this.href=oauthDoc()\" target=\"oauthDoc\">OAuth Access Token</a> with scopes:<ul><li style='list-style-type: square'><a href=\"#\" onclick=\"this.href=oauthDoc('agreement_write')\" oncontextmenu=\"this.href=oauthDoc('agreement_write')\" target=\"oauthDoc\">agreement_write</a></li></ul>in the format <b>'Bearer {accessToken}'. | - **ifMatch** | **String**| The server will only update the resource if it matches the listed ETag otherwise error RESOURCE_MODIFIED(412) is returned. | **agreementId** | **String**| The agreement identifier, as returned by the agreement creation API or retrieved from the API to fetch agreements. | **formFieldMergeInfo** | [**FormFieldMergeInfo**](FormFieldMergeInfo.md)| A mapping indicating the default values to set for form fields | **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] **xOnBehalfOfUser** | **String**| The userId or email in the format <b>userid:{userId} OR email:{email}.</b> of the user that has shared his/her account | [optional] + **ifMatch** | **String**| The server will only update the resource if it matches the listed ETag otherwise error RESOURCE_MODIFIED(412) is returned. | [optional] ### Return type @@ -1789,7 +1896,7 @@ No authorization required # **updateAgreementSecurityOptionsForParticipation** -> updateAgreementSecurityOptionsForParticipation(authorization, ifMatch, agreementId, participantSetId, participantId, participantSecurityOption, xApiUser) +> updateAgreementSecurityOptionsForParticipation(authorization, agreementId, participantSetId, participantId, participantSecurityOption, ifMatch, xApiUser, xOnBehalfOfUser) Updates the security options for a particular participant. @@ -1802,14 +1909,15 @@ Updates the security options for a particular participant. AgreementsApi apiInstance = new AgreementsApi(); String authorization = "authorization_example"; // String | An OAuth Access Token with scopes:in the format 'Bearer {accessToken}'. -String ifMatch = "ifMatch_example"; // String | The server will only update the resource if it matches the listed ETag otherwise error RESOURCE_MODIFIED(412) is returned. String agreementId = "agreementId_example"; // String | The agreement identifier, as returned by the agreement creation API or retrieved from the API to fetch agreements. String participantSetId = "participantSetId_example"; // String | The participant set identifier String participantId = "participantId_example"; // String | The participant identifier ParticipantSecurityOption participantSecurityOption = new ParticipantSecurityOption(); // ParticipantSecurityOption | Security options that apply to the participant +String ifMatch = "ifMatch_example"; // String | The server will only update the resource if it matches the listed ETag otherwise error RESOURCE_MODIFIED(412) is returned. String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. +String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or email in the format userid:{userId} OR email:{email}. of the user that has shared his/her account try { - apiInstance.updateAgreementSecurityOptionsForParticipation(authorization, ifMatch, agreementId, participantSetId, participantId, participantSecurityOption, xApiUser); + apiInstance.updateAgreementSecurityOptionsForParticipation(authorization, agreementId, participantSetId, participantId, participantSecurityOption, ifMatch, xApiUser, xOnBehalfOfUser); } catch (ApiException e) { System.err.println("Exception when calling AgreementsApi#updateAgreementSecurityOptionsForParticipation"); e.printStackTrace(); @@ -1821,12 +1929,13 @@ try { Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **authorization** | **String**| An <a href=\"#\" onclick=\"this.href=oauthDoc()\" oncontextmenu=\"this.href=oauthDoc()\" target=\"oauthDoc\">OAuth Access Token</a> with scopes:<ul><li style='list-style-type: square'><a href=\"#\" onclick=\"this.href=oauthDoc('agreement_write')\" oncontextmenu=\"this.href=oauthDoc('agreement_write')\" target=\"oauthDoc\">agreement_write</a></li></ul>in the format <b>'Bearer {accessToken}'. | - **ifMatch** | **String**| The server will only update the resource if it matches the listed ETag otherwise error RESOURCE_MODIFIED(412) is returned. | **agreementId** | **String**| The agreement identifier, as returned by the agreement creation API or retrieved from the API to fetch agreements. | **participantSetId** | **String**| The participant set identifier | **participantId** | **String**| The participant identifier | **participantSecurityOption** | [**ParticipantSecurityOption**](ParticipantSecurityOption.md)| Security options that apply to the participant | + **ifMatch** | **String**| The server will only update the resource if it matches the listed ETag otherwise error RESOURCE_MODIFIED(412) is returned. | [optional] **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] + **xOnBehalfOfUser** | **String**| The userId or email in the format <b>userid:{userId} OR email:{email}.</b> of the user that has shared his/her account | [optional] ### Return type @@ -1843,7 +1952,7 @@ No authorization required # **updateAgreementState** -> updateAgreementState(authorization, ifMatch, agreementId, agreementStateInfo, xApiUser, xOnBehalfOfUser) +> updateAgreementState(authorization, agreementId, agreementStateInfo, xApiUser, xOnBehalfOfUser, ifMatch) Updates the state of an agreement identified by agreementId in the path. @@ -1858,13 +1967,13 @@ This endpoint can be used by originator/sender of an agreement to transition bet AgreementsApi apiInstance = new AgreementsApi(); String authorization = "authorization_example"; // String | An OAuth Access Token with scopes:in the format 'Bearer {accessToken}'. -String ifMatch = "ifMatch_example"; // String | The server will only update the resource if it matches the listed ETag otherwise error RESOURCE_MODIFIED(412) is returned. String agreementId = "agreementId_example"; // String | The agreement identifier, as returned by the agreement creation API or retrieved from the API to fetch agreements. AgreementStateInfo agreementStateInfo = new AgreementStateInfo(); // AgreementStateInfo | String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or email in the format userid:{userId} OR email:{email}. of the user that has shared his/her account +String ifMatch = "ifMatch_example"; // String | The server will only update the resource if it matches the listed ETag otherwise error RESOURCE_MODIFIED(412) is returned. try { - apiInstance.updateAgreementState(authorization, ifMatch, agreementId, agreementStateInfo, xApiUser, xOnBehalfOfUser); + apiInstance.updateAgreementState(authorization, agreementId, agreementStateInfo, xApiUser, xOnBehalfOfUser, ifMatch); } catch (ApiException e) { System.err.println("Exception when calling AgreementsApi#updateAgreementState"); e.printStackTrace(); @@ -1876,11 +1985,61 @@ try { Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **authorization** | **String**| An <a href=\"#\" onclick=\"this.href=oauthDoc()\" oncontextmenu=\"this.href=oauthDoc()\" target=\"oauthDoc\">OAuth Access Token</a> with scopes:<ul><li style='list-style-type: square'><a href=\"#\" onclick=\"this.href=oauthDoc('agreement_write')\" oncontextmenu=\"this.href=oauthDoc('agreement_write')\" target=\"oauthDoc\">agreement_write</a></li></ul>in the format <b>'Bearer {accessToken}'. | - **ifMatch** | **String**| The server will only update the resource if it matches the listed ETag otherwise error RESOURCE_MODIFIED(412) is returned. | **agreementId** | **String**| The agreement identifier, as returned by the agreement creation API or retrieved from the API to fetch agreements. | **agreementStateInfo** | [**AgreementStateInfo**](AgreementStateInfo.md)| | **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] **xOnBehalfOfUser** | **String**| The userId or email in the format <b>userid:{userId} OR email:{email}.</b> of the user that has shared his/her account | [optional] + **ifMatch** | **String**| The server will only update the resource if it matches the listed ETag otherwise error RESOURCE_MODIFIED(412) is returned. | [optional] + +### Return type + +null (empty response body) + +### Authorization + +No authorization required + +### HTTP request headers + + - **Content-Type**: Not defined + - **Accept**: application/json + + +# **updateAgreementVaulted** +> updateAgreementVaulted(authorization, agreementId, vaultEventInfo, xApiUser, xOnBehalfOfUser) + +Complete the vaulting process and update the agreement as vaulted. + +### Example +```java +// Import classes: +//import io.swagger.client.model.ApiException; +//import io.swagger.client.api.AgreementsApi; + + +AgreementsApi apiInstance = new AgreementsApi(); +String authorization = "authorization_example"; // String | An OAuth Access Token with scopes:in the format 'Bearer {accessToken}'. +String agreementId = "agreementId_example"; // String | The agreement identifier, as returned by the agreement creation API or retrieved from the API to fetch agreements. +VaultEventInfo vaultEventInfo = new VaultEventInfo(); // VaultEventInfo | Information to vault an agreement +String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. +String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or email in the format userid:{userId} OR email:{email}. of the user that has shared his/her account +try { + apiInstance.updateAgreementVaulted(authorization, agreementId, vaultEventInfo, xApiUser, xOnBehalfOfUser); +} catch (ApiException e) { + System.err.println("Exception when calling AgreementsApi#updateAgreementVaulted"); + e.printStackTrace(); +} +``` + +### Parameters + +Name | Type | Description | Notes +------------- | ------------- | ------------- | ------------- + **authorization** | **String**| An <a href=\"#\" onclick=\"this.href=oauthDoc()\" oncontextmenu=\"this.href=oauthDoc()\" target=\"oauthDoc\">OAuth Access Token</a> with scopes:<ul><li style='list-style-type: square'><a href=\"#\" onclick=\"this.href=oauthDoc('agreement_vault')\" oncontextmenu=\"this.href=oauthDoc('agreement_vault')\" target=\"oauthDoc\">agreement_vault</a></li></ul>in the format <b>'Bearer {accessToken}'. | + **agreementId** | **String**| The agreement identifier, as returned by the agreement creation API or retrieved from the API to fetch agreements. | + **vaultEventInfo** | [**VaultEventInfo**](VaultEventInfo.md)| Information to vault an agreement | + **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] + **xOnBehalfOfUser** | **String**| The userId or email in the format <b>userid:{userId} OR email:{email}.</b> of the user that has shared his/her account | [optional] ### Return type @@ -1947,7 +2106,7 @@ No authorization required # **updateFormFields** -> AgreementFormFields updateFormFields(authorization, ifMatch, agreementId, formFieldPutInfo, xApiUser, xOnBehalfOfUser) +> AgreementFormFields updateFormFields(authorization, agreementId, formFieldPutInfo, xApiUser, xOnBehalfOfUser, ifMatch) Updates form fields of an agreement. This will replace all fields in AUTHORING mode agreements, and will replace all fields except for text tag generated fields in DRAFT mode agreements. @@ -1960,13 +2119,13 @@ Updates form fields of an agreement. This will replace all fields in AUTHORING AgreementsApi apiInstance = new AgreementsApi(); String authorization = "authorization_example"; // String | An OAuth Access Token with scopes:in the format 'Bearer {accessToken}'. -String ifMatch = "ifMatch_example"; // String | The server will only update the resource if it matches the listed ETag otherwise error RESOURCE_MODIFIED(412) is returned. String agreementId = "agreementId_example"; // String | The agreement identifier, as returned by the agreement creation API or retrieved from the API to fetch agreements. -FormFieldPutInfo formFieldPutInfo = new FormFieldPutInfo(); // FormFieldPutInfo | List of form fields to add or replace +FormFieldPutInfo formFieldPutInfo = new FormFieldPutInfo(); // FormFieldPutInfo | List of form fields to set for agreement String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or email in the format userid:{userId} OR email:{email}. of the user that has shared his/her account +String ifMatch = "ifMatch_example"; // String | The server will only update the resource if it matches the listed ETag otherwise error RESOURCE_MODIFIED(412) is returned. try { - AgreementFormFields result = apiInstance.updateFormFields(authorization, ifMatch, agreementId, formFieldPutInfo, xApiUser, xOnBehalfOfUser); + AgreementFormFields result = apiInstance.updateFormFields(authorization, agreementId, formFieldPutInfo, xApiUser, xOnBehalfOfUser, ifMatch); System.out.println(result); } catch (ApiException e) { System.err.println("Exception when calling AgreementsApi#updateFormFields"); @@ -1979,11 +2138,11 @@ try { Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **authorization** | **String**| An <a href=\"#\" onclick=\"this.href=oauthDoc()\" oncontextmenu=\"this.href=oauthDoc()\" target=\"oauthDoc\">OAuth Access Token</a> with scopes:<ul><li style='list-style-type: square'><a href=\"#\" onclick=\"this.href=oauthDoc('agreement_write')\" oncontextmenu=\"this.href=oauthDoc('agreement_write')\" target=\"oauthDoc\">agreement_write</a></li></ul>in the format <b>'Bearer {accessToken}'. | - **ifMatch** | **String**| The server will only update the resource if it matches the listed ETag otherwise error RESOURCE_MODIFIED(412) is returned. | **agreementId** | **String**| The agreement identifier, as returned by the agreement creation API or retrieved from the API to fetch agreements. | - **formFieldPutInfo** | [**FormFieldPutInfo**](FormFieldPutInfo.md)| List of form fields to add or replace | + **formFieldPutInfo** | [**FormFieldPutInfo**](FormFieldPutInfo.md)| List of form fields to set for agreement | **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] **xOnBehalfOfUser** | **String**| The userId or email in the format <b>userid:{userId} OR email:{email}.</b> of the user that has shared his/her account | [optional] + **ifMatch** | **String**| The server will only update the resource if it matches the listed ETag otherwise error RESOURCE_MODIFIED(412) is returned. | [optional] ### Return type @@ -2000,7 +2159,7 @@ No authorization required # **updateParticipantSet** -> updateParticipantSet(authorization, ifMatch, agreementId, participantSetId, detailedParticipantSetInfo, xApiUser, xOnBehalfOfUser) +> updateParticipantSet(authorization, agreementId, participantSetId, detailedParticipantSetInfo, xApiUser, xOnBehalfOfUser, ifMatch) Updates the participant set of an agreement identified by agreementId in the path. @@ -2013,14 +2172,14 @@ Updates the participant set of an agreement identified by agreementId in the pat AgreementsApi apiInstance = new AgreementsApi(); String authorization = "authorization_example"; // String | An OAuth Access Token with scopes:in the format 'Bearer {accessToken}'. -String ifMatch = "ifMatch_example"; // String | The server will only update the resource if it matches the listed ETag otherwise error RESOURCE_MODIFIED(412) is returned. String agreementId = "agreementId_example"; // String | The agreement identifier, as returned by the agreement creation API or retrieved from the API to fetch agreements. String participantSetId = "participantSetId_example"; // String | The participant set identifier DetailedParticipantSetInfo detailedParticipantSetInfo = new DetailedParticipantSetInfo(); // DetailedParticipantSetInfo | The new participant set info. String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or email in the format userid:{userId} OR email:{email}. of the user that has shared his/her account +String ifMatch = "ifMatch_example"; // String | The server will only update the resource if it matches the listed ETag otherwise error RESOURCE_MODIFIED(412) is returned. try { - apiInstance.updateParticipantSet(authorization, ifMatch, agreementId, participantSetId, detailedParticipantSetInfo, xApiUser, xOnBehalfOfUser); + apiInstance.updateParticipantSet(authorization, agreementId, participantSetId, detailedParticipantSetInfo, xApiUser, xOnBehalfOfUser, ifMatch); } catch (ApiException e) { System.err.println("Exception when calling AgreementsApi#updateParticipantSet"); e.printStackTrace(); @@ -2032,12 +2191,12 @@ try { Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **authorization** | **String**| An <a href=\"#\" onclick=\"this.href=oauthDoc()\" oncontextmenu=\"this.href=oauthDoc()\" target=\"oauthDoc\">OAuth Access Token</a> with scopes:<ul><li style='list-style-type: square'><a href=\"#\" onclick=\"this.href=oauthDoc('agreement_write')\" oncontextmenu=\"this.href=oauthDoc('agreement_write')\" target=\"oauthDoc\">agreement_write</a></li></ul>in the format <b>'Bearer {accessToken}'. | - **ifMatch** | **String**| The server will only update the resource if it matches the listed ETag otherwise error RESOURCE_MODIFIED(412) is returned. | **agreementId** | **String**| The agreement identifier, as returned by the agreement creation API or retrieved from the API to fetch agreements. | **participantSetId** | **String**| The participant set identifier | **detailedParticipantSetInfo** | [**DetailedParticipantSetInfo**](DetailedParticipantSetInfo.md)| The new participant set info. | **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] **xOnBehalfOfUser** | **String**| The userId or email in the format <b>userid:{userId} OR email:{email}.</b> of the user that has shared his/her account | [optional] + **ifMatch** | **String**| The server will only update the resource if it matches the listed ETag otherwise error RESOURCE_MODIFIED(412) is returned. | [optional] ### Return type diff --git a/docs/BaseUrisApi.md b/docs/BaseUrisApi.md index 0aa769e..b18b078 100755 --- a/docs/BaseUrisApi.md +++ b/docs/BaseUrisApi.md @@ -1,6 +1,6 @@ # BaseUrisApi -All URIs are relative to *http://localhost/api/rest/v6* +All URIs are relative to *https://secure.au1.echosign.com/api/rest/v6* Method | HTTP request | Description ------------- | ------------- | ------------- diff --git a/docs/BasicDocumentsImageUrlsInfo.md b/docs/BasicDocumentsImageUrlsInfo.md new file mode 100644 index 0000000..1b49ad9 --- /dev/null +++ b/docs/BasicDocumentsImageUrlsInfo.md @@ -0,0 +1,10 @@ + +# BasicDocumentsImageUrlsInfo + +## Properties +Name | Type | Description | Notes +------------ | ------------- | ------------- | ------------- +**documentsImageUrlsInfo** | [**List<DocumentImageUrlsInfo>**](DocumentImageUrlsInfo.md) | A list of original document image URLs info. | [optional] + + + diff --git a/docs/BooleanSettingInfo.md b/docs/BooleanSettingInfo.md new file mode 100644 index 0000000..039aa4f --- /dev/null +++ b/docs/BooleanSettingInfo.md @@ -0,0 +1,11 @@ + +# BooleanSettingInfo + +## Properties +Name | Type | Description | Notes +------------ | ------------- | ------------- | ------------- +**inherited** | **Boolean** | True if setting is inherited from its group or account value. | [optional] +**value** | **Boolean** | Value of the setting. | [optional] + + + diff --git a/docs/CCParticipantInfo.md b/docs/CCParticipantInfo.md index 9ea61b5..29aa01f 100755 --- a/docs/CCParticipantInfo.md +++ b/docs/CCParticipantInfo.md @@ -4,10 +4,12 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**company** | **String** | Company of the CC participant, if available. | [optional] -**email** | **String** | Email of the CC participant of the widget | [optional] +**participantId** | **String** | The unique identifier of the CC participant of the web form. | [optional] +**hidden** | **Boolean** | True if the web form is hidden for the user that is calling the API. Only returned if self is true. | [optional] **name** | **String** | Name of the CC participant, if available. | [optional] -**participantId** | **String** | The unique identifier of the CC participant of the widget. | [optional] +**self** | **Boolean** | True if the CC participant of the web form is the same user that is calling the API. | [optional] +**company** | **String** | Company of the CC participant, if available. | [optional] +**email** | **String** | Email of the CC participant of the web form | [optional] diff --git a/docs/CCsListInfoDescription.md b/docs/CCsListInfoDescription.md new file mode 100644 index 0000000..cfeb62f --- /dev/null +++ b/docs/CCsListInfoDescription.md @@ -0,0 +1,17 @@ + +# CCsListInfoDescription + +## Properties +Name | Type | Description | Notes +------------ | ------------- | ------------- | ------------- +**minListCount** | **Integer** | minimum number of entries allowed in the current CC list | [optional] +**visible** | **Boolean** | Whether current field is visible or not. If visible attribute for this field is false then this field should not be shown in the agreement creation page using this workflow | [optional] +**editable** | **Boolean** | Whether current field can be edited. If editable attribute for this field is false then this field should not be provided in the agreement creation request and default value of this field will be used in agreement creation | [optional] +**name** | **String** | Name of the current CC list | [optional] +**defaultValues** | **List<String>** | An array of default emails that will be used if no input is provided for this list element. | [optional] +**maxListCount** | **Integer** | maximum number of entries allowed in the current CC list | [optional] +**label** | **String** | A display text for the workflow user that can be used for the current CC list | [optional] +**required** | **Boolean** | Whether this field is required or optional | [optional] + + + diff --git a/docs/CommonViewConfiguration.md b/docs/CommonViewConfiguration.md index d418249..b6b8c47 100755 --- a/docs/CommonViewConfiguration.md +++ b/docs/CommonViewConfiguration.md @@ -5,8 +5,8 @@ Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- **autoLoginUser** | **Boolean** | Auto LogIn Flag. If true, the URL returned will automatically log the user in. If false, the URL returned will require the credentials. By default its value is false | [optional] -**locale** | **String** | Message template locale | [optional] **noChrome** | **Boolean** | No Chrome Flag. If true, the embedded page is shown without a navigation header or footer. If false, the standard page header and footer will be present. By default its value is false | [optional] +**locale** | **String** | Message template locale | [optional] diff --git a/docs/DelegatedParticipantSetInfo.md b/docs/DelegatedParticipantSetInfo.md index 3d66dbe..5c00194 100755 --- a/docs/DelegatedParticipantSetInfo.md +++ b/docs/DelegatedParticipantSetInfo.md @@ -4,8 +4,8 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**memberInfos** | [**List<DelegatedParticipantInfo>**](DelegatedParticipantInfo.md) | Array of ParticipantInfo objects, containing participant-specific data (e.g. email). All participants in the array belong to the same set | [optional] **privateMessage** | **String** | Participant set's private message - all participants in the set will receive the same message. This cannot be changed as part of the PUT call. | [optional] +**memberInfos** | [**List<DelegatedParticipantInfo>**](DelegatedParticipantInfo.md) | Array of ParticipantInfo objects, containing participant-specific data (e.g. email). All participants in the array belong to the same set | [optional] diff --git a/docs/DetailedGroupInfo.md b/docs/DetailedGroupInfo.md index f4ede6d..b0ac48e 100755 --- a/docs/DetailedGroupInfo.md +++ b/docs/DetailedGroupInfo.md @@ -4,9 +4,10 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**created** | [**Date**](Date.md) | Date of creation of the group. Format would be yyyy-MM-dd'T'HH:mm:ssZ. For example, e.g 2016-02-25T18:46:19Z represents UTC time | [optional] -**id** | **String** | The unique identifier of the Group. This will be returned as part of GET call but is not mandatory to be passed as part of PUT/POST call for groups/{groupId} | [optional] +**isDefaultGroup** | **Boolean** | Is the default group for the account | [optional] +**created** | [**Date**](Date.md) | Date of creation of the group. This will be ignored as part of POST or PUT calls. Format would be yyyy-MM-dd'T'HH:mm:ssZ. For example, e.g 2016-02-25T18:46:19Z represents UTC time | [optional] **name** | **String** | Name of the group | [optional] +**id** | **String** | The unique identifier of the Group. This will be returned as part of GET call but is not mandatory to be passed as part of PUT/POST call for groups/{groupId} | [optional] diff --git a/docs/DetailedParticipantInfo.md b/docs/DetailedParticipantInfo.md index f3009b3..13eda46 100755 --- a/docs/DetailedParticipantInfo.md +++ b/docs/DetailedParticipantInfo.md @@ -4,23 +4,15 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- +**createdDate** | [**Date**](Date.md) | The date when the participant was added. This will be returned as part of GET call but is ignored if passed as part of PUT call. | [optional] +**hidden** | **Boolean** | True if the agreement is hidden for the user that is calling the API. Only returned if self is true. Ignored (not required) if modifying a participant (PUT). | [optional] +**name** | **String** | The name of the participant, if available. This cannot be changed as part of the PUT call. | [optional] +**self** | **Boolean** | True if this participant is the same user that is calling the API. Returned as part of Get. Ignored (not required) if modifying a participant set (PUT). | [optional] **company** | **String** | The company of the participant, if available. This cannot be changed as part of the PUT call. | [optional] -**email** | **String** | Email of the participant. In case of modifying a participant set (PUT) this is a required field. In case of GET, this is the required field and will always be returned unless it is a fax workflow (legacy agreements) that were created using fax as input | [optional] -**fax** | **String** | Fax of the participant. New Agreements can not be created with fax option. This is only returned for legacy agreements created with fax as participants | [optional] **id** | **String** | The unique identifier of the participant. This will be returned as part of Get call but is not mandatory to be passed as part of PUT call for agreements/{id}/members/participantSets/{id}. | [optional] -**name** | **String** | The name of the participant, if available. This cannot be changed as part of the PUT call. | [optional] -**privateMessage** | **String** | The private message of the participant, if available. This cannot be changed as part of the PUT call. | [optional] +**userId** | **String** | The user ID of the participant. This will be returned as part of GET call but is ignored if passed as part of PUT call. | [optional] +**email** | **String** | Email of the participant. In case of modifying a participant set (PUT) this is a required field. In case of GET, this is the required field and will always be returned unless it is a fax workflow (legacy agreements) that were created using fax as input | [optional] **securityOption** | [**ParticipantSecurityOption**](ParticipantSecurityOption.md) | Security options that apply to the participant. | [optional] -**self** | **Boolean** | True if this participant is the same user that is calling the API. Returned as part of Get. Ignored (not required) if modifying a participant set (PUT). | [optional] -**status** | [**StatusEnum**](#StatusEnum) | The status of the participant. This cannot be changed as part of the PUT call. New participants will be ignored if added with a REPLACED status. | [optional] - - - -## Enum: StatusEnum -Name | Value ----- | ----- -REPLACED | "REPLACED" -ACTIVE | "ACTIVE" diff --git a/docs/DetailedParticipantSetInfo.md b/docs/DetailedParticipantSetInfo.md index 40b109f..12921af 100755 --- a/docs/DetailedParticipantSetInfo.md +++ b/docs/DetailedParticipantSetInfo.md @@ -4,13 +4,13 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**id** | **String** | The unique identifier of the participant set. This cannot be changed as part of the PUT call. | [optional] +**role** | [**RoleEnum**](#RoleEnum) | Role assumed by all participants in the set (signer, approver etc.). | [optional] +**name** | **String** | Name of ParticipantSet (it can be empty, but needs not to be unique in a single megaSign). Maximum no of characters in participant set name is restricted to 255. | [optional] +**id** | **String** | The unique identifier of the participant set. | [optional] +**privateMessage** | **String** | Participant set's private message - all participants in the set will receive the same message. | [optional] **memberInfos** | [**List<DetailedParticipantInfo>**](DetailedParticipantInfo.md) | Array of ParticipantInfo objects, containing participant-specific data (e.g. email). All participants in the array belong to the same set | [optional] -**name** | **String** | Name of ParticipantSet (it can be empty, but needs not to be unique in a single agreement). Maximum no of characters in participant set name is restricted to 255. This cannot be changed as part of the PUT call. | [optional] -**order** | **Integer** | Index indicating sequential signing group (specified for hybrid routing). This cannot be changed as part of the PUT call. | [optional] -**privateMessage** | **String** | Participant set's private message - all participants in the set will receive the same message. This cannot be changed as part of the PUT call. | [optional] -**role** | [**RoleEnum**](#RoleEnum) | Role assumed by all participants in the set (signer, approver etc.). This cannot be changed as part of the PUT call. | [optional] -**status** | [**StatusEnum**](#StatusEnum) | The agreement status with respect to the participant set. This cannot be changed as part of the PUT call. | [optional] +**order** | **Integer** | Index indicating sequential signing group (specified for hybrid routing). | [optional] +**status** | [**StatusEnum**](#StatusEnum) | The megaSign status with respect to the participant set. | [optional] diff --git a/docs/DetailedUserInfo.md b/docs/DetailedUserInfo.md index 1d61cea..1f075fd 100755 --- a/docs/DetailedUserInfo.md +++ b/docs/DetailedUserInfo.md @@ -4,18 +4,21 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**accountType** | [**AccountTypeEnum**](#AccountTypeEnum) | Type of account to which the user belongs (null if no account) | [optional] -**company** | **String** | The name of company of the user | [optional] -**email** | **String** | The email address of the user | [optional] -**firstName** | **String** | The first name of the user | [optional] -**id** | **String** | A unique identifier of the user resource for REST APIs as issued by Sign. | [optional] -**initials** | **String** | The initials of the user | [optional] -**isAccountAdmin** | **Boolean** | True if the user is account admin | [optional] **lastName** | **String** | The last name of the user | [optional] +**initials** | **String** | The initials of the user | [optional] +**accountType** | [**AccountTypeEnum**](#AccountTypeEnum) | Type of account to which the user belongs (null if no account). If provided in POST or PUT it will be ignored. | [optional] **locale** | **String** | The UI locale of the user | [optional] -**phone** | **String** | The phone number of the user | [optional] -**status** | [**StatusEnum**](#StatusEnum) | Status of the user | [optional] **title** | **String** | The job title of the user | [optional] +**accountId** | **String** | The account id of the user | [optional] +**firstName** | **String** | The first name of the user | [optional] +**isAccountAdmin** | **Boolean** | True if the user is account admin | [optional] +**createdDate** | [**Date**](Date.md) | The date the user was created. If provided in POST or PUT it will be ignored | [optional] +**phone** | **String** | The phone number of the user | [optional] +**primaryGroupId** | **String** | Primary group in which the new user should be added. Default is the default group for the account the user is being added to. This will be ignored as part of PUT calls | [optional] +**company** | **String** | The name of company of the user | [optional] +**id** | **String** | A unique identifier of the user resource for REST APIs as issued by Sign. | [optional] +**email** | **String** | The email address of the user | [optional] +**status** | [**StatusEnum**](#StatusEnum) | Status of the user. If provided in POST it will be ignored. | [optional] diff --git a/docs/DetailedWidgetParticipantSetInfo.md b/docs/DetailedWidgetParticipantSetInfo.md index c013e2b..77a0516 100755 --- a/docs/DetailedWidgetParticipantSetInfo.md +++ b/docs/DetailedWidgetParticipantSetInfo.md @@ -4,10 +4,11 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- +**providerParticipantSetInfo** | [**ProviderParticipantSetInfo**](ProviderParticipantSetInfo.md) | Represents the attributes related to a unknown participant's provider. | [optional] +**role** | [**RoleEnum**](#RoleEnum) | Role assumed by all participants in the set (signer, approver etc.). This cannot be changed as part of the PUT call. | [optional] **id** | **String** | The unique identifier of the participant set. This cannot be changed as part of the PUT call. | [optional] **memberInfos** | [**List<DetailedParticipantInfo>**](DetailedParticipantInfo.md) | Array of ParticipantInfo objects, containing participant-specific data (e.g. email). All participants in the array belong to the same set | [optional] **order** | **Integer** | Index indicating sequential signing group (specified for hybrid routing). This cannot be changed as part of the PUT call. | [optional] -**role** | [**RoleEnum**](#RoleEnum) | Role assumed by all participants in the set (signer, approver etc.). This cannot be changed as part of the PUT call. | [optional] diff --git a/docs/DigitalSignatureInfo.md b/docs/DigitalSignatureInfo.md index 6f1b970..c191d34 100755 --- a/docs/DigitalSignatureInfo.md +++ b/docs/DigitalSignatureInfo.md @@ -4,9 +4,9 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- +**name** | **String** | Name captured during digital signing | [optional] **company** | **String** | Company name captured during digital signing | [optional] **email** | **String** | Email captured during digital signing | [optional] -**name** | **String** | Name captured during digital signing | [optional] diff --git a/docs/DisplayParticipantInfo.md b/docs/DisplayParticipantInfo.md index 1db2afd..94d1ebf 100755 --- a/docs/DisplayParticipantInfo.md +++ b/docs/DisplayParticipantInfo.md @@ -4,9 +4,9 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- +**fullName** | **String** | Displays the full name of the user, if available. | [optional] **company** | **String** | Displays the name of the company of the user, if available | [optional] **email** | **String** | Displays the email of the user | [optional] -**fullName** | **String** | Displays the full name of the user, if available. | [optional] diff --git a/docs/Document.md b/docs/Document.md index c8073b2..a4fb08e 100755 --- a/docs/Document.md +++ b/docs/Document.md @@ -4,11 +4,12 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- +**numPages** | **Integer** | Number of pages in the document | [optional] +**createdDate** | [**Date**](Date.md) | The date the document was created | [optional] +**name** | **String** | Name of the original document uploaded. This is returned in GET but not accepted back in PUT | [optional] **id** | **String** | ID of the document. In case of PUT call, this is the only field that is accepted in Document structure. Name and mimeType are ignored in case of PUT call | [optional] **label** | **String** | Label of the document | [optional] **mimeType** | **String** | mimeType of the original file. This is returned in GET but not accepted back in PUT | [optional] -**name** | **String** | Name of the original document uploaded. This is returned in GET but not accepted back in PUT | [optional] -**numPages** | **Integer** | Number of pages in the document | [optional] diff --git a/docs/DocumentImageUrls.md b/docs/DocumentImageUrls.md index 2691193..4533206 100755 --- a/docs/DocumentImageUrls.md +++ b/docs/DocumentImageUrls.md @@ -4,9 +4,9 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**imageSize** | [**ImageSizeEnum**](#ImageSizeEnum) | ImageSize corresponding to the imageUrl returned | [optional] **imageURLs** | [**List<PageImageUrl>**](PageImageUrl.md) | A list of image url (one per page). | [optional] **imagesAvailable** | **Boolean** | true if images for the associated image size is available, else false. | [optional] +**imageSize** | [**ImageSizeEnum**](#ImageSizeEnum) | ImageSize corresponding to the imageUrl returned | [optional] diff --git a/docs/DocumentImageUrlsInfo.md b/docs/DocumentImageUrlsInfo.md index 722357d..a2d5e44 100755 --- a/docs/DocumentImageUrlsInfo.md +++ b/docs/DocumentImageUrlsInfo.md @@ -4,8 +4,8 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**documentId** | **String** | Id of the document | [optional] **documentImageUrlsList** | [**List<DocumentImageUrls>**](DocumentImageUrls.md) | A list of documents image URLs. | [optional] +**documentId** | **String** | Id of the document | [optional] diff --git a/docs/DocumentPageInfo.md b/docs/DocumentPageInfo.md index e48d9e9..a9a000c 100755 --- a/docs/DocumentPageInfo.md +++ b/docs/DocumentPageInfo.md @@ -4,10 +4,10 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**height** | **Double** | Height of the page | [optional] -**index** | **Integer** | Index of the page in combined document starting from 1 | [optional] **rotation** | **Double** | Rotation angle of the page in clockwise direction in degree | [optional] **width** | **Double** | Width of the page | [optional] +**index** | **Integer** | Index of the page in combined document starting from 1 | [optional] +**height** | **Double** | Height of the page | [optional] diff --git a/docs/DocumentsImageUrlsInfo.md b/docs/DocumentsImageUrlsInfo.md index 7d9c8dd..01f42f2 100755 --- a/docs/DocumentsImageUrlsInfo.md +++ b/docs/DocumentsImageUrlsInfo.md @@ -4,8 +4,8 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**originalDocumentsImageUrlsInfo** | [**List<DocumentImageUrlsInfo>**](DocumentImageUrlsInfo.md) | A list of original document image URLs info. | [optional] **supportingDocumentsImageUrlsInfo** | [**List<DocumentImageUrlsInfo>**](DocumentImageUrlsInfo.md) | A list of supporting document image URLs info. | [optional] +**originalDocumentsImageUrlsInfo** | [**List<DocumentImageUrlsInfo>**](DocumentImageUrlsInfo.md) | A list of original document image URLs info. | [optional] diff --git a/docs/ExpirationFieldInfoDescription.md b/docs/ExpirationFieldInfoDescription.md new file mode 100644 index 0000000..d32918c --- /dev/null +++ b/docs/ExpirationFieldInfoDescription.md @@ -0,0 +1,14 @@ + +# ExpirationFieldInfoDescription + +## Properties +Name | Type | Description | Notes +------------ | ------------- | ------------- | ------------- +**maxDays** | **Integer** | Maximum number of days for agreement expiration | [optional] +**visible** | **Boolean** | Whether current field is visible or not. If visible attribute for this field is false then this field should not be visible in the agreement creation UI using this workflow to user | [optional] +**defaultValue** | **String** | default value of the field if input for this field is not provided and this field is required | [optional] +**editable** | **Boolean** | Whether current field can be edited. If editable attribute for this field is false then this field should not be provided in the agreement creation request and default value of this field will be used in agreement creation | [optional] +**required** | **Boolean** | Whether this field is required or optional | [optional] + + + diff --git a/docs/FetchedAgreementInfo.md b/docs/FetchedAgreementInfo.md new file mode 100644 index 0000000..447819d --- /dev/null +++ b/docs/FetchedAgreementInfo.md @@ -0,0 +1,106 @@ + +# FetchedAgreementInfo + +## Properties +Name | Type | Description | Notes +------------ | ------------- | ------------- | ------------- +**groupId** | **String** | The unique identifier of the group to which the agreement belongs to. If not provided during agreement creation, primary group of the creator will be used | [optional] +**locale** | **String** | The locale associated with this agreement - specifies the language for the signing page and emails, for example en_US or fr_FR. If none specified, defaults to the language configured for the agreement sender | [optional] +**type** | [**TypeEnum**](#TypeEnum) | The kind of agreement | [optional] +**vaultingInfo** | [**VaultingInfo**](VaultingInfo.md) | Vaulting properties that allows Adobe Sign to securely store documents with a vault provider | [optional] +**securityOption** | [**SecurityOption**](SecurityOption.md) | Optional secondary security parameters for the agreement. Should not be provided in offline agreement creation. | [optional] +**postSignOption** | [**PostSignOption**](PostSignOption.md) | URL and associated properties for the success page the user will be taken to after completing the signing process. Should not be provided in offline agreement creation. | [optional] +**ccs** | [**List<AgreementCcInfo>**](AgreementCcInfo.md) | A list of one or more CCs that will be copied in the agreement transaction. The CCs will each receive an email at the beginning of the transaction and also when the final document is signed. The email addresses will also receive a copy of the document, attached as a PDF file. Should not be provided in offline agreement creation. | [optional] +**documentVisibilityEnabled** | **Boolean** | If set to true, enable limited document visibility. Should not be provided in offline agreement creation. | [optional] +**isDocumentRetentionApplied** | **Boolean** | Is document retention applied for this resource. If provided in POST or PUT, it will simply be ignored. | [optional] +**hasSignerIdentityReport** | **Boolean** | True if agreement has signer identity report available. If provided in POST or PUT, it will simply be ignored. | [optional] +**lastEventDate** | [**Date**](Date.md) | The date of the last event that occurred for this agreement. Format would be yyyy-MM-dd'T'HH:mm:ssZ. For example, e.g 2016-02-25T18:46:19Z represents UTC time | [optional] +**senderEmail** | **String** | Email of agreement sender. Only provided in GET. Can not be provided in POST/PUT request. If provided in POST/PUT, it will be ignored | [optional] +**id** | **String** | The unique identifier of the agreement.If provided in POST, it will simply be ignored | [optional] +**state** | [**StateEnum**](#StateEnum) | The state in which the agreement should land. The state field can only be provided in POST calls, will never get returned in GET /agreements/{ID} and will be ignored if provided in PUT /agreements/{ID} call. The eventual status of the agreement can be obtained from GET /agreements/ID | [optional] +**mergeFieldInfo** | [**List<MergefieldInfo>**](MergefieldInfo.md) | Optional default values for fields to merge into the document. The values will be presented to the signers for editable fields; for read-only fields the provided values will not be editable during the signing process. Merging data into fields is currently not supported when used with libraryDocumentId or libraryDocumentName. Only file and url are currently supported | [optional] +**firstReminderDelay** | **Integer** | Integer which specifies the delay in hours before sending the first reminder.<br>This is an optional field. The minimum value allowed is 1 hour and the maximum value can’t be more than the difference of agreement creation and expiry time of the agreement in hours.<br>If this is not specified but the reminder frequency is specified, then the first reminder will be sent based on frequency.<br>i.e. if the reminder is created with frequency specified as daily, the firstReminderDelay will be 24 hours. Should not be provided in offline agreement creation. | [optional] +**emailOption** | [**EmailOption**](EmailOption.md) | Email configurations for the agreement. Should not be provided in offline agreement creation or when updating a non draft agreement. | [optional] +**signatureType** | [**SignatureTypeEnum**](#SignatureTypeEnum) | Specifies the type of signature you would like to request - written or e-signature. The possible values are <br> ESIGN : Agreement needs to be signed electronically <br>, WRITTEN : Agreement will be signed using handwritten signature and signed document will be uploaded into the system | [optional] +**externalId** | [**ExternalId**](ExternalId.md) | An arbitrary value from your system, which can be specified at sending time and then later returned or queried. Should not be provided in offline agreement creation. | [optional] +**message** | **String** | An optional message to the participants, describing what is being sent or why their signature is required | [optional] +**deviceInfo** | [**OfflineDeviceInfo**](OfflineDeviceInfo.md) | Device info of the offline device. It should only be provided in case of offline agreement creation. | [optional] +**parentId** | **String** | The parent id of a megaSign child *OR* the originating id of a widget agreement instance | [optional] +**reminderFrequency** | [**ReminderFrequencyEnum**](#ReminderFrequencyEnum) | Optional parameter that sets how often you want to send reminders to the participants. If it is not specified, the default frequency set for the account will be used. Should not be provided in offline agreement creation. If provided in PUT as a different value than the current one, an error will be thrown. | [optional] +**createdDate** | [**Date**](Date.md) | Date when agreement was created. This is a server generated attributed and can not be provided in POST/PUT calls. Format would be yyyy-MM-dd'T'HH:mm:ssZ. For example, e.g 2016-02-25T18:46:19Z represents UTC time | [optional] +**participantSetsInfo** | [**List<ParticipantSetInfo>**](ParticipantSetInfo.md) | A list of one or more participant set. A participant set may have one or more participant. If any member of the participant set takes the action that has been assigned to the set(Sign/Approve/Acknowledge etc), the action is considered as the action taken by whole participation set. For regular (non-MegaSign) documents, there is no limit on the number of electronic signatures in a single document. Written signatures are limited to four per document | [optional] +**hasFormFieldData** | **Boolean** | True if form field data is present. If provided in POST or PUT, it will simply be ignored. | [optional] +**expirationTime** | [**Date**](Date.md) | Time after which Agreement expires and needs to be signed before it. Format should be yyyy-MM-dd'T'HH:mm:ssZ. For example, e.g 2016-02-25T18:46:19Z represents UTC time. Should not be provided in offline agreement creation. | [optional] +**formFieldLayerTemplates** | [**List<FileInfo>**](FileInfo.md) | Specifies the form field layer template or source of form fields to apply on the files in this transaction. If specified, the FileInfo for this parameter must refer to a form field layer template via libraryDocumentId or libraryDocumentName, or if specified via transientDocumentId or documentURL, it must be of a supported file type. Note: Only one of the four parameters in every FileInfo object must be specified | [optional] +**name** | **String** | The name of the agreement that will be used to identify it, in emails, website and other places | [optional] +**fileInfos** | [**List<FileInfo>**](FileInfo.md) | A list of one or more files (or references to files) that will be sent out for signature. If more than one file is provided, they will be combined into one PDF before being sent out. Note: Only one of the four parameters in every FileInfo object must be specified | [optional] +**workflowId** | **String** | The identifier of custom workflow which defines the routing path of an agreement. Should not be provided in offline agreement creation. | [optional] +**status** | [**StatusEnum**](#StatusEnum) | This is a server generated attribute which provides the detailed status of an agreement. | [optional] + + + +## Enum: TypeEnum +Name | Value +---- | ----- +AGREEMENT | "AGREEMENT" +MEGASIGN_CHILD | "MEGASIGN_CHILD" +WIDGET_INSTANCE | "WIDGET_INSTANCE" + + + +## Enum: StateEnum +Name | Value +---- | ----- +AUTHORING | "AUTHORING" +DRAFT | "DRAFT" +IN_PROCESS | "IN_PROCESS" + + + +## Enum: SignatureTypeEnum +Name | Value +---- | ----- +ESIGN | "ESIGN" +WRITTEN | "WRITTEN" + + + +## Enum: ReminderFrequencyEnum +Name | Value +---- | ----- +DAILY_UNTIL_SIGNED | "DAILY_UNTIL_SIGNED" +WEEKDAILY_UNTIL_SIGNED | "WEEKDAILY_UNTIL_SIGNED" +EVERY_OTHER_DAY_UNTIL_SIGNED | "EVERY_OTHER_DAY_UNTIL_SIGNED" +EVERY_THIRD_DAY_UNTIL_SIGNED | "EVERY_THIRD_DAY_UNTIL_SIGNED" +EVERY_FIFTH_DAY_UNTIL_SIGNED | "EVERY_FIFTH_DAY_UNTIL_SIGNED" +WEEKLY_UNTIL_SIGNED | "WEEKLY_UNTIL_SIGNED" +ONCE | "ONCE" + + + +## Enum: StatusEnum +Name | Value +---- | ----- +OUT_FOR_SIGNATURE | "OUT_FOR_SIGNATURE" +OUT_FOR_DELIVERY | "OUT_FOR_DELIVERY" +OUT_FOR_ACCEPTANCE | "OUT_FOR_ACCEPTANCE" +OUT_FOR_FORM_FILLING | "OUT_FOR_FORM_FILLING" +OUT_FOR_APPROVAL | "OUT_FOR_APPROVAL" +AUTHORING | "AUTHORING" +CANCELLED | "CANCELLED" +SIGNED | "SIGNED" +APPROVED | "APPROVED" +DELIVERED | "DELIVERED" +ACCEPTED | "ACCEPTED" +FORM_FILLED | "FORM_FILLED" +EXPIRED | "EXPIRED" +ARCHIVED | "ARCHIVED" +PREFILL | "PREFILL" +WIDGET_WAITING_FOR_VERIFICATION | "WIDGET_WAITING_FOR_VERIFICATION" +DRAFT | "DRAFT" +DOCUMENTS_NOT_YET_PROCESSED | "DOCUMENTS_NOT_YET_PROCESSED" +WAITING_FOR_FAXIN | "WAITING_FOR_FAXIN" +WAITING_FOR_VERIFICATION | "WAITING_FOR_VERIFICATION" + + + diff --git a/docs/FetchedMegaSignInfo.md b/docs/FetchedMegaSignInfo.md new file mode 100644 index 0000000..b312500 --- /dev/null +++ b/docs/FetchedMegaSignInfo.md @@ -0,0 +1,71 @@ + +# FetchedMegaSignInfo + +## Properties +Name | Type | Description | Notes +------------ | ------------- | ------------- | ------------- +**firstReminderDelay** | **Integer** | Integer which specifies the delay in hours before sending the first reminder.<br>This is an optional field. The minimum value allowed is 1 hour and the maximum value can’t be more than the difference of agreement creation and expiry time of the agreement in hours.<br>If this is not specified but the reminder frequency is specified, then the first reminder will be sent based on frequency.<br>i.e. if the reminder is created with frequency specified as daily, the firstReminderDelay will be 24 hours. Cannot be updated in a PUT | [optional] +**groupId** | **String** | The unique identifier of the group to which the megasign agreement will belong to when it is created. If it is not provided during agreement creation the primary group of the creator will be used | [optional] +**childAgreementsInfo** | [**ChildAgreementsInfo**](ChildAgreementsInfo.md) | Info corresponding to each child agreement of the megaSign | [optional] +**signatureType** | [**SignatureTypeEnum**](#SignatureTypeEnum) | Specifies the type of signature you would like to request - written or e-signature. The possible values are <br> ESIGN : Agreement needs to be signed electronically <br>, WRITTEN : Agreement will be signed using handwritten signature and signed document will be uploaded into the system | [optional] +**externalId** | [**ExternalId**](ExternalId.md) | An arbitrary value from your system, which can be specified at sending time and then later returned or queried | [optional] +**locale** | **String** | The locale associated with this agreement - specifies the language for the signing page and emails, for example en_US or fr_FR. If none specified, defaults to the language configured for the agreement sender | [optional] +**message** | **String** | An optional message to the participants, describing what is being sent or why their signature is required | [optional] +**vaultingInfo** | [**VaultingInfo**](VaultingInfo.md) | Vaulting properties that allows Adobe Sign to securely store documents with a vault provider | [optional] +**securityOption** | [**MegaSignSecurityOption**](MegaSignSecurityOption.md) | Optional security parameters for the megasign | [optional] +**postSignOption** | [**PostSignOption**](PostSignOption.md) | URL and associated properties for the success page the user will be taken to after completing the signing process | [optional] +**reminderFrequency** | [**ReminderFrequencyEnum**](#ReminderFrequencyEnum) | Optional parameter that sets how often you want to send reminders to the participants. If it is not specified, the default frequency set for the account will be used | [optional] +**ccs** | [**List<MegaSignCcInfo>**](MegaSignCcInfo.md) | A list of one or more CCs that will be copied in the megasign transaction. The CCs will each receive an email at the beginning of the transaction and also when the final document is signed. The email addresses will also receive a copy of the document, attached as a PDF file | [optional] +**createdDate** | [**Date**](Date.md) | Date when megasign was created. Format would be yyyy-MM-dd'T'HH:mm:ssZ. For example, e.g 2016-02-25T18:46:19Z represents UTC time | [optional] +**isDocumentRetentionApplied** | **Boolean** | Is document retention applied for this resource. If provided in POST or PUT, it will simply be ignored. | [optional] +**expirationTime** | [**Date**](Date.md) | Time after which Agreement expires and needs to be signed before it. Format should be yyyy-MM-dd'T'HH:mm:ssZ. For example, e.g 2016-02-25T18:46:19Z represents UTC time. Should not be provided in offline agreement creation. | [optional] +**lastEventDate** | [**Date**](Date.md) | The date of the last event that occurred for this megasign. Format would be yyyy-MM-dd'T'HH:mm:ssZ. For example, e.g 2016-02-25T18:46:19Z represents UTC time | [optional] +**senderEmail** | **String** | Email of agreement sender. Only provided in GET. Can not be provided in POST/PUT request. If provided in POST/PUT, it will be ignored | [optional] +**name** | **String** | The name of the agreement that will be used to identify it, in emails, website and other places | [optional] +**numChildren** | **Integer** | The total number of MegaSign children associated with the MegaSign parent. If provided in POST, it will be ignored. If modified in PUT, it will throw error MODIFYING_IMMUTABLE_FIELDS | [optional] +**fileInfos** | [**List<FileInfo>**](FileInfo.md) | A list of one or more files (or references to files) that will be sent out for signature. If more than one file is provided, they will be combined into one PDF before being sent out. Note: Only one of the four parameters in every FileInfo object must be specified | [optional] +**id** | **String** | The unique identifier of megasign | [optional] +**state** | [**StateEnum**](#StateEnum) | State of the Megasign | [optional] +**status** | [**StatusEnum**](#StatusEnum) | Status of the Megasign | [optional] + + + +## Enum: SignatureTypeEnum +Name | Value +---- | ----- +ESIGN | "ESIGN" +WRITTEN | "WRITTEN" + + + +## Enum: ReminderFrequencyEnum +Name | Value +---- | ----- +DAILY_UNTIL_SIGNED | "DAILY_UNTIL_SIGNED" +WEEKDAILY_UNTIL_SIGNED | "WEEKDAILY_UNTIL_SIGNED" +EVERY_OTHER_DAY_UNTIL_SIGNED | "EVERY_OTHER_DAY_UNTIL_SIGNED" +EVERY_THIRD_DAY_UNTIL_SIGNED | "EVERY_THIRD_DAY_UNTIL_SIGNED" +EVERY_FIFTH_DAY_UNTIL_SIGNED | "EVERY_FIFTH_DAY_UNTIL_SIGNED" +WEEKLY_UNTIL_SIGNED | "WEEKLY_UNTIL_SIGNED" + + + +## Enum: StateEnum +Name | Value +---- | ----- +PROCESS | "IN_PROCESS" + + + +## Enum: StatusEnum +Name | Value +---- | ----- +AUTHORING | "AUTHORING" +IN_PROCESS | "IN_PROCESS" +CANCELLED | "CANCELLED" +COMPLETED | "COMPLETED" +EXPIRED | "EXPIRED" +PREFILL | "PREFILL" + + + diff --git a/docs/FetchedWidgetInfo.md b/docs/FetchedWidgetInfo.md new file mode 100644 index 0000000..5450cbf --- /dev/null +++ b/docs/FetchedWidgetInfo.md @@ -0,0 +1,49 @@ + +# FetchedWidgetInfo + +## Properties +Name | Type | Description | Notes +------------ | ------------- | ------------- | ------------- +**additionalParticipantSetsInfo** | [**List<WidgetAdditionalParticipationSetInfo>**](WidgetAdditionalParticipationSetInfo.md) | List of all the participants in the web form except web form signer | [optional] +**creatorEmail** | **String** | Email of web form creator. Only returned in GET response. Cannot be provided in POST/PUT request. If provided in POST, it will simply be ignored | [optional] +**groupId** | **String** | The ID of the group to which the widget belongs to. If not provided during creation, primary group of the creator will be used | [optional] +**locale** | **String** | The locale associated with this web form - specifies the language for the signing page and emails, for example en_US or fr_FR. If none specified, defaults to the language configured for the web form creator | [optional] +**vaultingInfo** | [**VaultingInfo**](VaultingInfo.md) | Vaulting properties that allows Adobe Sign to securely store documents with a vault provider | [optional] +**securityOption** | [**SecurityOption**](SecurityOption.md) | Secondary security parameters for the web form | [optional] +**widgetParticipantSetInfo** | [**WidgetParticipantSetInfo**](WidgetParticipantSetInfo.md) | Represents web form participant for whom email should not be provided | [optional] +**widgetInActiveInfo** | [**WidgetInActiveInfo**](WidgetInActiveInfo.md) | The custom message which will be displayed to the user or the URL to which user will be redirected when the web form is accessed in a disabled state. This can only be specified in PUT request | [optional] +**ccs** | [**List<WidgetCcInfo>**](WidgetCcInfo.md) | A list of one or more email addresses that you want to copy on this transaction. The email addresses will each receive an email when the final agreement created through web form is signed. The email addresses will also receive a copy of the document, attached as a PDF file | [optional] +**createdDate** | [**Date**](Date.md) | Date when web form was created. If provided in POST, it will simply be ignored. Format would be yyyy-MM-dd'T'HH:mm:ssZ. For example, e.g 2016-02-25T18:46:19Z represents UTC time | [optional] +**isDocumentRetentionApplied** | **Boolean** | Is document retention applied for this resource. If provided in POST or PUT, it will simply be ignored. | [optional] +**lastEventDate** | [**Date**](Date.md) | The date of the last event that occurred for this web form. Format would be yyyy-MM-dd'T'HH:mm:ssZ. For example, e.g 2016-02-25T18:46:19Z represents UTC time | [optional] +**name** | **String** | The name of the web form that will be used to identify it, in emails, website and other places | [optional] +**completionInfo** | [**WidgetRedirectionInfo**](WidgetRedirectionInfo.md) | URL and associated properties for the success page the web form signer will be taken to after performing desired action on the web form | [optional] +**authFailureInfo** | [**WidgetRedirectionInfo**](WidgetRedirectionInfo.md) | URL and associated properties for the error page the web form signer will be taken after failing to authenticate | [optional] +**fileInfos** | [**List<FileInfo>**](FileInfo.md) | A list of one or more files (or references to files) that will be used to create the web form. If more than one file is provided, they will be combined before the web form is created. Library documents are not permitted. Note: Only one of the four parameters in every FileInfo object must be specified | [optional] +**id** | **String** | A resource identifier that can be used to uniquely identify the web form in other apis. If provided in POST, it will simply be ignored | [optional] +**state** | [**StateEnum**](#StateEnum) | The state in which the web form should land. For example in order to create a web form in DRAFT state, field should be DRAFT. The state field will never get returned in GET /widgets/{ID} and will be ignored if provided in PUT /widgets/{ID} call. The eventual status of the web form can be obtained from GET /widgets/ID | [optional] +**status** | [**StatusEnum**](#StatusEnum) | Status of the Web Form. If provided in POST, it will simply be ignored | [optional] + + + +## Enum: StateEnum +Name | Value +---- | ----- +DRAFT | "DRAFT" +ACTIVE | "ACTIVE" +AUTHORING | "AUTHORING" + + + +## Enum: StatusEnum +Name | Value +---- | ----- +DRAFT | "DRAFT" +AUTHORING | "AUTHORING" +ACTIVE | "ACTIVE" +DOCUMENTS_NOT_YET_PROCESSED | "DOCUMENTS_NOT_YET_PROCESSED" +DISABLED | "DISABLED" +DISCARDED | "DISCARDED" + + + diff --git a/docs/FileInfo.md b/docs/FileInfo.md index cb0ce80..e4b0043 100755 --- a/docs/FileInfo.md +++ b/docs/FileInfo.md @@ -4,8 +4,8 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**document** | [**Document**](Document.md) | A document that is associated with the widget. This field cannot be provided in POST call. In case of GET call, this is the only field returned in the response | [optional] -**transientDocumentId** | **String** | ID for a transient document that will be added to the widget | [optional] +**transientDocumentId** | **String** | ID for a transient document that will be added to the web form | [optional] +**document** | [**Document**](Document.md) | A document that is associated with the web form. This field cannot be provided in POST call. In case of GET call, this is the only field returned in the response | [optional] **urlFileInfo** | [**URLFileInfo**](URLFileInfo.md) | URL for an external document to add to the agreement | [optional] diff --git a/docs/FileInfosDescription.md b/docs/FileInfosDescription.md new file mode 100644 index 0000000..0e2148f --- /dev/null +++ b/docs/FileInfosDescription.md @@ -0,0 +1,13 @@ + +# FileInfosDescription + +## Properties +Name | Type | Description | Notes +------------ | ------------- | ------------- | ------------- +**name** | **String** | Name of the fileInfo element | [optional] +**workflowLibraryDocumentSelectorList** | [**List<WorkflowLibraryDocument>**](WorkflowLibraryDocument.md) | A list of workflow library documents out of which one workflow library document can be selected with this fileInfo object | [optional] +**label** | **String** | Display label of this field for external users | [optional] +**required** | **Boolean** | Whether this field is required or optional | [optional] + + + diff --git a/docs/FileUploadOptions.md b/docs/FileUploadOptions.md index fa8c1be..8f2c66b 100755 --- a/docs/FileUploadOptions.md +++ b/docs/FileUploadOptions.md @@ -4,9 +4,10 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**libraryDocument** | **Boolean** | Whether library documents link should appear or not. Default value is taken as true | [optional] +**canEditFiles** | **Boolean** | Whether the file upload section can be edited by adding or removing files. Default value is taken as true. Changing the default value will alter the compose page view configuration for this agreement, but is not an access control mechanism | [optional] **localFile** | **Boolean** | Whether local file upload button should appear or not. Default value is taken as true | [optional] **webConnectors** | **Boolean** | Whether link to attach documents from web sources like Dropbox should appear or not. Default value is taken as true | [optional] +**libraryDocument** | **Boolean** | Whether library documents link should appear or not. Default value is taken as true | [optional] diff --git a/docs/FormField.md b/docs/FormField.md index 34d34dd..3f707a9 100755 --- a/docs/FormField.md +++ b/docs/FormField.md @@ -4,54 +4,87 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**alignment** | [**AlignmentEnum**](#AlignmentEnum) | Alignment of the text. | [optional] -**assignee** | **String** | Who the field is assigned to. Either a participant set id, null, NOBODY or PREFILL. | [optional] -**backgroundColor** | **String** | Background color of the form field in RGB or HEX format | [optional] +**radioCheckType** | [**RadioCheckTypeEnum**](#RadioCheckTypeEnum) | The type of radio button (if field is radio button, identified by inputType). | [optional] **borderColor** | **String** | Color of the border of the field in RGB or HEX format | [optional] -**borderStyle** | [**BorderStyleEnum**](#BorderStyleEnum) | Style of the border of the field. | [optional] -**borderWidth** | **Double** | Width of the border of the field in pixels | [optional] -**calculated** | **Boolean** | true if this field's value is calculated from an expression, else false | [optional] -**conditionalAction** | [**FormFieldConditionalAction**](FormFieldConditionalAction.md) | A predicate (or set of predicates) that determines whether this field is visible and enabled. | [optional] -**contentType** | [**ContentTypeEnum**](#ContentTypeEnum) | Content Type of the form field. | [optional] +**valueExpression** | **String** | Expression to calculate value of the form field | [optional] +**maskingText** | **String** | Text to mask the masked form field | [optional] **defaultValue** | **String** | Default value of the form field | [optional] -**displayFormat** | **String** | Format of the value of the field to be displayed based on the displayFormatType property. | [optional] -**displayFormatType** | [**DisplayFormatTypeEnum**](#DisplayFormatTypeEnum) | Format type of the text field. | [optional] -**displayLabel** | **String** | Display label attached to the field | [optional] -**fontColor** | **String** | Font color of the form field in RGB or HEX format | [optional] -**fontName** | **String** | Font name of the form field | [optional] -**fontSize** | **Double** | Font size of the form field in points | [optional] -**hiddenOptions** | **List<String>** | Text values which are hidden in a drop down form field | [optional] -**hyperlink** | [**FormFieldHyperlink**](FormFieldHyperlink.md) | Hyperlink-specific data (e.g. as url, link type) | [optional] -**inputType** | [**InputTypeEnum**](#InputTypeEnum) | Input type of the form field | [optional] -**locations** | [**List<FormFieldLocation>**](FormFieldLocation.md) | All locations in a document where the form field is placed | [optional] **masked** | **Boolean** | true if the input entered by the signer has to be masked (like password), false if it shouldn't be | [optional] -**maskingText** | **String** | Text to mask the masked form field | [optional] -**maxLength** | **Integer** | Maximum length of the input text field in terms of no. of characters | [optional] -**maxValue** | **Double** | Upper bound of the number that can be entered by the signer | [optional] **minLength** | **Integer** | Minimum length of the input text field in terms of no. of characters | [optional] -**minValue** | **Double** | Lower bound of the number that can be entered by the signer | [optional] -**name** | **String** | The name of the form field | [optional] **origin** | [**OriginEnum**](#OriginEnum) | Origin of Form Field | [optional] -**radioCheckType** | [**RadioCheckTypeEnum**](#RadioCheckTypeEnum) | The type of radio button (if field is radio button, identified by inputType). | [optional] -**readOnly** | **Boolean** | true if it is a read-only field, else false | [optional] -**required** | **Boolean** | true if it is a mandatory field to be filled by the signer, else false | [optional] **tooltip** | **String** | Text that appears while hovering over the field | [optional] -**urlOverridable** | **Boolean** | For widget text fields only - true if the default value may come from the URL, else false | [optional] -**validation** | [**ValidationEnum**](#ValidationEnum) | Rule for validating the field value. | [optional] +**hiddenOptions** | **List<String>** | Text values which are hidden in a drop down form field | [optional] +**required** | **Boolean** | true if it is a mandatory field to be filled by the signer, else false | [optional] **validationData** | **String** | Further data for validating input with regards to the field's specified format. The contents and interpretation of formatData depends on the value of validation. | [optional] -**validationErrMsg** | **String** | Error message to be shown to the signer if filled value doesn't match the validations of the form field | [optional] -**valueExpression** | **String** | Expression to calculate value of the form field | [optional] +**minValue** | **Double** | Lower bound of the number that can be entered by the signer | [optional] +**borderWidth** | **Double** | Width of the border of the field in pixels | [optional] +**urlOverridable** | **Boolean** | For web form text fields only - true if the default value may come from the URL, else false | [optional] +**inputType** | [**InputTypeEnum**](#InputTypeEnum) | Input type of the form field | [optional] +**borderStyle** | [**BorderStyleEnum**](#BorderStyleEnum) | Style of the border of the field. | [optional] +**calculated** | **Boolean** | true if this field's value is calculated from an expression, else false | [optional] +**contentType** | [**ContentTypeEnum**](#ContentTypeEnum) | Content Type of the form field. | [optional] +**validation** | [**ValidationEnum**](#ValidationEnum) | Rule for validating the field value. | [optional] +**displayLabel** | **String** | Display label attached to the field | [optional] +**hyperlink** | [**FormFieldHyperlink**](FormFieldHyperlink.md) | Hyperlink-specific data (e.g. as url, link type) | [optional] +**backgroundColor** | **String** | Background color of the form field in RGB or HEX format | [optional] **visible** | **Boolean** | If set to false, then the form field is hidden. Otherwise, it is visible. | [optional] +**displayFormatType** | [**DisplayFormatTypeEnum**](#DisplayFormatTypeEnum) | Format type of the text field. | [optional] +**maxValue** | **Double** | Upper bound of the number that can be entered by the signer | [optional] +**validationErrMsg** | **String** | Error message to be shown to the signer if filled value doesn't match the validations of the form field | [optional] +**displayFormat** | **String** | Format of the value of the field to be displayed based on the displayFormatType property. | [optional] **visibleOptions** | **List<String>** | Text values which are visible in a drop down form field | [optional] +**readOnly** | **Boolean** | true if it is a read-only field, else false | [optional] +**fontName** | **String** | Font name of the form field | [optional] +**conditionalAction** | [**FormFieldConditionalAction**](FormFieldConditionalAction.md) | A predicate (or set of predicates) that determines whether this field is visible and enabled. | [optional] +**name** | **String** | The name of the form field | [optional] +**fontSize** | **Double** | Font size of the form field in points | [optional] +**locations** | [**List<FormFieldLocation>**](FormFieldLocation.md) | All locations in a document where the form field is placed | [optional] +**assignee** | **String** | Who the field is assigned to. Valid values are a participant set id, null, \"NOBODY\", \"PREFILL\" or \"EVERYONE\". If set to a participant set id, then any member of that participant set may fill out the field. \"NOBODY\" indicates that the field may not be filled by anybody (e.g. autopopulated fields like transaction number). \"PREFILL\" indicates that the field will be filled by the sender before the agreement is sent out for signing. \"EVERYONE\" exists only in hyperlink fields currently and indicates that it is assigned to all participants. null indicates that anybody may fill out the field. If the propeerty isn't specified, it is treated as null. | [optional] +**alignment** | [**AlignmentEnum**](#AlignmentEnum) | Alignment of the text. | [optional] +**fontColor** | **String** | Font color of the form field in RGB or HEX format | [optional] +**maxLength** | **Integer** | Maximum length of the input text field in terms of no. of characters | [optional] - -## Enum: AlignmentEnum + +## Enum: RadioCheckTypeEnum Name | Value ---- | ----- -LEFT | "LEFT" -RIGHT | "RIGHT" -CENTER | "CENTER" +CIRCLE | "CIRCLE" +CHECK | "CHECK" +CROSS | "CROSS" +DIAMOND | "DIAMOND" +SQUARE | "SQUARE" +STAR | "STAR" + + + +## Enum: OriginEnum +Name | Value +---- | ----- +AUTHORED | "AUTHORED" +GENERATED | "GENERATED" +IMPORTED | "IMPORTED" + + + +## Enum: InputTypeEnum +Name | Value +---- | ----- +TEXT_FIELD | "TEXT_FIELD" +MULTILINE | "MULTILINE" +PASSWORD | "PASSWORD" +RADIO | "RADIO" +CHECKBOX | "CHECKBOX" +DROP_DOWN | "DROP_DOWN" +LISTBOX | "LISTBOX" +SIGNATURE | "SIGNATURE" +PDF_SIGNATURE | "PDF_SIGNATURE" +BUTTON | "BUTTON" +BLOCK | "BLOCK" +FILE_CHOOSER | "FILE_CHOOSER" +COMB | "COMB" +INLINE_IMAGE | "INLINE_IMAGE" +UNSUPPORTED | "UNSUPPORTED" @@ -86,57 +119,7 @@ TRANSACTION_ID | "TRANSACTION_ID" SIGNATURE_STAMP | "SIGNATURE_STAMP" PAYMENT | "PAYMENT" DIGITAL_SIGNATURE | "DIGITAL_SIGNATURE" - - - -## Enum: DisplayFormatTypeEnum -Name | Value ----- | ----- -DEFAULT | "DEFAULT" -DATE | "DATE" -NUMBER | "NUMBER" - - - -## Enum: InputTypeEnum -Name | Value ----- | ----- -TEXT_FIELD | "TEXT_FIELD" -MULTILINE | "MULTILINE" -PASSWORD | "PASSWORD" -RADIO | "RADIO" -CHECKBOX | "CHECKBOX" -DROP_DOWN | "DROP_DOWN" -LISTBOX | "LISTBOX" -SIGNATURE | "SIGNATURE" -PDF_SIGNATURE | "PDF_SIGNATURE" -BUTTON | "BUTTON" -BLOCK | "BLOCK" -FILE_CHOOSER | "FILE_CHOOSER" -COMB | "COMB" -INLINE_IMAGE | "INLINE_IMAGE" -UNSUPPORTED | "UNSUPPORTED" - - - -## Enum: OriginEnum -Name | Value ----- | ----- -AUTHORED | "AUTHORED" -GENERATED | "GENERATED" -IMPORTED | "IMPORTED" - - - -## Enum: RadioCheckTypeEnum -Name | Value ----- | ----- -CIRCLE | "CIRCLE" -CHECK | "CHECK" -CROSS | "CROSS" -DIAMOND | "DIAMOND" -SQUARE | "SQUARE" -STAR | "STAR" +CALC | "CALC" @@ -160,4 +143,22 @@ CUSTOM | "CUSTOM" XFA_PICTURE | "XFA_PICTURE" + +## Enum: DisplayFormatTypeEnum +Name | Value +---- | ----- +DEFAULT | "DEFAULT" +DATE | "DATE" +NUMBER | "NUMBER" + + + +## Enum: AlignmentEnum +Name | Value +---- | ----- +LEFT | "LEFT" +RIGHT | "RIGHT" +CENTER | "CENTER" + + diff --git a/docs/FormFieldConditionPredicate.md b/docs/FormFieldConditionPredicate.md index 350225f..2823511 100755 --- a/docs/FormFieldConditionPredicate.md +++ b/docs/FormFieldConditionPredicate.md @@ -4,10 +4,10 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**fieldLocationIndex** | **Integer** | Index of the location of the form field used in the predicate | [optional] **fieldName** | **String** | Name of the field whose value is the basis of predicate | [optional] -**operator** | [**OperatorEnum**](#OperatorEnum) | Operator to be applied on the value of the predicate field. | [optional] **value** | **String** | Value to compare against the value of the predicate's form field, using the specified operator | [optional] +**operator** | [**OperatorEnum**](#OperatorEnum) | Operator to be applied on the value of the predicate field. | [optional] +**fieldLocationIndex** | **Integer** | Index of the location of the form field used in the predicate | [optional] diff --git a/docs/FormFieldConditionalAction.md b/docs/FormFieldConditionalAction.md index 20ffb29..f4cc8ff 100755 --- a/docs/FormFieldConditionalAction.md +++ b/docs/FormFieldConditionalAction.md @@ -4,9 +4,17 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**action** | [**ActionEnum**](#ActionEnum) | Action to show/hide the form field is to be taken on the basis of evaluation of conditions. | [optional] -**anyOrAll** | [**AnyOrAllEnum**](#AnyOrAllEnum) | It indicates if any one of the conditions or all of them have to be true. | [optional] **predicates** | [**List<FormFieldConditionPredicate>**](FormFieldConditionPredicate.md) | The predicates to be evaluated in order to determine whether this condition is true | [optional] +**anyOrAll** | [**AnyOrAllEnum**](#AnyOrAllEnum) | It indicates if any one of the conditions or all of them have to be true. | [optional] +**action** | [**ActionEnum**](#ActionEnum) | Action to show/hide the form field is to be taken on the basis of evaluation of conditions. | [optional] + + + +## Enum: AnyOrAllEnum +Name | Value +---- | ----- +ALL | "ALL" +ANY | "ANY" @@ -19,12 +27,4 @@ DISABLE | "DISABLE" ENABLE | "ENABLE" - -## Enum: AnyOrAllEnum -Name | Value ----- | ----- -ALL | "ALL" -ANY | "ANY" - - diff --git a/docs/FormFieldHyperlink.md b/docs/FormFieldHyperlink.md index 43c07e9..3f616b8 100755 --- a/docs/FormFieldHyperlink.md +++ b/docs/FormFieldHyperlink.md @@ -4,8 +4,8 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**documentLocation** | [**FormFieldLocation**](FormFieldLocation.md) | Location on the document pointed by the link in case of INTERNAL type link | [optional] **linkType** | [**LinkTypeEnum**](#LinkTypeEnum) | Type of link in an agreement. | [optional] +**documentLocation** | [**FormFieldLocation**](FormFieldLocation.md) | Location on the document pointed by the link in case of INTERNAL type link | [optional] **url** | **String** | URL, in case of EXTERNAL type link | [optional] diff --git a/docs/FormFieldLocation.md b/docs/FormFieldLocation.md index f6a6070..a1f425b 100755 --- a/docs/FormFieldLocation.md +++ b/docs/FormFieldLocation.md @@ -4,11 +4,11 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**height** | **Double** | Height of the form field in pixels | [optional] -**left** | **Double** | No. of pixels from left of the page for form field placement | [optional] **pageNumber** | **Integer** | Number of the page where form field has to be placed, starting from 1. | [optional] **top** | **Double** | No. of pixels from bottom of the page for form field placement | [optional] +**left** | **Double** | No. of pixels from left of the page for form field placement | [optional] **width** | **Double** | Width of the form field in pixels | [optional] +**height** | **Double** | Height of the form field in pixels | [optional] diff --git a/docs/GroupCreationResponse.md b/docs/GroupCreationResponse.md new file mode 100644 index 0000000..31213d2 --- /dev/null +++ b/docs/GroupCreationResponse.md @@ -0,0 +1,10 @@ + +# GroupCreationResponse + +## Properties +Name | Type | Description | Notes +------------ | ------------- | ------------- | ------------- +**id** | **String** | Unique identifier of the group created. | [optional] + + + diff --git a/docs/GroupInfo.md b/docs/GroupInfo.md index dc02890..4a8ae55 100755 --- a/docs/GroupInfo.md +++ b/docs/GroupInfo.md @@ -4,8 +4,10 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**groupId** | **String** | Unique identifier of the group | [optional] +**isDefaultGroup** | **Boolean** | Is the default group for the account | [optional] **groupName** | **String** | Name of the group | [optional] +**createdDate** | [**Date**](Date.md) | Date group was created | [optional] +**groupId** | **String** | Unique identifier of the group | [optional] diff --git a/docs/GroupUserInfo.md b/docs/GroupUserInfo.md index 8880b7b..8db745c 100755 --- a/docs/GroupUserInfo.md +++ b/docs/GroupUserInfo.md @@ -4,12 +4,12 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**company** | **String** | The name of company of the user | [optional] -**email** | **String** | The email address of the user | [optional] **firstName** | **String** | The first name of the user | [optional] -**id** | **String** | A unique identifier of the user resource for REST APIs. This identifier can not be used in SOAP APIs | [optional] -**isGroupAdmin** | **Boolean** | True if user is group admin | [optional] **lastName** | **String** | The last name of the user | [optional] +**isGroupAdmin** | **Boolean** | True if user is group admin | [optional] +**company** | **String** | The name of company of the user | [optional] +**id** | **String** | A unique identifier of the user resource for REST APIs. This identifier can not be used in SOAP APIs | [optional] +**email** | **String** | The email address of the user | [optional] diff --git a/docs/GroupUsersInfo.md b/docs/GroupUsersInfo.md index ac13d3a..33e2195 100755 --- a/docs/GroupUsersInfo.md +++ b/docs/GroupUsersInfo.md @@ -4,8 +4,8 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**page** | [**PageInfo**](PageInfo.md) | Pagination information for navigating through the response | [optional] **userInfoList** | [**List<GroupUserInfo>**](GroupUserInfo.md) | The list of users in the account. | [optional] +**page** | [**PageInfo**](PageInfo.md) | Pagination information for navigating through the response | [optional] diff --git a/docs/GroupsApi.md b/docs/GroupsApi.md index dd1ec3c..a17ef11 100755 --- a/docs/GroupsApi.md +++ b/docs/GroupsApi.md @@ -1,14 +1,110 @@ # GroupsApi -All URIs are relative to *http://localhost/api/rest/v6* +All URIs are relative to *https://secure.au1.echosign.com/api/rest/v6* Method | HTTP request | Description ------------- | ------------- | ------------- +[**createGroup**](GroupsApi.md#createGroup) | **POST** /groups | Creates a new group in an account. +[**deleteGroup**](GroupsApi.md#deleteGroup) | **DELETE** /groups/{groupId} | Delete an existing group. [**getGroupDetails**](GroupsApi.md#getGroupDetails) | **GET** /groups/{groupId} | Retrieves detailed information about the group. [**getGroups**](GroupsApi.md#getGroups) | **GET** /groups | Retrieves all the groups in an account. [**getUsersInGroup**](GroupsApi.md#getUsersInGroup) | **GET** /groups/{groupId}/users | Retrieves all the users in a group. +[**modifyGroup**](GroupsApi.md#modifyGroup) | **PUT** /groups/{groupId} | Update an existing group. + +# **createGroup** +> GroupCreationResponse createGroup(authorization, detailedGroupInfo, xApiUser) + +Creates a new group in an account. + +### Example +```java +// Import classes: +//import io.swagger.client.model.ApiException; +//import io.swagger.client.api.GroupsApi; + + +GroupsApi apiInstance = new GroupsApi(); +String authorization = "authorization_example"; // String | An OAuth Access Token with scopes:in the format 'Bearer {accessToken}'. +DetailedGroupInfo detailedGroupInfo = new DetailedGroupInfo(); // DetailedGroupInfo | Information necessary to create a group. +String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. +try { + GroupCreationResponse result = apiInstance.createGroup(authorization, detailedGroupInfo, xApiUser); + System.out.println(result); +} catch (ApiException e) { + System.err.println("Exception when calling GroupsApi#createGroup"); + e.printStackTrace(); +} +``` + +### Parameters + +Name | Type | Description | Notes +------------- | ------------- | ------------- | ------------- + **authorization** | **String**| An <a href=\"#\" onclick=\"this.href=oauthDoc()\" oncontextmenu=\"this.href=oauthDoc()\" target=\"oauthDoc\">OAuth Access Token</a> with scopes:<ul><li style='list-style-type: square'><a href=\"#\" onclick=\"this.href=oauthDoc('user_write')\" oncontextmenu=\"this.href=oauthDoc('user_write')\" target=\"oauthDoc\">user_write</a></li></ul>in the format <b>'Bearer {accessToken}'. | + **detailedGroupInfo** | [**DetailedGroupInfo**](DetailedGroupInfo.md)| Information necessary to create a group. | + **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] + +### Return type + +[**GroupCreationResponse**](GroupCreationResponse.md) + +### Authorization + +No authorization required + +### HTTP request headers + + - **Content-Type**: Not defined + - **Accept**: application/json + + +# **deleteGroup** +> deleteGroup(authorization, groupId, xApiUser) + +Delete an existing group. + +### Example +```java +// Import classes: +//import io.swagger.client.model.ApiException; +//import io.swagger.client.api.GroupsApi; + + +GroupsApi apiInstance = new GroupsApi(); +String authorization = "authorization_example"; // String | An OAuth Access Token with scopes:in the format 'Bearer {accessToken}'. +String groupId = "groupId_example"; // String | The group identifier, as returned by the group creation API or retrieved from the API to fetch groups +String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. +try { + apiInstance.deleteGroup(authorization, groupId, xApiUser); +} catch (ApiException e) { + System.err.println("Exception when calling GroupsApi#deleteGroup"); + e.printStackTrace(); +} +``` + +### Parameters + +Name | Type | Description | Notes +------------- | ------------- | ------------- | ------------- + **authorization** | **String**| An <a href=\"#\" onclick=\"this.href=oauthDoc()\" oncontextmenu=\"this.href=oauthDoc()\" target=\"oauthDoc\">OAuth Access Token</a> with scopes:<ul><li style='list-style-type: square'><a href=\"#\" onclick=\"this.href=oauthDoc('user_write')\" oncontextmenu=\"this.href=oauthDoc('user_write')\" target=\"oauthDoc\">user_write</a></li></ul>in the format <b>'Bearer {accessToken}'. | + **groupId** | **String**| The group identifier, as returned by the group creation API or retrieved from the API to fetch groups | + **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] + +### Return type + +null (empty response body) + +### Authorization + +No authorization required + +### HTTP request headers + + - **Content-Type**: Not defined + - **Accept**: application/json + # **getGroupDetails** > DetailedGroupInfo getGroupDetails(authorization, groupId, xApiUser) @@ -156,3 +252,51 @@ No authorization required - **Content-Type**: Not defined - **Accept**: application/json + +# **modifyGroup** +> modifyGroup(authorization, groupId, detailedGroupInfo, xApiUser) + +Update an existing group. + +### Example +```java +// Import classes: +//import io.swagger.client.model.ApiException; +//import io.swagger.client.api.GroupsApi; + + +GroupsApi apiInstance = new GroupsApi(); +String authorization = "authorization_example"; // String | An OAuth Access Token with scopes:in the format 'Bearer {accessToken}'. +String groupId = "groupId_example"; // String | The group identifier, as returned by the group creation API or retrieved from the API to fetch groups +DetailedGroupInfo detailedGroupInfo = new DetailedGroupInfo(); // DetailedGroupInfo | Information necessary to update a group. +String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. +try { + apiInstance.modifyGroup(authorization, groupId, detailedGroupInfo, xApiUser); +} catch (ApiException e) { + System.err.println("Exception when calling GroupsApi#modifyGroup"); + e.printStackTrace(); +} +``` + +### Parameters + +Name | Type | Description | Notes +------------- | ------------- | ------------- | ------------- + **authorization** | **String**| An <a href=\"#\" onclick=\"this.href=oauthDoc()\" oncontextmenu=\"this.href=oauthDoc()\" target=\"oauthDoc\">OAuth Access Token</a> with scopes:<ul><li style='list-style-type: square'><a href=\"#\" onclick=\"this.href=oauthDoc('user_write')\" oncontextmenu=\"this.href=oauthDoc('user_write')\" target=\"oauthDoc\">user_write</a></li></ul>in the format <b>'Bearer {accessToken}'. | + **groupId** | **String**| The group identifier, as returned by the group creation API or retrieved from the API to fetch groups | + **detailedGroupInfo** | [**DetailedGroupInfo**](DetailedGroupInfo.md)| Information necessary to update a group. | + **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] + +### Return type + +null (empty response body) + +### Authorization + +No authorization required + +### HTTP request headers + + - **Content-Type**: Not defined + - **Accept**: application/json + diff --git a/docs/LibraryDocument.md b/docs/LibraryDocument.md index 969e206..0b3471b 100755 --- a/docs/LibraryDocument.md +++ b/docs/LibraryDocument.md @@ -4,14 +4,23 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**creatorEmail** | **String** | Email address of the library document creator. It will be ignored in POST/PUT requests | [optional] -**id** | **String** | The unique identifier that is used to refer to the library template | [optional] +**templateTypes** | [**List<TemplateTypesEnum>**](#List<TemplateTypesEnum>) | A list of one or more library template types | [optional] **hidden** | **Boolean** | True if Library Document is hidden | [optional] +**creatorEmail** | **String** | Email address of the library document creator. It will be ignored in POST/PUT requests | [optional] +**sharingMode** | [**SharingModeEnum**](#SharingModeEnum) | Specifies who should have access to this library document. GLOBAL sharing is a restricted operation. | [optional] +**groupId** | **String** | The unique identifier of the group to which the library template belongs to. If not provided during creation, primary group of the creator will be used | [optional] **modifiedDate** | [**Date**](Date.md) | The date on which the library document was last modified. Format would be yyyy-MM-dd'T'HH:mm:ssZ. For example, e.g 2016-02-25T18:46:19Z represents UTC time | [optional] **name** | **String** | The name of the library document | [optional] -**sharingMode** | [**SharingModeEnum**](#SharingModeEnum) | Specifies who should have access to this library document. GLOBAL sharing mode is not applicable in POST/PUT requests | [optional] +**id** | **String** | The unique identifier that is used to refer to the library template | [optional] **status** | [**StatusEnum**](#StatusEnum) | Status of the library document | [optional] -**templateTypes** | [**List<TemplateTypesEnum>**](#List<TemplateTypesEnum>) | A list of one or more library template types | [optional] + + + +## Enum: List<TemplateTypesEnum> +Name | Value +---- | ----- +DOCUMENT | "DOCUMENT" +FORM_FIELD_LAYER | "FORM_FIELD_LAYER" @@ -33,12 +42,4 @@ ACTIVE | "ACTIVE" REMOVED | "REMOVED" - -## Enum: List<TemplateTypesEnum> -Name | Value ----- | ----- -DOCUMENT | "DOCUMENT" -FORM_FIELD_LAYER | "FORM_FIELD_LAYER" - - diff --git a/docs/LibraryDocumentCreationInfoV6.md b/docs/LibraryDocumentCreationInfoV6.md index fbd32ce..d0f70a8 100755 --- a/docs/LibraryDocumentCreationInfoV6.md +++ b/docs/LibraryDocumentCreationInfoV6.md @@ -4,17 +4,20 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**createdDate** | [**Date**](Date.md) | Date when library document was created. It will be ignored in POST/PUT requests. Format would be yyyy-MM-dd'T'HH:mm:ssZ. For example, e.g 2016-02-25T18:46:19Z represents UTC time | [optional] **creatorEmail** | **String** | Email address of the library document creator. It will be ignored in POST/PUT requests | [optional] +**sharingMode** | [**SharingModeEnum**](#SharingModeEnum) | Specifies who should have access to this library document. GLOBAL sharing is a restricted operation. | [optional] +**groupId** | **String** | The unique identifier of the group to which the library template belongs to. If not provided during creation, primary group of the creator will be used | [optional] **creatorName** | **String** | Name of the library document creator. It will be ignored in POST/PUT requests | [optional] -**fileInfos** | [**List<FileInfo>**](FileInfo.md) | A list of one or more files (or references to files) that will be used to create the template. If more than one file is provided, they will be combined into one PDF. Note: Only a single parameter in every FileInfo object must be specified | [optional] -**id** | **String** | The unique identifier that is used to refer to the library template. It will be ignored in POST requests | [optional] +**createdDate** | [**Date**](Date.md) | Date when library document was created. It will be ignored in POST/PUT requests. Format would be yyyy-MM-dd'T'HH:mm:ssZ. For example, e.g 2016-02-25T18:46:19Z represents UTC time | [optional] +**isDocumentRetentionApplied** | **Boolean** | Is document retention applied for this resource. If provided in POST or PUT, it will simply be ignored. | [optional] +**templateTypes** | [**List<TemplateTypesEnum>**](#List<TemplateTypesEnum>) | A list of one or more library template types | [optional] +**lastEventDate** | [**Date**](Date.md) | The date of the last event that occurred for this library document | [optional] **modifiedDate** | [**Date**](Date.md) | Date when library document was last modified. It will be ignored in POST/PUT requests. Format would be yyyy-MM-dd'T'HH:mm:ssZ. For example, e.g 2016-02-25T18:46:19Z represents UTC time | [optional] **name** | **String** | The name of the library template that will be used to identify it, in emails and on the website | [optional] -**sharingMode** | [**SharingModeEnum**](#SharingModeEnum) | Specifies who should have access to this library document. GLOBAL sharing mode is not applicable in POST/PUT requests | [optional] +**fileInfos** | [**List<FileInfo>**](FileInfo.md) | A list of one or more files (or references to files) that will be used to create the template. If more than one file is provided, they will be combined into one PDF. Note: Only a single parameter in every FileInfo object must be specified | [optional] +**id** | **String** | The unique identifier that is used to refer to the library template. It will be ignored in POST requests | [optional] **state** | [**StateEnum**](#StateEnum) | State of the library document. | [optional] **status** | [**StatusEnum**](#StatusEnum) | Status of the library document | [optional] -**templateTypes** | [**List<TemplateTypesEnum>**](#List<TemplateTypesEnum>) | A list of one or more library template types | [optional] @@ -27,6 +30,14 @@ ACCOUNT | "ACCOUNT" GLOBAL | "GLOBAL" + +## Enum: List<TemplateTypesEnum> +Name | Value +---- | ----- +DOCUMENT | "DOCUMENT" +FORM_FIELD_LAYER | "FORM_FIELD_LAYER" + + ## Enum: StateEnum Name | Value @@ -44,12 +55,4 @@ ACTIVE | "ACTIVE" REMOVED | "REMOVED" - -## Enum: List<TemplateTypesEnum> -Name | Value ----- | ----- -DOCUMENT | "DOCUMENT" -FORM_FIELD_LAYER | "FORM_FIELD_LAYER" - - diff --git a/docs/LibraryDocumentEvent.md b/docs/LibraryDocumentEvent.md index 44c367a..e8555a2 100755 --- a/docs/LibraryDocumentEvent.md +++ b/docs/LibraryDocumentEvent.md @@ -4,25 +4,36 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**actingUserEmail** | **String** | Email address of the user that created the event | [optional] -**actingUserIpAddress** | **String** | The IP address of the user that created the event | [optional] -**actingUserName** | **String** | The name of the acting user | [optional] -**comment** | **String** | The event comment. For RECALLED or REJECTED, the reason given by the user that initiates the event. For DELEGATE or SHARE, the message from the acting user to the participant | [optional] **date** | [**Date**](Date.md) | The date of the audit event. Format would be yyyy-MM-dd'T'HH:mm:ssZ. For example, e.g 2016-02-25T18:46:19Z represents UTC time | [optional] -**description** | **String** | A description of the audit event | [optional] -**deviceLocation** | [**LibDocEventDeviceLocation**](LibDocEventDeviceLocation.md) | Location of the device that generated the event (This value may be null due to limited privileges) | [optional] -**devicePhoneNumber** | **String** | Phone number from the device used when the participation is completed on a mobile phone | [optional] -**digitalSignatureInfo** | [**DigitalSignatureInfo**](DigitalSignatureInfo.md) | This is present for ESIGNED events when the participation is signed digitally | [optional] -**initiatingUserEmail** | **String** | Email address of the user that initiated the event on behalf of the acting user when the account is shared. Will be empty if there is no account sharing in effect | [optional] **initiatingUserName** | **String** | Full name of the user that initiated the event on behalf of the acting user when the account is shared. Will be empty if there is no account sharing in effect | [optional] +**description** | **String** | A description of the audit event | [optional] +**actingUserName** | **String** | The name of the acting user | [optional] +**actingUserIpAddress** | **String** | The IP address of the user that created the event | [optional] **participantEmail** | **String** | Email address of the user that is the participant for the event. This may be different than the acting user for certain event types. For example, for a DELEGATION event, this is the user who was delegated to | [optional] -**participantId** | **String** | The unique identifier of the participant for the event. This may be different than the acting user for certain event types. For example, for a DELEGATION event, this is the user who was delegated to | [optional] -**participantRole** | [**ParticipantRoleEnum**](#ParticipantRoleEnum) | Role assumed by all participants in the participant set the participant belongs to (signer, approver etc.). | [optional] -**synchronizationId** | **String** | A unique identifier linking offline events to synchronization events (specified for offline signing events and synchronization events, else null) | [optional] **type** | [**TypeEnum**](#TypeEnum) | Type of library document event | [optional] +**participantRole** | [**ParticipantRoleEnum**](#ParticipantRoleEnum) | Role assumed by all participants in the participant set the participant belongs to (signer, approver etc.). | [optional] **vaultEventId** | **String** | The identifier assigned by the vault provider for the vault event (if vaulted, otherwise null) | [optional] -**vaultProviderName** | **String** | Name of the vault provider for the vault event (if vaulted, otherwise null) | [optional] +**participantId** | **String** | The unique identifier of the participant for the event. This may be different than the acting user for certain event types. For example, for a DELEGATION event, this is the user who was delegated to | [optional] **versionId** | **String** | An ID which uniquely identifies the version of the document associated with this audit event | [optional] +**actingUserEmail** | **String** | Email address of the user that created the event | [optional] +**devicePhoneNumber** | **String** | Phone number from the device used when the participation is completed on a mobile phone | [optional] +**initiatingUserEmail** | **String** | Email address of the user that initiated the event on behalf of the acting user when the account is shared. Will be empty if there is no account sharing in effect | [optional] +**digitalSignatureInfo** | [**DigitalSignatureInfo**](DigitalSignatureInfo.md) | This is present for ESIGNED events when the participation is signed digitally | [optional] +**vaultProviderName** | **String** | Name of the vault provider for the vault event (if vaulted, otherwise null) | [optional] +**comment** | **String** | The event comment. For RECALLED or REJECTED, the reason given by the user that initiates the event. For DELEGATE or SHARE, the message from the acting user to the participant | [optional] +**id** | **String** | The identifier for the event. | [optional] +**synchronizationId** | **String** | A unique identifier linking offline events to synchronization events (specified for offline signing events and synchronization events, else null) | [optional] +**deviceLocation** | [**LibDocEventDeviceLocation**](LibDocEventDeviceLocation.md) | Location of the device that generated the event (This value may be null due to limited privileges) | [optional] + + + +## Enum: TypeEnum +Name | Value +---- | ----- +AUTO_CANCELLED_CONVERSION_PROBLEM | "AUTO_CANCELLED_CONVERSION_PROBLEM" +CREATED | "CREATED" +MODIFIED | "MODIFIED" +DOCUMENTS_DELETED | "DOCUMENTS_DELETED" @@ -43,14 +54,4 @@ SHARE | "SHARE" SENDER | "SENDER" - -## Enum: TypeEnum -Name | Value ----- | ----- -AUTO_CANCELLED_CONVERSION_PROBLEM | "AUTO_CANCELLED_CONVERSION_PROBLEM" -CREATED | "CREATED" -MODIFIED | "MODIFIED" -DOCUMENTS_DELETED | "DOCUMENTS_DELETED" - - diff --git a/docs/LibraryDocumentFormFields.md b/docs/LibraryDocumentFormFields.md new file mode 100644 index 0000000..e67cd65 --- /dev/null +++ b/docs/LibraryDocumentFormFields.md @@ -0,0 +1,10 @@ + +# LibraryDocumentFormFields + +## Properties +Name | Type | Description | Notes +------------ | ------------- | ------------- | ------------- +**fields** | [**List<FormField>**](FormField.md) | List of the form fields in an agreement | [optional] + + + diff --git a/docs/LibraryDocumentInfo.md b/docs/LibraryDocumentInfo.md index 7f5ee6a..dc0463c 100755 --- a/docs/LibraryDocumentInfo.md +++ b/docs/LibraryDocumentInfo.md @@ -4,17 +4,20 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**createdDate** | [**Date**](Date.md) | Date when library document was created. It will be ignored in POST/PUT requests. Format would be yyyy-MM-dd'T'HH:mm:ssZ. For example, e.g 2016-02-25T18:46:19Z represents UTC time | [optional] **creatorEmail** | **String** | Email address of the library document creator. It will be ignored in POST/PUT requests | [optional] +**sharingMode** | [**SharingModeEnum**](#SharingModeEnum) | Specifies who should have access to this library document. GLOBAL sharing is a restricted operation. | [optional] +**groupId** | **String** | The unique identifier of the group to which the library template belongs to. If not provided during creation, primary group of the creator will be used | [optional] **creatorName** | **String** | Name of the library document creator. It will be ignored in POST/PUT requests | [optional] -**fileInfos** | [**List<FileInfo>**](FileInfo.md) | A list of one or more files (or references to files) that will be used to create the template. If more than one file is provided, they will be combined into one PDF. Note: Only a single parameter in every FileInfo object must be specified | [optional] -**id** | **String** | The unique identifier that is used to refer to the library template. It will be ignored in POST requests | [optional] +**createdDate** | [**Date**](Date.md) | Date when library document was created. It will be ignored in POST/PUT requests. Format would be yyyy-MM-dd'T'HH:mm:ssZ. For example, e.g 2016-02-25T18:46:19Z represents UTC time | [optional] +**isDocumentRetentionApplied** | **Boolean** | Is document retention applied for this resource. If provided in POST or PUT, it will simply be ignored. | [optional] +**templateTypes** | [**List<TemplateTypesEnum>**](#List<TemplateTypesEnum>) | A list of one or more library template types | [optional] +**lastEventDate** | [**Date**](Date.md) | The date of the last event that occurred for this library document | [optional] **modifiedDate** | [**Date**](Date.md) | Date when library document was last modified. It will be ignored in POST/PUT requests. Format would be yyyy-MM-dd'T'HH:mm:ssZ. For example, e.g 2016-02-25T18:46:19Z represents UTC time | [optional] **name** | **String** | The name of the library template that will be used to identify it, in emails and on the website | [optional] -**sharingMode** | [**SharingModeEnum**](#SharingModeEnum) | Specifies who should have access to this library document. GLOBAL sharing mode is not applicable in POST/PUT requests | [optional] +**fileInfos** | [**List<FileInfo>**](FileInfo.md) | A list of one or more files (or references to files) that will be used to create the template. If more than one file is provided, they will be combined into one PDF. Note: Only a single parameter in every FileInfo object must be specified | [optional] +**id** | **String** | The unique identifier that is used to refer to the library template. It will be ignored in POST requests | [optional] **state** | [**StateEnum**](#StateEnum) | State of the library document. | [optional] **status** | [**StatusEnum**](#StatusEnum) | Status of the library document | [optional] -**templateTypes** | [**List<TemplateTypesEnum>**](#List<TemplateTypesEnum>) | A list of one or more library template types | [optional] @@ -27,6 +30,14 @@ ACCOUNT | "ACCOUNT" GLOBAL | "GLOBAL" + +## Enum: List<TemplateTypesEnum> +Name | Value +---- | ----- +DOCUMENT | "DOCUMENT" +FORM_FIELD_LAYER | "FORM_FIELD_LAYER" + + ## Enum: StateEnum Name | Value @@ -44,12 +55,4 @@ ACTIVE | "ACTIVE" REMOVED | "REMOVED" - -## Enum: List<TemplateTypesEnum> -Name | Value ----- | ----- -DOCUMENT | "DOCUMENT" -FORM_FIELD_LAYER | "FORM_FIELD_LAYER" - - diff --git a/docs/LibraryDocumentMembersInfo.md b/docs/LibraryDocumentMembersInfo.md new file mode 100644 index 0000000..8670dd3 --- /dev/null +++ b/docs/LibraryDocumentMembersInfo.md @@ -0,0 +1,10 @@ + +# LibraryDocumentMembersInfo + +## Properties +Name | Type | Description | Notes +------------ | ------------- | ------------- | ------------- +**creatorInfo** | [**SenderInfo**](SenderInfo.md) | Information about the creator of the library document. | [optional] + + + diff --git a/docs/LibraryDocumentStateInfo.md b/docs/LibraryDocumentStateInfo.md index 9f9d4e8..2aef4c0 100755 --- a/docs/LibraryDocumentStateInfo.md +++ b/docs/LibraryDocumentStateInfo.md @@ -13,6 +13,7 @@ Name | Value ---- | ----- AUTHORING | "AUTHORING" ACTIVE | "ACTIVE" +REMOVED | "REMOVED" diff --git a/docs/LibraryDocumentsApi.md b/docs/LibraryDocumentsApi.md index 6791e9c..f887123 100755 --- a/docs/LibraryDocumentsApi.md +++ b/docs/LibraryDocumentsApi.md @@ -1,21 +1,26 @@ # LibraryDocumentsApi -All URIs are relative to *http://localhost/api/rest/v6* +All URIs are relative to *https://secure.au1.echosign.com/api/rest/v6* Method | HTTP request | Description ------------- | ------------- | ------------- [**createLibraryDocument**](LibraryDocumentsApi.md#createLibraryDocument) | **POST** /libraryDocuments | Creates a template that is placed in the library of the user for reuse. [**createLibraryDocumentView**](LibraryDocumentsApi.md#createLibraryDocumentView) | **POST** /libraryDocuments/{libraryDocumentId}/views | Retrieves the latest state view url of a library document. +[**getAllLibraryDocumentMembers**](LibraryDocumentsApi.md#getAllLibraryDocumentMembers) | **GET** /libraryDocuments/{libraryDocumentId}/members | Retrieves information of members (creator) of the library document. [**getCombinedDocument**](LibraryDocumentsApi.md#getCombinedDocument) | **GET** /libraryDocuments/{libraryDocumentId}/combinedDocument | Retrieves the combined document associated with a library document. [**getDocuments**](LibraryDocumentsApi.md#getDocuments) | **GET** /libraryDocuments/{libraryDocumentId}/documents | Retrieves the IDs of the documents associated with library document. [**getEvents**](LibraryDocumentsApi.md#getEvents) | **GET** /libraryDocuments/{libraryDocumentId}/events | Retrieves the events information for a library document. [**getFormData**](LibraryDocumentsApi.md#getFormData) | **GET** /libraryDocuments/{libraryDocumentId}/formData | Retrieves data entered into the interactive form fields of the library document. +[**getFormFields**](LibraryDocumentsApi.md#getFormFields) | **GET** /libraryDocuments/{libraryDocumentId}/formFields | Retrieves details of form fields of a library document. +[**getLibraryCombinedDocumentUrl**](LibraryDocumentsApi.md#getLibraryCombinedDocumentUrl) | **GET** /libraryDocuments/{libraryDocumentId}/combinedDocument/url | Retrieves url of all visible pages of all the documents associated with a library document. [**getLibraryDocument**](LibraryDocumentsApi.md#getLibraryDocument) | **GET** /libraryDocuments/{libraryDocumentId}/documents/{documentId} | Retrieves the file stream of a document of library document. [**getLibraryDocumentAuditTrail**](LibraryDocumentsApi.md#getLibraryDocumentAuditTrail) | **GET** /libraryDocuments/{libraryDocumentId}/auditTrail | Retrieves the audit trail associated with a library document. [**getLibraryDocumentImageUrls**](LibraryDocumentsApi.md#getLibraryDocumentImageUrls) | **GET** /libraryDocuments/{libraryDocumentId}/documents/{documentId}/imageUrls | Retrieves image urls of all visible pages of a document associated with a library document. [**getLibraryDocumentInfo**](LibraryDocumentsApi.md#getLibraryDocumentInfo) | **GET** /libraryDocuments/{libraryDocumentId} | Retrieves the details of a library document. +[**getLibraryDocumentInfoForUser**](LibraryDocumentsApi.md#getLibraryDocumentInfoForUser) | **GET** /libraryDocuments/{libraryDocumentId}/me | Retrieves the library document information related to the api caller [**getLibraryDocumentNoteForApiUser**](LibraryDocumentsApi.md#getLibraryDocumentNoteForApiUser) | **GET** /libraryDocuments/{libraryDocumentId}/me/note | Retrieves the latest note of a library document for the API user. [**getLibraryDocuments**](LibraryDocumentsApi.md#getLibraryDocuments) | **GET** /libraryDocuments | Retrieves library documents for a user. +[**updateFormFields**](LibraryDocumentsApi.md#updateFormFields) | **PUT** /libraryDocuments/{libraryDocumentId}/formFields | Updates details of form fields of a library document. [**updateLibraryDocument**](LibraryDocumentsApi.md#updateLibraryDocument) | **PUT** /libraryDocuments/{libraryDocumentId} | Updates the library document. [**updateLibraryDocumentNoteForApiUser**](LibraryDocumentsApi.md#updateLibraryDocumentNoteForApiUser) | **PUT** /libraryDocuments/{libraryDocumentId}/me/note | Updates the latest note of a library document for the API user. [**updateLibraryDocumentState**](LibraryDocumentsApi.md#updateLibraryDocumentState) | **PUT** /libraryDocuments/{libraryDocumentId}/state | Updates the library document's state. @@ -119,6 +124,57 @@ Name | Type | Description | Notes No authorization required +### HTTP request headers + + - **Content-Type**: Not defined + - **Accept**: application/json + + +# **getAllLibraryDocumentMembers** +> LibraryDocumentMembersInfo getAllLibraryDocumentMembers(authorization, libraryDocumentId, xApiUser, xOnBehalfOfUser, ifNoneMatch) + +Retrieves information of members (creator) of the library document. + +### Example +```java +// Import classes: +//import io.swagger.client.model.ApiException; +//import io.swagger.client.api.LibraryDocumentsApi; + + +LibraryDocumentsApi apiInstance = new LibraryDocumentsApi(); +String authorization = "authorization_example"; // String | An OAuth Access Token with scopes:in the format 'Bearer {accessToken}'. +String libraryDocumentId = "libraryDocumentId_example"; // String | The document identifier, as retrieved from the API to fetch library documents. +String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. +String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or email in the format userid:{userId} OR email:{email}. of the user that has shared his/her account +String ifNoneMatch = "ifNoneMatch_example"; // String | Pass the value of the e-tag header obtained from the previous response to the same request to get a RESOURCE_NOT_MODIFIED(304) if the resource hasn't changed. +try { + LibraryDocumentMembersInfo result = apiInstance.getAllLibraryDocumentMembers(authorization, libraryDocumentId, xApiUser, xOnBehalfOfUser, ifNoneMatch); + System.out.println(result); +} catch (ApiException e) { + System.err.println("Exception when calling LibraryDocumentsApi#getAllLibraryDocumentMembers"); + e.printStackTrace(); +} +``` + +### Parameters + +Name | Type | Description | Notes +------------- | ------------- | ------------- | ------------- + **authorization** | **String**| An <a href=\"#\" onclick=\"this.href=oauthDoc()\" oncontextmenu=\"this.href=oauthDoc()\" target=\"oauthDoc\">OAuth Access Token</a> with scopes:<ul><li style='list-style-type: square'><a href=\"#\" onclick=\"this.href=oauthDoc('library_read')\" oncontextmenu=\"this.href=oauthDoc('library_read')\" target=\"oauthDoc\">library_read</a></li></ul>in the format <b>'Bearer {accessToken}'. | + **libraryDocumentId** | **String**| The document identifier, as retrieved from the API to fetch library documents. | + **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] + **xOnBehalfOfUser** | **String**| The userId or email in the format <b>userid:{userId} OR email:{email}.</b> of the user that has shared his/her account | [optional] + **ifNoneMatch** | **String**| Pass the value of the e-tag header obtained from the previous response to the same request to get a RESOURCE_NOT_MODIFIED(304) if the resource hasn't changed. | [optional] + +### Return type + +[**LibraryDocumentMembersInfo**](LibraryDocumentMembersInfo.md) + +### Authorization + +No authorization required + ### HTTP request headers - **Content-Type**: Not defined @@ -283,7 +339,7 @@ No authorization required # **getFormData** -> byte[] getFormData(authorization, libraryDocumentId, xApiUser, xOnBehalfOfUser, ifNoneMatch) +> byte[] getFormData(authorization, libraryDocumentId, xApiUser, xOnBehalfOfUser, ifNoneMatch, cursor, pageSize) Retrieves data entered into the interactive form fields of the library document. @@ -302,8 +358,10 @@ String libraryDocumentId = "libraryDocumentId_example"; // String | The document String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or email in the format userid:{userId} OR email:{email}. of the user that has shared his/her account String ifNoneMatch = "ifNoneMatch_example"; // String | Pass the value of the e-tag header obtained from the previous response to the same request to get a RESOURCE_NOT_MODIFIED(304) if the resource hasn't changed. +String cursor = "cursor_example"; // String | Used to navigate through the pages. If not provided, returns the first page. +Integer pageSize = 56; // Integer | Number of intended items in the response page. If not provided, it is decided by the application settings. try { - byte[] result = apiInstance.getFormData(authorization, libraryDocumentId, xApiUser, xOnBehalfOfUser, ifNoneMatch); + byte[] result = apiInstance.getFormData(authorization, libraryDocumentId, xApiUser, xOnBehalfOfUser, ifNoneMatch, cursor, pageSize); System.out.println(result); } catch (ApiException e) { System.err.println("Exception when calling LibraryDocumentsApi#getFormData"); @@ -320,6 +378,8 @@ Name | Type | Description | Notes **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] **xOnBehalfOfUser** | **String**| The userId or email in the format <b>userid:{userId} OR email:{email}.</b> of the user that has shared his/her account | [optional] **ifNoneMatch** | **String**| Pass the value of the e-tag header obtained from the previous response to the same request to get a RESOURCE_NOT_MODIFIED(304) if the resource hasn't changed. | [optional] + **cursor** | **String**| Used to navigate through the pages. If not provided, returns the first page. | [optional] + **pageSize** | **Integer**| Number of intended items in the response page. If not provided, it is decided by the application settings. | [optional] ### Return type @@ -332,7 +392,109 @@ No authorization required ### HTTP request headers - **Content-Type**: Not defined - - **Accept**: text/csv + - **Accept**: application/json, text/csv + + +# **getFormFields** +> LibraryDocumentFormFields getFormFields(authorization, libraryDocumentId, xApiUser, xOnBehalfOfUser, ifNoneMatch) + +Retrieves details of form fields of a library document. + +### Example +```java +// Import classes: +//import io.swagger.client.model.ApiException; +//import io.swagger.client.api.LibraryDocumentsApi; + + +LibraryDocumentsApi apiInstance = new LibraryDocumentsApi(); +String authorization = "authorization_example"; // String | An OAuth Access Token with scopes:in the format 'Bearer {accessToken}'. +String libraryDocumentId = "libraryDocumentId_example"; // String | The document identifier, as retrieved from the API to fetch library documents. +String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. +String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or email in the format userid:{userId} OR email:{email}. of the user that has shared his/her account +String ifNoneMatch = "ifNoneMatch_example"; // String | Pass the value of the e-tag header obtained from the previous response to the same request to get a RESOURCE_NOT_MODIFIED(304) if the resource hasn't changed. +try { + LibraryDocumentFormFields result = apiInstance.getFormFields(authorization, libraryDocumentId, xApiUser, xOnBehalfOfUser, ifNoneMatch); + System.out.println(result); +} catch (ApiException e) { + System.err.println("Exception when calling LibraryDocumentsApi#getFormFields"); + e.printStackTrace(); +} +``` + +### Parameters + +Name | Type | Description | Notes +------------- | ------------- | ------------- | ------------- + **authorization** | **String**| An <a href=\"#\" onclick=\"this.href=oauthDoc()\" oncontextmenu=\"this.href=oauthDoc()\" target=\"oauthDoc\">OAuth Access Token</a> with scopes:<ul><li style='list-style-type: square'><a href=\"#\" onclick=\"this.href=oauthDoc('library_read')\" oncontextmenu=\"this.href=oauthDoc('library_read')\" target=\"oauthDoc\">library_read</a></li></ul>in the format <b>'Bearer {accessToken}'. | + **libraryDocumentId** | **String**| The document identifier, as retrieved from the API to fetch library documents. | + **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] + **xOnBehalfOfUser** | **String**| The userId or email in the format <b>userid:{userId} OR email:{email}.</b> of the user that has shared his/her account | [optional] + **ifNoneMatch** | **String**| Pass the value of the e-tag header obtained from the previous response to the same request to get a RESOURCE_NOT_MODIFIED(304) if the resource hasn't changed. | [optional] + +### Return type + +[**LibraryDocumentFormFields**](LibraryDocumentFormFields.md) + +### Authorization + +No authorization required + +### HTTP request headers + + - **Content-Type**: Not defined + - **Accept**: application/json + + +# **getLibraryCombinedDocumentUrl** +> DocumentUrl getLibraryCombinedDocumentUrl(authorization, libraryDocumentId, xApiUser, xOnBehalfOfUser, attachAuditReport) + +Retrieves url of all visible pages of all the documents associated with a library document. + +### Example +```java +// Import classes: +//import io.swagger.client.model.ApiException; +//import io.swagger.client.api.LibraryDocumentsApi; + + +LibraryDocumentsApi apiInstance = new LibraryDocumentsApi(); +String authorization = "authorization_example"; // String | An OAuth Access Token with scopes:in the format 'Bearer {accessToken}'. +String libraryDocumentId = "libraryDocumentId_example"; // String | The document identifier, as retrieved from the API to fetch library documents. +String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. +String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or email in the format userid:{userId} OR email:{email}. of the user that has shared his/her account +Boolean attachAuditReport = true; // Boolean | When set to true, attach an audit report to the library document PDF. The default value is false. +try { + DocumentUrl result = apiInstance.getLibraryCombinedDocumentUrl(authorization, libraryDocumentId, xApiUser, xOnBehalfOfUser, attachAuditReport); + System.out.println(result); +} catch (ApiException e) { + System.err.println("Exception when calling LibraryDocumentsApi#getLibraryCombinedDocumentUrl"); + e.printStackTrace(); +} +``` + +### Parameters + +Name | Type | Description | Notes +------------- | ------------- | ------------- | ------------- + **authorization** | **String**| An <a href=\"#\" onclick=\"this.href=oauthDoc()\" oncontextmenu=\"this.href=oauthDoc()\" target=\"oauthDoc\">OAuth Access Token</a> with scopes:<ul><li style='list-style-type: square'><a href=\"#\" onclick=\"this.href=oauthDoc('library_read')\" oncontextmenu=\"this.href=oauthDoc('library_read')\" target=\"oauthDoc\">library_read</a></li></ul>in the format <b>'Bearer {accessToken}'. | + **libraryDocumentId** | **String**| The document identifier, as retrieved from the API to fetch library documents. | + **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] + **xOnBehalfOfUser** | **String**| The userId or email in the format <b>userid:{userId} OR email:{email}.</b> of the user that has shared his/her account | [optional] + **attachAuditReport** | **Boolean**| When set to true, attach an audit report to the library document PDF. The default value is false. | [optional] + +### Return type + +[**DocumentUrl**](DocumentUrl.md) + +### Authorization + +No authorization required + +### HTTP request headers + + - **Content-Type**: Not defined + - **Accept**: application/json # **getLibraryDocument** @@ -440,7 +602,7 @@ No authorization required # **getLibraryDocumentImageUrls** -> DocumentImageUrlsInfo getLibraryDocumentImageUrls(authorization, libraryDocumentId, documentId, xApiUser, xOnBehalfOfUser, ifNoneMatch, imageSizes, startPage, endPage) +> DocumentImageUrlsInfo getLibraryDocumentImageUrls(authorization, libraryDocumentId, documentId, xApiUser, xOnBehalfOfUser, imageSizes, startPage, endPage) Retrieves image urls of all visible pages of a document associated with a library document. @@ -457,12 +619,11 @@ String libraryDocumentId = "libraryDocumentId_example"; // String | The document String documentId = "documentId_example"; // String | The document identifier, as retrieved from the API which fetches the documents of a specified library document String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or email in the format userid:{userId} OR email:{email}. of the user that has shared his/her account -String ifNoneMatch = "ifNoneMatch_example"; // String | Pass the value of the e-tag header obtained from the previous response to the same request to get a RESOURCE_NOT_MODIFIED(304) if the resource hasn't changed. String imageSizes = "imageSizes_example"; // String | A comma separated list of image sizes i.e. {FIXED_WIDTH_50px, FIXED_WIDTH_250px, FIXED_WIDTH_675px, ZOOM_50_PERCENT, ZOOM_75_PERCENT, ZOOM_100_PERCENT, ZOOM_125_PERCENT, ZOOM_150_PERCENT, ZOOM_200_PERCENT}. Default sizes returned are {FIXED_WIDTH_50px, FIXED_WIDTH_250px, FIXED_WIDTH_675px, ZOOM_100_PERCENT}. Integer startPage = 56; // Integer | Start of page number range for which imageUrls are requested. Starting page number should be greater than 0. Integer endPage = 56; // Integer | End of page number range for which imageUrls are requested. try { - DocumentImageUrlsInfo result = apiInstance.getLibraryDocumentImageUrls(authorization, libraryDocumentId, documentId, xApiUser, xOnBehalfOfUser, ifNoneMatch, imageSizes, startPage, endPage); + DocumentImageUrlsInfo result = apiInstance.getLibraryDocumentImageUrls(authorization, libraryDocumentId, documentId, xApiUser, xOnBehalfOfUser, imageSizes, startPage, endPage); System.out.println(result); } catch (ApiException e) { System.err.println("Exception when calling LibraryDocumentsApi#getLibraryDocumentImageUrls"); @@ -479,7 +640,6 @@ Name | Type | Description | Notes **documentId** | **String**| The document identifier, as retrieved from the API which fetches the documents of a specified library document | **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] **xOnBehalfOfUser** | **String**| The userId or email in the format <b>userid:{userId} OR email:{email}.</b> of the user that has shared his/her account | [optional] - **ifNoneMatch** | **String**| Pass the value of the e-tag header obtained from the previous response to the same request to get a RESOURCE_NOT_MODIFIED(304) if the resource hasn't changed. | [optional] **imageSizes** | **String**| A comma separated list of image sizes i.e. {FIXED_WIDTH_50px, FIXED_WIDTH_250px, FIXED_WIDTH_675px, ZOOM_50_PERCENT, ZOOM_75_PERCENT, ZOOM_100_PERCENT, ZOOM_125_PERCENT, ZOOM_150_PERCENT, ZOOM_200_PERCENT}. Default sizes returned are {FIXED_WIDTH_50px, FIXED_WIDTH_250px, FIXED_WIDTH_675px, ZOOM_100_PERCENT}. | [optional] **startPage** | **Integer**| Start of page number range for which imageUrls are requested. Starting page number should be greater than 0. | [optional] **endPage** | **Integer**| End of page number range for which imageUrls are requested. | [optional] @@ -543,6 +703,53 @@ Name | Type | Description | Notes No authorization required +### HTTP request headers + + - **Content-Type**: Not defined + - **Accept**: application/json + + +# **getLibraryDocumentInfoForUser** +> MyAgreementInfo getLibraryDocumentInfoForUser(authorization, libraryDocumentId, xApiUser) + +Retrieves the library document information related to the api caller + +### Example +```java +// Import classes: +//import io.swagger.client.model.ApiException; +//import io.swagger.client.api.LibraryDocumentsApi; + + +LibraryDocumentsApi apiInstance = new LibraryDocumentsApi(); +String authorization = "authorization_example"; // String | An OAuth Access Token with scopes:in the format 'Bearer {accessToken}'. +String libraryDocumentId = "libraryDocumentId_example"; // String | The document identifier, as retrieved from the API to fetch library documents. +String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. +try { + MyAgreementInfo result = apiInstance.getLibraryDocumentInfoForUser(authorization, libraryDocumentId, xApiUser); + System.out.println(result); +} catch (ApiException e) { + System.err.println("Exception when calling LibraryDocumentsApi#getLibraryDocumentInfoForUser"); + e.printStackTrace(); +} +``` + +### Parameters + +Name | Type | Description | Notes +------------- | ------------- | ------------- | ------------- + **authorization** | **String**| An <a href=\"#\" onclick=\"this.href=oauthDoc()\" oncontextmenu=\"this.href=oauthDoc()\" target=\"oauthDoc\">OAuth Access Token</a> with scopes:<ul><li style='list-style-type: square'><a href=\"#\" onclick=\"this.href=oauthDoc('library_read')\" oncontextmenu=\"this.href=oauthDoc('library_read')\" target=\"oauthDoc\">library_read</a></li></ul>in the format <b>'Bearer {accessToken}'. | + **libraryDocumentId** | **String**| The document identifier, as retrieved from the API to fetch library documents. | + **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] + +### Return type + +[**MyAgreementInfo**](MyAgreementInfo.md) + +### Authorization + +No authorization required + ### HTTP request headers - **Content-Type**: Not defined @@ -599,7 +806,7 @@ No authorization required # **getLibraryDocuments** -> LibraryDocuments getLibraryDocuments(authorization, xApiUser, xOnBehalfOfUser, showHiddenLibraryDocuments, cursor, pageSize) +> LibraryDocuments getLibraryDocuments(authorization, xApiUser, xOnBehalfOfUser, groupId, showHiddenLibraryDocuments, cursor, pageSize) Retrieves library documents for a user. @@ -614,11 +821,12 @@ LibraryDocumentsApi apiInstance = new LibraryDocumentsApi(); String authorization = "authorization_example"; // String | An OAuth Access Token with scopes:in the format 'Bearer {accessToken}'. String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or email in the format userid:{userId} OR email:{email}. of the user that has shared his/her account +String groupId = "groupId_example"; // String | The group identifier, as returned by the group creation API or retrieved from the API to fetch groups. Boolean showHiddenLibraryDocuments = true; // Boolean | A query parameter to fetch all the hidden library documents along with the visible library documents. Default value is false. String cursor = "cursor_example"; // String | Used to navigate through the pages. If not provided, returns the first page. Integer pageSize = 56; // Integer | Number of intended items in the response page. If not provided, it is decided by the application settings. try { - LibraryDocuments result = apiInstance.getLibraryDocuments(authorization, xApiUser, xOnBehalfOfUser, showHiddenLibraryDocuments, cursor, pageSize); + LibraryDocuments result = apiInstance.getLibraryDocuments(authorization, xApiUser, xOnBehalfOfUser, groupId, showHiddenLibraryDocuments, cursor, pageSize); System.out.println(result); } catch (ApiException e) { System.err.println("Exception when calling LibraryDocumentsApi#getLibraryDocuments"); @@ -633,6 +841,7 @@ Name | Type | Description | Notes **authorization** | **String**| An <a href=\"#\" onclick=\"this.href=oauthDoc()\" oncontextmenu=\"this.href=oauthDoc()\" target=\"oauthDoc\">OAuth Access Token</a> with scopes:<ul><li style='list-style-type: square'><a href=\"#\" onclick=\"this.href=oauthDoc('library_read')\" oncontextmenu=\"this.href=oauthDoc('library_read')\" target=\"oauthDoc\">library_read</a></li></ul>in the format <b>'Bearer {accessToken}'. | **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] **xOnBehalfOfUser** | **String**| The userId or email in the format <b>userid:{userId} OR email:{email}.</b> of the user that has shared his/her account | [optional] + **groupId** | **String**| The group identifier, as returned by the group creation API or retrieved from the API to fetch groups. | [optional] **showHiddenLibraryDocuments** | **Boolean**| A query parameter to fetch all the hidden library documents along with the visible library documents. Default value is false. | [optional] **cursor** | **String**| Used to navigate through the pages. If not provided, returns the first page. | [optional] **pageSize** | **Integer**| Number of intended items in the response page. If not provided, it is decided by the application settings. | [optional] @@ -645,6 +854,59 @@ Name | Type | Description | Notes No authorization required +### HTTP request headers + + - **Content-Type**: Not defined + - **Accept**: application/json + + +# **updateFormFields** +> LibraryDocumentFormFields updateFormFields(authorization, libraryDocumentId, formFieldPutInfo, xApiUser, xOnBehalfOfUser, ifNoneMatch) + +Updates details of form fields of a library document. + +### Example +```java +// Import classes: +//import io.swagger.client.model.ApiException; +//import io.swagger.client.api.LibraryDocumentsApi; + + +LibraryDocumentsApi apiInstance = new LibraryDocumentsApi(); +String authorization = "authorization_example"; // String | An OAuth Access Token with scopes:in the format 'Bearer {accessToken}'. +String libraryDocumentId = "libraryDocumentId_example"; // String | The document identifier, as retrieved from the API to fetch library documents. +FormFieldPutInfo formFieldPutInfo = new FormFieldPutInfo(); // FormFieldPutInfo | List of form fields to set for library document +String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. +String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or email in the format userid:{userId} OR email:{email}. of the user that has shared his/her account +String ifNoneMatch = "ifNoneMatch_example"; // String | Pass the value of the e-tag header obtained from the previous response to the same request to get a RESOURCE_NOT_MODIFIED(304) if the resource hasn't changed. +try { + LibraryDocumentFormFields result = apiInstance.updateFormFields(authorization, libraryDocumentId, formFieldPutInfo, xApiUser, xOnBehalfOfUser, ifNoneMatch); + System.out.println(result); +} catch (ApiException e) { + System.err.println("Exception when calling LibraryDocumentsApi#updateFormFields"); + e.printStackTrace(); +} +``` + +### Parameters + +Name | Type | Description | Notes +------------- | ------------- | ------------- | ------------- + **authorization** | **String**| An <a href=\"#\" onclick=\"this.href=oauthDoc()\" oncontextmenu=\"this.href=oauthDoc()\" target=\"oauthDoc\">OAuth Access Token</a> with scopes:<ul><li style='list-style-type: square'><a href=\"#\" onclick=\"this.href=oauthDoc('library_write')\" oncontextmenu=\"this.href=oauthDoc('library_write')\" target=\"oauthDoc\">library_write</a></li></ul>in the format <b>'Bearer {accessToken}'. | + **libraryDocumentId** | **String**| The document identifier, as retrieved from the API to fetch library documents. | + **formFieldPutInfo** | [**FormFieldPutInfo**](FormFieldPutInfo.md)| List of form fields to set for library document | + **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] + **xOnBehalfOfUser** | **String**| The userId or email in the format <b>userid:{userId} OR email:{email}.</b> of the user that has shared his/her account | [optional] + **ifNoneMatch** | **String**| Pass the value of the e-tag header obtained from the previous response to the same request to get a RESOURCE_NOT_MODIFIED(304) if the resource hasn't changed. | [optional] + +### Return type + +[**LibraryDocumentFormFields**](LibraryDocumentFormFields.md) + +### Authorization + +No authorization required + ### HTTP request headers - **Content-Type**: Not defined @@ -652,7 +914,7 @@ No authorization required # **updateLibraryDocument** -> updateLibraryDocument(authorization, ifMatch, libraryDocumentId, libraryDocumentInfo, xApiUser, xOnBehalfOfUser) +> updateLibraryDocument(authorization, libraryDocumentId, libraryDocumentInfo, xApiUser, xOnBehalfOfUser, ifMatch) Updates the library document. @@ -667,13 +929,13 @@ Currently status, name, sharingMode and templateTypes of the library document ca LibraryDocumentsApi apiInstance = new LibraryDocumentsApi(); String authorization = "authorization_example"; // String | An OAuth Access Token with scopes:in the format 'Bearer {accessToken}'. -String ifMatch = "ifMatch_example"; // String | The server will only update the resource if it matches the listed ETag otherwise error RESOURCE_MODIFIED(412) is returned. String libraryDocumentId = "libraryDocumentId_example"; // String | The document identifier, as retrieved from the API to fetch library documents. LibraryDocumentInfo libraryDocumentInfo = new LibraryDocumentInfo(); // LibraryDocumentInfo | Information about the library document that you want to create. String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or email in the format userid:{userId} OR email:{email}. of the user that has shared his/her account +String ifMatch = "ifMatch_example"; // String | The server will only update the resource if it matches the listed ETag otherwise error RESOURCE_MODIFIED(412) is returned. try { - apiInstance.updateLibraryDocument(authorization, ifMatch, libraryDocumentId, libraryDocumentInfo, xApiUser, xOnBehalfOfUser); + apiInstance.updateLibraryDocument(authorization, libraryDocumentId, libraryDocumentInfo, xApiUser, xOnBehalfOfUser, ifMatch); } catch (ApiException e) { System.err.println("Exception when calling LibraryDocumentsApi#updateLibraryDocument"); e.printStackTrace(); @@ -685,11 +947,11 @@ try { Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **authorization** | **String**| An <a href=\"#\" onclick=\"this.href=oauthDoc()\" oncontextmenu=\"this.href=oauthDoc()\" target=\"oauthDoc\">OAuth Access Token</a> with scopes:<ul><li style='list-style-type: square'><a href=\"#\" onclick=\"this.href=oauthDoc('library_write')\" oncontextmenu=\"this.href=oauthDoc('library_write')\" target=\"oauthDoc\">library_write</a></li></ul>in the format <b>'Bearer {accessToken}'. | - **ifMatch** | **String**| The server will only update the resource if it matches the listed ETag otherwise error RESOURCE_MODIFIED(412) is returned. | **libraryDocumentId** | **String**| The document identifier, as retrieved from the API to fetch library documents. | **libraryDocumentInfo** | [**LibraryDocumentInfo**](LibraryDocumentInfo.md)| Information about the library document that you want to create. | **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] **xOnBehalfOfUser** | **String**| The userId or email in the format <b>userid:{userId} OR email:{email}.</b> of the user that has shared his/her account | [optional] + **ifMatch** | **String**| The server will only update the resource if it matches the listed ETag otherwise error RESOURCE_MODIFIED(412) is returned. | [optional] ### Return type @@ -756,11 +1018,11 @@ No authorization required # **updateLibraryDocumentState** -> updateLibraryDocumentState(authorization, ifMatch, libraryDocumentId, libraryDocumentStateInfo, xApiUser, xOnBehalfOfUser) +> updateLibraryDocumentState(authorization, libraryDocumentId, libraryDocumentStateInfo, xApiUser, xOnBehalfOfUser, ifMatch) Updates the library document's state. -Currently state can be changed from AUTHORING to ACTIVE. +Currently state can be changed from AUTHORING to ACTIVE, AUTHORING to REMOVED or ACTIVE to REMOVED ### Example ```java @@ -771,13 +1033,13 @@ Currently state can be changed from AUTHORING to ACTIVE. LibraryDocumentsApi apiInstance = new LibraryDocumentsApi(); String authorization = "authorization_example"; // String | An OAuth Access Token with scopes:in the format 'Bearer {accessToken}'. -String ifMatch = "ifMatch_example"; // String | The server will only update the resource if it matches the listed ETag otherwise error RESOURCE_MODIFIED(412) is returned. String libraryDocumentId = "libraryDocumentId_example"; // String | The document identifier, as retrieved from the API to fetch library documents. LibraryDocumentStateInfo libraryDocumentStateInfo = new LibraryDocumentStateInfo(); // LibraryDocumentStateInfo | Information about the state of library document to which you want to update String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or email in the format userid:{userId} OR email:{email}. of the user that has shared his/her account +String ifMatch = "ifMatch_example"; // String | The server will only update the resource if it matches the listed ETag otherwise error RESOURCE_MODIFIED(412) is returned. try { - apiInstance.updateLibraryDocumentState(authorization, ifMatch, libraryDocumentId, libraryDocumentStateInfo, xApiUser, xOnBehalfOfUser); + apiInstance.updateLibraryDocumentState(authorization, libraryDocumentId, libraryDocumentStateInfo, xApiUser, xOnBehalfOfUser, ifMatch); } catch (ApiException e) { System.err.println("Exception when calling LibraryDocumentsApi#updateLibraryDocumentState"); e.printStackTrace(); @@ -789,11 +1051,11 @@ try { Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **authorization** | **String**| An <a href=\"#\" onclick=\"this.href=oauthDoc()\" oncontextmenu=\"this.href=oauthDoc()\" target=\"oauthDoc\">OAuth Access Token</a> with scopes:<ul><li style='list-style-type: square'><a href=\"#\" onclick=\"this.href=oauthDoc('library_write')\" oncontextmenu=\"this.href=oauthDoc('library_write')\" target=\"oauthDoc\">library_write</a></li></ul>in the format <b>'Bearer {accessToken}'. | - **ifMatch** | **String**| The server will only update the resource if it matches the listed ETag otherwise error RESOURCE_MODIFIED(412) is returned. | **libraryDocumentId** | **String**| The document identifier, as retrieved from the API to fetch library documents. | **libraryDocumentStateInfo** | [**LibraryDocumentStateInfo**](LibraryDocumentStateInfo.md)| Information about the state of library document to which you want to update | **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] **xOnBehalfOfUser** | **String**| The userId or email in the format <b>userid:{userId} OR email:{email}.</b> of the user that has shared his/her account | [optional] + **ifMatch** | **String**| The server will only update the resource if it matches the listed ETag otherwise error RESOURCE_MODIFIED(412) is returned. | [optional] ### Return type diff --git a/docs/LibraryView.md b/docs/LibraryView.md index d928194..c874ed2 100755 --- a/docs/LibraryView.md +++ b/docs/LibraryView.md @@ -4,10 +4,10 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**embeddedCode** | **String** | Embedded code of url of resource | [optional] -**expiration** | [**Date**](Date.md) | Expiration of user url | [optional] **isCurrent** | **Boolean** | True if this view is the current view | [optional] +**embeddedCode** | **String** | Embedded code of url of resource | [optional] **name** | [**NameEnum**](#NameEnum) | Name of the requested libraryDocument view | [optional] +**expiration** | [**Date**](Date.md) | Expiration of user url | [optional] **url** | **String** | Url of resource location | [optional] diff --git a/docs/LocaleFieldInfoDescription.md b/docs/LocaleFieldInfoDescription.md new file mode 100644 index 0000000..d755646 --- /dev/null +++ b/docs/LocaleFieldInfoDescription.md @@ -0,0 +1,14 @@ + +# LocaleFieldInfoDescription + +## Properties +Name | Type | Description | Notes +------------ | ------------- | ------------- | ------------- +**visible** | **Boolean** | Whether current field is visible or not. If visible attribute for this field is false then this field should not be visible in the agreement creation UI using this workflow to user | [optional] +**defaultValue** | **String** | default value of the field if input for this field is not provided and this field is required | [optional] +**editable** | **Boolean** | Whether current field can be edited. If editable attribute for this field is false then this field should not be provided in the agreement creation request and default value of this field will be used in agreement creation | [optional] +**required** | **Boolean** | Whether this field is required or optional | [optional] +**availableLocales** | **List<String>** | Which locales can be chosen for this workflow | [optional] + + + diff --git a/docs/MegaSign.md b/docs/MegaSign.md index fba62b4..14ca74e 100755 --- a/docs/MegaSign.md +++ b/docs/MegaSign.md @@ -4,10 +4,12 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- +**hidden** | **Boolean** | True, if megaSign is hidden for the user | [optional] **displayDate** | [**Date**](Date.md) | The display date for the MegaSign parent agreement. Format would be yyyy-MM-dd'T'HH:mm:ssZ. For example, e.g 2016-02-25T18:46:19Z represents UTC time | [optional] -**id** | **String** | The unique identifier of the MegaSign parent agreement | [optional] +**groupId** | **String** | Unique identifier of the group | [optional] **esign** | **Boolean** | True, if the signature type of the MegaSign parent agreement is ESIGN. False, if the signature type of the MegaSign parent agreement is WRITTEN | [optional] **name** | **String** | Name of the MegaSign parent agreement | [optional] +**id** | **String** | The unique identifier of the MegaSign parent agreement | [optional] **status** | [**StatusEnum**](#StatusEnum) | Current status of the MegaSign parent agreement from the perspective of the user | [optional] diff --git a/docs/MegaSignChildAgreement.md b/docs/MegaSignChildAgreement.md index 12ade15..38737e3 100755 --- a/docs/MegaSignChildAgreement.md +++ b/docs/MegaSignChildAgreement.md @@ -5,12 +5,23 @@ Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- **displayDate** | [**Date**](Date.md) | The display date for the agreement. Format would be yyyy-MM-dd'T'HH:mm:ssZ. For example, e.g 2016-02-25T18:46:19Z represents UTC time | [optional] -**id** | **String** | The unique identifier of the agreement.If provided in POST, it will simply be ignored | [optional] **esign** | **Boolean** | True if this is an e-sign document | [optional] **name** | **String** | Name of the Agreement | [optional] +**id** | **String** | The unique identifier of the agreement.If provided in POST, it will simply be ignored | [optional] +**type** | [**TypeEnum**](#TypeEnum) | The kind of agreement | [optional] +**parentId** | **String** | The parent id of a megaSign child *OR* the originating id of a widget agreement instance | [optional] **status** | [**StatusEnum**](#StatusEnum) | This is a server generated attribute which provides the detailed status of an agreement with respect to the apiCaller | [optional] + +## Enum: TypeEnum +Name | Value +---- | ----- +AGREEMENT | "AGREEMENT" +MEGASIGN_CHILD | "MEGASIGN_CHILD" +WIDGET_INSTANCE | "WIDGET_INSTANCE" + + ## Enum: StatusEnum Name | Value diff --git a/docs/MegaSignChildAgreements.md b/docs/MegaSignChildAgreements.md index 6a570ff..88983cd 100755 --- a/docs/MegaSignChildAgreements.md +++ b/docs/MegaSignChildAgreements.md @@ -4,8 +4,8 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**megaSignChildAgreementList** | [**List<MegaSignChildAgreement>**](MegaSignChildAgreement.md) | A array of MegaSign child agreements | [optional] **page** | [**PageInfo**](PageInfo.md) | Pagination information for navigating through the response | [optional] +**megaSignChildAgreementList** | [**List<MegaSignChildAgreement>**](MegaSignChildAgreement.md) | A array of MegaSign child agreements | [optional] diff --git a/docs/MegaSignChildAgreementsFileInfo.md b/docs/MegaSignChildAgreementsFileInfo.md index a5c729b..3ee72d8 100755 --- a/docs/MegaSignChildAgreementsFileInfo.md +++ b/docs/MegaSignChildAgreementsFileInfo.md @@ -4,9 +4,9 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**childAgreementsInfoFileId** | **String** | id of the file containg information about the existing childAgreementsInfo associated with the megaSign. Will be ignored in POST call and in case of GET call, this is the only thing that will be returned. The content of the file can be fetched through GET /megaSigns/{megaSignId}/childAgreementsInfo/{childAgreementsInfoFileId} endpoint. | [optional] -**fileType** | [**FileTypeEnum**](#FileTypeEnum) | Input type through which participantSetsInfos will be provided. Whichever input type is provided, the values should be provided in its corresponding value object. Currently we are supporting CSV file format for providing megaSIgn child recipients. | [optional] **transientDocumentId** | **String** | Transient id of the input file which contains participantSetsInfos. Currently only csv format is suppported. More details about CSV format <a href='https://www.adobe.com/go/documentcloud_megasigncsv'>here</a> | [optional] +**fileType** | [**FileTypeEnum**](#FileTypeEnum) | Input type through which participantSetsInfos will be provided. Whichever input type is provided, the values should be provided in its corresponding value object. Currently we are supporting CSV file format for providing megaSIgn child recipients. | [optional] +**childAgreementsInfoFileId** | **String** | id of the file containg information about the existing childAgreementsInfo associated with the megaSign. Will be ignored in POST and PUT calls and in the case of GET call, this is the only thing that will be returned. The content of the file can be fetched through GET /megaSigns/{megaSignId}/childAgreementsInfo/{childAgreementsInfoFileId} endpoint. | [optional] diff --git a/docs/MegaSignCreationInfo.md b/docs/MegaSignCreationInfo.md index 2b78352..7a05fd2 100755 --- a/docs/MegaSignCreationInfo.md +++ b/docs/MegaSignCreationInfo.md @@ -4,25 +4,37 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**ccs** | [**List<MegaSignCcInfo>**](MegaSignCcInfo.md) | A list of one or more CCs that will be copied in the megasign transaction. The CCs will each receive an email at the beginning of the transaction and also when the final document is signed. The email addresses will also receive a copy of the document, attached as a PDF file | [optional] +**firstReminderDelay** | **Integer** | Integer which specifies the delay in hours before sending the first reminder.<br>This is an optional field. The minimum value allowed is 1 hour and the maximum value can’t be more than the difference of agreement creation and expiry time of the agreement in hours.<br>If this is not specified but the reminder frequency is specified, then the first reminder will be sent based on frequency.<br>i.e. if the reminder is created with frequency specified as daily, the firstReminderDelay will be 24 hours. Cannot be updated in a PUT | [optional] +**groupId** | **String** | The unique identifier of the group to which the megasign agreement will belong to when it is created. If it is not provided during agreement creation the primary group of the creator will be used | [optional] **childAgreementsInfo** | [**ChildAgreementsInfo**](ChildAgreementsInfo.md) | Info corresponding to each child agreement of the megaSign | [optional] -**createdDate** | [**Date**](Date.md) | Date when megasign was created. Format would be yyyy-MM-dd'T'HH:mm:ssZ. For example, e.g 2016-02-25T18:46:19Z represents UTC time | [optional] -**expirationTime** | [**Date**](Date.md) | Time after which Agreement expires and needs to be signed before it. Format should be yyyy-MM-dd'T'HH:mm:ssZ. For example, e.g 2016-02-25T18:46:19Z represents UTC time. Should not be provided in offline agreement creation. | [optional] +**signatureType** | [**SignatureTypeEnum**](#SignatureTypeEnum) | Specifies the type of signature you would like to request - written or e-signature. The possible values are <br> ESIGN : Agreement needs to be signed electronically <br>, WRITTEN : Agreement will be signed using handwritten signature and signed document will be uploaded into the system | [optional] **externalId** | [**ExternalId**](ExternalId.md) | An arbitrary value from your system, which can be specified at sending time and then later returned or queried | [optional] -**fileInfos** | [**List<FileInfo>**](FileInfo.md) | A list of one or more files (or references to files) that will be sent out for signature. If more than one file is provided, they will be combined into one PDF before being sent out. Note: Only one of the four parameters in every FileInfo object must be specified | [optional] -**firstReminderDelay** | **Integer** | Integer which specifies the delay in hours before sending the first reminder.<br>This is an optional field. The minimum value allowed is 1 hour and the maximum value can’t be more than the difference of agreement creation and expiry time of the agreement in hours.<br>If this is not specified but the reminder frequency is specified, then the first reminder will be sent based on frequency.<br>i.e. if the reminder is created with frequency specified as daily, the firstReminderDelay will be 24 hours. Cannot be updated in a PUT | [optional] -**id** | **String** | The unique identifier of megasign | [optional] **locale** | **String** | The locale associated with this agreement - specifies the language for the signing page and emails, for example en_US or fr_FR. If none specified, defaults to the language configured for the agreement sender | [optional] **message** | **String** | An optional message to the participants, describing what is being sent or why their signature is required | [optional] -**name** | **String** | The name of the agreement that will be used to identify it, in emails, website and other places | [optional] +**vaultingInfo** | [**VaultingInfo**](VaultingInfo.md) | Vaulting properties that allows Adobe Sign to securely store documents with a vault provider | [optional] +**securityOption** | [**MegaSignSecurityOption**](MegaSignSecurityOption.md) | Optional security parameters for the megasign | [optional] **postSignOption** | [**PostSignOption**](PostSignOption.md) | URL and associated properties for the success page the user will be taken to after completing the signing process | [optional] **reminderFrequency** | [**ReminderFrequencyEnum**](#ReminderFrequencyEnum) | Optional parameter that sets how often you want to send reminders to the participants. If it is not specified, the default frequency set for the account will be used | [optional] -**securityOption** | [**MegaSignSecurityOption**](MegaSignSecurityOption.md) | Optional security parameters for the megasign | [optional] +**ccs** | [**List<MegaSignCcInfo>**](MegaSignCcInfo.md) | A list of one or more CCs that will be copied in the megasign transaction. The CCs will each receive an email at the beginning of the transaction and also when the final document is signed. The email addresses will also receive a copy of the document, attached as a PDF file | [optional] +**createdDate** | [**Date**](Date.md) | Date when megasign was created. Format would be yyyy-MM-dd'T'HH:mm:ssZ. For example, e.g 2016-02-25T18:46:19Z represents UTC time | [optional] +**isDocumentRetentionApplied** | **Boolean** | Is document retention applied for this resource. If provided in POST or PUT, it will simply be ignored. | [optional] +**expirationTime** | [**Date**](Date.md) | Time after which Agreement expires and needs to be signed before it. Format should be yyyy-MM-dd'T'HH:mm:ssZ. For example, e.g 2016-02-25T18:46:19Z represents UTC time. Should not be provided in offline agreement creation. | [optional] +**lastEventDate** | [**Date**](Date.md) | The date of the last event that occurred for this megasign. Format would be yyyy-MM-dd'T'HH:mm:ssZ. For example, e.g 2016-02-25T18:46:19Z represents UTC time | [optional] **senderEmail** | **String** | Email of agreement sender. Only provided in GET. Can not be provided in POST/PUT request. If provided in POST/PUT, it will be ignored | [optional] -**signatureType** | [**SignatureTypeEnum**](#SignatureTypeEnum) | Specifies the type of signature you would like to request - written or e-signature. The possible values are <br> ESIGN : Agreement needs to be signed electronically <br>, WRITTEN : Agreement will be signed using handwritten signature and signed document will be uploaded into the system | [optional] +**name** | **String** | The name of the agreement that will be used to identify it, in emails, website and other places | [optional] +**numChildren** | **Integer** | The total number of MegaSign children associated with the MegaSign parent. If provided in POST, it will be ignored. If modified in PUT, it will throw error MODIFYING_IMMUTABLE_FIELDS | [optional] +**fileInfos** | [**List<FileInfo>**](FileInfo.md) | A list of one or more files (or references to files) that will be sent out for signature. If more than one file is provided, they will be combined into one PDF before being sent out. Note: Only one of the four parameters in every FileInfo object must be specified | [optional] +**id** | **String** | The unique identifier of megasign | [optional] **state** | [**StateEnum**](#StateEnum) | State of the Megasign | [optional] **status** | [**StatusEnum**](#StatusEnum) | Status of the Megasign | [optional] -**vaultingInfo** | [**VaultingInfo**](VaultingInfo.md) | Vaulting properties that allows Adobe Sign to securely store documents with a vault provider | [optional] + + + +## Enum: SignatureTypeEnum +Name | Value +---- | ----- +ESIGN | "ESIGN" +WRITTEN | "WRITTEN" @@ -37,14 +49,6 @@ EVERY_FIFTH_DAY_UNTIL_SIGNED | "EVERY_FIFTH_DAY_UNTIL_SIGNED" WEEKLY_UNTIL_SIGNED | "WEEKLY_UNTIL_SIGNED" - -## Enum: SignatureTypeEnum -Name | Value ----- | ----- -ESIGN | "ESIGN" -WRITTEN | "WRITTEN" - - ## Enum: StateEnum Name | Value diff --git a/docs/MegaSignInfo.md b/docs/MegaSignInfo.md new file mode 100644 index 0000000..eb92c4c --- /dev/null +++ b/docs/MegaSignInfo.md @@ -0,0 +1,71 @@ + +# MegaSignInfo + +## Properties +Name | Type | Description | Notes +------------ | ------------- | ------------- | ------------- +**firstReminderDelay** | **Integer** | Integer which specifies the delay in hours before sending the first reminder.<br>This is an optional field. The minimum value allowed is 1 hour and the maximum value can’t be more than the difference of agreement creation and expiry time of the agreement in hours.<br>If this is not specified but the reminder frequency is specified, then the first reminder will be sent based on frequency.<br>i.e. if the reminder is created with frequency specified as daily, the firstReminderDelay will be 24 hours. Cannot be updated in a PUT | [optional] +**groupId** | **String** | The unique identifier of the group to which the megasign agreement will belong to when it is created. If it is not provided during agreement creation the primary group of the creator will be used | [optional] +**childAgreementsInfo** | [**ChildAgreementsInfo**](ChildAgreementsInfo.md) | Info corresponding to each child agreement of the megaSign | [optional] +**signatureType** | [**SignatureTypeEnum**](#SignatureTypeEnum) | Specifies the type of signature you would like to request - written or e-signature. The possible values are <br> ESIGN : Agreement needs to be signed electronically <br>, WRITTEN : Agreement will be signed using handwritten signature and signed document will be uploaded into the system | [optional] +**externalId** | [**ExternalId**](ExternalId.md) | An arbitrary value from your system, which can be specified at sending time and then later returned or queried | [optional] +**locale** | **String** | The locale associated with this agreement - specifies the language for the signing page and emails, for example en_US or fr_FR. If none specified, defaults to the language configured for the agreement sender | [optional] +**message** | **String** | An optional message to the participants, describing what is being sent or why their signature is required | [optional] +**vaultingInfo** | [**VaultingInfo**](VaultingInfo.md) | Vaulting properties that allows Adobe Sign to securely store documents with a vault provider | [optional] +**securityOption** | [**MegaSignSecurityOption**](MegaSignSecurityOption.md) | Optional security parameters for the megasign | [optional] +**postSignOption** | [**PostSignOption**](PostSignOption.md) | URL and associated properties for the success page the user will be taken to after completing the signing process | [optional] +**reminderFrequency** | [**ReminderFrequencyEnum**](#ReminderFrequencyEnum) | Optional parameter that sets how often you want to send reminders to the participants. If it is not specified, the default frequency set for the account will be used | [optional] +**ccs** | [**List<MegaSignCcInfo>**](MegaSignCcInfo.md) | A list of one or more CCs that will be copied in the megasign transaction. The CCs will each receive an email at the beginning of the transaction and also when the final document is signed. The email addresses will also receive a copy of the document, attached as a PDF file | [optional] +**createdDate** | [**Date**](Date.md) | Date when megasign was created. Format would be yyyy-MM-dd'T'HH:mm:ssZ. For example, e.g 2016-02-25T18:46:19Z represents UTC time | [optional] +**isDocumentRetentionApplied** | **Boolean** | Is document retention applied for this resource. If provided in POST or PUT, it will simply be ignored. | [optional] +**expirationTime** | [**Date**](Date.md) | Time after which Agreement expires and needs to be signed before it. Format should be yyyy-MM-dd'T'HH:mm:ssZ. For example, e.g 2016-02-25T18:46:19Z represents UTC time. Should not be provided in offline agreement creation. | [optional] +**lastEventDate** | [**Date**](Date.md) | The date of the last event that occurred for this megasign. Format would be yyyy-MM-dd'T'HH:mm:ssZ. For example, e.g 2016-02-25T18:46:19Z represents UTC time | [optional] +**senderEmail** | **String** | Email of agreement sender. Only provided in GET. Can not be provided in POST/PUT request. If provided in POST/PUT, it will be ignored | [optional] +**name** | **String** | The name of the agreement that will be used to identify it, in emails, website and other places | [optional] +**numChildren** | **Integer** | The total number of MegaSign children associated with the MegaSign parent. If provided in POST, it will be ignored. If modified in PUT, it will throw error MODIFYING_IMMUTABLE_FIELDS | [optional] +**fileInfos** | [**List<FileInfo>**](FileInfo.md) | A list of one or more files (or references to files) that will be sent out for signature. If more than one file is provided, they will be combined into one PDF before being sent out. Note: Only one of the four parameters in every FileInfo object must be specified | [optional] +**id** | **String** | The unique identifier of megasign | [optional] +**state** | [**StateEnum**](#StateEnum) | State of the Megasign | [optional] +**status** | [**StatusEnum**](#StatusEnum) | Status of the Megasign | [optional] + + + +## Enum: SignatureTypeEnum +Name | Value +---- | ----- +ESIGN | "ESIGN" +WRITTEN | "WRITTEN" + + + +## Enum: ReminderFrequencyEnum +Name | Value +---- | ----- +DAILY_UNTIL_SIGNED | "DAILY_UNTIL_SIGNED" +WEEKDAILY_UNTIL_SIGNED | "WEEKDAILY_UNTIL_SIGNED" +EVERY_OTHER_DAY_UNTIL_SIGNED | "EVERY_OTHER_DAY_UNTIL_SIGNED" +EVERY_THIRD_DAY_UNTIL_SIGNED | "EVERY_THIRD_DAY_UNTIL_SIGNED" +EVERY_FIFTH_DAY_UNTIL_SIGNED | "EVERY_FIFTH_DAY_UNTIL_SIGNED" +WEEKLY_UNTIL_SIGNED | "WEEKLY_UNTIL_SIGNED" + + + +## Enum: StateEnum +Name | Value +---- | ----- +PROCESS | "IN_PROCESS" + + + +## Enum: StatusEnum +Name | Value +---- | ----- +AUTHORING | "AUTHORING" +IN_PROCESS | "IN_PROCESS" +CANCELLED | "CANCELLED" +COMPLETED | "COMPLETED" +EXPIRED | "EXPIRED" +PREFILL | "PREFILL" + + + diff --git a/docs/MegaSignMembersInfo.md b/docs/MegaSignMembersInfo.md new file mode 100644 index 0000000..92b480b --- /dev/null +++ b/docs/MegaSignMembersInfo.md @@ -0,0 +1,13 @@ + +# MegaSignMembersInfo + +## Properties +Name | Type | Description | Notes +------------ | ------------- | ------------- | ------------- +**participantSets** | [**List<DetailedParticipantSetInfo>**](DetailedParticipantSetInfo.md) | Information about the participant Sets. | [optional] +**ccsInfo** | [**List<CCParticipantInfo>**](CCParticipantInfo.md) | Information of CC participants of the megaSign. | [optional] +**senderInfo** | [**SenderInfo**](SenderInfo.md) | Information of the sender of the megaSign. | [optional] +**sharesInfo** | [**List<ShareParticipantInfo>**](ShareParticipantInfo.md) | Information of the participants with whom the megaSign has been shared. | [optional] + + + diff --git a/docs/MegaSignRemindersResponse.md b/docs/MegaSignRemindersResponse.md new file mode 100644 index 0000000..7df0f0a --- /dev/null +++ b/docs/MegaSignRemindersResponse.md @@ -0,0 +1,10 @@ + +# MegaSignRemindersResponse + +## Properties +Name | Type | Description | Notes +------------ | ------------- | ------------- | ------------- +**reminderInfoList** | [**List<ReminderInfo>**](ReminderInfo.md) | A list of one or more reminders created on the MegaSign parent specified by the unique identifier megasignId by the user invoking the API. | [optional] + + + diff --git a/docs/MegaSignSecurityOption.md b/docs/MegaSignSecurityOption.md index 07695ba..4aaf9b1 100755 --- a/docs/MegaSignSecurityOption.md +++ b/docs/MegaSignSecurityOption.md @@ -5,8 +5,8 @@ Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- **externalAuthenticationMethod** | [**ExternalAuthenticationMethodEnum**](#ExternalAuthenticationMethodEnum) | The authentication method for the participants to have access to view and sign the document. | [optional] -**externalPassword** | **String** | The secondary password that will be used to protect signing the document for internal signers. Note that Adobe Sign will never show this password to anyone, so you will need to separately communicate it to any relevant parties. This password is applied only if password protection is specified for internal signers or all signers | [optional] **internalAuthenticationMethod** | [**InternalAuthenticationMethodEnum**](#InternalAuthenticationMethodEnum) | The authentication method for the participants to have access to view and sign the document. | [optional] +**externalPassword** | **String** | The secondary password that will be used to protect signing the document for internal signers. Note that Adobe Sign will never show this password to anyone, so you will need to separately communicate it to any relevant parties. This password is applied only if password protection is specified for internal signers or all signers | [optional] **internalPassword** | **String** | The secondary password that will be used to protect signing the document for external signers. Note that Adobe Sign will never show this password to anyone, so you will need to separately communicate it to any relevant parties. This password is applied only if password protection is specified for external signers or all signers | [optional] **openPassword** | **String** | The secondary password that will be used to secure the PDF document. Note that AdobeSign will never show this password to anyone, so you will need to separately communicate it to any relevant parties | [optional] diff --git a/docs/MegaSignStateInfo.md b/docs/MegaSignStateInfo.md index d4b14df..480aaf6 100755 --- a/docs/MegaSignStateInfo.md +++ b/docs/MegaSignStateInfo.md @@ -4,8 +4,8 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**megaSignCancellationInfo** | [**AgreementCancellationInfo**](AgreementCancellationInfo.md) | Cancellation information for the agreement. Mandatory while cancelling a megaSign | [optional] **state** | [**StateEnum**](#StateEnum) | The state to which the megaSign is to be updated. The only valid state for this variable is currently, CANCELLED | [optional] +**megaSignCancellationInfo** | [**AgreementCancellationInfo**](AgreementCancellationInfo.md) | Cancellation information for the agreement. Mandatory while cancelling a megaSign | [optional] diff --git a/docs/MegaSignView.md b/docs/MegaSignView.md index a9b82a0..15e9e17 100755 --- a/docs/MegaSignView.md +++ b/docs/MegaSignView.md @@ -4,10 +4,10 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**embeddedCode** | **String** | Embedded code of url of resource | [optional] -**expiration** | [**Date**](Date.md) | Expiration of user url | [optional] **isCurrent** | **Boolean** | True if this view is the current view | [optional] +**embeddedCode** | **String** | Embedded code of url of resource | [optional] **name** | [**NameEnum**](#NameEnum) | Name of the requested mega sign view | [optional] +**expiration** | [**Date**](Date.md) | Expiration of user url | [optional] **url** | **String** | Url of resource location | [optional] @@ -15,11 +15,13 @@ Name | Type | Description | Notes ## Enum: NameEnum Name | Value ---- | ----- +ACTIVITY_REPORT | "ACTIVITY_REPORT" AUTHORING | "AUTHORING" DOCUMENT | "DOCUMENT" MANAGE | "MANAGE" POST_CREATE | "POST_CREATE" PREFILL | "PREFILL" +SIGNING | "SIGNING" ALL | "ALL" diff --git a/docs/MegaSignViewInfo.md b/docs/MegaSignViewInfo.md index 8374d15..5f69089 100755 --- a/docs/MegaSignViewInfo.md +++ b/docs/MegaSignViewInfo.md @@ -12,11 +12,13 @@ Name | Type | Description | Notes ## Enum: NameEnum Name | Value ---- | ----- +ACTIVITY_REPORT | "ACTIVITY_REPORT" AUTHORING | "AUTHORING" DOCUMENT | "DOCUMENT" MANAGE | "MANAGE" POST_CREATE | "POST_CREATE" PREFILL | "PREFILL" +SIGNING | "SIGNING" ALL | "ALL" diff --git a/docs/MegaSignsApi.md b/docs/MegaSignsApi.md index 0b91524..dffa34c 100755 --- a/docs/MegaSignsApi.md +++ b/docs/MegaSignsApi.md @@ -1,19 +1,34 @@ # MegaSignsApi -All URIs are relative to *http://localhost/api/rest/v6* +All URIs are relative to *https://secure.au1.echosign.com/api/rest/v6* Method | HTTP request | Description ------------- | ------------- | ------------- [**createMegaSign**](MegaSignsApi.md#createMegaSign) | **POST** /megaSigns | Send an agreement out for signature to multiple recipients. Each recipient will receive and sign their own copy of the agreement. +[**createReminderOnMegaSign**](MegaSignsApi.md#createReminderOnMegaSign) | **POST** /megaSigns/{megaSignId}/reminders | Creates a reminder on the specified participants of the MegaSign parent. +[**createShareOnMegaSign**](MegaSignsApi.md#createShareOnMegaSign) | **POST** /megaSigns/{megaSignId}/members/share | Share a MegaSign parent and all the child agreements with someone. +[**getAllMegaSignMembers**](MegaSignsApi.md#getAllMegaSignMembers) | **GET** /megaSigns/{megaSignId}/members | Retrieves detailed member info along with IDs for different types of participants associated with the MegaSign parent agreement. [**getChildAgreementsInfoFile**](MegaSignsApi.md#getChildAgreementsInfoFile) | **GET** /megaSigns/{megaSignId}/childAgreementsInfo/{childAgreementsInfoFileId} | Retrieves the file stream of the original childAgreementsInfoFile that was uploaded by sender while creating the MegaSign. [**getEvents**](MegaSignsApi.md#getEvents) | **GET** /megaSigns/{megaSignId}/events | Retrieves the events information for the MegaSign parent agreement. +[**getMegaSignAllDocuments**](MegaSignsApi.md#getMegaSignAllDocuments) | **GET** /megaSigns/{megaSignId}/documents | Retrieves the IDs of the documents associated with a MegaSign parent agreement. +[**getMegaSignAllDocumentsImageUrls**](MegaSignsApi.md#getMegaSignAllDocumentsImageUrls) | **GET** /megaSigns/{megaSignId}/documents/imageUrls | Retrieves image urls of all visible pages of a document associated with a MegaSign parent agreement. [**getMegaSignChildAgreements**](MegaSignsApi.md#getMegaSignChildAgreements) | **GET** /megaSigns/{megaSignId}/agreements | Get all the child agreements of the specified MegaSign parent agreement. [**getMegaSignCombinedDocument**](MegaSignsApi.md#getMegaSignCombinedDocument) | **GET** /megaSigns/{megaSignId}/combinedDocument | Retrieves a single combined PDF document for the documents associated with the MegaSign parent agreement. +[**getMegaSignCombinedDocumentUrl**](MegaSignsApi.md#getMegaSignCombinedDocumentUrl) | **GET** /megaSigns/{megaSignId}/combinedDocument/url | Retrieves url of all visible pages of all the documents associated with the MegaSign parent agreement. +[**getMegaSignDocumentInfo**](MegaSignsApi.md#getMegaSignDocumentInfo) | **GET** /megaSigns/{megaSignId}/documents/{documentId} | Retrieves the file stream of a document of a MegaSign parent agreement. [**getMegaSignFormData**](MegaSignsApi.md#getMegaSignFormData) | **GET** /megaSigns/{megaSignId}/formData | Retrieves data entered by recipients into interactive form fields at the time they signed the child agreements of the specified MegaSign agreement [**getMegaSignInfo**](MegaSignsApi.md#getMegaSignInfo) | **GET** /megaSigns/{megaSignId} | Get detailed information of the specified MegaSign parent agreement. +[**getMegaSignInfoForUser**](MegaSignsApi.md#getMegaSignInfoForUser) | **GET** /megaSigns/{megaSignId}/me | Retrieves the MegaSign parent agreement information related to the api caller +[**getMegaSignNoteForUser**](MegaSignsApi.md#getMegaSignNoteForUser) | **GET** /megaSigns/{megaSignId}/me/note | Retrieves the latest note of a MegaSign parent agreement for the user. +[**getMegaSignReminder**](MegaSignsApi.md#getMegaSignReminder) | **GET** /megaSigns/{megaSignId}/reminders/{reminderId} | Retrieves a specific reminder given the reminder id for the specified MegaSign parent agreement. +[**getMegaSignReminders**](MegaSignsApi.md#getMegaSignReminders) | **GET** /megaSigns/{megaSignId}/reminders | Retrieves the reminders of the specified MegaSign parent agreement. [**getMegaSignView**](MegaSignsApi.md#getMegaSignView) | **POST** /megaSigns/{megaSignId}/views | Retrieves the requested views of mega sign agreement. [**getMegaSigns**](MegaSignsApi.md#getMegaSigns) | **GET** /megaSigns | Retrieves MegaSign parent agreements for a user. +[**updateMegaSign**](MegaSignsApi.md#updateMegaSign) | **PUT** /megaSigns/{megaSignId} | Update the expirationTime on an existing megaSign parent and all the child agreements that are already out for signature. +[**updateMegaSignNoteForUser**](MegaSignsApi.md#updateMegaSignNoteForUser) | **PUT** /megaSigns/{megaSignId}/me/note | Updates the latest note of a MegaSign parent agreement for the user. +[**updateMegaSignReminder**](MegaSignsApi.md#updateMegaSignReminder) | **PUT** /megaSigns/{megaSignId}/reminders/{reminderId} | Updates an existing reminder for a MegaSign parent agreement. [**updateMegaSignState**](MegaSignsApi.md#updateMegaSignState) | **PUT** /megaSigns/{megaSignId}/state | Updates the state of a MegaSign identified by MegaSignId in the path. +[**updateMegaSignVisibility**](MegaSignsApi.md#updateMegaSignVisibility) | **PUT** /megaSigns/{megaSignId}/me/visibility | Updates the visibility of a MegaSign. @@ -62,6 +77,159 @@ Name | Type | Description | Notes No authorization required +### HTTP request headers + + - **Content-Type**: Not defined + - **Accept**: application/json + + +# **createReminderOnMegaSign** +> ReminderCreationResult createReminderOnMegaSign(authorization, megaSignId, reminderInfo, xApiUser, xOnBehalfOfUser) + +Creates a reminder on the specified participants of the MegaSign parent. + +### Example +```java +// Import classes: +//import io.swagger.client.model.ApiException; +//import io.swagger.client.api.MegaSignsApi; + + +MegaSignsApi apiInstance = new MegaSignsApi(); +String authorization = "authorization_example"; // String | An OAuth Access Token with scopes:in the format 'Bearer {accessToken}'. +String megaSignId = "megaSignId_example"; // String | The identifier of the MegaSign parent agreement, as returned by the megaSign creation API or retrieved from the API to fetch megaSign agreements +ReminderInfo reminderInfo = new ReminderInfo(); // ReminderInfo | The information about a reminder associated with a recipient of an agreement. +String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. +String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or email in the format userid:{userId} OR email:{email}. of the user that has shared his/her account +try { + ReminderCreationResult result = apiInstance.createReminderOnMegaSign(authorization, megaSignId, reminderInfo, xApiUser, xOnBehalfOfUser); + System.out.println(result); +} catch (ApiException e) { + System.err.println("Exception when calling MegaSignsApi#createReminderOnMegaSign"); + e.printStackTrace(); +} +``` + +### Parameters + +Name | Type | Description | Notes +------------- | ------------- | ------------- | ------------- + **authorization** | **String**| An <a href=\"#\" onclick=\"this.href=oauthDoc()\" oncontextmenu=\"this.href=oauthDoc()\" target=\"oauthDoc\">OAuth Access Token</a> with scopes:<ul><li style='list-style-type: square'><a href=\"#\" onclick=\"this.href=oauthDoc('agreement_write')\" oncontextmenu=\"this.href=oauthDoc('agreement_write')\" target=\"oauthDoc\">agreement_write</a></li></ul>in the format <b>'Bearer {accessToken}'. | + **megaSignId** | **String**| The identifier of the MegaSign parent agreement, as returned by the megaSign creation API or retrieved from the API to fetch megaSign agreements | + **reminderInfo** | [**ReminderInfo**](ReminderInfo.md)| The information about a reminder associated with a recipient of an agreement. | + **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] + **xOnBehalfOfUser** | **String**| The userId or email in the format <b>userid:{userId} OR email:{email}.</b> of the user that has shared his/her account | [optional] + +### Return type + +[**ReminderCreationResult**](ReminderCreationResult.md) + +### Authorization + +No authorization required + +### HTTP request headers + + - **Content-Type**: Not defined + - **Accept**: application/json + + +# **createShareOnMegaSign** +> ShareCreationResponseList createShareOnMegaSign(authorization, megaSignId, shareCreationInfoList, xApiUser, xOnBehalfOfUser) + +Share a MegaSign parent and all the child agreements with someone. + +### Example +```java +// Import classes: +//import io.swagger.client.model.ApiException; +//import io.swagger.client.api.MegaSignsApi; + + +MegaSignsApi apiInstance = new MegaSignsApi(); +String authorization = "authorization_example"; // String | An OAuth Access Token with scopes:in the format 'Bearer {accessToken}'. +String megaSignId = "megaSignId_example"; // String | The identifier of the MegaSign parent agreement, as returned by the megaSign creation API or retrieved from the API to fetch megaSign agreements +ShareCreationInfoList shareCreationInfoList = new ShareCreationInfoList(); // ShareCreationInfoList | List of agreement share creation information objects. +String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. +String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or email in the format userid:{userId} OR email:{email}. of the user that has shared his/her account +try { + ShareCreationResponseList result = apiInstance.createShareOnMegaSign(authorization, megaSignId, shareCreationInfoList, xApiUser, xOnBehalfOfUser); + System.out.println(result); +} catch (ApiException e) { + System.err.println("Exception when calling MegaSignsApi#createShareOnMegaSign"); + e.printStackTrace(); +} +``` + +### Parameters + +Name | Type | Description | Notes +------------- | ------------- | ------------- | ------------- + **authorization** | **String**| An <a href=\"#\" onclick=\"this.href=oauthDoc()\" oncontextmenu=\"this.href=oauthDoc()\" target=\"oauthDoc\">OAuth Access Token</a> with scopes:<ul><li style='list-style-type: square'><a href=\"#\" onclick=\"this.href=oauthDoc('agreement_write')\" oncontextmenu=\"this.href=oauthDoc('agreement_write')\" target=\"oauthDoc\">agreement_write</a></li></ul>in the format <b>'Bearer {accessToken}'. | + **megaSignId** | **String**| The identifier of the MegaSign parent agreement, as returned by the megaSign creation API or retrieved from the API to fetch megaSign agreements | + **shareCreationInfoList** | [**ShareCreationInfoList**](ShareCreationInfoList.md)| List of agreement share creation information objects. | + **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] + **xOnBehalfOfUser** | **String**| The userId or email in the format <b>userid:{userId} OR email:{email}.</b> of the user that has shared his/her account | [optional] + +### Return type + +[**ShareCreationResponseList**](ShareCreationResponseList.md) + +### Authorization + +No authorization required + +### HTTP request headers + + - **Content-Type**: Not defined + - **Accept**: application/json + + +# **getAllMegaSignMembers** +> MegaSignMembersInfo getAllMegaSignMembers(authorization, megaSignId, xApiUser, xOnBehalfOfUser, ifNoneMatch) + +Retrieves detailed member info along with IDs for different types of participants associated with the MegaSign parent agreement. + +### Example +```java +// Import classes: +//import io.swagger.client.model.ApiException; +//import io.swagger.client.api.MegaSignsApi; + + +MegaSignsApi apiInstance = new MegaSignsApi(); +String authorization = "authorization_example"; // String | An OAuth Access Token with scopes:in the format 'Bearer {accessToken}'. +String megaSignId = "megaSignId_example"; // String | The identifier of the MegaSign parent agreement, as returned by the megaSign creation API or retrieved from the API to fetch megaSign agreements +String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. +String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or email in the format userid:{userId} OR email:{email}. of the user that has shared his/her account +String ifNoneMatch = "ifNoneMatch_example"; // String | Pass the value of the e-tag header obtained from the previous response to the same request to get a RESOURCE_NOT_MODIFIED(304) if the resource hasn't changed. +try { + MegaSignMembersInfo result = apiInstance.getAllMegaSignMembers(authorization, megaSignId, xApiUser, xOnBehalfOfUser, ifNoneMatch); + System.out.println(result); +} catch (ApiException e) { + System.err.println("Exception when calling MegaSignsApi#getAllMegaSignMembers"); + e.printStackTrace(); +} +``` + +### Parameters + +Name | Type | Description | Notes +------------- | ------------- | ------------- | ------------- + **authorization** | **String**| An <a href=\"#\" onclick=\"this.href=oauthDoc()\" oncontextmenu=\"this.href=oauthDoc()\" target=\"oauthDoc\">OAuth Access Token</a> with scopes:<ul><li style='list-style-type: square'><a href=\"#\" onclick=\"this.href=oauthDoc('agreement_read')\" oncontextmenu=\"this.href=oauthDoc('agreement_read')\" target=\"oauthDoc\">agreement_read</a></li></ul>in the format <b>'Bearer {accessToken}'. | + **megaSignId** | **String**| The identifier of the MegaSign parent agreement, as returned by the megaSign creation API or retrieved from the API to fetch megaSign agreements | + **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] + **xOnBehalfOfUser** | **String**| The userId or email in the format <b>userid:{userId} OR email:{email}.</b> of the user that has shared his/her account | [optional] + **ifNoneMatch** | **String**| Pass the value of the e-tag header obtained from the previous response to the same request to get a RESOURCE_NOT_MODIFIED(304) if the resource hasn't changed. | [optional] + +### Return type + +[**MegaSignMembersInfo**](MegaSignMembersInfo.md) + +### Authorization + +No authorization required + ### HTTP request headers - **Content-Type**: Not defined @@ -71,7 +239,429 @@ No authorization required # **getChildAgreementsInfoFile** > byte[] getChildAgreementsInfoFile(authorization, megaSignId, childAgreementsInfoFileId, xApiUser, xOnBehalfOfUser, ifNoneMatch) -Retrieves the file stream of the original childAgreementsInfoFile that was uploaded by sender while creating the MegaSign. +Retrieves the file stream of the original childAgreementsInfoFile that was uploaded by sender while creating the MegaSign. + +CSV file stream containing form data information + +### Example +```java +// Import classes: +//import io.swagger.client.model.ApiException; +//import io.swagger.client.api.MegaSignsApi; + + +MegaSignsApi apiInstance = new MegaSignsApi(); +String authorization = "authorization_example"; // String | An OAuth Access Token with scopes:in the format 'Bearer {accessToken}'. +String megaSignId = "megaSignId_example"; // String | The identifier of the MegaSign parent agreement, as returned by the megaSign creation API or retrieved from the API to fetch megaSign agreements +String childAgreementsInfoFileId = "childAgreementsInfoFileId_example"; // String | The identifier of the childAgreementsInfoFile that has been uploaded by sender while creating the megaSign or retrieved from the API to fetch megaSignInfo +String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. +String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or email in the format userid:{userId} OR email:{email}. of the user that has shared his/her account +String ifNoneMatch = "ifNoneMatch_example"; // String | Pass the value of the e-tag header obtained from the previous response to the same request to get a RESOURCE_NOT_MODIFIED(304) if the resource hasn't changed. +try { + byte[] result = apiInstance.getChildAgreementsInfoFile(authorization, megaSignId, childAgreementsInfoFileId, xApiUser, xOnBehalfOfUser, ifNoneMatch); + System.out.println(result); +} catch (ApiException e) { + System.err.println("Exception when calling MegaSignsApi#getChildAgreementsInfoFile"); + e.printStackTrace(); +} +``` + +### Parameters + +Name | Type | Description | Notes +------------- | ------------- | ------------- | ------------- + **authorization** | **String**| An <a href=\"#\" onclick=\"this.href=oauthDoc()\" oncontextmenu=\"this.href=oauthDoc()\" target=\"oauthDoc\">OAuth Access Token</a> with scopes:<ul><li style='list-style-type: square'><a href=\"#\" onclick=\"this.href=oauthDoc('agreement_read')\" oncontextmenu=\"this.href=oauthDoc('agreement_read')\" target=\"oauthDoc\">agreement_read</a></li></ul>in the format <b>'Bearer {accessToken}'. | + **megaSignId** | **String**| The identifier of the MegaSign parent agreement, as returned by the megaSign creation API or retrieved from the API to fetch megaSign agreements | + **childAgreementsInfoFileId** | **String**| The identifier of the childAgreementsInfoFile that has been uploaded by sender while creating the megaSign or retrieved from the API to fetch megaSignInfo | + **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] + **xOnBehalfOfUser** | **String**| The userId or email in the format <b>userid:{userId} OR email:{email}.</b> of the user that has shared his/her account | [optional] + **ifNoneMatch** | **String**| Pass the value of the e-tag header obtained from the previous response to the same request to get a RESOURCE_NOT_MODIFIED(304) if the resource hasn't changed. | [optional] + +### Return type + +**byte[]** + +### Authorization + +No authorization required + +### HTTP request headers + + - **Content-Type**: Not defined + - **Accept**: text/csv + + +# **getEvents** +> MegasignEventList getEvents(authorization, megaSignId, xApiUser, xOnBehalfOfUser, ifNoneMatch) + +Retrieves the events information for the MegaSign parent agreement. + +### Example +```java +// Import classes: +//import io.swagger.client.model.ApiException; +//import io.swagger.client.api.MegaSignsApi; + + +MegaSignsApi apiInstance = new MegaSignsApi(); +String authorization = "authorization_example"; // String | An OAuth Access Token with scopes:in the format 'Bearer {accessToken}'. +String megaSignId = "megaSignId_example"; // String | The identifier of the MegaSign parent agreement, as returned by the megaSign creation API or retrieved from the API to fetch megaSign agreements +String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. +String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or email in the format userid:{userId} OR email:{email}. of the user that has shared his/her account +String ifNoneMatch = "ifNoneMatch_example"; // String | Pass the value of the e-tag header obtained from the previous response to the same request to get a RESOURCE_NOT_MODIFIED(304) if the resource hasn't changed. +try { + MegasignEventList result = apiInstance.getEvents(authorization, megaSignId, xApiUser, xOnBehalfOfUser, ifNoneMatch); + System.out.println(result); +} catch (ApiException e) { + System.err.println("Exception when calling MegaSignsApi#getEvents"); + e.printStackTrace(); +} +``` + +### Parameters + +Name | Type | Description | Notes +------------- | ------------- | ------------- | ------------- + **authorization** | **String**| An <a href=\"#\" onclick=\"this.href=oauthDoc()\" oncontextmenu=\"this.href=oauthDoc()\" target=\"oauthDoc\">OAuth Access Token</a> with scopes:<ul><li style='list-style-type: square'><a href=\"#\" onclick=\"this.href=oauthDoc('agreement_read')\" oncontextmenu=\"this.href=oauthDoc('agreement_read')\" target=\"oauthDoc\">agreement_read</a></li></ul>in the format <b>'Bearer {accessToken}'. | + **megaSignId** | **String**| The identifier of the MegaSign parent agreement, as returned by the megaSign creation API or retrieved from the API to fetch megaSign agreements | + **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] + **xOnBehalfOfUser** | **String**| The userId or email in the format <b>userid:{userId} OR email:{email}.</b> of the user that has shared his/her account | [optional] + **ifNoneMatch** | **String**| Pass the value of the e-tag header obtained from the previous response to the same request to get a RESOURCE_NOT_MODIFIED(304) if the resource hasn't changed. | [optional] + +### Return type + +[**MegasignEventList**](MegasignEventList.md) + +### Authorization + +No authorization required + +### HTTP request headers + + - **Content-Type**: Not defined + - **Accept**: application/json + + +# **getMegaSignAllDocuments** +> AgreementDocuments getMegaSignAllDocuments(authorization, megaSignId, xApiUser, xOnBehalfOfUser, ifNoneMatch) + +Retrieves the IDs of the documents associated with a MegaSign parent agreement. + +### Example +```java +// Import classes: +//import io.swagger.client.model.ApiException; +//import io.swagger.client.api.MegaSignsApi; + + +MegaSignsApi apiInstance = new MegaSignsApi(); +String authorization = "authorization_example"; // String | An OAuth Access Token with scopes:in the format 'Bearer {accessToken}'. +String megaSignId = "megaSignId_example"; // String | The identifier of the MegaSign parent agreement, as returned by the megaSign creation API or retrieved from the API to fetch megaSign agreements +String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. +String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or email in the format userid:{userId} OR email:{email}. of the user that has shared his/her account +String ifNoneMatch = "ifNoneMatch_example"; // String | Pass the value of the e-tag header obtained from the previous response to the same request to get a RESOURCE_NOT_MODIFIED(304) if the resource hasn't changed. +try { + AgreementDocuments result = apiInstance.getMegaSignAllDocuments(authorization, megaSignId, xApiUser, xOnBehalfOfUser, ifNoneMatch); + System.out.println(result); +} catch (ApiException e) { + System.err.println("Exception when calling MegaSignsApi#getMegaSignAllDocuments"); + e.printStackTrace(); +} +``` + +### Parameters + +Name | Type | Description | Notes +------------- | ------------- | ------------- | ------------- + **authorization** | **String**| An <a href=\"#\" onclick=\"this.href=oauthDoc()\" oncontextmenu=\"this.href=oauthDoc()\" target=\"oauthDoc\">OAuth Access Token</a> with scopes:<ul><li style='list-style-type: square'><a href=\"#\" onclick=\"this.href=oauthDoc('agreement_read')\" oncontextmenu=\"this.href=oauthDoc('agreement_read')\" target=\"oauthDoc\">agreement_read</a></li></ul>in the format <b>'Bearer {accessToken}'. | + **megaSignId** | **String**| The identifier of the MegaSign parent agreement, as returned by the megaSign creation API or retrieved from the API to fetch megaSign agreements | + **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] + **xOnBehalfOfUser** | **String**| The userId or email in the format <b>userid:{userId} OR email:{email}.</b> of the user that has shared his/her account | [optional] + **ifNoneMatch** | **String**| Pass the value of the e-tag header obtained from the previous response to the same request to get a RESOURCE_NOT_MODIFIED(304) if the resource hasn't changed. | [optional] + +### Return type + +[**AgreementDocuments**](AgreementDocuments.md) + +### Authorization + +No authorization required + +### HTTP request headers + + - **Content-Type**: Not defined + - **Accept**: application/json + + +# **getMegaSignAllDocumentsImageUrls** +> BasicDocumentsImageUrlsInfo getMegaSignAllDocumentsImageUrls(authorization, megaSignId, xApiUser, xOnBehalfOfUser, imageSizes, showImageAvailabilityOnly) + +Retrieves image urls of all visible pages of a document associated with a MegaSign parent agreement. + +### Example +```java +// Import classes: +//import io.swagger.client.model.ApiException; +//import io.swagger.client.api.MegaSignsApi; + + +MegaSignsApi apiInstance = new MegaSignsApi(); +String authorization = "authorization_example"; // String | An OAuth Access Token with scopes:in the format 'Bearer {accessToken}'. +String megaSignId = "megaSignId_example"; // String | The identifier of the MegaSign parent agreement, as returned by the megaSign creation API or retrieved from the API to fetch megaSign agreements +String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. +String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or email in the format userid:{userId} OR email:{email}. of the user that has shared his/her account +String imageSizes = "imageSizes_example"; // String | A comma separated list of image sizes i.e. {FIXED_WIDTH_50px, FIXED_WIDTH_250px, FIXED_WIDTH_675px, ZOOM_50_PERCENT, ZOOM_75_PERCENT, ZOOM_100_PERCENT, ZOOM_125_PERCENT, ZOOM_150_PERCENT, ZOOM_200_PERCENT}. Default sizes returned are {FIXED_WIDTH_50px, FIXED_WIDTH_250px, FIXED_WIDTH_675px, ZOOM_100_PERCENT}. +Boolean showImageAvailabilityOnly = true; // Boolean | When set to true, returns only image availability. Else, returns both image urls and its availability. +try { + BasicDocumentsImageUrlsInfo result = apiInstance.getMegaSignAllDocumentsImageUrls(authorization, megaSignId, xApiUser, xOnBehalfOfUser, imageSizes, showImageAvailabilityOnly); + System.out.println(result); +} catch (ApiException e) { + System.err.println("Exception when calling MegaSignsApi#getMegaSignAllDocumentsImageUrls"); + e.printStackTrace(); +} +``` + +### Parameters + +Name | Type | Description | Notes +------------- | ------------- | ------------- | ------------- + **authorization** | **String**| An <a href=\"#\" onclick=\"this.href=oauthDoc()\" oncontextmenu=\"this.href=oauthDoc()\" target=\"oauthDoc\">OAuth Access Token</a> with scopes:<ul><li style='list-style-type: square'><a href=\"#\" onclick=\"this.href=oauthDoc('agreement_read')\" oncontextmenu=\"this.href=oauthDoc('agreement_read')\" target=\"oauthDoc\">agreement_read</a></li></ul>in the format <b>'Bearer {accessToken}'. | + **megaSignId** | **String**| The identifier of the MegaSign parent agreement, as returned by the megaSign creation API or retrieved from the API to fetch megaSign agreements | + **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] + **xOnBehalfOfUser** | **String**| The userId or email in the format <b>userid:{userId} OR email:{email}.</b> of the user that has shared his/her account | [optional] + **imageSizes** | **String**| A comma separated list of image sizes i.e. {FIXED_WIDTH_50px, FIXED_WIDTH_250px, FIXED_WIDTH_675px, ZOOM_50_PERCENT, ZOOM_75_PERCENT, ZOOM_100_PERCENT, ZOOM_125_PERCENT, ZOOM_150_PERCENT, ZOOM_200_PERCENT}. Default sizes returned are {FIXED_WIDTH_50px, FIXED_WIDTH_250px, FIXED_WIDTH_675px, ZOOM_100_PERCENT}. | [optional] + **showImageAvailabilityOnly** | **Boolean**| When set to true, returns only image availability. Else, returns both image urls and its availability. | [optional] + +### Return type + +[**BasicDocumentsImageUrlsInfo**](BasicDocumentsImageUrlsInfo.md) + +### Authorization + +No authorization required + +### HTTP request headers + + - **Content-Type**: Not defined + - **Accept**: application/json + + +# **getMegaSignChildAgreements** +> MegaSignChildAgreements getMegaSignChildAgreements(authorization, megaSignId, xApiUser, xOnBehalfOfUser, cursor, pageSize) + +Get all the child agreements of the specified MegaSign parent agreement. + +### Example +```java +// Import classes: +//import io.swagger.client.model.ApiException; +//import io.swagger.client.api.MegaSignsApi; + + +MegaSignsApi apiInstance = new MegaSignsApi(); +String authorization = "authorization_example"; // String | An OAuth Access Token with scopes:in the format 'Bearer {accessToken}'. +String megaSignId = "megaSignId_example"; // String | The identifier of the MegaSign parent agreement, as returned by the megaSign creation API or retrieved from the API to fetch megaSign agreements +String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. +String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or email in the format userid:{userId} OR email:{email}. of the user that has shared his/her account +String cursor = "cursor_example"; // String | Used to navigate through the pages. If not provided, returns the first page. +Integer pageSize = 56; // Integer | Number of intended items in the response page. If not provided, it is decided by the application settings. +try { + MegaSignChildAgreements result = apiInstance.getMegaSignChildAgreements(authorization, megaSignId, xApiUser, xOnBehalfOfUser, cursor, pageSize); + System.out.println(result); +} catch (ApiException e) { + System.err.println("Exception when calling MegaSignsApi#getMegaSignChildAgreements"); + e.printStackTrace(); +} +``` + +### Parameters + +Name | Type | Description | Notes +------------- | ------------- | ------------- | ------------- + **authorization** | **String**| An <a href=\"#\" onclick=\"this.href=oauthDoc()\" oncontextmenu=\"this.href=oauthDoc()\" target=\"oauthDoc\">OAuth Access Token</a> with scopes:<ul><li style='list-style-type: square'><a href=\"#\" onclick=\"this.href=oauthDoc('agreement_read')\" oncontextmenu=\"this.href=oauthDoc('agreement_read')\" target=\"oauthDoc\">agreement_read</a></li></ul>in the format <b>'Bearer {accessToken}'. | + **megaSignId** | **String**| The identifier of the MegaSign parent agreement, as returned by the megaSign creation API or retrieved from the API to fetch megaSign agreements | + **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] + **xOnBehalfOfUser** | **String**| The userId or email in the format <b>userid:{userId} OR email:{email}.</b> of the user that has shared his/her account | [optional] + **cursor** | **String**| Used to navigate through the pages. If not provided, returns the first page. | [optional] + **pageSize** | **Integer**| Number of intended items in the response page. If not provided, it is decided by the application settings. | [optional] + +### Return type + +[**MegaSignChildAgreements**](MegaSignChildAgreements.md) + +### Authorization + +No authorization required + +### HTTP request headers + + - **Content-Type**: Not defined + - **Accept**: application/json + + +# **getMegaSignCombinedDocument** +> byte[] getMegaSignCombinedDocument(authorization, megaSignId, xApiUser, xOnBehalfOfUser, ifNoneMatch, attachAuditReport) + +Retrieves a single combined PDF document for the documents associated with the MegaSign parent agreement. + +### Example +```java +// Import classes: +//import io.swagger.client.model.ApiException; +//import io.swagger.client.api.MegaSignsApi; + + +MegaSignsApi apiInstance = new MegaSignsApi(); +String authorization = "authorization_example"; // String | An OAuth Access Token with scopes:in the format 'Bearer {accessToken}'. +String megaSignId = "megaSignId_example"; // String | The identifier of the MegaSign parent agreement, as returned by the megaSign creation API or retrieved from the API to fetch megaSign agreements +String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. +String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or email in the format userid:{userId} OR email:{email}. of the user that has shared his/her account +String ifNoneMatch = "ifNoneMatch_example"; // String | Pass the value of the e-tag header obtained from the previous response to the same request to get a RESOURCE_NOT_MODIFIED(304) if the resource hasn't changed. +Boolean attachAuditReport = true; // Boolean | When set to true attach an audit report to the MegaSign document PDF. Default value will be false. +try { + byte[] result = apiInstance.getMegaSignCombinedDocument(authorization, megaSignId, xApiUser, xOnBehalfOfUser, ifNoneMatch, attachAuditReport); + System.out.println(result); +} catch (ApiException e) { + System.err.println("Exception when calling MegaSignsApi#getMegaSignCombinedDocument"); + e.printStackTrace(); +} +``` + +### Parameters + +Name | Type | Description | Notes +------------- | ------------- | ------------- | ------------- + **authorization** | **String**| An <a href=\"#\" onclick=\"this.href=oauthDoc()\" oncontextmenu=\"this.href=oauthDoc()\" target=\"oauthDoc\">OAuth Access Token</a> with scopes:<ul><li style='list-style-type: square'><a href=\"#\" onclick=\"this.href=oauthDoc('agreement_read')\" oncontextmenu=\"this.href=oauthDoc('agreement_read')\" target=\"oauthDoc\">agreement_read</a></li></ul>in the format <b>'Bearer {accessToken}'. | + **megaSignId** | **String**| The identifier of the MegaSign parent agreement, as returned by the megaSign creation API or retrieved from the API to fetch megaSign agreements | + **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] + **xOnBehalfOfUser** | **String**| The userId or email in the format <b>userid:{userId} OR email:{email}.</b> of the user that has shared his/her account | [optional] + **ifNoneMatch** | **String**| Pass the value of the e-tag header obtained from the previous response to the same request to get a RESOURCE_NOT_MODIFIED(304) if the resource hasn't changed. | [optional] + **attachAuditReport** | **Boolean**| When set to true attach an audit report to the MegaSign document PDF. Default value will be false. | [optional] + +### Return type + +**byte[]** + +### Authorization + +No authorization required + +### HTTP request headers + + - **Content-Type**: Not defined + - **Accept**: application/pdf, application/pdf;encoding=base64 + + +# **getMegaSignCombinedDocumentUrl** +> DocumentUrl getMegaSignCombinedDocumentUrl(authorization, megaSignId, xApiUser, xOnBehalfOfUser, attachAuditReport) + +Retrieves url of all visible pages of all the documents associated with the MegaSign parent agreement. + +### Example +```java +// Import classes: +//import io.swagger.client.model.ApiException; +//import io.swagger.client.api.MegaSignsApi; + + +MegaSignsApi apiInstance = new MegaSignsApi(); +String authorization = "authorization_example"; // String | An OAuth Access Token with scopes:in the format 'Bearer {accessToken}'. +String megaSignId = "megaSignId_example"; // String | The identifier of the MegaSign parent agreement, as returned by the megaSign creation API or retrieved from the API to fetch megaSign agreements +String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. +String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or email in the format userid:{userId} OR email:{email}. of the user that has shared his/her account +Boolean attachAuditReport = true; // Boolean | When set to true, attach an audit report to the MegaSign PDF. The default value is false. +try { + DocumentUrl result = apiInstance.getMegaSignCombinedDocumentUrl(authorization, megaSignId, xApiUser, xOnBehalfOfUser, attachAuditReport); + System.out.println(result); +} catch (ApiException e) { + System.err.println("Exception when calling MegaSignsApi#getMegaSignCombinedDocumentUrl"); + e.printStackTrace(); +} +``` + +### Parameters + +Name | Type | Description | Notes +------------- | ------------- | ------------- | ------------- + **authorization** | **String**| An <a href=\"#\" onclick=\"this.href=oauthDoc()\" oncontextmenu=\"this.href=oauthDoc()\" target=\"oauthDoc\">OAuth Access Token</a> with scopes:<ul><li style='list-style-type: square'><a href=\"#\" onclick=\"this.href=oauthDoc('agreement_read')\" oncontextmenu=\"this.href=oauthDoc('agreement_read')\" target=\"oauthDoc\">agreement_read</a></li></ul>in the format <b>'Bearer {accessToken}'. | + **megaSignId** | **String**| The identifier of the MegaSign parent agreement, as returned by the megaSign creation API or retrieved from the API to fetch megaSign agreements | + **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] + **xOnBehalfOfUser** | **String**| The userId or email in the format <b>userid:{userId} OR email:{email}.</b> of the user that has shared his/her account | [optional] + **attachAuditReport** | **Boolean**| When set to true, attach an audit report to the MegaSign PDF. The default value is false. | [optional] + +### Return type + +[**DocumentUrl**](DocumentUrl.md) + +### Authorization + +No authorization required + +### HTTP request headers + + - **Content-Type**: Not defined + - **Accept**: application/json + + +# **getMegaSignDocumentInfo** +> byte[] getMegaSignDocumentInfo(authorization, megaSignId, documentId, xApiUser, xOnBehalfOfUser, ifNoneMatch) + +Retrieves the file stream of a document of a MegaSign parent agreement. + +Raw stream of the file + +### Example +```java +// Import classes: +//import io.swagger.client.model.ApiException; +//import io.swagger.client.api.MegaSignsApi; + + +MegaSignsApi apiInstance = new MegaSignsApi(); +String authorization = "authorization_example"; // String | An OAuth Access Token with scopes:in the format 'Bearer {accessToken}'. +String megaSignId = "megaSignId_example"; // String | The identifier of the MegaSign parent agreement, as returned by the megaSign creation API or retrieved from the API to fetch megaSign agreements +String documentId = "documentId_example"; // String | The document identifier, as retrieved from the API which fetches the documents of a specified MegaSign parent +String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. +String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or email in the format userid:{userId} OR email:{email}. of the user that has shared his/her account +String ifNoneMatch = "ifNoneMatch_example"; // String | Pass the value of the e-tag header obtained from the previous response to the same request to get a RESOURCE_NOT_MODIFIED(304) if the resource hasn't changed. +try { + byte[] result = apiInstance.getMegaSignDocumentInfo(authorization, megaSignId, documentId, xApiUser, xOnBehalfOfUser, ifNoneMatch); + System.out.println(result); +} catch (ApiException e) { + System.err.println("Exception when calling MegaSignsApi#getMegaSignDocumentInfo"); + e.printStackTrace(); +} +``` + +### Parameters + +Name | Type | Description | Notes +------------- | ------------- | ------------- | ------------- + **authorization** | **String**| An <a href=\"#\" onclick=\"this.href=oauthDoc()\" oncontextmenu=\"this.href=oauthDoc()\" target=\"oauthDoc\">OAuth Access Token</a> with scopes:<ul><li style='list-style-type: square'><a href=\"#\" onclick=\"this.href=oauthDoc('agreement_read')\" oncontextmenu=\"this.href=oauthDoc('agreement_read')\" target=\"oauthDoc\">agreement_read</a></li></ul>in the format <b>'Bearer {accessToken}'. | + **megaSignId** | **String**| The identifier of the MegaSign parent agreement, as returned by the megaSign creation API or retrieved from the API to fetch megaSign agreements | + **documentId** | **String**| The document identifier, as retrieved from the API which fetches the documents of a specified MegaSign parent | + **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] + **xOnBehalfOfUser** | **String**| The userId or email in the format <b>userid:{userId} OR email:{email}.</b> of the user that has shared his/her account | [optional] + **ifNoneMatch** | **String**| Pass the value of the e-tag header obtained from the previous response to the same request to get a RESOURCE_NOT_MODIFIED(304) if the resource hasn't changed. | [optional] + +### Return type + +**byte[]** + +### Authorization + +No authorization required + +### HTTP request headers + + - **Content-Type**: Not defined + - **Accept**: application/pdf, application/pdf;encoding=base64 + + +# **getMegaSignFormData** +> byte[] getMegaSignFormData(authorization, megaSignId, xApiUser, xOnBehalfOfUser) + +Retrieves data entered by recipients into interactive form fields at the time they signed the child agreements of the specified MegaSign agreement CSV file stream containing form data information @@ -85,15 +675,13 @@ CSV file stream containing form data information MegaSignsApi apiInstance = new MegaSignsApi(); String authorization = "authorization_example"; // String | An OAuth Access Token with scopes:in the format 'Bearer {accessToken}'. String megaSignId = "megaSignId_example"; // String | The identifier of the MegaSign parent agreement, as returned by the megaSign creation API or retrieved from the API to fetch megaSign agreements -String childAgreementsInfoFileId = "childAgreementsInfoFileId_example"; // String | The identifier of the childAgreementsInfoFile that has been uploaded by sender while creating the megaSign or retrieved from the API to fetch megaSignInfo String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or email in the format userid:{userId} OR email:{email}. of the user that has shared his/her account -String ifNoneMatch = "ifNoneMatch_example"; // String | Pass the value of the e-tag header obtained from the previous response to the same request to get a RESOURCE_NOT_MODIFIED(304) if the resource hasn't changed. try { - byte[] result = apiInstance.getChildAgreementsInfoFile(authorization, megaSignId, childAgreementsInfoFileId, xApiUser, xOnBehalfOfUser, ifNoneMatch); + byte[] result = apiInstance.getMegaSignFormData(authorization, megaSignId, xApiUser, xOnBehalfOfUser); System.out.println(result); } catch (ApiException e) { - System.err.println("Exception when calling MegaSignsApi#getChildAgreementsInfoFile"); + System.err.println("Exception when calling MegaSignsApi#getMegaSignFormData"); e.printStackTrace(); } ``` @@ -104,10 +692,8 @@ Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **authorization** | **String**| An <a href=\"#\" onclick=\"this.href=oauthDoc()\" oncontextmenu=\"this.href=oauthDoc()\" target=\"oauthDoc\">OAuth Access Token</a> with scopes:<ul><li style='list-style-type: square'><a href=\"#\" onclick=\"this.href=oauthDoc('agreement_read')\" oncontextmenu=\"this.href=oauthDoc('agreement_read')\" target=\"oauthDoc\">agreement_read</a></li></ul>in the format <b>'Bearer {accessToken}'. | **megaSignId** | **String**| The identifier of the MegaSign parent agreement, as returned by the megaSign creation API or retrieved from the API to fetch megaSign agreements | - **childAgreementsInfoFileId** | **String**| The identifier of the childAgreementsInfoFile that has been uploaded by sender while creating the megaSign or retrieved from the API to fetch megaSignInfo | **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] **xOnBehalfOfUser** | **String**| The userId or email in the format <b>userid:{userId} OR email:{email}.</b> of the user that has shared his/her account | [optional] - **ifNoneMatch** | **String**| Pass the value of the e-tag header obtained from the previous response to the same request to get a RESOURCE_NOT_MODIFIED(304) if the resource hasn't changed. | [optional] ### Return type @@ -122,11 +708,11 @@ No authorization required - **Content-Type**: Not defined - **Accept**: text/csv - -# **getEvents** -> MegasignEventList getEvents(authorization, megaSignId, xApiUser, xOnBehalfOfUser, ifNoneMatch) + +# **getMegaSignInfo** +> FetchedMegaSignInfo getMegaSignInfo(authorization, megaSignId, xApiUser, xOnBehalfOfUser, ifNoneMatch) -Retrieves the events information for the MegaSign parent agreement. +Get detailed information of the specified MegaSign parent agreement. ### Example ```java @@ -142,10 +728,10 @@ String xApiUser = "xApiUser_example"; // String | The userId or email of API cal String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or email in the format userid:{userId} OR email:{email}. of the user that has shared his/her account String ifNoneMatch = "ifNoneMatch_example"; // String | Pass the value of the e-tag header obtained from the previous response to the same request to get a RESOURCE_NOT_MODIFIED(304) if the resource hasn't changed. try { - MegasignEventList result = apiInstance.getEvents(authorization, megaSignId, xApiUser, xOnBehalfOfUser, ifNoneMatch); + FetchedMegaSignInfo result = apiInstance.getMegaSignInfo(authorization, megaSignId, xApiUser, xOnBehalfOfUser, ifNoneMatch); System.out.println(result); } catch (ApiException e) { - System.err.println("Exception when calling MegaSignsApi#getEvents"); + System.err.println("Exception when calling MegaSignsApi#getMegaSignInfo"); e.printStackTrace(); } ``` @@ -162,7 +748,7 @@ Name | Type | Description | Notes ### Return type -[**MegasignEventList**](MegasignEventList.md) +[**FetchedMegaSignInfo**](FetchedMegaSignInfo.md) ### Authorization @@ -173,11 +759,11 @@ No authorization required - **Content-Type**: Not defined - **Accept**: application/json - -# **getMegaSignChildAgreements** -> MegaSignChildAgreements getMegaSignChildAgreements(authorization, megaSignId, xApiUser, xOnBehalfOfUser, cursor, pageSize) + +# **getMegaSignInfoForUser** +> MyAgreementInfo getMegaSignInfoForUser(authorization, megaSignId, xApiUser) -Get all the child agreements of the specified MegaSign parent agreement. +Retrieves the MegaSign parent agreement information related to the api caller ### Example ```java @@ -190,14 +776,11 @@ MegaSignsApi apiInstance = new MegaSignsApi(); String authorization = "authorization_example"; // String | An OAuth Access Token with scopes:in the format 'Bearer {accessToken}'. String megaSignId = "megaSignId_example"; // String | The identifier of the MegaSign parent agreement, as returned by the megaSign creation API or retrieved from the API to fetch megaSign agreements String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. -String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or email in the format userid:{userId} OR email:{email}. of the user that has shared his/her account -String cursor = "cursor_example"; // String | Used to navigate through the pages. If not provided, returns the first page. -Integer pageSize = 56; // Integer | Number of intended items in the response page. If not provided, it is decided by the application settings. try { - MegaSignChildAgreements result = apiInstance.getMegaSignChildAgreements(authorization, megaSignId, xApiUser, xOnBehalfOfUser, cursor, pageSize); + MyAgreementInfo result = apiInstance.getMegaSignInfoForUser(authorization, megaSignId, xApiUser); System.out.println(result); } catch (ApiException e) { - System.err.println("Exception when calling MegaSignsApi#getMegaSignChildAgreements"); + System.err.println("Exception when calling MegaSignsApi#getMegaSignInfoForUser"); e.printStackTrace(); } ``` @@ -209,13 +792,10 @@ Name | Type | Description | Notes **authorization** | **String**| An <a href=\"#\" onclick=\"this.href=oauthDoc()\" oncontextmenu=\"this.href=oauthDoc()\" target=\"oauthDoc\">OAuth Access Token</a> with scopes:<ul><li style='list-style-type: square'><a href=\"#\" onclick=\"this.href=oauthDoc('agreement_read')\" oncontextmenu=\"this.href=oauthDoc('agreement_read')\" target=\"oauthDoc\">agreement_read</a></li></ul>in the format <b>'Bearer {accessToken}'. | **megaSignId** | **String**| The identifier of the MegaSign parent agreement, as returned by the megaSign creation API or retrieved from the API to fetch megaSign agreements | **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] - **xOnBehalfOfUser** | **String**| The userId or email in the format <b>userid:{userId} OR email:{email}.</b> of the user that has shared his/her account | [optional] - **cursor** | **String**| Used to navigate through the pages. If not provided, returns the first page. | [optional] - **pageSize** | **Integer**| Number of intended items in the response page. If not provided, it is decided by the application settings. | [optional] ### Return type -[**MegaSignChildAgreements**](MegaSignChildAgreements.md) +[**MyAgreementInfo**](MyAgreementInfo.md) ### Authorization @@ -226,11 +806,11 @@ No authorization required - **Content-Type**: Not defined - **Accept**: application/json - -# **getMegaSignCombinedDocument** -> byte[] getMegaSignCombinedDocument(authorization, megaSignId, xApiUser, xOnBehalfOfUser, ifNoneMatch, attachAuditReport) + +# **getMegaSignNoteForUser** +> Note getMegaSignNoteForUser(authorization, megaSignId, xApiUser, xOnBehalfOfUser) -Retrieves a single combined PDF document for the documents associated with the MegaSign parent agreement. +Retrieves the latest note of a MegaSign parent agreement for the user. ### Example ```java @@ -244,13 +824,11 @@ String authorization = "authorization_example"; // String | An userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or email in the format userid:{userId} OR email:{email}. of the user that has shared his/her account -String ifNoneMatch = "ifNoneMatch_example"; // String | Pass the value of the e-tag header obtained from the previous response to the same request to get a RESOURCE_NOT_MODIFIED(304) if the resource hasn't changed. -Boolean attachAuditReport = true; // Boolean | When set to true attach an audit report to the MegaSign document PDF. Default value will be false. try { - byte[] result = apiInstance.getMegaSignCombinedDocument(authorization, megaSignId, xApiUser, xOnBehalfOfUser, ifNoneMatch, attachAuditReport); + Note result = apiInstance.getMegaSignNoteForUser(authorization, megaSignId, xApiUser, xOnBehalfOfUser); System.out.println(result); } catch (ApiException e) { - System.err.println("Exception when calling MegaSignsApi#getMegaSignCombinedDocument"); + System.err.println("Exception when calling MegaSignsApi#getMegaSignNoteForUser"); e.printStackTrace(); } ``` @@ -263,12 +841,10 @@ Name | Type | Description | Notes **megaSignId** | **String**| The identifier of the MegaSign parent agreement, as returned by the megaSign creation API or retrieved from the API to fetch megaSign agreements | **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] **xOnBehalfOfUser** | **String**| The userId or email in the format <b>userid:{userId} OR email:{email}.</b> of the user that has shared his/her account | [optional] - **ifNoneMatch** | **String**| Pass the value of the e-tag header obtained from the previous response to the same request to get a RESOURCE_NOT_MODIFIED(304) if the resource hasn't changed. | [optional] - **attachAuditReport** | **Boolean**| When set to true attach an audit report to the MegaSign document PDF. Default value will be false. | [optional] ### Return type -**byte[]** +[**Note**](Note.md) ### Authorization @@ -277,15 +853,13 @@ No authorization required ### HTTP request headers - **Content-Type**: Not defined - - **Accept**: application/pdf, application/pdf;encoding=base64 - - -# **getMegaSignFormData** -> byte[] getMegaSignFormData(authorization, megaSignId, xApiUser, xOnBehalfOfUser) + - **Accept**: application/json -Retrieves data entered by recipients into interactive form fields at the time they signed the child agreements of the specified MegaSign agreement + +# **getMegaSignReminder** +> ReminderInfo getMegaSignReminder(authorization, megaSignId, reminderId, xApiUser, xOnBehalfOfUser) -CSV file stream containing form data information +Retrieves a specific reminder given the reminder id for the specified MegaSign parent agreement. ### Example ```java @@ -297,13 +871,14 @@ CSV file stream containing form data information MegaSignsApi apiInstance = new MegaSignsApi(); String authorization = "authorization_example"; // String | An OAuth Access Token with scopes:in the format 'Bearer {accessToken}'. String megaSignId = "megaSignId_example"; // String | The identifier of the MegaSign parent agreement, as returned by the megaSign creation API or retrieved from the API to fetch megaSign agreements +String reminderId = "reminderId_example"; // String | The reminder identifier String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or email in the format userid:{userId} OR email:{email}. of the user that has shared his/her account try { - byte[] result = apiInstance.getMegaSignFormData(authorization, megaSignId, xApiUser, xOnBehalfOfUser); + ReminderInfo result = apiInstance.getMegaSignReminder(authorization, megaSignId, reminderId, xApiUser, xOnBehalfOfUser); System.out.println(result); } catch (ApiException e) { - System.err.println("Exception when calling MegaSignsApi#getMegaSignFormData"); + System.err.println("Exception when calling MegaSignsApi#getMegaSignReminder"); e.printStackTrace(); } ``` @@ -314,12 +889,13 @@ Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **authorization** | **String**| An <a href=\"#\" onclick=\"this.href=oauthDoc()\" oncontextmenu=\"this.href=oauthDoc()\" target=\"oauthDoc\">OAuth Access Token</a> with scopes:<ul><li style='list-style-type: square'><a href=\"#\" onclick=\"this.href=oauthDoc('agreement_read')\" oncontextmenu=\"this.href=oauthDoc('agreement_read')\" target=\"oauthDoc\">agreement_read</a></li></ul>in the format <b>'Bearer {accessToken}'. | **megaSignId** | **String**| The identifier of the MegaSign parent agreement, as returned by the megaSign creation API or retrieved from the API to fetch megaSign agreements | + **reminderId** | **String**| The reminder identifier | **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] **xOnBehalfOfUser** | **String**| The userId or email in the format <b>userid:{userId} OR email:{email}.</b> of the user that has shared his/her account | [optional] ### Return type -**byte[]** +[**ReminderInfo**](ReminderInfo.md) ### Authorization @@ -328,13 +904,13 @@ No authorization required ### HTTP request headers - **Content-Type**: Not defined - - **Accept**: text/csv + - **Accept**: application/json - -# **getMegaSignInfo** -> MegaSignCreationInfo getMegaSignInfo(authorization, megaSignId, xApiUser, xOnBehalfOfUser, ifNoneMatch) + +# **getMegaSignReminders** +> MegaSignRemindersResponse getMegaSignReminders(authorization, megaSignId, xApiUser, xOnBehalfOfUser, status) -Get detailed information of the specified MegaSign parent agreement. +Retrieves the reminders of the specified MegaSign parent agreement. ### Example ```java @@ -348,12 +924,12 @@ String authorization = "authorization_example"; // String | An userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or email in the format userid:{userId} OR email:{email}. of the user that has shared his/her account -String ifNoneMatch = "ifNoneMatch_example"; // String | Pass the value of the e-tag header obtained from the previous response to the same request to get a RESOURCE_NOT_MODIFIED(304) if the resource hasn't changed. +String status = "status_example"; // String | A comma-separated list of reminder statuses of the reminders which should be returned in the response. Currently supported values are ACTIVE, CANCELED, COMPLETE try { - MegaSignCreationInfo result = apiInstance.getMegaSignInfo(authorization, megaSignId, xApiUser, xOnBehalfOfUser, ifNoneMatch); + MegaSignRemindersResponse result = apiInstance.getMegaSignReminders(authorization, megaSignId, xApiUser, xOnBehalfOfUser, status); System.out.println(result); } catch (ApiException e) { - System.err.println("Exception when calling MegaSignsApi#getMegaSignInfo"); + System.err.println("Exception when calling MegaSignsApi#getMegaSignReminders"); e.printStackTrace(); } ``` @@ -366,11 +942,11 @@ Name | Type | Description | Notes **megaSignId** | **String**| The identifier of the MegaSign parent agreement, as returned by the megaSign creation API or retrieved from the API to fetch megaSign agreements | **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] **xOnBehalfOfUser** | **String**| The userId or email in the format <b>userid:{userId} OR email:{email}.</b> of the user that has shared his/her account | [optional] - **ifNoneMatch** | **String**| Pass the value of the e-tag header obtained from the previous response to the same request to get a RESOURCE_NOT_MODIFIED(304) if the resource hasn't changed. | [optional] + **status** | **String**| A comma-separated list of reminder statuses of the reminders which should be returned in the response. Currently supported values are ACTIVE, CANCELED, COMPLETE | [optional] ### Return type -[**MegaSignCreationInfo**](MegaSignCreationInfo.md) +[**MegaSignRemindersResponse**](MegaSignRemindersResponse.md) ### Authorization @@ -434,7 +1010,7 @@ No authorization required # **getMegaSigns** -> MegaSigns getMegaSigns(authorization, xApiUser, xOnBehalfOfUser, cursor, pageSize) +> MegaSigns getMegaSigns(authorization, xApiUser, xOnBehalfOfUser, showHiddenMegaSigns, cursor, pageSize, groupId) Retrieves MegaSign parent agreements for a user. @@ -449,10 +1025,12 @@ MegaSignsApi apiInstance = new MegaSignsApi(); String authorization = "authorization_example"; // String | An OAuth Access Token with scopes:in the format 'Bearer {accessToken}'. String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or email in the format userid:{userId} OR email:{email}. of the user that has shared his/her account +Boolean showHiddenMegaSigns = true; // Boolean | A query parameter to fetch all the hidden MegaSigns along with the visible MegaSigns. Default value is false. String cursor = "cursor_example"; // String | Used to navigate through the pages. If not provided, returns the first page. Integer pageSize = 56; // Integer | Number of intended items in the response page. If not provided, it is decided by the application settings. +String groupId = "groupId_example"; // String | The group identifier, as returned by the group creation API or retrieved from the API to fetch groups. try { - MegaSigns result = apiInstance.getMegaSigns(authorization, xApiUser, xOnBehalfOfUser, cursor, pageSize); + MegaSigns result = apiInstance.getMegaSigns(authorization, xApiUser, xOnBehalfOfUser, showHiddenMegaSigns, cursor, pageSize, groupId); System.out.println(result); } catch (ApiException e) { System.err.println("Exception when calling MegaSignsApi#getMegaSigns"); @@ -467,8 +1045,10 @@ Name | Type | Description | Notes **authorization** | **String**| An <a href=\"#\" onclick=\"this.href=oauthDoc()\" oncontextmenu=\"this.href=oauthDoc()\" target=\"oauthDoc\">OAuth Access Token</a> with scopes:<ul><li style='list-style-type: square'><a href=\"#\" onclick=\"this.href=oauthDoc('agreement_read')\" oncontextmenu=\"this.href=oauthDoc('agreement_read')\" target=\"oauthDoc\">agreement_read</a></li></ul>in the format <b>'Bearer {accessToken}'. | **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] **xOnBehalfOfUser** | **String**| The userId or email in the format <b>userid:{userId} OR email:{email}.</b> of the user that has shared his/her account | [optional] + **showHiddenMegaSigns** | **Boolean**| A query parameter to fetch all the hidden MegaSigns along with the visible MegaSigns. Default value is false. | [optional] **cursor** | **String**| Used to navigate through the pages. If not provided, returns the first page. | [optional] **pageSize** | **Integer**| Number of intended items in the response page. If not provided, it is decided by the application settings. | [optional] + **groupId** | **String**| The group identifier, as returned by the group creation API or retrieved from the API to fetch groups. | [optional] ### Return type @@ -478,6 +1058,162 @@ Name | Type | Description | Notes No authorization required +### HTTP request headers + + - **Content-Type**: Not defined + - **Accept**: application/json + + +# **updateMegaSign** +> updateMegaSign(authorization, megaSignId, megaSignInfo, xApiUser, xOnBehalfOfUser, ifMatch) + +Update the expirationTime on an existing megaSign parent and all the child agreements that are already out for signature. + +### Example +```java +// Import classes: +//import io.swagger.client.model.ApiException; +//import io.swagger.client.api.MegaSignsApi; + + +MegaSignsApi apiInstance = new MegaSignsApi(); +String authorization = "authorization_example"; // String | An OAuth Access Token with scopes:in the format 'Bearer {accessToken}'. +String megaSignId = "megaSignId_example"; // String | The identifier of the MegaSign parent agreement, as returned by the megaSign creation API or retrieved from the API to fetch megaSign agreements +MegaSignInfo megaSignInfo = new MegaSignInfo(); // MegaSignInfo | Information necessary to update a modifiable megaSign parent that is presently out for signature. +String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. +String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or email in the format userid:{userId} OR email:{email}. of the user that has shared his/her account +String ifMatch = "ifMatch_example"; // String | The server will only update the resource if it matches the listed ETag otherwise error RESOURCE_MODIFIED(412) is returned. +try { + apiInstance.updateMegaSign(authorization, megaSignId, megaSignInfo, xApiUser, xOnBehalfOfUser, ifMatch); +} catch (ApiException e) { + System.err.println("Exception when calling MegaSignsApi#updateMegaSign"); + e.printStackTrace(); +} +``` + +### Parameters + +Name | Type | Description | Notes +------------- | ------------- | ------------- | ------------- + **authorization** | **String**| An <a href=\"#\" onclick=\"this.href=oauthDoc()\" oncontextmenu=\"this.href=oauthDoc()\" target=\"oauthDoc\">OAuth Access Token</a> with scopes:<ul><li style='list-style-type: square'><a href=\"#\" onclick=\"this.href=oauthDoc('agreement_write')\" oncontextmenu=\"this.href=oauthDoc('agreement_write')\" target=\"oauthDoc\">agreement_write</a></li></ul>in the format <b>'Bearer {accessToken}'. | + **megaSignId** | **String**| The identifier of the MegaSign parent agreement, as returned by the megaSign creation API or retrieved from the API to fetch megaSign agreements | + **megaSignInfo** | [**MegaSignInfo**](MegaSignInfo.md)| Information necessary to update a modifiable megaSign parent that is presently out for signature. | + **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] + **xOnBehalfOfUser** | **String**| The userId or email in the format <b>userid:{userId} OR email:{email}.</b> of the user that has shared his/her account | [optional] + **ifMatch** | **String**| The server will only update the resource if it matches the listed ETag otherwise error RESOURCE_MODIFIED(412) is returned. | [optional] + +### Return type + +null (empty response body) + +### Authorization + +No authorization required + +### HTTP request headers + + - **Content-Type**: Not defined + - **Accept**: application/json + + +# **updateMegaSignNoteForUser** +> updateMegaSignNoteForUser(authorization, megaSignId, note, xApiUser, xOnBehalfOfUser) + +Updates the latest note of a MegaSign parent agreement for the user. + +### Example +```java +// Import classes: +//import io.swagger.client.model.ApiException; +//import io.swagger.client.api.MegaSignsApi; + + +MegaSignsApi apiInstance = new MegaSignsApi(); +String authorization = "authorization_example"; // String | An OAuth Access Token with scopes:in the format 'Bearer {accessToken}'. +String megaSignId = "megaSignId_example"; // String | The identifier of the MegaSign parent agreement, as returned by the megaSign creation API or retrieved from the API to fetch megaSign agreements +Note note = new Note(); // Note | The note to be associated with the MegaSign parent agreement. +String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. +String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or email in the format userid:{userId} OR email:{email}. of the user that has shared his/her account +try { + apiInstance.updateMegaSignNoteForUser(authorization, megaSignId, note, xApiUser, xOnBehalfOfUser); +} catch (ApiException e) { + System.err.println("Exception when calling MegaSignsApi#updateMegaSignNoteForUser"); + e.printStackTrace(); +} +``` + +### Parameters + +Name | Type | Description | Notes +------------- | ------------- | ------------- | ------------- + **authorization** | **String**| An <a href=\"#\" onclick=\"this.href=oauthDoc()\" oncontextmenu=\"this.href=oauthDoc()\" target=\"oauthDoc\">OAuth Access Token</a> with scopes:<ul><li style='list-style-type: square'><a href=\"#\" onclick=\"this.href=oauthDoc('agreement_write')\" oncontextmenu=\"this.href=oauthDoc('agreement_write')\" target=\"oauthDoc\">agreement_write</a></li></ul>in the format <b>'Bearer {accessToken}'. | + **megaSignId** | **String**| The identifier of the MegaSign parent agreement, as returned by the megaSign creation API or retrieved from the API to fetch megaSign agreements | + **note** | [**Note**](Note.md)| The note to be associated with the MegaSign parent agreement. | + **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] + **xOnBehalfOfUser** | **String**| The userId or email in the format <b>userid:{userId} OR email:{email}.</b> of the user that has shared his/her account | [optional] + +### Return type + +null (empty response body) + +### Authorization + +No authorization required + +### HTTP request headers + + - **Content-Type**: Not defined + - **Accept**: application/json + + +# **updateMegaSignReminder** +> updateMegaSignReminder(authorization, megaSignId, reminderId, reminderInfo, xApiUser, xOnBehalfOfUser) + +Updates an existing reminder for a MegaSign parent agreement. + +You can only update an ACTIVE reminder, and can only update the status to 'CANCELED', update reminderParticipantIds, update allUnsigned or update note. + +### Example +```java +// Import classes: +//import io.swagger.client.model.ApiException; +//import io.swagger.client.api.MegaSignsApi; + + +MegaSignsApi apiInstance = new MegaSignsApi(); +String authorization = "authorization_example"; // String | An OAuth Access Token with scopes:in the format 'Bearer {accessToken}'. +String megaSignId = "megaSignId_example"; // String | The identifier of the MegaSign parent agreement, as returned by the megaSign creation API or retrieved from the API to fetch megaSign agreements +String reminderId = "reminderId_example"; // String | The reminder identifier +ReminderInfo reminderInfo = new ReminderInfo(); // ReminderInfo | The information about a reminder associated with a recipient of an agreement. +String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. +String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or email in the format userid:{userId} OR email:{email}. of the user that has shared his/her account +try { + apiInstance.updateMegaSignReminder(authorization, megaSignId, reminderId, reminderInfo, xApiUser, xOnBehalfOfUser); +} catch (ApiException e) { + System.err.println("Exception when calling MegaSignsApi#updateMegaSignReminder"); + e.printStackTrace(); +} +``` + +### Parameters + +Name | Type | Description | Notes +------------- | ------------- | ------------- | ------------- + **authorization** | **String**| An <a href=\"#\" onclick=\"this.href=oauthDoc()\" oncontextmenu=\"this.href=oauthDoc()\" target=\"oauthDoc\">OAuth Access Token</a> with scopes:<ul><li style='list-style-type: square'><a href=\"#\" onclick=\"this.href=oauthDoc('agreement_write')\" oncontextmenu=\"this.href=oauthDoc('agreement_write')\" target=\"oauthDoc\">agreement_write</a></li></ul>in the format <b>'Bearer {accessToken}'. | + **megaSignId** | **String**| The identifier of the MegaSign parent agreement, as returned by the megaSign creation API or retrieved from the API to fetch megaSign agreements | + **reminderId** | **String**| The reminder identifier | + **reminderInfo** | [**ReminderInfo**](ReminderInfo.md)| The information about a reminder associated with a recipient of an agreement. | + **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] + **xOnBehalfOfUser** | **String**| The userId or email in the format <b>userid:{userId} OR email:{email}.</b> of the user that has shared his/her account | [optional] + +### Return type + +null (empty response body) + +### Authorization + +No authorization required + ### HTTP request headers - **Content-Type**: Not defined @@ -485,7 +1221,7 @@ No authorization required # **updateMegaSignState** -> updateMegaSignState(authorization, ifMatch, megaSignId, megaSignStateInfo, xApiUser, xOnBehalfOfUser) +> updateMegaSignState(authorization, megaSignId, megaSignStateInfo, xApiUser, xOnBehalfOfUser, ifMatch) Updates the state of a MegaSign identified by MegaSignId in the path. @@ -500,13 +1236,13 @@ This endpoint can be used by creator of the MegaSign to transition between the s MegaSignsApi apiInstance = new MegaSignsApi(); String authorization = "authorization_example"; // String | An OAuth Access Token with scopes:in the format 'Bearer {accessToken}'. -String ifMatch = "ifMatch_example"; // String | The server will only update the resource if it matches the listed ETag otherwise error RESOURCE_MODIFIED(412) is returned. String megaSignId = "megaSignId_example"; // String | The identifier of the MegaSign parent agreement, as returned by the megaSign creation API or retrieved from the API to fetch megaSign agreements MegaSignStateInfo megaSignStateInfo = new MegaSignStateInfo(); // MegaSignStateInfo | MegaSign state update information object. String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or email in the format userid:{userId} OR email:{email}. of the user that has shared his/her account +String ifMatch = "ifMatch_example"; // String | The server will only update the resource if it matches the listed ETag otherwise error RESOURCE_MODIFIED(412) is returned. try { - apiInstance.updateMegaSignState(authorization, ifMatch, megaSignId, megaSignStateInfo, xApiUser, xOnBehalfOfUser); + apiInstance.updateMegaSignState(authorization, megaSignId, megaSignStateInfo, xApiUser, xOnBehalfOfUser, ifMatch); } catch (ApiException e) { System.err.println("Exception when calling MegaSignsApi#updateMegaSignState"); e.printStackTrace(); @@ -518,11 +1254,61 @@ try { Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **authorization** | **String**| An <a href=\"#\" onclick=\"this.href=oauthDoc()\" oncontextmenu=\"this.href=oauthDoc()\" target=\"oauthDoc\">OAuth Access Token</a> with scopes:<ul><li style='list-style-type: square'><a href=\"#\" onclick=\"this.href=oauthDoc('agreement_write')\" oncontextmenu=\"this.href=oauthDoc('agreement_write')\" target=\"oauthDoc\">agreement_write</a></li></ul>in the format <b>'Bearer {accessToken}'. | - **ifMatch** | **String**| The server will only update the resource if it matches the listed ETag otherwise error RESOURCE_MODIFIED(412) is returned. | **megaSignId** | **String**| The identifier of the MegaSign parent agreement, as returned by the megaSign creation API or retrieved from the API to fetch megaSign agreements | **megaSignStateInfo** | [**MegaSignStateInfo**](MegaSignStateInfo.md)| MegaSign state update information object. | **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] **xOnBehalfOfUser** | **String**| The userId or email in the format <b>userid:{userId} OR email:{email}.</b> of the user that has shared his/her account | [optional] + **ifMatch** | **String**| The server will only update the resource if it matches the listed ETag otherwise error RESOURCE_MODIFIED(412) is returned. | [optional] + +### Return type + +null (empty response body) + +### Authorization + +No authorization required + +### HTTP request headers + + - **Content-Type**: Not defined + - **Accept**: application/json + + +# **updateMegaSignVisibility** +> updateMegaSignVisibility(authorization, megaSignId, visibilityInfo, xApiUser, xOnBehalfOfUser) + +Updates the visibility of a MegaSign. + +### Example +```java +// Import classes: +//import io.swagger.client.model.ApiException; +//import io.swagger.client.api.MegaSignsApi; + + +MegaSignsApi apiInstance = new MegaSignsApi(); +String authorization = "authorization_example"; // String | An OAuth Access Token with scopes:in the format 'Bearer {accessToken}'. +String megaSignId = "megaSignId_example"; // String | The identifier of the MegaSign parent agreement, as returned by the megaSign creation API or retrieved from the API to fetch megaSign agreements +VisibilityInfo visibilityInfo = new VisibilityInfo(); // VisibilityInfo | Information to update visibility of agreement +String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. +String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or email in the format userid:{userId} OR email:{email}. of the user that has shared his/her account +try { + apiInstance.updateMegaSignVisibility(authorization, megaSignId, visibilityInfo, xApiUser, xOnBehalfOfUser); +} catch (ApiException e) { + System.err.println("Exception when calling MegaSignsApi#updateMegaSignVisibility"); + e.printStackTrace(); +} +``` + +### Parameters + +Name | Type | Description | Notes +------------- | ------------- | ------------- | ------------- + **authorization** | **String**| An <a href=\"#\" onclick=\"this.href=oauthDoc()\" oncontextmenu=\"this.href=oauthDoc()\" target=\"oauthDoc\">OAuth Access Token</a> with scopes:<ul><li style='list-style-type: square'><a href=\"#\" onclick=\"this.href=oauthDoc('agreement_write')\" oncontextmenu=\"this.href=oauthDoc('agreement_write')\" target=\"oauthDoc\">agreement_write</a></li></ul>in the format <b>'Bearer {accessToken}'. | + **megaSignId** | **String**| The identifier of the MegaSign parent agreement, as returned by the megaSign creation API or retrieved from the API to fetch megaSign agreements | + **visibilityInfo** | [**VisibilityInfo**](VisibilityInfo.md)| Information to update visibility of agreement | + **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] + **xOnBehalfOfUser** | **String**| The userId or email in the format <b>userid:{userId} OR email:{email}.</b> of the user that has shared his/her account | [optional] ### Return type diff --git a/docs/MegasignEvent.md b/docs/MegasignEvent.md index 7cb0cd9..36c0e99 100755 --- a/docs/MegasignEvent.md +++ b/docs/MegasignEvent.md @@ -4,25 +4,40 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**actingUserEmail** | **String** | Email address of the user that created the event | [optional] -**actingUserIpAddress** | **String** | The IP address of the user that created the event | [optional] -**actingUserName** | **String** | The name of the acting user | [optional] -**comment** | **String** | The event comment. For RECALLED or REJECTED, the reason given by the user that initiates the event. For DELEGATE or SHARE, the message from the acting user to the participant | [optional] **date** | [**Date**](Date.md) | The date of the audit event. Format would be yyyy-MM-dd'T'HH:mm:ssZ. For example, e.g 2016-02-25T18:46:19Z represents UTC time | [optional] -**description** | **String** | A description of the audit event | [optional] -**deviceLocation** | [**DeviceLocation**](DeviceLocation.md) | Location of the device that generated the event (This value may be null due to limited privileges) | [optional] -**devicePhoneNumber** | **String** | Phone number from the device used when the participation is completed on a mobile phone | [optional] -**digitalSignatureInfo** | [**DigitalSignatureInfo**](DigitalSignatureInfo.md) | This is present for ESIGNED events when the participation is signed digitally | [optional] -**initiatingUserEmail** | **String** | Email address of the user that initiated the event on behalf of the acting user when the account is shared. Will be empty if there is no account sharing in effect | [optional] **initiatingUserName** | **String** | Full name of the user that initiated the event on behalf of the acting user when the account is shared. Will be empty if there is no account sharing in effect | [optional] +**description** | **String** | A description of the audit event | [optional] +**actingUserName** | **String** | The name of the acting user | [optional] +**actingUserIpAddress** | **String** | The IP address of the user that created the event | [optional] **participantEmail** | **String** | Email address of the user that is the participant for the event. This may be different than the acting user for certain event types. For example, for a DELEGATION event, this is the user who was delegated to | [optional] -**participantId** | **String** | The unique identifier of the participant for the event. This may be different than the acting user for certain event types. For example, for a DELEGATION event, this is the user who was delegated to | [optional] -**participantRole** | [**ParticipantRoleEnum**](#ParticipantRoleEnum) | Role assumed by all participants in the participant set the participant belongs to (signer, approver etc.). | [optional] -**synchronizationId** | **String** | A unique identifier linking offline events to synchronization events (specified for offline signing events and synchronization events, else null) | [optional] **type** | [**TypeEnum**](#TypeEnum) | Type of MegaSign event | [optional] +**participantRole** | [**ParticipantRoleEnum**](#ParticipantRoleEnum) | Role assumed by all participants in the participant set the participant belongs to (signer, approver etc.). | [optional] **vaultEventId** | **String** | The identifier assigned by the vault provider for the vault event (if vaulted, otherwise null) | [optional] -**vaultProviderName** | **String** | Name of the vault provider for the vault event (if vaulted, otherwise null) | [optional] +**participantId** | **String** | The unique identifier of the participant for the event. This may be different than the acting user for certain event types. For example, for a DELEGATION event, this is the user who was delegated to | [optional] **versionId** | **String** | An ID which uniquely identifies the version of the document associated with this audit event | [optional] +**actingUserEmail** | **String** | Email address of the user that created the event | [optional] +**devicePhoneNumber** | **String** | Phone number from the device used when the participation is completed on a mobile phone | [optional] +**initiatingUserEmail** | **String** | Email address of the user that initiated the event on behalf of the acting user when the account is shared. Will be empty if there is no account sharing in effect | [optional] +**digitalSignatureInfo** | [**DigitalSignatureInfo**](DigitalSignatureInfo.md) | This is present for ESIGNED events when the participation is signed digitally | [optional] +**vaultProviderName** | **String** | Name of the vault provider for the vault event (if vaulted, otherwise null) | [optional] +**comment** | **String** | The event comment. For RECALLED or REJECTED, the reason given by the user that initiates the event. For DELEGATE or SHARE, the message from the acting user to the participant | [optional] +**id** | **String** | The identifier for the event. | [optional] +**synchronizationId** | **String** | A unique identifier linking offline events to synchronization events (specified for offline signing events and synchronization events, else null) | [optional] +**deviceLocation** | [**DeviceLocation**](DeviceLocation.md) | Location of the device that generated the event (This value may be null due to limited privileges) | [optional] + + + +## Enum: TypeEnum +Name | Value +---- | ----- +AUTO_CANCELLED_CONVERSION_PROBLEM | "AUTO_CANCELLED_CONVERSION_PROBLEM" +CREATED | "CREATED" +EXPIRED | "EXPIRED" +EMAIL_BOUNCED | "EMAIL_BOUNCED" +RECALLED | "RECALLED" +SHARED | "SHARED" +READY_TO_VAULT | "READY_TO_VAULT" +VAULTED | "VAULTED" @@ -43,17 +58,4 @@ SHARE | "SHARE" SENDER | "SENDER" - -## Enum: TypeEnum -Name | Value ----- | ----- -AUTO_CANCELLED_CONVERSION_PROBLEM | "AUTO_CANCELLED_CONVERSION_PROBLEM" -CREATED | "CREATED" -EXPIRED | "EXPIRED" -EMAIL_BOUNCED | "EMAIL_BOUNCED" -RECALLED | "RECALLED" -SHARED | "SHARED" -VAULTED | "VAULTED" - - diff --git a/docs/MembersInfo.md b/docs/MembersInfo.md index dddb081..27a587f 100755 --- a/docs/MembersInfo.md +++ b/docs/MembersInfo.md @@ -4,9 +4,9 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- +**participantSets** | [**List<DetailedParticipantSetInfo>**](DetailedParticipantSetInfo.md) | Information about the participant Sets. | [optional] **ccsInfo** | [**List<CCParticipantInfo>**](CCParticipantInfo.md) | Information of CC participants of the agreement. | [optional] **nextParticipantSets** | [**List<DetailedParticipantSetInfo>**](DetailedParticipantSetInfo.md) | Information of next participant sets. | [optional] -**participantSets** | [**List<DetailedParticipantSetInfo>**](DetailedParticipantSetInfo.md) | Information about the participant Sets. | [optional] **senderInfo** | [**SenderInfo**](SenderInfo.md) | Information of the sender of the agreement. | [optional] **sharesInfo** | [**List<ShareParticipantInfo>**](ShareParticipantInfo.md) | Information of the participants with whom the agreement has been shared. | [optional] diff --git a/docs/MergeFieldInfoDescription.md b/docs/MergeFieldInfoDescription.md new file mode 100644 index 0000000..7812d29 --- /dev/null +++ b/docs/MergeFieldInfoDescription.md @@ -0,0 +1,15 @@ + +# MergeFieldInfoDescription + +## Properties +Name | Type | Description | Notes +------------ | ------------- | ------------- | ------------- +**fieldName** | **String** | Name of the custom field in this workflow | [optional] +**visible** | **Boolean** | Whether current field should be visible on agreement creation page. If visible attribute for this field is false then this field should not be shown on the agreement creation page using this workflow | [optional] +**defaultValue** | **String** | default value of the field if input for this field is not provided and this field is required | [optional] +**displayName** | **String** | The display text that can be shown for this custom field | [optional] +**editable** | **Boolean** | Whether current field can be edited. If editable attribute for this field is false then this field should not be provided in the agreement creation request and default value of this field will be used in agreement creation | [optional] +**required** | **Boolean** | Whether this field is required or optional | [optional] + + + diff --git a/docs/MergefieldInfo.md b/docs/MergefieldInfo.md index 4734589..c3a11c5 100755 --- a/docs/MergefieldInfo.md +++ b/docs/MergefieldInfo.md @@ -4,8 +4,8 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**defaultValue** | **String** | The default value of the field | [optional] **fieldName** | **String** | The name of the field | [optional] +**defaultValue** | **String** | The default value of the field | [optional] diff --git a/docs/MessageTemplate.md b/docs/MessageTemplate.md new file mode 100644 index 0000000..5b1cb54 --- /dev/null +++ b/docs/MessageTemplate.md @@ -0,0 +1,13 @@ + +# MessageTemplate + +## Properties +Name | Type | Description | Notes +------------ | ------------- | ------------- | ------------- +**name** | **String** | Message template name | [optional] +**messageTemplateId** | **String** | Unique identifier of the message template | [optional] +**text** | **String** | Message template text | [optional] +**locale** | **String** | Message template locale | [optional] + + + diff --git a/docs/MessageTemplates.md b/docs/MessageTemplates.md new file mode 100644 index 0000000..334d119 --- /dev/null +++ b/docs/MessageTemplates.md @@ -0,0 +1,11 @@ + +# MessageTemplates + +## Properties +Name | Type | Description | Notes +------------ | ------------- | ------------- | ------------- +**messageTemplateList** | [**List<MessageTemplate>**](MessageTemplate.md) | An array of message template items | [optional] +**page** | [**PageInfo**](PageInfo.md) | Pagination information for navigating through the response | [optional] + + + diff --git a/docs/MessageTemplatesApi.md b/docs/MessageTemplatesApi.md new file mode 100644 index 0000000..7efd5f5 --- /dev/null +++ b/docs/MessageTemplatesApi.md @@ -0,0 +1,64 @@ +# MessageTemplatesApi + +All URIs are relative to *https://secure.au1.echosign.com/api/rest/v6* + +Method | HTTP request | Description +------------- | ------------- | ------------- +[**getMessageTemplates**](MessageTemplatesApi.md#getMessageTemplates) | **GET** /messageTemplates | Retrieves a list of message templates applicable to the current user. + + + +# **getMessageTemplates** +> MessageTemplates getMessageTemplates(authorization, locale, xApiUser, xOnBehalfOfUser, groupId, cursor, pageSize) + +Retrieves a list of message templates applicable to the current user. + +### Example +```java +// Import classes: +//import io.swagger.client.model.ApiException; +//import io.swagger.client.api.MessageTemplatesApi; + + +MessageTemplatesApi apiInstance = new MessageTemplatesApi(); +String authorization = "authorization_example"; // String | An OAuth Access Token with scopes:in the format 'Bearer {accessToken}'. +String locale = "locale_example"; // String | Message template locale +String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. +String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or email in the format userid:{userId} OR email:{email}. of the user that has shared his/her account +String groupId = "groupId_example"; // String | The group identifier, as returned by the group creation API or retrieved from the API to fetch groups. +String cursor = "cursor_example"; // String | Used to navigate through the pages. If not provided, returns the first page. +Integer pageSize = 56; // Integer | Number of intended items in the response page. If not provided, it is decided by the application settings. +try { + MessageTemplates result = apiInstance.getMessageTemplates(authorization, locale, xApiUser, xOnBehalfOfUser, groupId, cursor, pageSize); + System.out.println(result); +} catch (ApiException e) { + System.err.println("Exception when calling MessageTemplatesApi#getMessageTemplates"); + e.printStackTrace(); +} +``` + +### Parameters + +Name | Type | Description | Notes +------------- | ------------- | ------------- | ------------- + **authorization** | **String**| An <a href=\"#\" onclick=\"this.href=oauthDoc()\" oncontextmenu=\"this.href=oauthDoc()\" target=\"oauthDoc\">OAuth Access Token</a> with scopes:<ul><li style='list-style-type: square'><a href=\"#\" onclick=\"this.href=oauthDoc('user_read')\" oncontextmenu=\"this.href=oauthDoc('user_read')\" target=\"oauthDoc\">user_read</a></li></ul>in the format <b>'Bearer {accessToken}'. | + **locale** | **String**| Message template locale | + **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] + **xOnBehalfOfUser** | **String**| The userId or email in the format <b>userid:{userId} OR email:{email}.</b> of the user that has shared his/her account | [optional] + **groupId** | **String**| The group identifier, as returned by the group creation API or retrieved from the API to fetch groups. | [optional] + **cursor** | **String**| Used to navigate through the pages. If not provided, returns the first page. | [optional] + **pageSize** | **Integer**| Number of intended items in the response page. If not provided, it is decided by the application settings. | [optional] + +### Return type + +[**MessageTemplates**](MessageTemplates.md) + +### Authorization + +No authorization required + +### HTTP request headers + + - **Content-Type**: Not defined + - **Accept**: application/json + diff --git a/docs/MyAgreementInfo.md b/docs/MyAgreementInfo.md new file mode 100644 index 0000000..56ef000 --- /dev/null +++ b/docs/MyAgreementInfo.md @@ -0,0 +1,10 @@ + +# MyAgreementInfo + +## Properties +Name | Type | Description | Notes +------------ | ------------- | ------------- | ------------- +**accountSharers** | [**List<AccountSharerInfo>**](AccountSharerInfo.md) | A list of account sharer in relation to the api caller and this resource. | [optional] + + + diff --git a/docs/OfflineDeviceInfo.md b/docs/OfflineDeviceInfo.md index 0c78ac7..4bb9b29 100755 --- a/docs/OfflineDeviceInfo.md +++ b/docs/OfflineDeviceInfo.md @@ -4,8 +4,8 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**applicationDescription** | **String** | Application Description | [optional] **deviceDescription** | **String** | Device Description | [optional] +**applicationDescription** | **String** | Application Description | [optional] **deviceTime** | [**Date**](Date.md) | The device local time. The device time provided should not be before 30 days of current date.Format should be yyyy-MM-dd'T'HH:mm:ssZ. For example, e.g 2016-02-25T18:46:19Z represents UTC time | [optional] diff --git a/docs/ParticipantSecurityOption.md b/docs/ParticipantSecurityOption.md index 2475e11..24229db 100755 --- a/docs/ParticipantSecurityOption.md +++ b/docs/ParticipantSecurityOption.md @@ -4,8 +4,8 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**authenticationMethod** | [**AuthenticationMethodEnum**](#AuthenticationMethodEnum) | The authentication method for the participants to have access to view and sign the document. When replacing a participant that has PASSWORD or PHONE authentication specified, you must supply a password or phone number for the new participant, and you cannot change the authentication method | [optional] **password** | **String** | The password required for the participant to view and sign the document. Note that AdobeSign will never show this password to anyone, so you will need to separately communicate it to any relevant parties. The password will not be returned in GET call. When replacing a participant that has PASSWORD authentication specified, you must supply a password for the new participant. | [optional] +**authenticationMethod** | [**AuthenticationMethodEnum**](#AuthenticationMethodEnum) | The authentication method for the participants to have access to view and sign the document. When replacing a participant that has PASSWORD or PHONE authentication specified, you must supply a password or phone number for the new participant, and you cannot change the authentication method. For unknown participants, only email based authentication is allowed. Hence, only ‘NONE’ authenticaiton method is permitted | [optional] **phoneInfo** | [**PhoneInfo**](PhoneInfo.md) | The phoneInfo required for the participant to view and sign the document | [optional] diff --git a/docs/ParticipantSetInfo.md b/docs/ParticipantSetInfo.md index 85d9d6f..5fad6b5 100755 --- a/docs/ParticipantSetInfo.md +++ b/docs/ParticipantSetInfo.md @@ -4,13 +4,14 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- +**role** | [**RoleEnum**](#RoleEnum) | Role assumed by all participants in the set (signer, approver etc.) | [optional] +**visiblePages** | **List<String>** | When you enable limited document visibility (documentVisibilityEnabled), you can specify which file (fileInfo) should be made visible to which specific participant set.<br>Specify one or more label values of a fileInfos element.<br>Each signer participant sets must contain at least one required signature field in at least one visible file included in this API call; if not a page with a signature field is automatically appended for any missing participant sets. If there is a possibility that one or more participant sets do not have a required signature field in the files included in the API call, all signer participant sets should include a special index value of '0' to make this automatically appended signature page visible to the signer. Not doing so may result in an error. For all other roles, you may omit this value to exclude this page. | [optional] +**name** | **String** | Name of the participant set (it can be empty, but if present it must be unique within a single agreement). Maximum no of characters in participant set name is restricted to 255 | [optional] +**id** | **String** | The unique identifier of the participant. This will be ignored as part of POST or PUT calls. The Id might be null in draft state | [optional] **label** | **String** | The unique label of a participant set.<br>For custom workflows, label specified in the participation set should map it to the participation step in the custom workflow. | [optional] +**privateMessage** | **String** | Participant set's private message - all participants in the set will receive the same message | [optional] **memberInfos** | [**List<ParticipantSetMemberInfo>**](ParticipantSetMemberInfo.md) | Array of ParticipantInfo objects, containing participant-specific data (e.g. email). All participants in the array belong to the same set | [optional] -**name** | **String** | Name of the participant set (it can be empty, but needs not to be unique in a single agreement). Maximum no of characters in participant set name is restricted to 255 | [optional] **order** | **Integer** | Index indicating position at which signing group needs to sign. Signing group to sign at first place is assigned a 1 index. Different signingOrder specified in input should form a valid consecutive increasing sequence of integers. Otherwise signingOrder will be considered invalid. No signingOrder should be specified for SHARE role | [optional] -**privateMessage** | **String** | Participant set's private message - all participants in the set will receive the same message | [optional] -**role** | [**RoleEnum**](#RoleEnum) | Role assumed by all participants in the set (signer, approver etc.) | [optional] -**visiblePages** | **List<String>** | When you enable limited document visibility (documentVisibilityEnabled), you can specify which file (fileInfo) should be made visible to which specific participant set.<br>Specify one or more label values of a fileInfos element.<br>Each signer participant sets must contain at least one required signature field in at least one visible file included in this API call; if not a page with a signature field is automatically appended for any missing participant sets. If there is a possibility that one or more participant sets do not have a required signature field in the files included in the API call, all signer participant sets should include a special index value of '0' to make this automatically appended signature page visible to the signer. Not doing so may result in an error. For all other roles, you may omit this value to exclude this page. | [optional] diff --git a/docs/ParticipantSetMemberInfo.md b/docs/ParticipantSetMemberInfo.md index 9767e83..c63d063 100755 --- a/docs/ParticipantSetMemberInfo.md +++ b/docs/ParticipantSetMemberInfo.md @@ -4,7 +4,8 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**email** | **String** | Email of the participant | [optional] +**id** | **String** | The unique identifier of the participant. This will be ignored as part of POST or PUT calls. The Id might be null in draft state | [optional] +**email** | **String** | Email of the participant. It should be blank for the unknown participants. | [optional] **securityOption** | [**ParticipantSecurityOption**](ParticipantSecurityOption.md) | Security options that apply to the participant | [optional] diff --git a/docs/PasswordFieldInfoDescription.md b/docs/PasswordFieldInfoDescription.md new file mode 100644 index 0000000..03c5ffe --- /dev/null +++ b/docs/PasswordFieldInfoDescription.md @@ -0,0 +1,15 @@ + +# PasswordFieldInfoDescription + +## Properties +Name | Type | Description | Notes +------------ | ------------- | ------------- | ------------- +**visible** | **Boolean** | Whether password info field is visible on agreement creation page | [optional] +**defaultValue** | **String** | Default value of the password info field | [optional] +**editable** | **Boolean** | Default value of the password info field | [optional] +**name** | **String** | Name of password field | [optional] +**label** | **String** | Label of password field | [optional] +**required** | **Boolean** | Whether this field is required or optional | [optional] + + + diff --git a/docs/PersonalizedSigningViewConfiguration.md b/docs/PersonalizedSigningViewConfiguration.md new file mode 100644 index 0000000..15f9694 --- /dev/null +++ b/docs/PersonalizedSigningViewConfiguration.md @@ -0,0 +1,13 @@ + +# PersonalizedSigningViewConfiguration + +## Properties +Name | Type | Description | Notes +------------ | ------------- | ------------- | ------------- +**comment** | **String** | Comment describing how the API caller established the signer's identity - will appear in the audit trail | [optional] +**expiration** | [**Date**](Date.md) | Expiration date for the personalization of this web form. After this date, the identity of the signer will not be assumed by Adobe Sign. Format should be yyyy-MM-dd'T'HH:mm:ssZ. For example, e.g 2022-02-25T18:46:19Z represents UTC time | [optional] +**email** | **String** | The email address of the person who will be receiving this web form | [optional] +**reusable** | **Boolean** | Should the intended signer be allowed to sign this web form more than once | [optional] + + + diff --git a/docs/PhoneInfo.md b/docs/PhoneInfo.md index 33ba91b..5387a7d 100755 --- a/docs/PhoneInfo.md +++ b/docs/PhoneInfo.md @@ -4,8 +4,9 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**countryCode** | **String** | The numeric country calling code (ISD code) required for the participant to view and sign the document if authentication type is PHONE | [optional] +**countryIsoCode** | **String** | The country ISO Alpha-2 code required for the participant to view and sign the document if authentication method is PHONE | [optional] **phone** | **String** | The phone number required for the participant to view and sign the document if authentication method is PHONE. When replacing a participant that has PHONE authentication specified, you must supply a phone number for the new participant. | [optional] +**countryCode** | **String** | The numeric country calling code (ISD code) required for the participant to view and sign the document if authentication type is PHONE | [optional] diff --git a/docs/PostSignOption.md b/docs/PostSignOption.md index 368b311..5889df4 100755 --- a/docs/PostSignOption.md +++ b/docs/PostSignOption.md @@ -4,8 +4,8 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**redirectDelay** | **Integer** | The delay (in seconds) before the user is taken to the success page. If this value is greater than 0, the user will first see the standard Adobe Sign success message, and then after a delay will be redirected to your success page | [optional] **redirectUrl** | **String** | A publicly accessible url to which the user will be sent after successfully completing the signing process | [optional] +**redirectDelay** | **Integer** | The delay (in seconds) before the user is taken to the success page. If this value is greater than 0, the user will first see the standard Adobe Sign success message, and then after a delay will be redirected to your success page | [optional] diff --git a/docs/ProviderParticipantSetInfo.md b/docs/ProviderParticipantSetInfo.md new file mode 100644 index 0000000..3d31f04 --- /dev/null +++ b/docs/ProviderParticipantSetInfo.md @@ -0,0 +1,11 @@ + +# ProviderParticipantSetInfo + +## Properties +Name | Type | Description | Notes +------------ | ------------- | ------------- | ------------- +**actionRequired** | **Boolean** | It indicates whether it is mandatory or not for the provider participant to provide the details for the unknown participant | [optional] +**actionDescription** | **String** | The description for the provider participant who is responsible to provide details like name, email for the unknown participant. | [optional] + + + diff --git a/docs/RecipientsListInfoDescription.md b/docs/RecipientsListInfoDescription.md new file mode 100644 index 0000000..44d3195 --- /dev/null +++ b/docs/RecipientsListInfoDescription.md @@ -0,0 +1,29 @@ + +# RecipientsListInfoDescription + +## Properties +Name | Type | Description | Notes +------------ | ------------- | ------------- | ------------- +**allowSender** | **Boolean** | whether sender is allowed as a recipient | [optional] +**minListCount** | **Integer** | minimum number of entries allowed in the current recipient list | [optional] +**visible** | **Boolean** | Whether current field is visible. If visible attribute for this field is false then this field should not be shown in the agreement creation UI using this workflow to user | [optional] +**authenticationMethod** | [**AuthenticationMethodEnum**](#AuthenticationMethodEnum) | authentication method for the current recipient list to have access to view and sign the document | [optional] +**allowfax** | **Boolean** | whether fax is allowed or not | [optional] +**defaultValue** | **String** | A default email or fax number | [optional] +**editable** | **Boolean** | Whether current field can be edited. If editable attribute for this field is false then this field should not be provided in the agreement creation request and default value of this field will be used in agreement creation | [optional] +**name** | **String** | Name of the current RecipientInfo list | [optional] +**maxListCount** | **Integer** | maximum number of entries allowed in the current recipient list | [optional] +**label** | **String** | A display text for the workflow user that can be used for the current recipients list | [optional] + + + +## Enum: AuthenticationMethodEnum +Name | Value +---- | ----- +NONE | "NONE" +KBA | "KBA" +PASSWORD | "PASSWORD" +WEB_IDENTITY | "WEB_IDENTITY" + + + diff --git a/docs/ReminderInfo.md b/docs/ReminderInfo.md index 3e4fae2..3feee28 100755 --- a/docs/ReminderInfo.md +++ b/docs/ReminderInfo.md @@ -4,17 +4,26 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**firstReminderDelay** | **Integer** | Integer which specifies the delay in hours before sending the first reminder.<br>This is an optional field. The minimum value allowed is 1 hour and the maximum value can’t be more than the difference of agreement creation and expiry time of the agreement in hours.<br>If this is not specified but the reminder frequency is specified, then the first reminder will be sent based on frequency.<br>i.e. if the reminder is created with frequency specified as daily, the firstReminderDelay will be 24 hours. Cannot be updated in a PUT | [optional] -**frequency** | [**FrequencyEnum**](#FrequencyEnum) | The frequency at which reminder will be sent until the agreement is completed.<br>If frequency is not provided, the reminder will be sent once (if the agreement is available at the specified time) with the delay based on the firstReminderDelay field and will never repeat again. If the agreement is not available at that time, reminder will not be sent. Cannot be updated in a PUT | [optional] +**note** | **String** | An optional message sent to the recipients, describing why their participation is required | [optional] **lastSentDate** | [**Date**](Date.md) | The date when the reminder was last sent. Only provided in GET. Cannot be provided in POST request. If provided in POST, it will be ignored. Cannot be updated in a PUT. Format would be yyyy-MM-dd'T'HH:mm:ssZ. For example, e.g 2016-02-25T18:46:19Z represents UTC time | [optional] **nextSentDate** | [**Date**](Date.md) | The date when the reminder is scheduled to be sent next. When provided in POST request, frequency needs to be ONCE (or not specified), startReminderCounterFrom needs to be REMINDER_CREATION (or not specified) and firstReminderDelay needs to be 0 (or not specified). Cannot be updated in a PUT. Format would be yyyy-MM-dd'T'HH:mm:ssZ. For example, e.g 2016-02-25T18:46:19Z represents UTC time | [optional] -**note** | **String** | An optional message sent to the recipients, describing why their participation is required | [optional] -**recipientParticipantIds** | **List<String>** | A list of one or more participant IDs that the reminder should be sent to. These must be recipients of the agreement and not sharees or cc's. | [optional] **reminderId** | **String** | An identifier of the reminder resource created on the server. If provided in POST or PUT, it will be ignored | [optional] +**firstReminderDelay** | **Integer** | Integer which specifies the delay in hours before sending the first reminder.<br>This is an optional field. The minimum value allowed is 1 hour and the maximum value can’t be more than the difference of agreement creation and expiry time of the agreement in hours.<br>If this is not specified but the reminder frequency is specified, then the first reminder will be sent based on frequency.<br>i.e. if the reminder is created with frequency specified as daily, the firstReminderDelay will be 24 hours. Cannot be updated in a PUT | [optional] +**recipientParticipantIds** | **List<String>** | A list of one or more participant IDs that the reminder should be sent to. These must be sharees or cc's on the MegaSign. In order to remind any other participant who has not signed, use the allUnsigned boolean parameter. | [optional] **startReminderCounterFrom** | [**StartReminderCounterFromEnum**](#StartReminderCounterFromEnum) | Reminder can be sent based on when the agreement becomes available or when the reminder is created<br>AGREEMENT_AVAILABILITY: If the agreement is not available to the participant at the time of reminder creation, the reminder will be sent for the first time, only when the agreement becomes available to the participant taking the firstReminderDelay into account. Subsequent reminders will be sent based on the frequency specified. If the agreement is already available to the participant at the time of reminder creation, the first reminder will be sent after the delay specified by firstReminderDelay from the reminder creation time.<br>REMINDER_CREATION: The first reminder will be sent after the delay specified by firstReminderDelay from the reminder creation time only if the agreement is available at that time. Subsequent reminders will be triggered based on the frequency specified and will be sent only if the agreement is available at that time. For agreements in authoring state, creating reminder with startReminderCounterFrom as REMINDER_CREATION is not allowed.<br>Note : If firstReminderDelay, frequency and startReminderCounterFrom fields are not specified in POST, reminder will be sent right now if the agreement is available. If agreement is not available, an error will be thrown. Cannot be updated in a PUT | [optional] +**allUnsigned** | **Boolean** | If true, set a reminder on all participants (non-CCs and non-sharees) that still need to sign the MegaSign agreement | [optional] +**frequency** | [**FrequencyEnum**](#FrequencyEnum) | The frequency at which reminder will be sent until the agreement is completed.<br>If frequency is not provided, the reminder will be sent once (if the agreement is available at the specified time) with the delay based on the firstReminderDelay field and will never repeat again. If the agreement is not available at that time, reminder will not be sent. Cannot be updated in a PUT | [optional] **status** | [**StatusEnum**](#StatusEnum) | Current status of the reminder. The only valid update in a PUT is from ACTIVE to CANCELED. Must be provided as ACTIVE in a POST. | [optional] + +## Enum: StartReminderCounterFromEnum +Name | Value +---- | ----- +AGREEMENT_AVAILABILITY | "AGREEMENT_AVAILABILITY" +REMINDER_CREATION | "REMINDER_CREATION" + + ## Enum: FrequencyEnum Name | Value @@ -28,14 +37,6 @@ WEEKLY_UNTIL_SIGNED | "WEEKLY_UNTIL_SIGNED" ONCE | "ONCE" - -## Enum: StartReminderCounterFromEnum -Name | Value ----- | ----- -AGREEMENT_AVAILABILITY | "AGREEMENT_AVAILABILITY" -REMINDER_CREATION | "REMINDER_CREATION" - - ## Enum: StatusEnum Name | Value diff --git a/docs/SendOptions.md b/docs/SendOptions.md index 2089dae..6222965 100755 --- a/docs/SendOptions.md +++ b/docs/SendOptions.md @@ -4,13 +4,13 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**completionEmails** | [**CompletionEmailsEnum**](#CompletionEmailsEnum) | Control notification mails for agreement completion events - COMPLETED, CANCELLED, EXPIRED and REJECTED | [optional] -**inFlightEmails** | [**InFlightEmailsEnum**](#InFlightEmailsEnum) | Control notification mails for agreement-in-process events - DELEGATED, REPLACED | [optional] **initEmails** | [**InitEmailsEnum**](#InitEmailsEnum) | Control notification mails for Agreement initiation events - ACTION_REQUESTED and CREATED | [optional] +**inFlightEmails** | [**InFlightEmailsEnum**](#InFlightEmailsEnum) | Control notification mails for agreement-in-process events - DELEGATED, REPLACED | [optional] +**completionEmails** | [**CompletionEmailsEnum**](#CompletionEmailsEnum) | Control notification mails for agreement completion events - COMPLETED, CANCELLED, EXPIRED and REJECTED | [optional] - -## Enum: CompletionEmailsEnum + +## Enum: InitEmailsEnum Name | Value ---- | ----- ALL | "ALL" @@ -25,8 +25,8 @@ ALL | "ALL" NONE | "NONE" - -## Enum: InitEmailsEnum + +## Enum: CompletionEmailsEnum Name | Value ---- | ----- ALL | "ALL" diff --git a/docs/SendViewConfiguration.md b/docs/SendViewConfiguration.md index 9810c0c..f241ec1 100755 --- a/docs/SendViewConfiguration.md +++ b/docs/SendViewConfiguration.md @@ -4,9 +4,9 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**agrName** | **String** | The agreement name for the library document on the compose page | [optional] **fileUploadOptions** | [**FileUploadOptions**](FileUploadOptions.md) | Controls various file upload options available on the compose page | [optional] **isPreviewSelected** | **Boolean** | Should the compose page be provided with authoring mode selected? | [optional] +**agrName** | **String** | The agreement name for the library document on the compose page | [optional] diff --git a/docs/SenderInfo.md b/docs/SenderInfo.md index a044ba0..404b497 100755 --- a/docs/SenderInfo.md +++ b/docs/SenderInfo.md @@ -4,11 +4,14 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**company** | **String** | Company of the creator, if available. | [optional] -**email** | **String** | Email of the creator of the widget. | [optional] +**participantId** | **String** | The unique identifier of the creator of the web form. | [optional] +**createdDate** | [**Date**](Date.md) | The date when the sender was added. This will be returned as part of GET call but is ignored if passed as part of PUT call. | [optional] +**hidden** | **Boolean** | True if the web form is hidden for the user that is calling the API. Only returned if self is true. | [optional] **name** | **String** | Name of the creator, if available. | [optional] -**participantId** | **String** | The unique identifier of the creator of the widget. | [optional] -**self** | **Boolean** | True if the creator of the widget is the same user that is calling the API. | [optional] +**self** | **Boolean** | True if the creator of the web form is the same user that is calling the API. | [optional] +**company** | **String** | Company of the creator, if available. | [optional] +**userId** | **String** | The user ID of the sender. This will be returned as part of GET call but is ignored if passed as part of PUT call. | [optional] +**email** | **String** | Email of the creator of the web form. | [optional] diff --git a/docs/SettingsInfo.md b/docs/SettingsInfo.md new file mode 100644 index 0000000..883f693 --- /dev/null +++ b/docs/SettingsInfo.md @@ -0,0 +1,11 @@ + +# SettingsInfo + +## Properties +Name | Type | Description | Notes +------------ | ------------- | ------------- | ------------- +**libaryDocumentCreationVisible** | [**BooleanSettingInfo**](BooleanSettingInfo.md) | Can user create library documents? | [optional] +**userCanSend** | [**BooleanSettingInfo**](BooleanSettingInfo.md) | Can user send agreements for signature to others? | [optional] + + + diff --git a/docs/ShareCreationInfo.md b/docs/ShareCreationInfo.md index 83c6714..57fc959 100755 --- a/docs/ShareCreationInfo.md +++ b/docs/ShareCreationInfo.md @@ -4,8 +4,8 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**email** | **String** | The email address of the member with whom the agreement will be shared | [optional] **message** | **String** | Optional message to the sharee | [optional] +**email** | **String** | The email address of the member with whom the agreement will be shared | [optional] diff --git a/docs/ShareCreationResponse.md b/docs/ShareCreationResponse.md index f4014a0..73d5d5a 100755 --- a/docs/ShareCreationResponse.md +++ b/docs/ShareCreationResponse.md @@ -4,8 +4,8 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**email** | **String** | The email address that was requested | [optional] **participantId** | **String** | The unique identifier of the participant | [optional] +**email** | **String** | The email address that was requested | [optional] diff --git a/docs/ShareParticipantInfo.md b/docs/ShareParticipantInfo.md index 3f5c605..089b421 100755 --- a/docs/ShareParticipantInfo.md +++ b/docs/ShareParticipantInfo.md @@ -4,11 +4,13 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**company** | **String** | Company of the sharee participant of the widget, if available. | [optional] -**email** | **String** | Email of the sharee participant of the widget. | [optional] -**name** | **String** | Name of the sharee participant of the widget, if available. | [optional] -**participantId** | **String** | The unique identifier of the sharee participant of the widget. | [optional] -**sharerParticipantId** | **String** | The unique identifier of the participant who shared the widget. | [optional] +**participantId** | **String** | The unique identifier of the sharee participant of the web form. | [optional] +**hidden** | **Boolean** | True if the web form is hidden for the user that is calling the API. Only returned if self is true. | [optional] +**name** | **String** | Name of the sharee participant of the web form, if available. | [optional] +**self** | **Boolean** | True if the Share participant of the web form is the same user that is calling the API. | [optional] +**sharerParticipantId** | **String** | The unique identifier of the participant who shared the web form. | [optional] +**company** | **String** | Company of the sharee participant of the web form, if available. | [optional] +**email** | **String** | Email of the sharee participant of the web form. | [optional] diff --git a/docs/SignerIdentityReportInfo.md b/docs/SignerIdentityReportInfo.md new file mode 100644 index 0000000..fcede8f --- /dev/null +++ b/docs/SignerIdentityReportInfo.md @@ -0,0 +1,10 @@ + +# SignerIdentityReportInfo + +## Properties +Name | Type | Description | Notes +------------ | ------------- | ------------- | ------------- +**securityOption** | [**SecurityOption**](SecurityOption.md) | Optional secondary security parameters for the signer identity report. | [optional] + + + diff --git a/docs/SigningUrl.md b/docs/SigningUrl.md index c9100ce..1524dd1 100755 --- a/docs/SigningUrl.md +++ b/docs/SigningUrl.md @@ -4,8 +4,8 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**email** | **String** | The email address of the signer associated with this signing url | [optional] **esignUrl** | **String** | The email address of the signer associated with this signing url | [optional] +**email** | **String** | The email address of the signer associated with this signing url | [optional] diff --git a/docs/SigningUrlSetInfo.md b/docs/SigningUrlSetInfo.md index 03bb95b..1677d8e 100755 --- a/docs/SigningUrlSetInfo.md +++ b/docs/SigningUrlSetInfo.md @@ -4,8 +4,8 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**signingUrlSetName** | **String** | The name of the current signer set. Returned only, if the API caller is the sender of agreement | [optional] **signingUrls** | [**List<SigningUrl>**](SigningUrl.md) | An array of urls for current signer set. | [optional] +**signingUrlSetName** | **String** | The name of the current signer set. Returned only, if the API caller is the sender of agreement | [optional] diff --git a/docs/SupportingDocument.md b/docs/SupportingDocument.md index 882acd6..edc1c91 100755 --- a/docs/SupportingDocument.md +++ b/docs/SupportingDocument.md @@ -5,11 +5,11 @@ Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- **displayLabel** | **String** | Display name of the document | [optional] +**participantId** | **String** | The unique identifier of the participant that uploaded the supporting document | [optional] +**numPages** | **Integer** | Number of pages in the document | [optional] **fieldName** | **String** | The name of the supporting document field | [optional] **id** | **String** | Id representing the document | [optional] **mimeType** | **String** | Mime-type of the document | [optional] -**numPages** | **Integer** | Number of pages in the document | [optional] -**participantId** | **String** | The unique identifier of the participant that uploaded the supporting document | [optional] diff --git a/docs/TransientDocumentResponse.md b/docs/TransientDocumentResponse.md index f45705a..1802169 100755 --- a/docs/TransientDocumentResponse.md +++ b/docs/TransientDocumentResponse.md @@ -4,7 +4,7 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**transientDocumentId** | **String** | The unique identifier of the uploaded document that can be used in an agreement or a megaSign or widget creation call | [optional] +**transientDocumentId** | **String** | The unique identifier of the uploaded document that can be used in an agreement or a megaSign or web form creation call | [optional] diff --git a/docs/TransientDocumentsApi.md b/docs/TransientDocumentsApi.md index bb1ec6b..0f995bf 100755 --- a/docs/TransientDocumentsApi.md +++ b/docs/TransientDocumentsApi.md @@ -1,6 +1,6 @@ # TransientDocumentsApi -All URIs are relative to *http://localhost/api/rest/v6* +All URIs are relative to *https://secure.au1.echosign.com/api/rest/v6* Method | HTTP request | Description ------------- | ------------- | ------------- diff --git a/docs/URLFileInfo.md b/docs/URLFileInfo.md index fcf4f05..8b53f0d 100755 --- a/docs/URLFileInfo.md +++ b/docs/URLFileInfo.md @@ -4,8 +4,8 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**mimeType** | **String** | The mime type of the referenced file, used to determine if the file can be accepted and the necessary conversion steps can be performed | [optional] **name** | **String** | The original system file name of the document being sent | [optional] +**mimeType** | **String** | The mime type of the referenced file, used to determine if the file can be accepted and the necessary conversion steps can be performed | [optional] **url** | **String** | A publicly accessible URL for retrieving the raw file content | [optional] diff --git a/docs/UserAgreement.md b/docs/UserAgreement.md index 392f27e..9789bd7 100755 --- a/docs/UserAgreement.md +++ b/docs/UserAgreement.md @@ -4,16 +4,28 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- +**hidden** | **Boolean** | True if agreement is hidden for the user | [optional] **displayDate** | [**Date**](Date.md) | The display date for the agreement. Format would be yyyy-MM-dd'T'HH:mm:ssZ. For example, e.g 2016-02-25T18:46:19Z represents UTC time | [optional] -**displayParticipantSetInfos** | [**List<DisplayParticipantSetInfo>**](DisplayParticipantSetInfo.md) | The most relevant current user set for the agreement. It is typically the next signer if the agreement is from the current user, or the sender if received from another user | [optional] -**id** | **String** | The unique identifier of the agreement.If provided in POST, it will simply be ignored | [optional] +**groupId** | **String** | Unique identifier of the group | [optional] **esign** | **Boolean** | True if this is an e-sign document | [optional] -**hidden** | **Boolean** | True if agreement is hidden for the user | [optional] -**latestVersionId** | **String** | A version ID which uniquely identifies the current version of the agreement | [optional] **name** | **String** | Name of the Agreement | [optional] +**displayParticipantSetInfos** | [**List<DisplayParticipantSetInfo>**](DisplayParticipantSetInfo.md) | The most relevant current user set for the agreement. It is typically the next signer if the agreement is from the current user, or the sender if received from another user | [optional] +**latestVersionId** | **String** | A version ID which uniquely identifies the current version of the agreement | [optional] +**id** | **String** | The unique identifier of the agreement.If provided in POST, it will simply be ignored | [optional] +**type** | [**TypeEnum**](#TypeEnum) | The kind of agreement | [optional] +**parentId** | **String** | The parent id of a megaSign child *OR* the originating id of a widget agreement instance | [optional] **status** | [**StatusEnum**](#StatusEnum) | This is a server generated attribute which provides the detailed status of an agreement with respect to the apiCaller | [optional] + +## Enum: TypeEnum +Name | Value +---- | ----- +AGREEMENT | "AGREEMENT" +MEGASIGN_CHILD | "MEGASIGN_CHILD" +WIDGET_INSTANCE | "WIDGET_INSTANCE" + + ## Enum: StatusEnum Name | Value diff --git a/docs/UserAgreements.md b/docs/UserAgreements.md index b8e1ac6..c386886 100755 --- a/docs/UserAgreements.md +++ b/docs/UserAgreements.md @@ -4,8 +4,8 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**page** | [**PageInfo**](PageInfo.md) | Pagination information for navigating through the response | [optional] **userAgreementList** | [**List<UserAgreement>**](UserAgreement.md) | An array of UserAgreement items | [optional] +**page** | [**PageInfo**](PageInfo.md) | Pagination information for navigating through the response | [optional] diff --git a/docs/UserGroupInfo.md b/docs/UserGroupInfo.md index aa9cad8..33ef324 100755 --- a/docs/UserGroupInfo.md +++ b/docs/UserGroupInfo.md @@ -4,9 +4,21 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**id** | **String** | Unique identifier of the group | [optional] +**settings** | [**SettingsInfo**](SettingsInfo.md) | List of some group membership settings. | [optional] +**createdDate** | [**Date**](Date.md) | Date group was created | [optional] **isGroupAdmin** | **Boolean** | True if user is group admin. | [optional] +**isPrimaryGroup** | **Boolean** | True if the group is the user's primary group. | [optional] **name** | **String** | Name of the group. This will be ignored as part of PUT call. | [optional] +**id** | **String** | Unique identifier of the group | [optional] +**status** | [**StatusEnum**](#StatusEnum) | Status of the group membership | [optional] + + + +## Enum: StatusEnum +Name | Value +---- | ----- +ACTIVE | "ACTIVE" +DELETED | "DELETED" diff --git a/docs/UserInfo.md b/docs/UserInfo.md index 5c179b1..c6c80f6 100755 --- a/docs/UserInfo.md +++ b/docs/UserInfo.md @@ -4,12 +4,13 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**company** | **String** | The name of company of the user | [optional] -**email** | **String** | The email address of the user | [optional] +**accountId** | **String** | The account id of the user | [optional] **firstName** | **String** | The first name of the user | [optional] -**id** | **String** | A unique identifier of the user resource for REST APIs as issued by Sign. | [optional] -**isAccountAdmin** | **Boolean** | True if user is account admin | [optional] **lastName** | **String** | The last name of the user | [optional] +**isAccountAdmin** | **Boolean** | True if user is account admin | [optional] +**company** | **String** | The name of company of the user | [optional] +**id** | **String** | A unique identifier of the user resource for REST APIs as issued by Sign. | [optional] +**email** | **String** | The email address of the user | [optional] diff --git a/docs/UserStatusUpdateResponse.md b/docs/UserStatusUpdateResponse.md index 87efeae..d274aab 100755 --- a/docs/UserStatusUpdateResponse.md +++ b/docs/UserStatusUpdateResponse.md @@ -5,8 +5,8 @@ Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- **code** | [**CodeEnum**](#CodeEnum) | The result of the attempt to activate or deactivate the user | [optional] -**message** | **String** | String result message if there was no error | [optional] **state** | [**StateEnum**](#StateEnum) | A status value showing the result of this operation | [optional] +**message** | **String** | String result message if there was no error | [optional] diff --git a/docs/UserView.md b/docs/UserView.md index 4b3c8bf..9cc7f98 100755 --- a/docs/UserView.md +++ b/docs/UserView.md @@ -5,8 +5,8 @@ Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- **embeddedCode** | **String** | Embedded code of url of resource | [optional] -**expiration** | [**Date**](Date.md) | Expiration of user url | [optional] **name** | [**NameEnum**](#NameEnum) | Name of the requested user view | [optional] +**expiration** | [**Date**](Date.md) | Expiration of user url | [optional] **url** | **String** | Url of resource location | [optional] diff --git a/docs/UserWebhook.md b/docs/UserWebhook.md index ffdd680..713cdd0 100755 --- a/docs/UserWebhook.md +++ b/docs/UserWebhook.md @@ -4,45 +4,17 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**applicationDisplayName** | **String** | The display name of the application through which webhook is created | [optional] -**applicationName** | **String** | The name of the application through which webhook is created | [optional] +**resourceId** | **String** | Id of the resource type for which you want to create webhook. Provide agreementId if webhook needs to be created for an agreement. Similarly, widgetId if webhook needs to be created for a web form, megaSignId if webhook needs to be created for a megaSign and libraryDocumentId if webhook needs to be created for a library document. Need to specify only if scope is 'RESOURCE'. Can't be modified in PUT request | [optional] +**webhookUrlInfo** | [**WebhookUrlInfo**](WebhookUrlInfo.md) | Info of webhook url | [optional] +**webhookSubscriptionEvents** | [**List<WebhookSubscriptionEventsEnum>**](#List<WebhookSubscriptionEventsEnum>) | Determines events for which the webhook is triggered. The possible values are <br> AGREEMENT_CREATED : When an agreement is created <br>, AGREEMENT_ACTION_DELEGATED : When an agreement is delegated <br>, AGREEMENT_RECALLED : When an agreement is recalled <br>, AGREEMENT_REJECTED : When an agreement is rejected <br>, AGREEMENT_EXPIRED : When an agreement expires <br>, AGREEMENT_ACTION_COMPLETED : When an agreement action is completed <br>, AGREEMENT_WORKFLOW_COMPLETED : When an agreement workflow is completed <br>, AGREEMENT_EMAIL_VIEWED : When an agreement's email is viewed <br>, AGREEMENT_MODIFIED : When an agreement is modified <br>, AGREEMENT_SHARED : When an agreement is shared <br>, AGREEMENT_READY_TO_VAULT : When an agreement is ready to vault <br>, AGREEMENT_VAULTED : When an agreement is vaulted <br>, AGREEMENT_ACTION_REQUESTED : When an agreement action is requested <br>, AGREEMENT_ACTION_REPLACED_SIGNER : When signer is replaced for an agreement <br>, AGREEMENT_AUTO_CANCELLED_CONVERSION_PROBLEM : When an agreement is auto-cancelled due to conversion problem <br>, AGREEMENT_DOCUMENTS_DELETED : When an agreement documents are deleted <br>, AGREEMENT_EMAIL_BOUNCED : When an agreement email gets bounced <br>, AGREEMENT_KBA_AUTHENTICATED : When an agreement KBA is authenticated <br>, AGREEMENT_OFFLINE_SYNC : When an agreement is synced offline <br>, AGREEMENT_USER_ACK_AGREEMENT_MODIFIED : User Acknowledgement when an agreement is modified <br>, AGREEMENT_UPLOADED_BY_SENDER : When an agreement is uploaded by sender <br>, AGREEMENT_WEB_IDENTITY_AUTHENTICATED : When an agreement web identity is authenticated <br>, AGREEMENT_ALL : All the supported agreement events for Webhooks <br>, MEGASIGN_CREATED : When a megaSign is created <br>, MEGASIGN_RECALLED : When a megaSign is recalled <br>, MEGASIGN_SHARED : When a megaSign is shared <br>, MEGASIGN_ALL : All the supported megaSign events for Webhooks <br>, WIDGET_CREATED : When a web form is created <br>, WIDGET_MODIFIED : When a web form is modified <br>, WIDGET_SHARED : When a web form is shared <br>, WIDGET_ENABLED : When a web form is enabled <br>, WIDGET_DISABLED : When a web form is disabled <br>, WIDGET_AUTO_CANCELLED_CONVERSION_PROBLEM : When a web form is auto-cancelled due to conversion problem <br>, WIDGET_ALL : All the supported web form events for Webhooks <br>, LIBRARY_DOCUMENT_CREATED : When a library document is created <br>, LIBRARY_DOCUMENT_AUTO_CANCELLED_CONVERSION_PROBLEM : When a library document is auto-cancelled due to conversion problem <br>, LIBRARY_DOCUMENT_MODIFIED : When a library document is modified <br>, LIBRARY_DOCUMENT_ALL : All the supported library document events for Webhooks | [optional] +**scope** | [**ScopeEnum**](#ScopeEnum) | Scope of webhook. Can't be modified in PUT request. The possible values are ACCOUNT, GROUP, USER or RESOURCE | [optional] +**name** | **String** | The name of the webhook | [optional] **id** | **String** | The unique identifier of the webhook. Will only be returned in GET request. Can't be modified in PUT request | [optional] **lastModified** | [**Date**](Date.md) | Timestamp when the webhook was last updated. Will only be returned in GET request. Can't be modified in PUT request | [optional] -**name** | **String** | The name of the webhook | [optional] -**resourceId** | **String** | Id of the resource type for which you want to create webhook. Provide agreementId if webhook needs to be created for an agreement. Similarly, widgetId if webhook needs to be created for a widget, megaSignId if webhook needs to be created for a megaSign and libraryDocumentId if webhook needs to be created for a library document. Need to specify only if scope is 'RESOURCE'. Can't be modified in PUT request | [optional] +**applicationDisplayName** | **String** | The display name of the application through which webhook is created | [optional] +**applicationName** | **String** | The name of the application through which webhook is created | [optional] **resourceType** | [**ResourceTypeEnum**](#ResourceTypeEnum) | The resource for which you want to create webhook. Need to specify only if scope is 'RESOURCE'. Can't be modified in PUT request. The possible values are AGREEMENT, WIDGET, MEGASIGN AND LIBRARY_DOCUMENT | [optional] -**scope** | [**ScopeEnum**](#ScopeEnum) | Scope of webhook. Can't be modified in PUT request. The possible values are ACCOUNT, GROUP, USER or RESOURCE | [optional] **status** | [**StatusEnum**](#StatusEnum) | Status of the webhook. Determines whether the webhook will be actually triggered. Default: ACTIVE, if ACTIVE, this webhook will receive event requests. If INACTIVE, this webhook will not receive event requests. Can't provide status in POST/PUT requests. | [optional] -**webhookSubscriptionEvents** | [**List<WebhookSubscriptionEventsEnum>**](#List<WebhookSubscriptionEventsEnum>) | Determines events for which the webhook is triggered. The possible values are <br> AGREEMENT_CREATED : When an agreement is created <br>, AGREEMENT_ACTION_DELEGATED : When an agreement is delegated <br>, AGREEMENT_RECALLED : When an agreement is recalled <br>, AGREEMENT_REJECTED : When an agreement is rejected <br>, AGREEMENT_EXPIRED : When an agreement expires <br>, AGREEMENT_ACTION_COMPLETED : When an agreement action is completed <br>, AGREEMENT_WORKFLOW_COMPLETED : When an agreement workflow is completed <br>, AGREEMENT_EMAIL_VIEWED : When an agreement's email is viewed <br>, AGREEMENT_MODIFIED : When an agreement is modified <br>, AGREEMENT_SHARED : When an agreement is shared <br>, AGREEMENT_VAULTED : When an agreement is vaulted <br>, AGREEMENT_ACTION_REQUESTED : When an agreement action is requested <br>, AGREEMENT_ACTION_REPLACED_SIGNER : When signer is replaced for an agreement <br>, AGREEMENT_AUTO_CANCELLED_CONVERSION_PROBLEM : When an agreement is auto-cancelled due to conversion problem <br>, AGREEMENT_DOCUMENTS_DELETED : When an agreement documents are deleted <br>, AGREEMENT_EMAIL_BOUNCED : When an agreement email gets bounced <br>, AGREEMENT_KBA_AUTHENTICATED : When an agreement KBA is authenticated <br>, AGREEMENT_OFFLINE_SYNC : When an agreement is synced offline <br>, AGREEMENT_USER_ACK_AGREEMENT_MODIFIED : User Acknowledgement when an agreement is modified <br>, AGREEMENT_UPLOADED_BY_SENDER : When an agreement is uploaded by sender <br>, AGREEMENT_WEB_IDENTITY_AUTHENTICATED : When an agreement web identity is authenticated <br>, AGREEMENT_ALL : All the supported agreement events for Webhooks <br>, MEGASIGN_CREATED : When a megaSign is created <br>, MEGASIGN_RECALLED : When a megaSign is recalled <br>, MEGASIGN_SHARED : When a megaSign is shared <br>, MEGASIGN_ALL : All the supported megaSign events for Webhooks <br>, WIDGET_CREATED : When a widget is created <br>, WIDGET_MODIFIED : When a widget is modified <br>, WIDGET_SHARED : When a widget is shared <br>, WIDGET_ENABLED : When a widget is enabled <br>, WIDGET_DISABLED : When a widget is disabled <br>, WIDGET_AUTO_CANCELLED_CONVERSION_PROBLEM : When a widget is auto-cancelled due to conversion problem <br>, WIDGET_ALL : All the supported widget events for Webhooks <br>, LIBRARY_DOCUMENT_CREATED : When a library document is created <br>, LIBRARY_DOCUMENT_AUTO_CANCELLED_CONVERSION_PROBLEM : When a library document is auto-cancelled due to conversion problem <br>, LIBRARY_DOCUMENT_MODIFIED : When a library document is modified <br>, LIBRARY_DOCUMENT_ALL : All the supported library document events for Webhooks | [optional] -**webhookUrlInfo** | [**WebhookUrlInfo**](WebhookUrlInfo.md) | Info of webhook url | [optional] - - - -## Enum: ResourceTypeEnum -Name | Value ----- | ----- -AGREEMENT | "AGREEMENT" -WIDGET | "WIDGET" -MEGASIGN | "MEGASIGN" -LIBRARY_DOCUMENT | "LIBRARY_DOCUMENT" - - - -## Enum: ScopeEnum -Name | Value ----- | ----- -ACCOUNT | "ACCOUNT" -GROUP | "GROUP" -USER | "USER" -RESOURCE | "RESOURCE" - - - -## Enum: StatusEnum -Name | Value ----- | ----- -ACTIVE | "ACTIVE" -INACTIVE | "INACTIVE" @@ -59,6 +31,7 @@ AGREEMENT_WORKFLOW_COMPLETED | "AGREEMENT_WORKFLOW_COMPLETED" AGREEMENT_EMAIL_VIEWED | "AGREEMENT_EMAIL_VIEWED" AGREEMENT_MODIFIED | "AGREEMENT_MODIFIED" AGREEMENT_SHARED | "AGREEMENT_SHARED" +AGREEMENT_READY_TO_VAULT | "AGREEMENT_READY_TO_VAULT" AGREEMENT_VAULTED | "AGREEMENT_VAULTED" AGREEMENT_ACTION_REQUESTED | "AGREEMENT_ACTION_REQUESTED" AGREEMENT_ACTION_REPLACED_SIGNER | "AGREEMENT_ACTION_REPLACED_SIGNER" @@ -88,4 +61,32 @@ LIBRARY_DOCUMENT_MODIFIED | "LIBRARY_DOCUMENT_MODIFIED" LIBRARY_DOCUMENT_ALL | "LIBRARY_DOCUMENT_ALL" + +## Enum: ScopeEnum +Name | Value +---- | ----- +ACCOUNT | "ACCOUNT" +GROUP | "GROUP" +USER | "USER" +RESOURCE | "RESOURCE" + + + +## Enum: ResourceTypeEnum +Name | Value +---- | ----- +AGREEMENT | "AGREEMENT" +WIDGET | "WIDGET" +MEGASIGN | "MEGASIGN" +LIBRARY_DOCUMENT | "LIBRARY_DOCUMENT" + + + +## Enum: StatusEnum +Name | Value +---- | ----- +ACTIVE | "ACTIVE" +INACTIVE | "INACTIVE" + + diff --git a/docs/UserWebhooks.md b/docs/UserWebhooks.md index fa12074..40829eb 100755 --- a/docs/UserWebhooks.md +++ b/docs/UserWebhooks.md @@ -4,8 +4,8 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- +**userWebhookList** | [**List<UserWebhook>**](UserWebhook.md) | An array of web form items | [optional] **page** | [**PageInfo**](PageInfo.md) | Pagination information for navigating through the response | [optional] -**userWebhookList** | [**List<UserWebhook>**](UserWebhook.md) | An array of widget items | [optional] diff --git a/docs/UserWidget.md b/docs/UserWidget.md index 2fd8051..ea44912 100755 --- a/docs/UserWidget.md +++ b/docs/UserWidget.md @@ -4,13 +4,14 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**id** | **String** | The unique identifier of a widget | [optional] **hidden** | **Boolean** | True if agreement is hidden for the user | [optional] -**javascript** | **String** | The embedded javascript code of the widget | [optional] -**modifiedDate** | [**Date**](Date.md) | The date on which the widget was last modified. Format would be yyyy-MM-dd'T'HH:mm:ssZ. For example, e.g 2016-02-25T18:46:19Z represents UTC time | [optional] -**name** | **String** | The name of the widget. | [optional] -**status** | [**StatusEnum**](#StatusEnum) | The widget status (AUTHORING, ACTIVE, DRAFT, DISABLED) | [optional] -**url** | **String** | The hosted url of the widget | [optional] +**groupId** | **String** | Unique identifier of the group | [optional] +**modifiedDate** | [**Date**](Date.md) | The date on which the web form was last modified. Format would be yyyy-MM-dd'T'HH:mm:ssZ. For example, e.g 2016-02-25T18:46:19Z represents UTC time | [optional] +**name** | **String** | The name of the web form. | [optional] +**id** | **String** | The unique identifier of a web form | [optional] +**javascript** | **String** | The embedded javascript code of the web form | [optional] +**url** | **String** | The hosted url of the web form | [optional] +**status** | [**StatusEnum**](#StatusEnum) | The web form status (AUTHORING, ACTIVE, DRAFT, DISABLED) | [optional] diff --git a/docs/UserWidgets.md b/docs/UserWidgets.md index 8a22fea..40c140b 100755 --- a/docs/UserWidgets.md +++ b/docs/UserWidgets.md @@ -4,8 +4,8 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- +**userWidgetList** | [**List<UserWidget>**](UserWidget.md) | An array of web form items | [optional] **page** | [**PageInfo**](PageInfo.md) | Pagination information for navigating through the response | [optional] -**userWidgetList** | [**List<UserWidget>**](UserWidget.md) | An array of widget items | [optional] diff --git a/docs/UserWorkflow.md b/docs/UserWorkflow.md index 36a473a..60916cf 100755 --- a/docs/UserWorkflow.md +++ b/docs/UserWorkflow.md @@ -4,13 +4,13 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- +**scopeId** | **String** | Identifier of scope. Currently it is applicable for scope GROUP only and the value will be groupId. | [optional] **created** | [**Date**](Date.md) | The date on which the workflow was created. Format would be yyyy-MM-dd'T'HH:mm:ssZ. For example, e.g 2016-02-25T18:46:19Z represents UTC time | [optional] -**description** | **String** | Description provided for this workflow at the time of its creation | [optional] **displayName** | **String** | The display name of the workflow. | [optional] -**id** | **String** | The unique identifier of a workflow | [optional] -**name** | **String** | The name of the workflow. | [optional] **scope** | [**ScopeEnum**](#ScopeEnum) | The workflow scope (ACCOUNT or GROUP or OTHER) | [optional] -**scopeId** | **String** | Identifier of scope. Currently it is applicable for scope GROUP only and the value will be groupId. | [optional] +**name** | **String** | The name of the workflow. | [optional] +**description** | **String** | Description provided for this workflow at the time of its creation | [optional] +**id** | **String** | The unique identifier of a workflow | [optional] **status** | [**StatusEnum**](#StatusEnum) | The workflow status (ACTIVE or DRAFT or INACTIVE or OTHER) | [optional] diff --git a/docs/UsersApi.md b/docs/UsersApi.md index c77ce1a..c1dd610 100755 --- a/docs/UsersApi.md +++ b/docs/UsersApi.md @@ -1,6 +1,6 @@ # UsersApi -All URIs are relative to *http://localhost/api/rest/v6* +All URIs are relative to *https://secure.au1.echosign.com/api/rest/v6* Method | HTTP request | Description ------------- | ------------- | ------------- diff --git a/docs/UsersInfo.md b/docs/UsersInfo.md index cebeb4d..8bc46c7 100755 --- a/docs/UsersInfo.md +++ b/docs/UsersInfo.md @@ -4,8 +4,8 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**page** | [**PageInfo**](PageInfo.md) | Pagination information for navigating through the response | [optional] **userInfoList** | [**List<UserInfo>**](UserInfo.md) | The list of users in the account. | [optional] +**page** | [**PageInfo**](PageInfo.md) | Pagination information for navigating through the response | [optional] diff --git a/docs/VaultEventInfo.md b/docs/VaultEventInfo.md new file mode 100644 index 0000000..49a7560 --- /dev/null +++ b/docs/VaultEventInfo.md @@ -0,0 +1,11 @@ + +# VaultEventInfo + +## Properties +Name | Type | Description | Notes +------------ | ------------- | ------------- | ------------- +**vaultEventComment** | **String** | The description provided by the vault provider for the vault event | [optional] +**vaultEventId** | **String** | The identifier assigned by the vault provider for the vault event | [optional] + + + diff --git a/docs/WebhookAgreementEvents.md b/docs/WebhookAgreementEvents.md index 90e8be2..b8d2a08 100755 --- a/docs/WebhookAgreementEvents.md +++ b/docs/WebhookAgreementEvents.md @@ -5,9 +5,9 @@ Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- **includeDetailedInfo** | **Boolean** | Determines whether agreement detailed info will be returned in the response payload | [optional] -**includeDocumentsInfo** | **Boolean** | Determines whether document info will be returned in the response payload | [optional] **includeParticipantsInfo** | **Boolean** | Determines whether participants info will be returned in the response payload | [optional] **includeSignedDocuments** | **Boolean** | Determines whether documents will be returned in webhook response payload. If set to true, signed document will be returned in base 64 encoded format in JSON when signing is complete | [optional] +**includeDocumentsInfo** | **Boolean** | Determines whether document info will be returned in the response payload | [optional] diff --git a/docs/WebhookConditionalParams.md b/docs/WebhookConditionalParams.md index 0976031..531a436 100755 --- a/docs/WebhookConditionalParams.md +++ b/docs/WebhookConditionalParams.md @@ -4,10 +4,10 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**webhookAgreementEvents** | [**WebhookAgreementEvents**](WebhookAgreementEvents.md) | Conditional parameters for webhook agreement events | [optional] -**webhookLibraryDocumentEvents** | [**WebhookLibraryDocumentEvents**](WebhookLibraryDocumentEvents.md) | Conditional parameters for webhook library document events | [optional] +**webhookWidgetEvents** | [**WebhookWidgetEvents**](WebhookWidgetEvents.md) | Conditional parameters for webhook web form events | [optional] **webhookMegaSignEvents** | [**WebhookMegaSignEvents**](WebhookMegaSignEvents.md) | Conditional parameters for webhook megasign events | [optional] -**webhookWidgetEvents** | [**WebhookWidgetEvents**](WebhookWidgetEvents.md) | Conditional parameters for webhook widget events | [optional] +**webhookLibraryDocumentEvents** | [**WebhookLibraryDocumentEvents**](WebhookLibraryDocumentEvents.md) | Conditional parameters for webhook library document events | [optional] +**webhookAgreementEvents** | [**WebhookAgreementEvents**](WebhookAgreementEvents.md) | Conditional parameters for webhook agreement events | [optional] diff --git a/docs/WebhookInfo.md b/docs/WebhookInfo.md index 813be50..58616bb 100755 --- a/docs/WebhookInfo.md +++ b/docs/WebhookInfo.md @@ -4,55 +4,20 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**applicationDisplayName** | **String** | The display name of the application through which webhook is created | [optional] -**applicationName** | **String** | The name of the application through which webhook is created | [optional] +**resourceId** | **String** | Id of the resource type for which you want to create webhook. Provide agreementId if webhook needs to be created for an agreement. Similarly, widgetId if webhook needs to be created for a web form, megaSignId if webhook needs to be created for a megaSign and libraryDocumentId if webhook needs to be created for a library document. Need to specify only if scope is 'RESOURCE'. Can't be modified in PUT request | [optional] +**webhookUrlInfo** | [**WebhookUrlInfo**](WebhookUrlInfo.md) | Info of webhook url | [optional] +**webhookConditionalParams** | [**WebhookConditionalParams**](WebhookConditionalParams.md) | Conditions which webhook creator can specify for the payload while creating or updating a webhook | [optional] **created** | [**Date**](Date.md) | Timestamp when the webhook was created. Will only be returned in GET request. Can't be modified in PUT request | [optional] +**webhookSubscriptionEvents** | [**List<WebhookSubscriptionEventsEnum>**](#List<WebhookSubscriptionEventsEnum>) | Determines events for which the webhook is triggered. The possible values are <br> AGREEMENT_CREATED : When an agreement is created <br>, AGREEMENT_ACTION_DELEGATED : When an agreement is delegated <br>, AGREEMENT_RECALLED : When an agreement is recalled <br>, AGREEMENT_REJECTED : When an agreement is rejected <br>, AGREEMENT_EXPIRED : When an agreement expires <br>, AGREEMENT_ACTION_COMPLETED : When an agreement action is completed <br>, AGREEMENT_WORKFLOW_COMPLETED : When an agreement workflow is completed <br>, AGREEMENT_EMAIL_VIEWED : When an agreement's email is viewed <br>, AGREEMENT_MODIFIED : When an agreement is modified <br>, AGREEMENT_SHARED : When an agreement is shared <br>, AGREEMENT_READY_TO_VAULT : When an agreement is ready to vault <br>, AGREEMENT_VAULTED : When an agreement is vaulted <br>, AGREEMENT_ACTION_REQUESTED : When an agreement action is requested <br>, AGREEMENT_ACTION_REPLACED_SIGNER : When signer is replaced for an agreement <br>, AGREEMENT_AUTO_CANCELLED_CONVERSION_PROBLEM : When an agreement is auto-cancelled due to conversion problem <br>, AGREEMENT_DOCUMENTS_DELETED : When an agreement documents are deleted <br>, AGREEMENT_EMAIL_BOUNCED : When an agreement email gets bounced <br>, AGREEMENT_KBA_AUTHENTICATED : When an agreement KBA is authenticated <br>, AGREEMENT_OFFLINE_SYNC : When an agreement is synced offline <br>, AGREEMENT_USER_ACK_AGREEMENT_MODIFIED : User Acknowledgement when an agreement is modified <br>, AGREEMENT_UPLOADED_BY_SENDER : When an agreement is uploaded by sender <br>, AGREEMENT_WEB_IDENTITY_AUTHENTICATED : When an agreement web identity is authenticated <br>, AGREEMENT_ALL : All the supported agreement events for Webhooks <br>, MEGASIGN_CREATED : When a megaSign is created <br>, MEGASIGN_RECALLED : When a megaSign is recalled <br>, MEGASIGN_SHARED : When a megaSign is shared <br>, MEGASIGN_ALL : All the supported megaSign events for Webhooks <br>, WIDGET_CREATED : When a web form is created <br>, WIDGET_MODIFIED : When a web form is modified <br>, WIDGET_SHARED : When a web form is shared <br>, WIDGET_ENABLED : When a web form is enabled <br>, WIDGET_DISABLED : When a web form is disabled <br>, WIDGET_AUTO_CANCELLED_CONVERSION_PROBLEM : When a web form is auto-cancelled due to conversion problem <br>, WIDGET_ALL : All the supported web form events for Webhooks <br>, LIBRARY_DOCUMENT_CREATED : When a library document is created <br>, LIBRARY_DOCUMENT_AUTO_CANCELLED_CONVERSION_PROBLEM : When a library document is auto-cancelled due to conversion problem <br>, LIBRARY_DOCUMENT_MODIFIED : When a library document is modified <br>, LIBRARY_DOCUMENT_ALL : All the supported library document events for Webhooks | [optional] +**applicationDisplayName** | **String** | The display name of the application through which webhook is created | [optional] +**scope** | [**ScopeEnum**](#ScopeEnum) | Scope of webhook. Can't be modified in PUT request. The possible values are ACCOUNT, GROUP, USER or RESOURCE | [optional] +**name** | **String** | The name of the webhook | [optional] **id** | **String** | The unique identifier of the webhook. Will only be returned in GET request. Can't be modified in PUT request | [optional] **lastModified** | [**Date**](Date.md) | Timestamp when the webhook was last updated. Will only be returned in GET request. Can't be modified in PUT request | [optional] -**name** | **String** | The name of the webhook | [optional] -**resourceId** | **String** | Id of the resource type for which you want to create webhook. Provide agreementId if webhook needs to be created for an agreement. Similarly, widgetId if webhook needs to be created for a widget, megaSignId if webhook needs to be created for a megaSign and libraryDocumentId if webhook needs to be created for a library document. Need to specify only if scope is 'RESOURCE'. Can't be modified in PUT request | [optional] -**resourceType** | [**ResourceTypeEnum**](#ResourceTypeEnum) | The resource for which you want to create webhook. Need to specify only if scope is 'RESOURCE'. Can't be modified in PUT request. The possible values are AGREEMENT, WIDGET, MEGASIGN AND LIBRARY_DOCUMENT | [optional] -**scope** | [**ScopeEnum**](#ScopeEnum) | Scope of webhook. Can't be modified in PUT request. The possible values are ACCOUNT, GROUP, USER or RESOURCE | [optional] **state** | [**StateEnum**](#StateEnum) | The state in which the webhook should be created | [optional] +**applicationName** | **String** | The name of the application through which webhook is created | [optional] +**resourceType** | [**ResourceTypeEnum**](#ResourceTypeEnum) | The resource for which you want to create webhook. Need to specify only if scope is 'RESOURCE'. Can't be modified in PUT request. The possible values are AGREEMENT, WIDGET, MEGASIGN AND LIBRARY_DOCUMENT | [optional] **status** | [**StatusEnum**](#StatusEnum) | Status of the webhook. Determines whether the webhook will be actually triggered. Default: ACTIVE, if ACTIVE, this webhook will receive event requests. If INACTIVE, this webhook will not receive event requests. Can't provide status in POST/PUT requests. | [optional] -**webhookConditionalParams** | [**WebhookConditionalParams**](WebhookConditionalParams.md) | Conditions which webhook creator can specify for the payload while creating or updating a webhook | [optional] -**webhookSubscriptionEvents** | [**List<WebhookSubscriptionEventsEnum>**](#List<WebhookSubscriptionEventsEnum>) | Determines events for which the webhook is triggered. The possible values are <br> AGREEMENT_CREATED : When an agreement is created <br>, AGREEMENT_ACTION_DELEGATED : When an agreement is delegated <br>, AGREEMENT_RECALLED : When an agreement is recalled <br>, AGREEMENT_REJECTED : When an agreement is rejected <br>, AGREEMENT_EXPIRED : When an agreement expires <br>, AGREEMENT_ACTION_COMPLETED : When an agreement action is completed <br>, AGREEMENT_WORKFLOW_COMPLETED : When an agreement workflow is completed <br>, AGREEMENT_EMAIL_VIEWED : When an agreement's email is viewed <br>, AGREEMENT_MODIFIED : When an agreement is modified <br>, AGREEMENT_SHARED : When an agreement is shared <br>, AGREEMENT_VAULTED : When an agreement is vaulted <br>, AGREEMENT_ACTION_REQUESTED : When an agreement action is requested <br>, AGREEMENT_ACTION_REPLACED_SIGNER : When signer is replaced for an agreement <br>, AGREEMENT_AUTO_CANCELLED_CONVERSION_PROBLEM : When an agreement is auto-cancelled due to conversion problem <br>, AGREEMENT_DOCUMENTS_DELETED : When an agreement documents are deleted <br>, AGREEMENT_EMAIL_BOUNCED : When an agreement email gets bounced <br>, AGREEMENT_KBA_AUTHENTICATED : When an agreement KBA is authenticated <br>, AGREEMENT_OFFLINE_SYNC : When an agreement is synced offline <br>, AGREEMENT_USER_ACK_AGREEMENT_MODIFIED : User Acknowledgement when an agreement is modified <br>, AGREEMENT_UPLOADED_BY_SENDER : When an agreement is uploaded by sender <br>, AGREEMENT_WEB_IDENTITY_AUTHENTICATED : When an agreement web identity is authenticated <br>, AGREEMENT_ALL : All the supported agreement events for Webhooks <br>, MEGASIGN_CREATED : When a megaSign is created <br>, MEGASIGN_RECALLED : When a megaSign is recalled <br>, MEGASIGN_SHARED : When a megaSign is shared <br>, MEGASIGN_ALL : All the supported megaSign events for Webhooks <br>, WIDGET_CREATED : When a widget is created <br>, WIDGET_MODIFIED : When a widget is modified <br>, WIDGET_SHARED : When a widget is shared <br>, WIDGET_ENABLED : When a widget is enabled <br>, WIDGET_DISABLED : When a widget is disabled <br>, WIDGET_AUTO_CANCELLED_CONVERSION_PROBLEM : When a widget is auto-cancelled due to conversion problem <br>, WIDGET_ALL : All the supported widget events for Webhooks <br>, LIBRARY_DOCUMENT_CREATED : When a library document is created <br>, LIBRARY_DOCUMENT_AUTO_CANCELLED_CONVERSION_PROBLEM : When a library document is auto-cancelled due to conversion problem <br>, LIBRARY_DOCUMENT_MODIFIED : When a library document is modified <br>, LIBRARY_DOCUMENT_ALL : All the supported library document events for Webhooks | [optional] -**webhookUrlInfo** | [**WebhookUrlInfo**](WebhookUrlInfo.md) | Info of webhook url | [optional] - - - -## Enum: ResourceTypeEnum -Name | Value ----- | ----- -AGREEMENT | "AGREEMENT" -WIDGET | "WIDGET" -MEGASIGN | "MEGASIGN" -LIBRARY_DOCUMENT | "LIBRARY_DOCUMENT" - - - -## Enum: ScopeEnum -Name | Value ----- | ----- -ACCOUNT | "ACCOUNT" -GROUP | "GROUP" -USER | "USER" -RESOURCE | "RESOURCE" - - - -## Enum: StateEnum -Name | Value ----- | ----- -ACTIVE | "ACTIVE" - - - -## Enum: StatusEnum -Name | Value ----- | ----- -ACTIVE | "ACTIVE" -INACTIVE | "INACTIVE" @@ -69,6 +34,7 @@ AGREEMENT_WORKFLOW_COMPLETED | "AGREEMENT_WORKFLOW_COMPLETED" AGREEMENT_EMAIL_VIEWED | "AGREEMENT_EMAIL_VIEWED" AGREEMENT_MODIFIED | "AGREEMENT_MODIFIED" AGREEMENT_SHARED | "AGREEMENT_SHARED" +AGREEMENT_READY_TO_VAULT | "AGREEMENT_READY_TO_VAULT" AGREEMENT_VAULTED | "AGREEMENT_VAULTED" AGREEMENT_ACTION_REQUESTED | "AGREEMENT_ACTION_REQUESTED" AGREEMENT_ACTION_REPLACED_SIGNER | "AGREEMENT_ACTION_REPLACED_SIGNER" @@ -98,4 +64,39 @@ LIBRARY_DOCUMENT_MODIFIED | "LIBRARY_DOCUMENT_MODIFIED" LIBRARY_DOCUMENT_ALL | "LIBRARY_DOCUMENT_ALL" + +## Enum: ScopeEnum +Name | Value +---- | ----- +ACCOUNT | "ACCOUNT" +GROUP | "GROUP" +USER | "USER" +RESOURCE | "RESOURCE" + + + +## Enum: StateEnum +Name | Value +---- | ----- +ACTIVE | "ACTIVE" + + + +## Enum: ResourceTypeEnum +Name | Value +---- | ----- +AGREEMENT | "AGREEMENT" +WIDGET | "WIDGET" +MEGASIGN | "MEGASIGN" +LIBRARY_DOCUMENT | "LIBRARY_DOCUMENT" + + + +## Enum: StatusEnum +Name | Value +---- | ----- +ACTIVE | "ACTIVE" +INACTIVE | "INACTIVE" + + diff --git a/docs/WebhookWidgetEvents.md b/docs/WebhookWidgetEvents.md index ea3ec6c..978d4e9 100755 --- a/docs/WebhookWidgetEvents.md +++ b/docs/WebhookWidgetEvents.md @@ -5,8 +5,8 @@ Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- **includeDetailedInfo** | **Boolean** | Determines whether agreement detailed info will be returned in the response payload | [optional] -**includeDocumentsInfo** | **Boolean** | Determines whether document info will be returned in the response payload | [optional] **includeParticipantsInfo** | **Boolean** | Determines whether participants info will be returned in the response payload | [optional] +**includeDocumentsInfo** | **Boolean** | Determines whether document info will be returned in the response payload | [optional] diff --git a/docs/WebhooksApi.md b/docs/WebhooksApi.md index 4ee7d96..e7fd26f 100755 --- a/docs/WebhooksApi.md +++ b/docs/WebhooksApi.md @@ -1,6 +1,6 @@ # WebhooksApi -All URIs are relative to *http://localhost/api/rest/v6* +All URIs are relative to *https://secure.au1.echosign.com/api/rest/v6* Method | HTTP request | Description ------------- | ------------- | ------------- @@ -18,7 +18,7 @@ Method | HTTP request | Description Creates a webhook. -This is a primary endpoint which is used to create a new webhook. A webhook can only be created in ACTIVE state. Currently, webhooks are supported at four scopes - Account, Group, User and Resource. <br/> <br/> Before creating a webhook successfully at any of these scopes, Adobe Sign <a href='https://www.adobe.io/apis/documentcloud/sign/docs.html#!adobeio/adobeio-documentation/master/sign/webhooks.md#verificationofintentofthewebhookurl'>verifies</a> that the webhook URL that is provided in the registration request really intends to receive notifications and is a valid URL. <br/>There is a defined mechanism for this validation where Adobe Sign makes an HTTPS GET request to the webhook URL. This request has a custom HTTP header X-AdobeSign-ClientId. The value of this header is the client ID of the application that is requesting to create the webhook. To register a webhook successfully, the webhook URL must respond to this verification request with an HTTPS 2XX response code, and also it must send back the same client ID value in one of the following two ways:<ol><li>In a custom response header, X-AdobeSign-ClientId. This is the same header which was passed in the request, and can be echoed back in the response.</li><li> In the JSON response body of the response with the key of xAdobeSignClientId and its value being the same client ID that was sent in the request. </li></ol><p>On successful registration, Adobe Sign sends a success response (any HTTPS 2XX code) to your client app with the unique webhook identifier and a Location header, which contains the URL of the webhook resource created in Adobe Sign.<br/> To learn more, please refer <a href='https://www.adobe.io/apis/documentcloud/sign/docs.html#!adobeio/adobeio-documentation/master/sign/webhooks.md'>Webhooks in Adobe Sign Guide</a>.</p> +This is a primary endpoint which is used to create a new webhook. A webhook can only be created in ACTIVE state. Currently, webhooks are supported at four scopes - Account, Group, User and Resource. <br/> <br/> Before creating a webhook successfully at any of these scopes, Adobe Sign <a href='https://www.adobe.io/apis/documentcloud/sign/docs.html#!adobedocs/adobe-sign/master/webhooks.md#verificationofintentofthewebhookurl'>verifies</a> that the webhook URL that is provided in the registration request really intends to receive notifications and is a valid URL. <br/>There is a defined mechanism for this validation where Adobe Sign makes an HTTPS GET request to the webhook URL. This request has a custom HTTP header X-AdobeSign-ClientId. The value of this header is the client ID of the application that is requesting to create the webhook. To register a webhook successfully, the webhook URL must respond to this verification request with an HTTPS 2XX response code, and also it must send back the same client ID value in one of the following two ways:<ol><li>In a custom response header, X-AdobeSign-ClientId. This is the same header which was passed in the request, and can be echoed back in the response.</li><li> In the JSON response body of the response with the key of xAdobeSignClientId and its value being the same client ID that was sent in the request. </li></ol><p>On successful registration, Adobe Sign sends a success response (any HTTPS 2XX code) to your client app with the unique webhook identifier and a Location header, which contains the URL of the webhook resource created in Adobe Sign.<br/> To learn more, please refer <a href='https://www.adobe.io/apis/documentcloud/sign/docs.html#!adobedocs/adobe-sign/master/webhooks.md'>Webhooks in Adobe Sign Guide</a>.</p> ### Example ```java @@ -65,7 +65,7 @@ No authorization required # **deleteWebhook** -> deleteWebhook(authorization, ifMatch, webhookId, xApiUser, xOnBehalfOfUser) +> deleteWebhook(authorization, webhookId, xApiUser, xOnBehalfOfUser, ifMatch) Deletes a webhook. @@ -78,12 +78,12 @@ Deletes a webhook. WebhooksApi apiInstance = new WebhooksApi(); String authorization = "authorization_example"; // String | An OAuth Access Token with scopes:in the format 'Bearer {accessToken}'. -String ifMatch = "ifMatch_example"; // String | The server will only update the resource if it matches the listed ETag otherwise error RESOURCE_MODIFIED(412) is returned. String webhookId = "webhookId_example"; // String | The webhook identifier, as returned by the webhook creation API or retrieved from the API to fetch webhooks. String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or email in the format userid:{userId} OR email:{email}. of the user that has shared his/her account +String ifMatch = "ifMatch_example"; // String | The server will only update the resource if it matches the listed ETag otherwise error RESOURCE_MODIFIED(412) is returned. try { - apiInstance.deleteWebhook(authorization, ifMatch, webhookId, xApiUser, xOnBehalfOfUser); + apiInstance.deleteWebhook(authorization, webhookId, xApiUser, xOnBehalfOfUser, ifMatch); } catch (ApiException e) { System.err.println("Exception when calling WebhooksApi#deleteWebhook"); e.printStackTrace(); @@ -95,10 +95,10 @@ try { Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **authorization** | **String**| An <a href=\"#\" onclick=\"this.href=oauthDoc()\" oncontextmenu=\"this.href=oauthDoc()\" target=\"oauthDoc\">OAuth Access Token</a> with scopes:<ul><li style='list-style-type: square'><a href=\"#\" onclick=\"this.href=oauthDoc('webhook_retention')\" oncontextmenu=\"this.href=oauthDoc('webhook_retention')\" target=\"oauthDoc\">webhook_retention</a></li></ul>in the format <b>'Bearer {accessToken}'. | - **ifMatch** | **String**| The server will only update the resource if it matches the listed ETag otherwise error RESOURCE_MODIFIED(412) is returned. | **webhookId** | **String**| The webhook identifier, as returned by the webhook creation API or retrieved from the API to fetch webhooks. | **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] **xOnBehalfOfUser** | **String**| The userId or email in the format <b>userid:{userId} OR email:{email}.</b> of the user that has shared his/her account | [optional] + **ifMatch** | **String**| The server will only update the resource if it matches the listed ETag otherwise error RESOURCE_MODIFIED(412) is returned. | [optional] ### Return type @@ -223,7 +223,7 @@ No authorization required # **updateWebhook** -> updateWebhook(authorization, ifMatch, webhookId, webhookInfo, xApiUser, xOnBehalfOfUser) +> updateWebhook(authorization, webhookId, webhookInfo, xApiUser, xOnBehalfOfUser, ifMatch) Updates a webhook. @@ -236,13 +236,13 @@ Updates a webhook. WebhooksApi apiInstance = new WebhooksApi(); String authorization = "authorization_example"; // String | An OAuth Access Token with scopes:in the format 'Bearer {accessToken}'. -String ifMatch = "ifMatch_example"; // String | The server will only update the resource if it matches the listed ETag otherwise error RESOURCE_MODIFIED(412) is returned. String webhookId = "webhookId_example"; // String | The webhook identifier, as returned by the webhook creation API or retrieved from the API to fetch webhooks. WebhookInfo webhookInfo = new WebhookInfo(); // WebhookInfo | Information necessary to update a webhook String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or email in the format userid:{userId} OR email:{email}. of the user that has shared his/her account +String ifMatch = "ifMatch_example"; // String | The server will only update the resource if it matches the listed ETag otherwise error RESOURCE_MODIFIED(412) is returned. try { - apiInstance.updateWebhook(authorization, ifMatch, webhookId, webhookInfo, xApiUser, xOnBehalfOfUser); + apiInstance.updateWebhook(authorization, webhookId, webhookInfo, xApiUser, xOnBehalfOfUser, ifMatch); } catch (ApiException e) { System.err.println("Exception when calling WebhooksApi#updateWebhook"); e.printStackTrace(); @@ -254,11 +254,11 @@ try { Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **authorization** | **String**| An <a href=\"#\" onclick=\"this.href=oauthDoc()\" oncontextmenu=\"this.href=oauthDoc()\" target=\"oauthDoc\">OAuth Access Token</a> with scopes:<ul><li style='list-style-type: square'><a href=\"#\" onclick=\"this.href=oauthDoc('webhook_write')\" oncontextmenu=\"this.href=oauthDoc('webhook_write')\" target=\"oauthDoc\">webhook_write</a></li></ul>in the format <b>'Bearer {accessToken}'. | - **ifMatch** | **String**| The server will only update the resource if it matches the listed ETag otherwise error RESOURCE_MODIFIED(412) is returned. | **webhookId** | **String**| The webhook identifier, as returned by the webhook creation API or retrieved from the API to fetch webhooks. | **webhookInfo** | [**WebhookInfo**](WebhookInfo.md)| Information necessary to update a webhook | **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] **xOnBehalfOfUser** | **String**| The userId or email in the format <b>userid:{userId} OR email:{email}.</b> of the user that has shared his/her account | [optional] + **ifMatch** | **String**| The server will only update the resource if it matches the listed ETag otherwise error RESOURCE_MODIFIED(412) is returned. | [optional] ### Return type @@ -275,7 +275,7 @@ No authorization required # **updateWebhookState** -> updateWebhookState(authorization, ifMatch, webhookId, webhookStateInfo, xApiUser, xOnBehalfOfUser) +> updateWebhookState(authorization, webhookId, webhookStateInfo, xApiUser, xOnBehalfOfUser, ifMatch) Updates the state of a webhook identified by webhookId in the path. @@ -288,13 +288,13 @@ Updates the state of a webhook identified by webhookId in the path. WebhooksApi apiInstance = new WebhooksApi(); String authorization = "authorization_example"; // String | An OAuth Access Token with scopes:in the format 'Bearer {accessToken}'. -String ifMatch = "ifMatch_example"; // String | The server will only update the resource if it matches the listed ETag otherwise error RESOURCE_MODIFIED(412) is returned. String webhookId = "webhookId_example"; // String | The webhook identifier, as returned by the webhook creation API or retrieved from the API to fetch webhooks. WebhookStateInfo webhookStateInfo = new WebhookStateInfo(); // WebhookStateInfo | String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or email in the format userid:{userId} OR email:{email}. of the user that has shared his/her account +String ifMatch = "ifMatch_example"; // String | The server will only update the resource if it matches the listed ETag otherwise error RESOURCE_MODIFIED(412) is returned. try { - apiInstance.updateWebhookState(authorization, ifMatch, webhookId, webhookStateInfo, xApiUser, xOnBehalfOfUser); + apiInstance.updateWebhookState(authorization, webhookId, webhookStateInfo, xApiUser, xOnBehalfOfUser, ifMatch); } catch (ApiException e) { System.err.println("Exception when calling WebhooksApi#updateWebhookState"); e.printStackTrace(); @@ -306,11 +306,11 @@ try { Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **authorization** | **String**| An <a href=\"#\" onclick=\"this.href=oauthDoc()\" oncontextmenu=\"this.href=oauthDoc()\" target=\"oauthDoc\">OAuth Access Token</a> with scopes:<ul><li style='list-style-type: square'><a href=\"#\" onclick=\"this.href=oauthDoc('webhook_write')\" oncontextmenu=\"this.href=oauthDoc('webhook_write')\" target=\"oauthDoc\">webhook_write</a></li></ul>in the format <b>'Bearer {accessToken}'. | - **ifMatch** | **String**| The server will only update the resource if it matches the listed ETag otherwise error RESOURCE_MODIFIED(412) is returned. | **webhookId** | **String**| The webhook identifier, as returned by the webhook creation API or retrieved from the API to fetch webhooks. | **webhookStateInfo** | [**WebhookStateInfo**](WebhookStateInfo.md)| | **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] **xOnBehalfOfUser** | **String**| The userId or email in the format <b>userid:{userId} OR email:{email}.</b> of the user that has shared his/her account | [optional] + **ifMatch** | **String**| The server will only update the resource if it matches the listed ETag otherwise error RESOURCE_MODIFIED(412) is returned. | [optional] ### Return type diff --git a/docs/WidgetAdditionalParticipationSetInfo.md b/docs/WidgetAdditionalParticipationSetInfo.md index 3a1d2e3..4ec3fb3 100755 --- a/docs/WidgetAdditionalParticipationSetInfo.md +++ b/docs/WidgetAdditionalParticipationSetInfo.md @@ -4,9 +4,10 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**memberInfos** | [**List<ParticipantSetMemberInfo>**](ParticipantSetMemberInfo.md) | Array of ParticipantInfo objects, containing participant-specific data (email, e.g.) for all the additional participants in the widget | [optional] -**order** | **Integer** | Index indicating position at which signing group needs to sign. Additional participant to sign at first place is assigned a index of 1. Widget participant should not have any order specified. Widget participant should not have any email address and and can not have phone authentication applied. Different signingOrder specified in input should form a valid consecutive increasing sequence of integers. Otherwise signingOrder will be considered invalid | [optional] -**role** | [**RoleEnum**](#RoleEnum) | Role assumed by all participants in the set (signer, approver, etc.) Widget First Participant will only have roles - Signer, Approver, Acceptor and Form Filler | [optional] +**providerParticipantSetInfo** | [**ProviderParticipantSetInfo**](ProviderParticipantSetInfo.md) | Represents all the attributes related to the unknown participant and its provider. If it is defined then the participant will be treated as an unknown participant. | [optional] +**role** | [**RoleEnum**](#RoleEnum) | Role assumed by all participants in the set (signer, approver, etc.) Web Form First Participant will only have roles - Signer, Approver, Acceptor and Form Filler | [optional] +**memberInfos** | [**List<ParticipantSetMemberInfo>**](ParticipantSetMemberInfo.md) | Array of ParticipantInfo objects, containing participant-specific data (email, e.g.) for all the additional participants in the web form. If the email of the participant is unknown at the time of web form creation, the email should be left empty, | [optional] +**order** | **Integer** | Index indicating position at which signing group needs to sign. Additional participant to sign at first place is assigned a index of 1. Web Form participant should not have any order specified. Web Form participant should not have any email address and and can not have phone authentication applied. Different signingOrder specified in input should form a valid consecutive increasing sequence of integers. Otherwise signingOrder will be considered invalid, | [optional] diff --git a/docs/WidgetAgreement.md b/docs/WidgetAgreement.md index a108b23..1671ad3 100755 --- a/docs/WidgetAgreement.md +++ b/docs/WidgetAgreement.md @@ -4,16 +4,28 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- +**hidden** | **Boolean** | True if agreement is hidden for the user | [optional] **displayDate** | [**Date**](Date.md) | The display date for the agreement. Format would be yyyy-MM-dd'T'HH:mm:ssZ. For example, e.g 2016-02-25T18:46:19Z represents UTC time | [optional] -**displayParticipantSetInfos** | [**List<DisplayWidgetParticipantSetInfo>**](DisplayWidgetParticipantSetInfo.md) | The most relevant current user set for the agreement. It is typically the next signer if the agreement is from the current user, or the sender if received from another user | [optional] -**id** | **String** | The unique identifier of the agreement.If provided in POST, it will simply be ignored | [optional] +**groupId** | **String** | Unique identifier of the group | [optional] **esign** | **Boolean** | True if this is an e-sign document | [optional] -**hidden** | **Boolean** | True if agreement is hidden for the user | [optional] -**latestVersionId** | **String** | A version ID which uniquely identifies the current version of the agreement | [optional] **name** | **String** | Name of the Agreement | [optional] +**displayParticipantSetInfos** | [**List<DisplayWidgetParticipantSetInfo>**](DisplayWidgetParticipantSetInfo.md) | The most relevant current user set for the agreement. It is typically the next signer if the agreement is from the current user, or the sender if received from another user | [optional] +**latestVersionId** | **String** | A version ID which uniquely identifies the current version of the agreement | [optional] +**id** | **String** | The unique identifier of the agreement.If provided in POST, it will simply be ignored | [optional] +**type** | [**TypeEnum**](#TypeEnum) | The kind of agreement | [optional] +**parentId** | **String** | The parent id of a megaSign child *OR* the originating id of a widget agreement instance | [optional] **status** | [**StatusEnum**](#StatusEnum) | The current status of the document from the perspective of the originator | [optional] + +## Enum: TypeEnum +Name | Value +---- | ----- +AGREEMENT | "AGREEMENT" +MEGASIGN_CHILD | "MEGASIGN_CHILD" +WIDGET_INSTANCE | "WIDGET_INSTANCE" + + ## Enum: StatusEnum Name | Value diff --git a/docs/WidgetAgreements.md b/docs/WidgetAgreements.md index f26996f..79e8c35 100755 --- a/docs/WidgetAgreements.md +++ b/docs/WidgetAgreements.md @@ -4,8 +4,8 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**page** | [**PageInfo**](PageInfo.md) | Pagination information for navigating through the response | [optional] **userAgreementList** | [**List<WidgetAgreement>**](WidgetAgreement.md) | An array of UserAgreement items | [optional] +**page** | [**PageInfo**](PageInfo.md) | Pagination information for navigating through the response | [optional] diff --git a/docs/WidgetCcInfo.md b/docs/WidgetCcInfo.md index 75127c1..e83eb03 100755 --- a/docs/WidgetCcInfo.md +++ b/docs/WidgetCcInfo.md @@ -4,7 +4,7 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**email** | **String** | Email of the CC participant of the widget | [optional] +**email** | **String** | Email of the CC participant of the web form | [optional] diff --git a/docs/WidgetCreationInfoV6.md b/docs/WidgetCreationInfoV6.md index b26e683..9d24b4e 100755 --- a/docs/WidgetCreationInfoV6.md +++ b/docs/WidgetCreationInfoV6.md @@ -4,22 +4,25 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**additionalParticipantSetsInfo** | [**List<WidgetAdditionalParticipationSetInfo>**](WidgetAdditionalParticipationSetInfo.md) | List of all the participants in the widget except widget signer | [optional] -**authFailureInfo** | [**WidgetRedirectionInfo**](WidgetRedirectionInfo.md) | URL and associated properties for the error page the widget signer will be taken after failing to authenticate | [optional] -**ccs** | [**List<WidgetCcInfo>**](WidgetCcInfo.md) | A list of one or more email addresses that you want to copy on this transaction. The email addresses will each receive an email when the final agreement created through widget is signed. The email addresses will also receive a copy of the document, attached as a PDF file | [optional] -**completionInfo** | [**WidgetRedirectionInfo**](WidgetRedirectionInfo.md) | URL and associated properties for the success page the widget signer will be taken to after performing desired action on the widget | [optional] -**createdDate** | [**Date**](Date.md) | Date when widget was created. If provided in POST, it will simply be ignored. Format would be yyyy-MM-dd'T'HH:mm:ssZ. For example, e.g 2016-02-25T18:46:19Z represents UTC time | [optional] -**creatorEmail** | **String** | Email of widget creator. Only returned in GET response. Cannot be provided in POST/PUT request. If provided in POST, it will simply be ignored | [optional] -**fileInfos** | [**List<FileInfo>**](FileInfo.md) | A list of one or more files (or references to files) that will be used to create the widget. If more than one file is provided, they will be combined before the widget is created. Library documents are not permitted. Note: Only one of the four parameters in every FileInfo object must be specified | [optional] -**id** | **String** | A resource identifier that can be used to uniquely identify the widget in other apis. If provided in POST, it will simply be ignored | [optional] -**locale** | **String** | The locale associated with this widget - specifies the language for the signing page and emails, for example en_US or fr_FR. If none specified, defaults to the language configured for the widget creator | [optional] -**name** | **String** | The name of the widget that will be used to identify it, in emails, website and other places | [optional] -**securityOption** | [**SecurityOption**](SecurityOption.md) | Secondary security parameters for the widget | [optional] -**state** | [**StateEnum**](#StateEnum) | The state in which the widget should land. For example in order to create a widget in DRAFT state, field should be DRAFT. The state field will never get returned in GET /widgets/{ID} and will be ignored if provided in PUT /widgets/{ID} call. The eventual status of the widget can be obtained from GET /widgets/ID | [optional] -**status** | [**StatusEnum**](#StatusEnum) | Status of the Widget. If provided in POST, it will simply be ignored | [optional] +**additionalParticipantSetsInfo** | [**List<WidgetAdditionalParticipationSetInfo>**](WidgetAdditionalParticipationSetInfo.md) | List of all the participants in the web form except web form signer | [optional] +**creatorEmail** | **String** | Email of web form creator. Only returned in GET response. Cannot be provided in POST/PUT request. If provided in POST, it will simply be ignored | [optional] +**groupId** | **String** | The ID of the group to which the widget belongs to. If not provided during creation, primary group of the creator will be used | [optional] +**locale** | **String** | The locale associated with this web form - specifies the language for the signing page and emails, for example en_US or fr_FR. If none specified, defaults to the language configured for the web form creator | [optional] **vaultingInfo** | [**VaultingInfo**](VaultingInfo.md) | Vaulting properties that allows Adobe Sign to securely store documents with a vault provider | [optional] -**widgetInActiveInfo** | [**WidgetInActiveInfo**](WidgetInActiveInfo.md) | The custom message which will be displayed to the user or the URL to which user will be redirected when the widget is accessed in a disabled state. This can only be specified in PUT request | [optional] -**widgetParticipantSetInfo** | [**WidgetParticipantSetInfo**](WidgetParticipantSetInfo.md) | Represents widget participant for whom email should not be provided | [optional] +**securityOption** | [**SecurityOption**](SecurityOption.md) | Secondary security parameters for the web form | [optional] +**widgetParticipantSetInfo** | [**WidgetParticipantSetInfo**](WidgetParticipantSetInfo.md) | Represents web form participant for whom email should not be provided | [optional] +**widgetInActiveInfo** | [**WidgetInActiveInfo**](WidgetInActiveInfo.md) | The custom message which will be displayed to the user or the URL to which user will be redirected when the web form is accessed in a disabled state. This can only be specified in PUT request | [optional] +**ccs** | [**List<WidgetCcInfo>**](WidgetCcInfo.md) | A list of one or more email addresses that you want to copy on this transaction. The email addresses will each receive an email when the final agreement created through web form is signed. The email addresses will also receive a copy of the document, attached as a PDF file | [optional] +**createdDate** | [**Date**](Date.md) | Date when web form was created. If provided in POST, it will simply be ignored. Format would be yyyy-MM-dd'T'HH:mm:ssZ. For example, e.g 2016-02-25T18:46:19Z represents UTC time | [optional] +**isDocumentRetentionApplied** | **Boolean** | Is document retention applied for this resource. If provided in POST or PUT, it will simply be ignored. | [optional] +**lastEventDate** | [**Date**](Date.md) | The date of the last event that occurred for this web form. Format would be yyyy-MM-dd'T'HH:mm:ssZ. For example, e.g 2016-02-25T18:46:19Z represents UTC time | [optional] +**name** | **String** | The name of the web form that will be used to identify it, in emails, website and other places | [optional] +**completionInfo** | [**WidgetRedirectionInfo**](WidgetRedirectionInfo.md) | URL and associated properties for the success page the web form signer will be taken to after performing desired action on the web form | [optional] +**authFailureInfo** | [**WidgetRedirectionInfo**](WidgetRedirectionInfo.md) | URL and associated properties for the error page the web form signer will be taken after failing to authenticate | [optional] +**fileInfos** | [**List<FileInfo>**](FileInfo.md) | A list of one or more files (or references to files) that will be used to create the web form. If more than one file is provided, they will be combined before the web form is created. Library documents are not permitted. Note: Only one of the four parameters in every FileInfo object must be specified | [optional] +**id** | **String** | A resource identifier that can be used to uniquely identify the web form in other apis. If provided in POST, it will simply be ignored | [optional] +**state** | [**StateEnum**](#StateEnum) | The state in which the web form should land. For example in order to create a web form in DRAFT state, field should be DRAFT. The state field will never get returned in GET /widgets/{ID} and will be ignored if provided in PUT /widgets/{ID} call. The eventual status of the web form can be obtained from GET /widgets/ID | [optional] +**status** | [**StatusEnum**](#StatusEnum) | Status of the Web Form. If provided in POST, it will simply be ignored | [optional] diff --git a/docs/WidgetCreationResponse.md b/docs/WidgetCreationResponse.md index 3638df3..16a9cdf 100755 --- a/docs/WidgetCreationResponse.md +++ b/docs/WidgetCreationResponse.md @@ -4,7 +4,7 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**id** | **String** | The unique identifier of widget which can be used to retrieve the data entered by the signers. | [optional] +**id** | **String** | The unique identifier of web form which can be used to retrieve the data entered by the signers. | [optional] diff --git a/docs/WidgetEvent.md b/docs/WidgetEvent.md index e4e6be4..5833ae3 100755 --- a/docs/WidgetEvent.md +++ b/docs/WidgetEvent.md @@ -4,25 +4,37 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**actingUserEmail** | **String** | Email address of the user that created the event | [optional] -**actingUserIpAddress** | **String** | The IP address of the user that created the event | [optional] -**actingUserName** | **String** | The name of the acting user | [optional] -**comment** | **String** | The event comment. For RECALLED or REJECTED, the reason given by the user that initiates the event. For DELEGATE or SHARE, the message from the acting user to the participant | [optional] **date** | [**Date**](Date.md) | The date of the audit event. Format would be yyyy-MM-dd'T'HH:mm:ssZ. For example, e.g 2016-02-25T18:46:19Z represents UTC time | [optional] -**description** | **String** | A description of the audit event | [optional] -**deviceLocation** | [**WidgetEventDeviceLocation**](WidgetEventDeviceLocation.md) | Location of the device that generated the event (This value may be null due to limited privileges) | [optional] -**devicePhoneNumber** | **String** | Phone number from the device used when the participation is completed on a mobile phone | [optional] -**digitalSignatureInfo** | [**DigitalSignatureInfo**](DigitalSignatureInfo.md) | This is present for ESIGNED events when the participation is signed digitally | [optional] -**initiatingUserEmail** | **String** | Email address of the user that initiated the event on behalf of the acting user when the account is shared. Will be empty if there is no account sharing in effect | [optional] **initiatingUserName** | **String** | Full name of the user that initiated the event on behalf of the acting user when the account is shared. Will be empty if there is no account sharing in effect | [optional] +**description** | **String** | A description of the audit event | [optional] +**actingUserName** | **String** | The name of the acting user | [optional] +**actingUserIpAddress** | **String** | The IP address of the user that created the event | [optional] **participantEmail** | **String** | Email address of the user that is the participant for the event. This may be different than the acting user for certain event types. For example, for a DELEGATION event, this is the user who was delegated to | [optional] -**participantId** | **String** | The unique identifier of the participant for the event. This may be different than the acting user for certain event types. For example, for a DELEGATION event, this is the user who was delegated to | [optional] +**type** | [**TypeEnum**](#TypeEnum) | Type of web form event | [optional] **participantRole** | [**ParticipantRoleEnum**](#ParticipantRoleEnum) | Role assumed by all participants in the participant set the participant belongs to (signer, approver etc.). | [optional] -**synchronizationId** | **String** | A unique identifier linking offline events to synchronization events (specified for offline signing events and synchronization events, else null) | [optional] -**type** | [**TypeEnum**](#TypeEnum) | Type of widget event | [optional] **vaultEventId** | **String** | The identifier assigned by the vault provider for the vault event (if vaulted, otherwise null) | [optional] -**vaultProviderName** | **String** | Name of the vault provider for the vault event (if vaulted, otherwise null) | [optional] +**participantId** | **String** | The unique identifier of the participant for the event. This may be different than the acting user for certain event types. For example, for a DELEGATION event, this is the user who was delegated to | [optional] **versionId** | **String** | An ID which uniquely identifies the version of the document associated with this audit event | [optional] +**actingUserEmail** | **String** | Email address of the user that created the event | [optional] +**devicePhoneNumber** | **String** | Phone number from the device used when the participation is completed on a mobile phone | [optional] +**initiatingUserEmail** | **String** | Email address of the user that initiated the event on behalf of the acting user when the account is shared. Will be empty if there is no account sharing in effect | [optional] +**digitalSignatureInfo** | [**DigitalSignatureInfo**](DigitalSignatureInfo.md) | This is present for ESIGNED events when the participation is signed digitally | [optional] +**vaultProviderName** | **String** | Name of the vault provider for the vault event (if vaulted, otherwise null) | [optional] +**comment** | **String** | The event comment. For RECALLED or REJECTED, the reason given by the user that initiates the event. For DELEGATE or SHARE, the message from the acting user to the participant | [optional] +**id** | **String** | The identifier for the event. | [optional] +**synchronizationId** | **String** | A unique identifier linking offline events to synchronization events (specified for offline signing events and synchronization events, else null) | [optional] +**deviceLocation** | [**WidgetEventDeviceLocation**](WidgetEventDeviceLocation.md) | Location of the device that generated the event (This value may be null due to limited privileges) | [optional] + + + +## Enum: TypeEnum +Name | Value +---- | ----- +AUTO_CANCELLED_CONVERSION_PROBLEM | "AUTO_CANCELLED_CONVERSION_PROBLEM" +ACTIVATED | "ACTIVATED" +CREATED | "CREATED" +DEACTIVATED | "DEACTIVATED" +MODIFIED | "MODIFIED" @@ -43,15 +55,4 @@ SHARE | "SHARE" SENDER | "SENDER" - -## Enum: TypeEnum -Name | Value ----- | ----- -AUTO_CANCELLED_CONVERSION_PROBLEM | "AUTO_CANCELLED_CONVERSION_PROBLEM" -ACTIVATED | "ACTIVATED" -CREATED | "CREATED" -DEACTIVATED | "DEACTIVATED" -MODIFIED | "MODIFIED" - - diff --git a/docs/WidgetInActiveInfo.md b/docs/WidgetInActiveInfo.md index ce09892..7cd9195 100755 --- a/docs/WidgetInActiveInfo.md +++ b/docs/WidgetInActiveInfo.md @@ -4,8 +4,8 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**message** | **String** | Display this custom message to the user when the widget is accessed. Note that this can contain wiki markup to include clickable links in the message. This is required if redirectUrl is not provided. Both message and redirectUrl cannot be specified. | [optional] -**redirectUrl** | **String** | Redirect the user to this URL when the widget is accessed. This is required if message is not provided. Both message and redirectUrl cannot be specified. | [optional] +**redirectUrl** | **String** | Redirect the user to this URL when the web form is accessed. This is required if message is not provided. Both message and redirectUrl cannot be specified. | [optional] +**message** | **String** | Display this custom message to the user when the web form is accessed. Note that this can contain wiki markup to include clickable links in the message. This is required if redirectUrl is not provided. Both message and redirectUrl cannot be specified. | [optional] diff --git a/docs/WidgetInfo.md b/docs/WidgetInfo.md index 1f30da5..60516eb 100755 --- a/docs/WidgetInfo.md +++ b/docs/WidgetInfo.md @@ -4,22 +4,25 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**additionalParticipantSetsInfo** | [**List<WidgetAdditionalParticipationSetInfo>**](WidgetAdditionalParticipationSetInfo.md) | List of all the participants in the widget except widget signer | [optional] -**authFailureInfo** | [**WidgetRedirectionInfo**](WidgetRedirectionInfo.md) | URL and associated properties for the error page the widget signer will be taken after failing to authenticate | [optional] -**ccs** | [**List<WidgetCcInfo>**](WidgetCcInfo.md) | A list of one or more email addresses that you want to copy on this transaction. The email addresses will each receive an email when the final agreement created through widget is signed. The email addresses will also receive a copy of the document, attached as a PDF file | [optional] -**completionInfo** | [**WidgetRedirectionInfo**](WidgetRedirectionInfo.md) | URL and associated properties for the success page the widget signer will be taken to after performing desired action on the widget | [optional] -**createdDate** | [**Date**](Date.md) | Date when widget was created. If provided in POST, it will simply be ignored. Format would be yyyy-MM-dd'T'HH:mm:ssZ. For example, e.g 2016-02-25T18:46:19Z represents UTC time | [optional] -**creatorEmail** | **String** | Email of widget creator. Only returned in GET response. Cannot be provided in POST/PUT request. If provided in POST, it will simply be ignored | [optional] -**fileInfos** | [**List<FileInfo>**](FileInfo.md) | A list of one or more files (or references to files) that will be used to create the widget. If more than one file is provided, they will be combined before the widget is created. Library documents are not permitted. Note: Only one of the four parameters in every FileInfo object must be specified | [optional] -**id** | **String** | A resource identifier that can be used to uniquely identify the widget in other apis. If provided in POST, it will simply be ignored | [optional] -**locale** | **String** | The locale associated with this widget - specifies the language for the signing page and emails, for example en_US or fr_FR. If none specified, defaults to the language configured for the widget creator | [optional] -**name** | **String** | The name of the widget that will be used to identify it, in emails, website and other places | [optional] -**securityOption** | [**SecurityOption**](SecurityOption.md) | Secondary security parameters for the widget | [optional] -**state** | [**StateEnum**](#StateEnum) | The state in which the widget should land. For example in order to create a widget in DRAFT state, field should be DRAFT. The state field will never get returned in GET /widgets/{ID} and will be ignored if provided in PUT /widgets/{ID} call. The eventual status of the widget can be obtained from GET /widgets/ID | [optional] -**status** | [**StatusEnum**](#StatusEnum) | Status of the Widget. If provided in POST, it will simply be ignored | [optional] +**additionalParticipantSetsInfo** | [**List<WidgetAdditionalParticipationSetInfo>**](WidgetAdditionalParticipationSetInfo.md) | List of all the participants in the web form except web form signer | [optional] +**creatorEmail** | **String** | Email of web form creator. Only returned in GET response. Cannot be provided in POST/PUT request. If provided in POST, it will simply be ignored | [optional] +**groupId** | **String** | The ID of the group to which the widget belongs to. If not provided during creation, primary group of the creator will be used | [optional] +**locale** | **String** | The locale associated with this web form - specifies the language for the signing page and emails, for example en_US or fr_FR. If none specified, defaults to the language configured for the web form creator | [optional] **vaultingInfo** | [**VaultingInfo**](VaultingInfo.md) | Vaulting properties that allows Adobe Sign to securely store documents with a vault provider | [optional] -**widgetInActiveInfo** | [**WidgetInActiveInfo**](WidgetInActiveInfo.md) | The custom message which will be displayed to the user or the URL to which user will be redirected when the widget is accessed in a disabled state. This can only be specified in PUT request | [optional] -**widgetParticipantSetInfo** | [**WidgetParticipantSetInfo**](WidgetParticipantSetInfo.md) | Represents widget participant for whom email should not be provided | [optional] +**securityOption** | [**SecurityOption**](SecurityOption.md) | Secondary security parameters for the web form | [optional] +**widgetParticipantSetInfo** | [**WidgetParticipantSetInfo**](WidgetParticipantSetInfo.md) | Represents web form participant for whom email should not be provided | [optional] +**widgetInActiveInfo** | [**WidgetInActiveInfo**](WidgetInActiveInfo.md) | The custom message which will be displayed to the user or the URL to which user will be redirected when the web form is accessed in a disabled state. This can only be specified in PUT request | [optional] +**ccs** | [**List<WidgetCcInfo>**](WidgetCcInfo.md) | A list of one or more email addresses that you want to copy on this transaction. The email addresses will each receive an email when the final agreement created through web form is signed. The email addresses will also receive a copy of the document, attached as a PDF file | [optional] +**createdDate** | [**Date**](Date.md) | Date when web form was created. If provided in POST, it will simply be ignored. Format would be yyyy-MM-dd'T'HH:mm:ssZ. For example, e.g 2016-02-25T18:46:19Z represents UTC time | [optional] +**isDocumentRetentionApplied** | **Boolean** | Is document retention applied for this resource. If provided in POST or PUT, it will simply be ignored. | [optional] +**lastEventDate** | [**Date**](Date.md) | The date of the last event that occurred for this web form. Format would be yyyy-MM-dd'T'HH:mm:ssZ. For example, e.g 2016-02-25T18:46:19Z represents UTC time | [optional] +**name** | **String** | The name of the web form that will be used to identify it, in emails, website and other places | [optional] +**completionInfo** | [**WidgetRedirectionInfo**](WidgetRedirectionInfo.md) | URL and associated properties for the success page the web form signer will be taken to after performing desired action on the web form | [optional] +**authFailureInfo** | [**WidgetRedirectionInfo**](WidgetRedirectionInfo.md) | URL and associated properties for the error page the web form signer will be taken after failing to authenticate | [optional] +**fileInfos** | [**List<FileInfo>**](FileInfo.md) | A list of one or more files (or references to files) that will be used to create the web form. If more than one file is provided, they will be combined before the web form is created. Library documents are not permitted. Note: Only one of the four parameters in every FileInfo object must be specified | [optional] +**id** | **String** | A resource identifier that can be used to uniquely identify the web form in other apis. If provided in POST, it will simply be ignored | [optional] +**state** | [**StateEnum**](#StateEnum) | The state in which the web form should land. For example in order to create a web form in DRAFT state, field should be DRAFT. The state field will never get returned in GET /widgets/{ID} and will be ignored if provided in PUT /widgets/{ID} call. The eventual status of the web form can be obtained from GET /widgets/ID | [optional] +**status** | [**StatusEnum**](#StatusEnum) | Status of the Web Form. If provided in POST, it will simply be ignored | [optional] diff --git a/docs/WidgetMembersInfo.md b/docs/WidgetMembersInfo.md index abb0421..98bba22 100755 --- a/docs/WidgetMembersInfo.md +++ b/docs/WidgetMembersInfo.md @@ -4,11 +4,11 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**additionalParticipantSets** | [**List<DetailedWidgetParticipantSetInfo>**](DetailedWidgetParticipantSetInfo.md) | Information about the widget additional participant Sets | [optional] -**ccsInfo** | [**List<CCParticipantInfo>**](CCParticipantInfo.md) | Information of CC participants of the widget. | [optional] -**creatorInfo** | [**SenderInfo**](SenderInfo.md) | Information of the creator of the widget. | [optional] -**sharesInfo** | [**List<ShareParticipantInfo>**](ShareParticipantInfo.md) | Information of the participants with whom the widget has been shared. | [optional] -**widgetParticipantSet** | [**DetailedWidgetParticipantSetInfo**](DetailedWidgetParticipantSetInfo.md) | Information about the widget participant Set | [optional] +**ccsInfo** | [**List<CCParticipantInfo>**](CCParticipantInfo.md) | Information of CC participants of the web form. | [optional] +**additionalParticipantSets** | [**List<DetailedWidgetParticipantSetInfo>**](DetailedWidgetParticipantSetInfo.md) | Information about the web form additional participant Sets | [optional] +**widgetParticipantSet** | [**DetailedWidgetParticipantSetInfo**](DetailedWidgetParticipantSetInfo.md) | Information about the web form participant Set | [optional] +**sharesInfo** | [**List<ShareParticipantInfo>**](ShareParticipantInfo.md) | Information of the participants with whom the web form has been shared. | [optional] +**creatorInfo** | [**SenderInfo**](SenderInfo.md) | Information of the creator of the web form. | [optional] diff --git a/docs/WidgetParticipantSetInfo.md b/docs/WidgetParticipantSetInfo.md index 8dd80c2..333b35a 100755 --- a/docs/WidgetParticipantSetInfo.md +++ b/docs/WidgetParticipantSetInfo.md @@ -4,8 +4,8 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**memberInfos** | [**List<ParticipantSetMemberInfo>**](ParticipantSetMemberInfo.md) | Array of ParticipantInfo objects, containing participant - specific data (email, e.g.). All participants in the array belong to the same set. Currently we are supporting only one member in the set. Since the email of the widget signer is unknown at the time of widget creation, the email should be left empty and its optional security options should be provided. | [optional] -**role** | [**RoleEnum**](#RoleEnum) | Role assumed by all participants in the set (signer, approver, etc.) Widget First Participant will only have roles - Signer, Approver, Acceptor and Form Filler | [optional] +**role** | [**RoleEnum**](#RoleEnum) | Role assumed by all participants in the set (signer, approver, etc.) Web Form First Participant will only have roles - Signer, Approver, Acceptor and Form Filler | [optional] +**memberInfos** | [**List<ParticipantSetMemberInfo>**](ParticipantSetMemberInfo.md) | Array of ParticipantInfo objects, containing participant - specific data (email, e.g.). All participants in the array belong to the same set. Currently we are supporting only one member in the set. Since the email of the web form signer is unknown at the time of web form creation, the email should be left empty and its optional security options should be provided. | [optional] diff --git a/docs/WidgetRedirectionInfo.md b/docs/WidgetRedirectionInfo.md index 6e55c91..6049570 100755 --- a/docs/WidgetRedirectionInfo.md +++ b/docs/WidgetRedirectionInfo.md @@ -4,9 +4,9 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**deframe** | **Boolean** | If deframe is false, the resultant page will be shown inside the widget frame. If deframe is true, the resultant page will be shown in the full browser window. Note that in the case of embedded widgets, browser security restrictions do not permit automatic redirection in the full browser window, so if deframe is true the user will instead just see a link to the success page. We recommend this scenario be avoided - in other words, setting deframe to false is recommended for embedded widgets | [optional] -**delay** | **Integer** | The delay (in seconds) before the user is taken to the resultant page. If this value is greater than 0, the user will first see the standard Adobe Sign result message, and then after a delay will be redirected to your resultant page. Note that this parameter has no effect for embedded widgets when deframe is true | [optional] -**url** | **String** | A publicly accessible url to which the user will be sent after successfully completing the widget. If the URL you provide includes information that allows you to identify the specific transaction, such as your own unique identifier, you can use the browser request to this URL as a callback to notify you that this transaction is completed. In addition, Adobe Sign will append a documentKey parameter to the URL which will contain the Adobe Sign DocumentKey for this signed widget, but only if the sender is the same as the API key user. Your application can use this value to get the form data for this widget | [optional] +**delay** | **Integer** | The delay (in seconds) before the user is taken to the resultant page. If this value is greater than 0, the user will first see the standard Adobe Sign result message, and then after a delay will be redirected to your resultant page. Note that this parameter has no effect for embedded web forms when deframe is true | [optional] +**deframe** | **Boolean** | If deframe is false, the resultant page will be shown inside the web form frame. If deframe is true, the resultant page will be shown in the full browser window. Note that in the case of embedded web forms, browser security restrictions do not permit automatic redirection in the full browser window, so if deframe is true the user will instead just see a link to the success page. We recommend this scenario be avoided - in other words, setting deframe to false is recommended for embedded web forms | [optional] +**url** | **String** | A publicly accessible url to which the user will be sent after successfully completing the web form. If the URL you provide includes information that allows you to identify the specific transaction, such as your own unique identifier, you can use the browser request to this URL as a callback to notify you that this transaction is completed. In addition, Adobe Sign will append a documentKey parameter to the URL which will contain the Adobe Sign DocumentKey for this signed web form, but only if the sender is the same as the API key user. Your application can use this value to get the form data for this web form | [optional] diff --git a/docs/WidgetStateInfo.md b/docs/WidgetStateInfo.md index 20ec940..c5c1cad 100755 --- a/docs/WidgetStateInfo.md +++ b/docs/WidgetStateInfo.md @@ -4,8 +4,8 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**state** | [**StateEnum**](#StateEnum) | State of the Widget | [optional] -**widgetInActiveInfo** | [**WidgetInActiveInfo**](WidgetInActiveInfo.md) | The custom message which will be displayed to the user or the URL to which user will be redirected when the widget is accessed in a disabled state. This can only be specified in PUT request | [optional] +**widgetInActiveInfo** | [**WidgetInActiveInfo**](WidgetInActiveInfo.md) | The custom message which will be displayed to the user or the URL to which user will be redirected when the web form is accessed in a disabled state. This can only be specified in PUT request | [optional] +**state** | [**StateEnum**](#StateEnum) | State of the Web Form | [optional] diff --git a/docs/WidgetView.md b/docs/WidgetView.md index 7f9c2ce..26ced9b 100755 --- a/docs/WidgetView.md +++ b/docs/WidgetView.md @@ -4,10 +4,10 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- +**isCurrent** | **Boolean** | True if this view is the current view | [optional] **embeddedCode** | **String** | Embedded code of url of resource | [optional] +**name** | [**NameEnum**](#NameEnum) | Name of the requested web form view | [optional] **expiration** | [**Date**](Date.md) | Expiration of user url | [optional] -**isCurrent** | **Boolean** | True if this view is the current view | [optional] -**name** | [**NameEnum**](#NameEnum) | Name of the requested widget view | [optional] **url** | **String** | Url of resource location | [optional] diff --git a/docs/WidgetViewInfo.md b/docs/WidgetViewInfo.md index 312a20f..61a9282 100755 --- a/docs/WidgetViewInfo.md +++ b/docs/WidgetViewInfo.md @@ -5,7 +5,8 @@ Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- **commonViewConfiguration** | [**CommonViewConfiguration**](CommonViewConfiguration.md) | Common view configuration for all the available views | [optional] -**name** | [**NameEnum**](#NameEnum) | Name of the requested widget view | [optional] +**name** | [**NameEnum**](#NameEnum) | Name of the requested web form view | [optional] +**personalizedSigningViewConfiguration** | [**PersonalizedSigningViewConfiguration**](PersonalizedSigningViewConfiguration.md) | Personalized SIGNING view configuration | [optional] diff --git a/docs/WidgetViews.md b/docs/WidgetViews.md index c722e9f..46d3b59 100755 --- a/docs/WidgetViews.md +++ b/docs/WidgetViews.md @@ -4,7 +4,7 @@ ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- -**widgetViewList** | [**List<WidgetView>**](WidgetView.md) | List of widget views | [optional] +**widgetViewList** | [**List<WidgetView>**](WidgetView.md) | List of web form views | [optional] diff --git a/docs/WidgetsApi.md b/docs/WidgetsApi.md index 01d7a4e..56e5394 100755 --- a/docs/WidgetsApi.md +++ b/docs/WidgetsApi.md @@ -1,38 +1,40 @@ # WidgetsApi -All URIs are relative to *http://localhost/api/rest/v6* +All URIs are relative to *https://secure.au1.echosign.com/api/rest/v6* Method | HTTP request | Description ------------- | ------------- | ------------- -[**createShareOnWidget**](WidgetsApi.md#createShareOnWidget) | **POST** /widgets/{widgetId}/members/share | Share a widget with someone. -[**createWidget**](WidgetsApi.md#createWidget) | **POST** /widgets | Creates a widget and and returns the widgetId in the response to the client. +[**createShareOnWidget**](WidgetsApi.md#createShareOnWidget) | **POST** /widgets/{widgetId}/members/share | Share a web form with someone. +[**createWidget**](WidgetsApi.md#createWidget) | **POST** /widgets | Creates a web form and and returns the widgetId in the response to the client. [**getAllWidgetMembers**](WidgetsApi.md#getAllWidgetMembers) | **GET** /widgets/{widgetId}/members | Retrieves detailed member info along with IDs for different types of participants. -[**getEvents**](WidgetsApi.md#getEvents) | **GET** /widgets/{widgetId}/events | Retrieves the events information for a widget. -[**getParticipantSet**](WidgetsApi.md#getParticipantSet) | **GET** /widgets/{widgetId}/members/participantSets/{participantSetId} | Retrieves the participant set of a widget identified by widgetId in the path. -[**getWidgetAgreements**](WidgetsApi.md#getWidgetAgreements) | **GET** /widgets/{widgetId}/agreements | Retrieves agreements for the widget. -[**getWidgetAllDocumentsImageUrls**](WidgetsApi.md#getWidgetAllDocumentsImageUrls) | **GET** /widgets/{widgetId}/documents/imageUrls | Retrieves image urls of all visible pages of a document associated with a widget. -[**getWidgetAuditTrail**](WidgetsApi.md#getWidgetAuditTrail) | **GET** /widgets/{widgetId}/auditTrail | Retrieves the audit trail of a widget identified by widgetId. -[**getWidgetCombinedDocument**](WidgetsApi.md#getWidgetCombinedDocument) | **GET** /widgets/{widgetId}/combinedDocument | Retrieves a single combined PDF document for the documents associated with a widget. -[**getWidgetDocumentInfo**](WidgetsApi.md#getWidgetDocumentInfo) | **GET** /widgets/{widgetId}/documents/{documentId} | Retrieves the file stream of a document of a widget. -[**getWidgetDocuments**](WidgetsApi.md#getWidgetDocuments) | **GET** /widgets/{widgetId}/documents | Retrieves the IDs of the documents associated with widget. -[**getWidgetFormData**](WidgetsApi.md#getWidgetFormData) | **GET** /widgets/{widgetId}/formData | Retrieves data entered by the user into interactive form fields at the time they signed the widget -[**getWidgetInfo**](WidgetsApi.md#getWidgetInfo) | **GET** /widgets/{widgetId} | Retrieves the details of a widget. -[**getWidgetNoteForApiUser**](WidgetsApi.md#getWidgetNoteForApiUser) | **GET** /widgets/{widgetId}/me/note | Retrieves the latest note of a widget for the API user. +[**getEvents**](WidgetsApi.md#getEvents) | **GET** /widgets/{widgetId}/events | Retrieves the events information for a web form. +[**getParticipantSet**](WidgetsApi.md#getParticipantSet) | **GET** /widgets/{widgetId}/members/participantSets/{participantSetId} | Retrieves the participant set of a web form identified by widgetId in the path. +[**getWidgetAgreements**](WidgetsApi.md#getWidgetAgreements) | **GET** /widgets/{widgetId}/agreements | Retrieves agreements for the web form. +[**getWidgetAllDocumentsImageUrls**](WidgetsApi.md#getWidgetAllDocumentsImageUrls) | **GET** /widgets/{widgetId}/documents/imageUrls | Retrieves image urls of all visible pages of a document associated with a web form. +[**getWidgetAuditTrail**](WidgetsApi.md#getWidgetAuditTrail) | **GET** /widgets/{widgetId}/auditTrail | Retrieves the audit trail of a web form identified by widgetId. +[**getWidgetCombinedDocument**](WidgetsApi.md#getWidgetCombinedDocument) | **GET** /widgets/{widgetId}/combinedDocument | Retrieves a single combined PDF document for the documents associated with a web form. +[**getWidgetCombinedDocumentUrl**](WidgetsApi.md#getWidgetCombinedDocumentUrl) | **GET** /widgets/{widgetId}/combinedDocument/url | Retrieves url of all visible pages of all the documents associated with a web form. +[**getWidgetDocumentInfo**](WidgetsApi.md#getWidgetDocumentInfo) | **GET** /widgets/{widgetId}/documents/{documentId} | Retrieves the file stream of a document of a web form. +[**getWidgetDocuments**](WidgetsApi.md#getWidgetDocuments) | **GET** /widgets/{widgetId}/documents | Retrieves the IDs of the documents associated with web form. +[**getWidgetFormData**](WidgetsApi.md#getWidgetFormData) | **GET** /widgets/{widgetId}/formData | Retrieves data entered by the user into interactive form fields at the time they signed the web form +[**getWidgetInfo**](WidgetsApi.md#getWidgetInfo) | **GET** /widgets/{widgetId} | Retrieves the details of a web form. +[**getWidgetInfoForUser**](WidgetsApi.md#getWidgetInfoForUser) | **GET** /widgets/{widgetId}/me | Retrieves the web form information related to the api caller +[**getWidgetNoteForApiUser**](WidgetsApi.md#getWidgetNoteForApiUser) | **GET** /widgets/{widgetId}/me/note | Retrieves the latest note of a web form for the API user. [**getWidgetSecurityOptionsForParticipation**](WidgetsApi.md#getWidgetSecurityOptionsForParticipation) | **GET** /widgets/{widgetId}/members/participantSets/{participantSetId}/participants/{participantId}/securityOptions | Retrieves the security options for a particular participant. -[**getWidgetView**](WidgetsApi.md#getWidgetView) | **POST** /widgets/{widgetId}/views | Retrieves the requested views for a widget. -[**getWidgets**](WidgetsApi.md#getWidgets) | **GET** /widgets | Retrieves widgets for a user. -[**updateWidget**](WidgetsApi.md#updateWidget) | **PUT** /widgets/{widgetId} | Updates a widget. -[**updateWidgetNoteForApiUser**](WidgetsApi.md#updateWidgetNoteForApiUser) | **PUT** /widgets/{widgetId}/me/note | Updates the latest note of a widget for the API user. +[**getWidgetView**](WidgetsApi.md#getWidgetView) | **POST** /widgets/{widgetId}/views | Retrieves the requested views for a web form. +[**getWidgets**](WidgetsApi.md#getWidgets) | **GET** /widgets | Retrieves web forms for a user. +[**updateWidget**](WidgetsApi.md#updateWidget) | **PUT** /widgets/{widgetId} | Updates a web form. +[**updateWidgetNoteForApiUser**](WidgetsApi.md#updateWidgetNoteForApiUser) | **PUT** /widgets/{widgetId}/me/note | Updates the latest note of a web form for the API user. [**updateWidgetSecurityOptionsForParticipation**](WidgetsApi.md#updateWidgetSecurityOptionsForParticipation) | **PUT** /widgets/{widgetId}/members/participantSets/{participantSetId}/participants/{participantId}/securityOptions | Updates the security options for a particular participant. -[**updateWidgetState**](WidgetsApi.md#updateWidgetState) | **PUT** /widgets/{widgetId}/state | Updates the state of a widget identified by widgetId in the path. -[**updateWidgetVisibility**](WidgetsApi.md#updateWidgetVisibility) | **PUT** /widgets/{widgetId}/me/visibility | Updates the visibility of widget. +[**updateWidgetState**](WidgetsApi.md#updateWidgetState) | **PUT** /widgets/{widgetId}/state | Updates the state of a web form identified by widgetId in the path. +[**updateWidgetVisibility**](WidgetsApi.md#updateWidgetVisibility) | **PUT** /widgets/{widgetId}/me/visibility | Updates the visibility of web form. # **createShareOnWidget** > ShareCreationResponseList createShareOnWidget(authorization, widgetId, shareCreationInfoList, xApiUser, xOnBehalfOfUser) -Share a widget with someone. +Share a web form with someone. ### Example ```java @@ -43,7 +45,7 @@ Share a widget with someone. WidgetsApi apiInstance = new WidgetsApi(); String authorization = "authorization_example"; // String | An OAuth Access Token with scopes:in the format 'Bearer {accessToken}'. -String widgetId = "widgetId_example"; // String | The widget identifier, as returned by the widget creation API or retrieved from the API to fetch widgets. +String widgetId = "widgetId_example"; // String | The web form identifier, as returned by the web form creation API or retrieved from the API to fetch web forms. ShareCreationInfoList shareCreationInfoList = new ShareCreationInfoList(); // ShareCreationInfoList | List of agreement share creation information objects. String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or email in the format userid:{userId} OR email:{email}. of the user that has shared his/her account @@ -61,7 +63,7 @@ try { Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **authorization** | **String**| An <a href=\"#\" onclick=\"this.href=oauthDoc()\" oncontextmenu=\"this.href=oauthDoc()\" target=\"oauthDoc\">OAuth Access Token</a> with scopes:<ul><li style='list-style-type: square'><a href=\"#\" onclick=\"this.href=oauthDoc('widget_write')\" oncontextmenu=\"this.href=oauthDoc('widget_write')\" target=\"oauthDoc\">widget_write</a></li></ul>in the format <b>'Bearer {accessToken}'. | - **widgetId** | **String**| The widget identifier, as returned by the widget creation API or retrieved from the API to fetch widgets. | + **widgetId** | **String**| The web form identifier, as returned by the web form creation API or retrieved from the API to fetch web forms. | **shareCreationInfoList** | [**ShareCreationInfoList**](ShareCreationInfoList.md)| List of agreement share creation information objects. | **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] **xOnBehalfOfUser** | **String**| The userId or email in the format <b>userid:{userId} OR email:{email}.</b> of the user that has shared his/her account | [optional] @@ -83,9 +85,9 @@ No authorization required # **createWidget** > WidgetCreationResponse createWidget(authorization, widgetInfo, xApiUser, xOnBehalfOfUser) -Creates a widget and and returns the widgetId in the response to the client. +Creates a web form and and returns the widgetId in the response to the client. -This is a primary endpoint which is used to create a new widget. You can create a widget in one of the 3 mentioned states: a) <b>DRAFT</b> - to incrementally build the widget, b) <b>AUTHORING</b> - to add/edit form fields in the widget, c) <b>ACTIVE</b> - to immediately host the widget. You can use the PUT /widgets/{widgetId}/state endpoint to transition a widget between the above mentioned states. An allowed transition would follow the any of the following sequences: DRAFT->AUTHORING->ACTIVE, ACTIVE<->INACTIVE, DRAFT->CANCELLED. +This is a primary endpoint which is used to create a new web form. You can create a web form in one of the 3 mentioned states: a) <b>DRAFT</b> - to incrementally build the web form, b) <b>AUTHORING</b> - to add/edit form fields in the web form, c) <b>ACTIVE</b> - to immediately host the web form. You can use the PUT /widgets/{widgetId}/state endpoint to transition a web form between the above mentioned states. An allowed transition would follow the any of the following sequences: DRAFT->AUTHORING->ACTIVE, ACTIVE<->INACTIVE, DRAFT->CANCELLED. ### Example ```java @@ -96,7 +98,7 @@ This is a primary endpoint which is used to create a new widget. You can create WidgetsApi apiInstance = new WidgetsApi(); String authorization = "authorization_example"; // String | An OAuth Access Token with scopes:in the format 'Bearer {accessToken}'. -WidgetCreationInfoV6 widgetInfo = new WidgetCreationInfoV6(); // WidgetCreationInfoV6 | Information about the widget that you want to create. +WidgetCreationInfoV6 widgetInfo = new WidgetCreationInfoV6(); // WidgetCreationInfoV6 | Information about the web form that you want to create. String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or email in the format userid:{userId} OR email:{email}. of the user that has shared his/her account try { @@ -113,7 +115,7 @@ try { Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **authorization** | **String**| An <a href=\"#\" onclick=\"this.href=oauthDoc()\" oncontextmenu=\"this.href=oauthDoc()\" target=\"oauthDoc\">OAuth Access Token</a> with scopes:<ul><li style='list-style-type: square'><a href=\"#\" onclick=\"this.href=oauthDoc('widget_write')\" oncontextmenu=\"this.href=oauthDoc('widget_write')\" target=\"oauthDoc\">widget_write</a></li></ul>in the format <b>'Bearer {accessToken}'. | - **widgetInfo** | [**WidgetCreationInfoV6**](WidgetCreationInfoV6.md)| Information about the widget that you want to create. | + **widgetInfo** | [**WidgetCreationInfoV6**](WidgetCreationInfoV6.md)| Information about the web form that you want to create. | **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] **xOnBehalfOfUser** | **String**| The userId or email in the format <b>userid:{userId} OR email:{email}.</b> of the user that has shared his/her account | [optional] @@ -145,7 +147,7 @@ Retrieves detailed member info along with IDs for different types of participant WidgetsApi apiInstance = new WidgetsApi(); String authorization = "authorization_example"; // String | An OAuth Access Token with scopes:in the format 'Bearer {accessToken}'. -String widgetId = "widgetId_example"; // String | The widget identifier, as returned by the widget creation API or retrieved from the API to fetch widgets. +String widgetId = "widgetId_example"; // String | The web form identifier, as returned by the web form creation API or retrieved from the API to fetch web forms. String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or email in the format userid:{userId} OR email:{email}. of the user that has shared his/her account String ifNoneMatch = "ifNoneMatch_example"; // String | Pass the value of the e-tag header obtained from the previous response to the same request to get a RESOURCE_NOT_MODIFIED(304) if the resource hasn't changed. @@ -163,7 +165,7 @@ try { Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **authorization** | **String**| An <a href=\"#\" onclick=\"this.href=oauthDoc()\" oncontextmenu=\"this.href=oauthDoc()\" target=\"oauthDoc\">OAuth Access Token</a> with scopes:<ul><li style='list-style-type: square'><a href=\"#\" onclick=\"this.href=oauthDoc('widget_read')\" oncontextmenu=\"this.href=oauthDoc('widget_read')\" target=\"oauthDoc\">widget_read</a></li></ul>in the format <b>'Bearer {accessToken}'. | - **widgetId** | **String**| The widget identifier, as returned by the widget creation API or retrieved from the API to fetch widgets. | + **widgetId** | **String**| The web form identifier, as returned by the web form creation API or retrieved from the API to fetch web forms. | **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] **xOnBehalfOfUser** | **String**| The userId or email in the format <b>userid:{userId} OR email:{email}.</b> of the user that has shared his/her account | [optional] **ifNoneMatch** | **String**| Pass the value of the e-tag header obtained from the previous response to the same request to get a RESOURCE_NOT_MODIFIED(304) if the resource hasn't changed. | [optional] @@ -185,7 +187,7 @@ No authorization required # **getEvents** > WidgetEventList getEvents(authorization, widgetId, xApiUser, xOnBehalfOfUser, ifNoneMatch) -Retrieves the events information for a widget. +Retrieves the events information for a web form. ### Example ```java @@ -196,7 +198,7 @@ Retrieves the events information for a widget. WidgetsApi apiInstance = new WidgetsApi(); String authorization = "authorization_example"; // String | An OAuth Access Token with scopes:in the format 'Bearer {accessToken}'. -String widgetId = "widgetId_example"; // String | The widget identifier, as returned by the widget creation API or retrieved from the API to fetch widgets. +String widgetId = "widgetId_example"; // String | The web form identifier, as returned by the web form creation API or retrieved from the API to fetch web forms. String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or email in the format userid:{userId} OR email:{email}. of the user that has shared his/her account String ifNoneMatch = "ifNoneMatch_example"; // String | Pass the value of the e-tag header obtained from the previous response to the same request to get a RESOURCE_NOT_MODIFIED(304) if the resource hasn't changed. @@ -214,7 +216,7 @@ try { Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **authorization** | **String**| An <a href=\"#\" onclick=\"this.href=oauthDoc()\" oncontextmenu=\"this.href=oauthDoc()\" target=\"oauthDoc\">OAuth Access Token</a> with scopes:<ul><li style='list-style-type: square'><a href=\"#\" onclick=\"this.href=oauthDoc('widget_read')\" oncontextmenu=\"this.href=oauthDoc('widget_read')\" target=\"oauthDoc\">widget_read</a></li></ul>in the format <b>'Bearer {accessToken}'. | - **widgetId** | **String**| The widget identifier, as returned by the widget creation API or retrieved from the API to fetch widgets. | + **widgetId** | **String**| The web form identifier, as returned by the web form creation API or retrieved from the API to fetch web forms. | **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] **xOnBehalfOfUser** | **String**| The userId or email in the format <b>userid:{userId} OR email:{email}.</b> of the user that has shared his/her account | [optional] **ifNoneMatch** | **String**| Pass the value of the e-tag header obtained from the previous response to the same request to get a RESOURCE_NOT_MODIFIED(304) if the resource hasn't changed. | [optional] @@ -236,7 +238,7 @@ No authorization required # **getParticipantSet** > DetailedWidgetParticipantSetInfo getParticipantSet(authorization, widgetId, participantSetId, xApiUser, xOnBehalfOfUser, ifNoneMatch) -Retrieves the participant set of a widget identified by widgetId in the path. +Retrieves the participant set of a web form identified by widgetId in the path. ### Example ```java @@ -247,7 +249,7 @@ Retrieves the participant set of a widget identified by widgetId in the path. WidgetsApi apiInstance = new WidgetsApi(); String authorization = "authorization_example"; // String | An OAuth Access Token with scopes:in the format 'Bearer {accessToken}'. -String widgetId = "widgetId_example"; // String | The widget identifier, as returned by the widget creation API or retrieved from the API to fetch widgets. +String widgetId = "widgetId_example"; // String | The web form identifier, as returned by the web form creation API or retrieved from the API to fetch web forms. String participantSetId = "participantSetId_example"; // String | The participant set identifier String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or email in the format userid:{userId} OR email:{email}. of the user that has shared his/her account @@ -266,7 +268,7 @@ try { Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **authorization** | **String**| An <a href=\"#\" onclick=\"this.href=oauthDoc()\" oncontextmenu=\"this.href=oauthDoc()\" target=\"oauthDoc\">OAuth Access Token</a> with scopes:<ul><li style='list-style-type: square'><a href=\"#\" onclick=\"this.href=oauthDoc('widget_read')\" oncontextmenu=\"this.href=oauthDoc('widget_read')\" target=\"oauthDoc\">widget_read</a></li></ul>in the format <b>'Bearer {accessToken}'. | - **widgetId** | **String**| The widget identifier, as returned by the widget creation API or retrieved from the API to fetch widgets. | + **widgetId** | **String**| The web form identifier, as returned by the web form creation API or retrieved from the API to fetch web forms. | **participantSetId** | **String**| The participant set identifier | **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] **xOnBehalfOfUser** | **String**| The userId or email in the format <b>userid:{userId} OR email:{email}.</b> of the user that has shared his/her account | [optional] @@ -289,7 +291,7 @@ No authorization required # **getWidgetAgreements** > WidgetAgreements getWidgetAgreements(authorization, widgetId, xApiUser, xOnBehalfOfUser, showHiddenAgreements, cursor, pageSize) -Retrieves agreements for the widget. +Retrieves agreements for the web form. ### Example ```java @@ -300,7 +302,7 @@ Retrieves agreements for the widget. WidgetsApi apiInstance = new WidgetsApi(); String authorization = "authorization_example"; // String | An OAuth Access Token with scopes:in the format 'Bearer {accessToken}'. -String widgetId = "widgetId_example"; // String | The widget identifier, as returned by the widget creation API or retrieved from the API to fetch widgets. +String widgetId = "widgetId_example"; // String | The web form identifier, as returned by the web form creation API or retrieved from the API to fetch web forms. String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or email in the format userid:{userId} OR email:{email}. of the user that has shared his/her account Boolean showHiddenAgreements = true; // Boolean | A query parameter to fetch all the hidden agreements along with the visible agreements. Default value is false. @@ -320,7 +322,7 @@ try { Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **authorization** | **String**| An <a href=\"#\" onclick=\"this.href=oauthDoc()\" oncontextmenu=\"this.href=oauthDoc()\" target=\"oauthDoc\">OAuth Access Token</a> with scopes:<ul><li style='list-style-type: square'><a href=\"#\" onclick=\"this.href=oauthDoc('widget_read')\" oncontextmenu=\"this.href=oauthDoc('widget_read')\" target=\"oauthDoc\">widget_read</a></li></ul>in the format <b>'Bearer {accessToken}'. | - **widgetId** | **String**| The widget identifier, as returned by the widget creation API or retrieved from the API to fetch widgets. | + **widgetId** | **String**| The web form identifier, as returned by the web form creation API or retrieved from the API to fetch web forms. | **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] **xOnBehalfOfUser** | **String**| The userId or email in the format <b>userid:{userId} OR email:{email}.</b> of the user that has shared his/her account | [optional] **showHiddenAgreements** | **Boolean**| A query parameter to fetch all the hidden agreements along with the visible agreements. Default value is false. | [optional] @@ -342,9 +344,9 @@ No authorization required # **getWidgetAllDocumentsImageUrls** -> WidgetDocumentsImageUrlsInfo getWidgetAllDocumentsImageUrls(authorization, widgetId, xApiUser, xOnBehalfOfUser, ifNoneMatch, imageSizes, showImageAvailabilityOnly) +> BasicDocumentsImageUrlsInfo getWidgetAllDocumentsImageUrls(authorization, widgetId, xApiUser, xOnBehalfOfUser, imageSizes, showImageAvailabilityOnly) -Retrieves image urls of all visible pages of a document associated with a widget. +Retrieves image urls of all visible pages of a document associated with a web form. ### Example ```java @@ -355,14 +357,13 @@ Retrieves image urls of all visible pages of a document associated with a widget WidgetsApi apiInstance = new WidgetsApi(); String authorization = "authorization_example"; // String | An OAuth Access Token with scopes:in the format 'Bearer {accessToken}'. -String widgetId = "widgetId_example"; // String | The widget identifier, as returned by the widget creation API or retrieved from the API to fetch widgets. +String widgetId = "widgetId_example"; // String | The web form identifier, as returned by the web form creation API or retrieved from the API to fetch web forms. String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or email in the format userid:{userId} OR email:{email}. of the user that has shared his/her account -String ifNoneMatch = "ifNoneMatch_example"; // String | Pass the value of the e-tag header obtained from the previous response to the same request to get a RESOURCE_NOT_MODIFIED(304) if the resource hasn't changed. String imageSizes = "imageSizes_example"; // String | A comma separated list of image sizes i.e. {FIXED_WIDTH_50px, FIXED_WIDTH_250px, FIXED_WIDTH_675px, ZOOM_50_PERCENT, ZOOM_75_PERCENT, ZOOM_100_PERCENT, ZOOM_125_PERCENT, ZOOM_150_PERCENT, ZOOM_200_PERCENT}. Default sizes returned are {FIXED_WIDTH_50px, FIXED_WIDTH_250px, FIXED_WIDTH_675px, ZOOM_100_PERCENT}. Boolean showImageAvailabilityOnly = true; // Boolean | When set to true, returns only image availability. Else, returns both image urls and its availability. try { - WidgetDocumentsImageUrlsInfo result = apiInstance.getWidgetAllDocumentsImageUrls(authorization, widgetId, xApiUser, xOnBehalfOfUser, ifNoneMatch, imageSizes, showImageAvailabilityOnly); + BasicDocumentsImageUrlsInfo result = apiInstance.getWidgetAllDocumentsImageUrls(authorization, widgetId, xApiUser, xOnBehalfOfUser, imageSizes, showImageAvailabilityOnly); System.out.println(result); } catch (ApiException e) { System.err.println("Exception when calling WidgetsApi#getWidgetAllDocumentsImageUrls"); @@ -375,16 +376,15 @@ try { Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **authorization** | **String**| An <a href=\"#\" onclick=\"this.href=oauthDoc()\" oncontextmenu=\"this.href=oauthDoc()\" target=\"oauthDoc\">OAuth Access Token</a> with scopes:<ul><li style='list-style-type: square'><a href=\"#\" onclick=\"this.href=oauthDoc('widget_read')\" oncontextmenu=\"this.href=oauthDoc('widget_read')\" target=\"oauthDoc\">widget_read</a></li></ul>in the format <b>'Bearer {accessToken}'. | - **widgetId** | **String**| The widget identifier, as returned by the widget creation API or retrieved from the API to fetch widgets. | + **widgetId** | **String**| The web form identifier, as returned by the web form creation API or retrieved from the API to fetch web forms. | **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] **xOnBehalfOfUser** | **String**| The userId or email in the format <b>userid:{userId} OR email:{email}.</b> of the user that has shared his/her account | [optional] - **ifNoneMatch** | **String**| Pass the value of the e-tag header obtained from the previous response to the same request to get a RESOURCE_NOT_MODIFIED(304) if the resource hasn't changed. | [optional] **imageSizes** | **String**| A comma separated list of image sizes i.e. {FIXED_WIDTH_50px, FIXED_WIDTH_250px, FIXED_WIDTH_675px, ZOOM_50_PERCENT, ZOOM_75_PERCENT, ZOOM_100_PERCENT, ZOOM_125_PERCENT, ZOOM_150_PERCENT, ZOOM_200_PERCENT}. Default sizes returned are {FIXED_WIDTH_50px, FIXED_WIDTH_250px, FIXED_WIDTH_675px, ZOOM_100_PERCENT}. | [optional] **showImageAvailabilityOnly** | **Boolean**| When set to true, returns only image availability. Else, returns both image urls and its availability. | [optional] ### Return type -[**WidgetDocumentsImageUrlsInfo**](WidgetDocumentsImageUrlsInfo.md) +[**BasicDocumentsImageUrlsInfo**](BasicDocumentsImageUrlsInfo.md) ### Authorization @@ -399,7 +399,7 @@ No authorization required # **getWidgetAuditTrail** > byte[] getWidgetAuditTrail(authorization, widgetId, xApiUser, xOnBehalfOfUser, ifNoneMatch) -Retrieves the audit trail of a widget identified by widgetId. +Retrieves the audit trail of a web form identified by widgetId. ### Example ```java @@ -410,7 +410,7 @@ Retrieves the audit trail of a widget identified by widgetId. WidgetsApi apiInstance = new WidgetsApi(); String authorization = "authorization_example"; // String | An OAuth Access Token with scopes:in the format 'Bearer {accessToken}'. -String widgetId = "widgetId_example"; // String | The widget identifier, as returned by the widget creation API or retrieved from the API to fetch widgets. +String widgetId = "widgetId_example"; // String | The web form identifier, as returned by the web form creation API or retrieved from the API to fetch web forms. String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or email in the format userid:{userId} OR email:{email}. of the user that has shared his/her account String ifNoneMatch = "ifNoneMatch_example"; // String | Pass the value of the e-tag header obtained from the previous response to the same request to get a RESOURCE_NOT_MODIFIED(304) if the resource hasn't changed. @@ -428,7 +428,7 @@ try { Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **authorization** | **String**| An <a href=\"#\" onclick=\"this.href=oauthDoc()\" oncontextmenu=\"this.href=oauthDoc()\" target=\"oauthDoc\">OAuth Access Token</a> with scopes:<ul><li style='list-style-type: square'><a href=\"#\" onclick=\"this.href=oauthDoc('widget_read')\" oncontextmenu=\"this.href=oauthDoc('widget_read')\" target=\"oauthDoc\">widget_read</a></li></ul>in the format <b>'Bearer {accessToken}'. | - **widgetId** | **String**| The widget identifier, as returned by the widget creation API or retrieved from the API to fetch widgets. | + **widgetId** | **String**| The web form identifier, as returned by the web form creation API or retrieved from the API to fetch web forms. | **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] **xOnBehalfOfUser** | **String**| The userId or email in the format <b>userid:{userId} OR email:{email}.</b> of the user that has shared his/her account | [optional] **ifNoneMatch** | **String**| Pass the value of the e-tag header obtained from the previous response to the same request to get a RESOURCE_NOT_MODIFIED(304) if the resource hasn't changed. | [optional] @@ -450,7 +450,7 @@ No authorization required # **getWidgetCombinedDocument** > byte[] getWidgetCombinedDocument(authorization, widgetId, xApiUser, xOnBehalfOfUser, ifNoneMatch, versionId, participantId, attachAuditReport) -Retrieves a single combined PDF document for the documents associated with a widget. +Retrieves a single combined PDF document for the documents associated with a web form. ### Example ```java @@ -461,13 +461,13 @@ Retrieves a single combined PDF document for the documents associated with a wid WidgetsApi apiInstance = new WidgetsApi(); String authorization = "authorization_example"; // String | An OAuth Access Token with scopes:in the format 'Bearer {accessToken}'. -String widgetId = "widgetId_example"; // String | The widget identifier, as returned by the widget creation API or retrieved from the API to fetch widgets. +String widgetId = "widgetId_example"; // String | The web form identifier, as returned by the web form creation API or retrieved from the API to fetch web forms. String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or email in the format userid:{userId} OR email:{email}. of the user that has shared his/her account String ifNoneMatch = "ifNoneMatch_example"; // String | Pass the value of the e-tag header obtained from the previous response to the same request to get a RESOURCE_NOT_MODIFIED(304) if the resource hasn't changed. -String versionId = "versionId_example"; // String | The version identifier of widget as provided by the API which retrieves information of a specific widget. If not provided then latest version will be used. +String versionId = "versionId_example"; // String | The version identifier of web form as provided by the API which retrieves information of a specific web form. If not provided then latest version will be used. String participantId = "participantId_example"; // String | The ID of the participant to be used to retrieve documents. If not mentioned, the participation of api caller is used. -Boolean attachAuditReport = true; // Boolean | When set to YES, attach an audit report to the signed Widget PDF. Default value is false +Boolean attachAuditReport = true; // Boolean | When set to YES, attach an audit report to the signed Web Form PDF. Default value is false try { byte[] result = apiInstance.getWidgetCombinedDocument(authorization, widgetId, xApiUser, xOnBehalfOfUser, ifNoneMatch, versionId, participantId, attachAuditReport); System.out.println(result); @@ -482,13 +482,13 @@ try { Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **authorization** | **String**| An <a href=\"#\" onclick=\"this.href=oauthDoc()\" oncontextmenu=\"this.href=oauthDoc()\" target=\"oauthDoc\">OAuth Access Token</a> with scopes:<ul><li style='list-style-type: square'><a href=\"#\" onclick=\"this.href=oauthDoc('widget_read')\" oncontextmenu=\"this.href=oauthDoc('widget_read')\" target=\"oauthDoc\">widget_read</a></li></ul>in the format <b>'Bearer {accessToken}'. | - **widgetId** | **String**| The widget identifier, as returned by the widget creation API or retrieved from the API to fetch widgets. | + **widgetId** | **String**| The web form identifier, as returned by the web form creation API or retrieved from the API to fetch web forms. | **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] **xOnBehalfOfUser** | **String**| The userId or email in the format <b>userid:{userId} OR email:{email}.</b> of the user that has shared his/her account | [optional] **ifNoneMatch** | **String**| Pass the value of the e-tag header obtained from the previous response to the same request to get a RESOURCE_NOT_MODIFIED(304) if the resource hasn't changed. | [optional] - **versionId** | **String**| The version identifier of widget as provided by the API which retrieves information of a specific widget. If not provided then latest version will be used. | [optional] + **versionId** | **String**| The version identifier of web form as provided by the API which retrieves information of a specific web form. If not provided then latest version will be used. | [optional] **participantId** | **String**| The ID of the participant to be used to retrieve documents. If not mentioned, the participation of api caller is used. | [optional] - **attachAuditReport** | **Boolean**| When set to YES, attach an audit report to the signed Widget PDF. Default value is false | [optional] + **attachAuditReport** | **Boolean**| When set to YES, attach an audit report to the signed Web Form PDF. Default value is false | [optional] ### Return type @@ -503,11 +503,62 @@ No authorization required - **Content-Type**: Not defined - **Accept**: application/pdf, application/pdf;encoding=base64 + +# **getWidgetCombinedDocumentUrl** +> DocumentUrl getWidgetCombinedDocumentUrl(authorization, widgetId, xApiUser, xOnBehalfOfUser, attachAuditReport) + +Retrieves url of all visible pages of all the documents associated with a web form. + +### Example +```java +// Import classes: +//import io.swagger.client.model.ApiException; +//import io.swagger.client.api.WidgetsApi; + + +WidgetsApi apiInstance = new WidgetsApi(); +String authorization = "authorization_example"; // String | An OAuth Access Token with scopes:in the format 'Bearer {accessToken}'. +String widgetId = "widgetId_example"; // String | The web form identifier, as returned by the web form creation API or retrieved from the API to fetch web forms. +String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. +String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or email in the format userid:{userId} OR email:{email}. of the user that has shared his/her account +Boolean attachAuditReport = true; // Boolean | When set to true, attach an audit report to the web form PDF. The default value is false. +try { + DocumentUrl result = apiInstance.getWidgetCombinedDocumentUrl(authorization, widgetId, xApiUser, xOnBehalfOfUser, attachAuditReport); + System.out.println(result); +} catch (ApiException e) { + System.err.println("Exception when calling WidgetsApi#getWidgetCombinedDocumentUrl"); + e.printStackTrace(); +} +``` + +### Parameters + +Name | Type | Description | Notes +------------- | ------------- | ------------- | ------------- + **authorization** | **String**| An <a href=\"#\" onclick=\"this.href=oauthDoc()\" oncontextmenu=\"this.href=oauthDoc()\" target=\"oauthDoc\">OAuth Access Token</a> with scopes:<ul><li style='list-style-type: square'><a href=\"#\" onclick=\"this.href=oauthDoc('widget_read')\" oncontextmenu=\"this.href=oauthDoc('widget_read')\" target=\"oauthDoc\">widget_read</a></li></ul>in the format <b>'Bearer {accessToken}'. | + **widgetId** | **String**| The web form identifier, as returned by the web form creation API or retrieved from the API to fetch web forms. | + **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] + **xOnBehalfOfUser** | **String**| The userId or email in the format <b>userid:{userId} OR email:{email}.</b> of the user that has shared his/her account | [optional] + **attachAuditReport** | **Boolean**| When set to true, attach an audit report to the web form PDF. The default value is false. | [optional] + +### Return type + +[**DocumentUrl**](DocumentUrl.md) + +### Authorization + +No authorization required + +### HTTP request headers + + - **Content-Type**: Not defined + - **Accept**: application/json + # **getWidgetDocumentInfo** > byte[] getWidgetDocumentInfo(authorization, widgetId, documentId, xApiUser, xOnBehalfOfUser, ifNoneMatch) -Retrieves the file stream of a document of a widget. +Retrieves the file stream of a document of a web form. ### Example ```java @@ -518,8 +569,8 @@ Retrieves the file stream of a document of a widget. WidgetsApi apiInstance = new WidgetsApi(); String authorization = "authorization_example"; // String | An OAuth Access Token with scopes:in the format 'Bearer {accessToken}'. -String widgetId = "widgetId_example"; // String | The widget identifier, as returned by the widget creation API or retrieved from the API to fetch widgets. -String documentId = "documentId_example"; // String | The document identifier, as retrieved from the API which fetches the documents of a specified widget +String widgetId = "widgetId_example"; // String | The web form identifier, as returned by the web form creation API or retrieved from the API to fetch web forms. +String documentId = "documentId_example"; // String | The document identifier, as retrieved from the API which fetches the documents of a specified web form String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or email in the format userid:{userId} OR email:{email}. of the user that has shared his/her account String ifNoneMatch = "ifNoneMatch_example"; // String | Pass the value of the e-tag header obtained from the previous response to the same request to get a RESOURCE_NOT_MODIFIED(304) if the resource hasn't changed. @@ -537,8 +588,8 @@ try { Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **authorization** | **String**| An <a href=\"#\" onclick=\"this.href=oauthDoc()\" oncontextmenu=\"this.href=oauthDoc()\" target=\"oauthDoc\">OAuth Access Token</a> with scopes:<ul><li style='list-style-type: square'><a href=\"#\" onclick=\"this.href=oauthDoc('widget_read')\" oncontextmenu=\"this.href=oauthDoc('widget_read')\" target=\"oauthDoc\">widget_read</a></li></ul>in the format <b>'Bearer {accessToken}'. | - **widgetId** | **String**| The widget identifier, as returned by the widget creation API or retrieved from the API to fetch widgets. | - **documentId** | **String**| The document identifier, as retrieved from the API which fetches the documents of a specified widget | + **widgetId** | **String**| The web form identifier, as returned by the web form creation API or retrieved from the API to fetch web forms. | + **documentId** | **String**| The document identifier, as retrieved from the API which fetches the documents of a specified web form | **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] **xOnBehalfOfUser** | **String**| The userId or email in the format <b>userid:{userId} OR email:{email}.</b> of the user that has shared his/her account | [optional] **ifNoneMatch** | **String**| Pass the value of the e-tag header obtained from the previous response to the same request to get a RESOURCE_NOT_MODIFIED(304) if the resource hasn't changed. | [optional] @@ -560,7 +611,7 @@ No authorization required # **getWidgetDocuments** > WidgetDocuments getWidgetDocuments(authorization, widgetId, xApiUser, xOnBehalfOfUser, ifNoneMatch, versionId, participantId) -Retrieves the IDs of the documents associated with widget. +Retrieves the IDs of the documents associated with web form. ### Example ```java @@ -571,11 +622,11 @@ Retrieves the IDs of the documents associated with widget. WidgetsApi apiInstance = new WidgetsApi(); String authorization = "authorization_example"; // String | An OAuth Access Token with scopes:in the format 'Bearer {accessToken}'. -String widgetId = "widgetId_example"; // String | The widget identifier, as returned by the widget creation API or retrieved from the API to fetch widgets. +String widgetId = "widgetId_example"; // String | The web form identifier, as returned by the web form creation API or retrieved from the API to fetch web forms. String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or email in the format userid:{userId} OR email:{email}. of the user that has shared his/her account String ifNoneMatch = "ifNoneMatch_example"; // String | Pass the value of the e-tag header obtained from the previous response to the same request to get a RESOURCE_NOT_MODIFIED(304) if the resource hasn't changed. -String versionId = "versionId_example"; // String | The version identifier of widget as provided by the API which retrieves information of a specific widget. If not provided then latest version will be used. +String versionId = "versionId_example"; // String | The version identifier of web form as provided by the API which retrieves information of a specific web form. If not provided then latest version will be used. String participantId = "participantId_example"; // String | The ID of the participant to be used to retrieve documents. If not mentioned, the participation of api caller is used. try { WidgetDocuments result = apiInstance.getWidgetDocuments(authorization, widgetId, xApiUser, xOnBehalfOfUser, ifNoneMatch, versionId, participantId); @@ -591,11 +642,11 @@ try { Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **authorization** | **String**| An <a href=\"#\" onclick=\"this.href=oauthDoc()\" oncontextmenu=\"this.href=oauthDoc()\" target=\"oauthDoc\">OAuth Access Token</a> with scopes:<ul><li style='list-style-type: square'><a href=\"#\" onclick=\"this.href=oauthDoc('widget_read')\" oncontextmenu=\"this.href=oauthDoc('widget_read')\" target=\"oauthDoc\">widget_read</a></li></ul>in the format <b>'Bearer {accessToken}'. | - **widgetId** | **String**| The widget identifier, as returned by the widget creation API or retrieved from the API to fetch widgets. | + **widgetId** | **String**| The web form identifier, as returned by the web form creation API or retrieved from the API to fetch web forms. | **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] **xOnBehalfOfUser** | **String**| The userId or email in the format <b>userid:{userId} OR email:{email}.</b> of the user that has shared his/her account | [optional] **ifNoneMatch** | **String**| Pass the value of the e-tag header obtained from the previous response to the same request to get a RESOURCE_NOT_MODIFIED(304) if the resource hasn't changed. | [optional] - **versionId** | **String**| The version identifier of widget as provided by the API which retrieves information of a specific widget. If not provided then latest version will be used. | [optional] + **versionId** | **String**| The version identifier of web form as provided by the API which retrieves information of a specific web form. If not provided then latest version will be used. | [optional] **participantId** | **String**| The ID of the participant to be used to retrieve documents. If not mentioned, the participation of api caller is used. | [optional] ### Return type @@ -615,7 +666,7 @@ No authorization required # **getWidgetFormData** > byte[] getWidgetFormData(authorization, widgetId, xApiUser, xOnBehalfOfUser) -Retrieves data entered by the user into interactive form fields at the time they signed the widget +Retrieves data entered by the user into interactive form fields at the time they signed the web form CSV file stream containing form data information @@ -628,7 +679,7 @@ CSV file stream containing form data information WidgetsApi apiInstance = new WidgetsApi(); String authorization = "authorization_example"; // String | An OAuth Access Token with scopes:in the format 'Bearer {accessToken}'. -String widgetId = "widgetId_example"; // String | The widget identifier, as returned by the widget creation API or retrieved from the API to fetch widgets. +String widgetId = "widgetId_example"; // String | The web form identifier, as returned by the web form creation API or retrieved from the API to fetch web forms. String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or email in the format userid:{userId} OR email:{email}. of the user that has shared his/her account try { @@ -645,7 +696,7 @@ try { Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **authorization** | **String**| An <a href=\"#\" onclick=\"this.href=oauthDoc()\" oncontextmenu=\"this.href=oauthDoc()\" target=\"oauthDoc\">OAuth Access Token</a> with scopes:<ul><li style='list-style-type: square'><a href=\"#\" onclick=\"this.href=oauthDoc('widget_read')\" oncontextmenu=\"this.href=oauthDoc('widget_read')\" target=\"oauthDoc\">widget_read</a></li></ul>in the format <b>'Bearer {accessToken}'. | - **widgetId** | **String**| The widget identifier, as returned by the widget creation API or retrieved from the API to fetch widgets. | + **widgetId** | **String**| The web form identifier, as returned by the web form creation API or retrieved from the API to fetch web forms. | **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] **xOnBehalfOfUser** | **String**| The userId or email in the format <b>userid:{userId} OR email:{email}.</b> of the user that has shared his/her account | [optional] @@ -664,9 +715,9 @@ No authorization required # **getWidgetInfo** -> WidgetCreationInfoV6 getWidgetInfo(authorization, widgetId, xApiUser, xOnBehalfOfUser, ifNoneMatch) +> FetchedWidgetInfo getWidgetInfo(authorization, widgetId, xApiUser, xOnBehalfOfUser, ifNoneMatch) -Retrieves the details of a widget. +Retrieves the details of a web form. ### Example ```java @@ -677,12 +728,12 @@ Retrieves the details of a widget. WidgetsApi apiInstance = new WidgetsApi(); String authorization = "authorization_example"; // String | An OAuth Access Token with scopes:in the format 'Bearer {accessToken}'. -String widgetId = "widgetId_example"; // String | The widget identifier, as returned by the widget creation API or retrieved from the API to fetch widgets. +String widgetId = "widgetId_example"; // String | The web form identifier, as returned by the web form creation API or retrieved from the API to fetch web forms. String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or email in the format userid:{userId} OR email:{email}. of the user that has shared his/her account String ifNoneMatch = "ifNoneMatch_example"; // String | Pass the value of the e-tag header obtained from the previous response to the same request to get a RESOURCE_NOT_MODIFIED(304) if the resource hasn't changed. try { - WidgetCreationInfoV6 result = apiInstance.getWidgetInfo(authorization, widgetId, xApiUser, xOnBehalfOfUser, ifNoneMatch); + FetchedWidgetInfo result = apiInstance.getWidgetInfo(authorization, widgetId, xApiUser, xOnBehalfOfUser, ifNoneMatch); System.out.println(result); } catch (ApiException e) { System.err.println("Exception when calling WidgetsApi#getWidgetInfo"); @@ -695,14 +746,61 @@ try { Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **authorization** | **String**| An <a href=\"#\" onclick=\"this.href=oauthDoc()\" oncontextmenu=\"this.href=oauthDoc()\" target=\"oauthDoc\">OAuth Access Token</a> with scopes:<ul><li style='list-style-type: square'><a href=\"#\" onclick=\"this.href=oauthDoc('widget_read')\" oncontextmenu=\"this.href=oauthDoc('widget_read')\" target=\"oauthDoc\">widget_read</a></li></ul>in the format <b>'Bearer {accessToken}'. | - **widgetId** | **String**| The widget identifier, as returned by the widget creation API or retrieved from the API to fetch widgets. | + **widgetId** | **String**| The web form identifier, as returned by the web form creation API or retrieved from the API to fetch web forms. | **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] **xOnBehalfOfUser** | **String**| The userId or email in the format <b>userid:{userId} OR email:{email}.</b> of the user that has shared his/her account | [optional] **ifNoneMatch** | **String**| Pass the value of the e-tag header obtained from the previous response to the same request to get a RESOURCE_NOT_MODIFIED(304) if the resource hasn't changed. | [optional] ### Return type -[**WidgetCreationInfoV6**](WidgetCreationInfoV6.md) +[**FetchedWidgetInfo**](FetchedWidgetInfo.md) + +### Authorization + +No authorization required + +### HTTP request headers + + - **Content-Type**: Not defined + - **Accept**: application/json + + +# **getWidgetInfoForUser** +> MyAgreementInfo getWidgetInfoForUser(authorization, widgetId, xApiUser) + +Retrieves the web form information related to the api caller + +### Example +```java +// Import classes: +//import io.swagger.client.model.ApiException; +//import io.swagger.client.api.WidgetsApi; + + +WidgetsApi apiInstance = new WidgetsApi(); +String authorization = "authorization_example"; // String | An OAuth Access Token with scopes:in the format 'Bearer {accessToken}'. +String widgetId = "widgetId_example"; // String | The web form identifier, as returned by the web form creation API or retrieved from the API to fetch web forms. +String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. +try { + MyAgreementInfo result = apiInstance.getWidgetInfoForUser(authorization, widgetId, xApiUser); + System.out.println(result); +} catch (ApiException e) { + System.err.println("Exception when calling WidgetsApi#getWidgetInfoForUser"); + e.printStackTrace(); +} +``` + +### Parameters + +Name | Type | Description | Notes +------------- | ------------- | ------------- | ------------- + **authorization** | **String**| An <a href=\"#\" onclick=\"this.href=oauthDoc()\" oncontextmenu=\"this.href=oauthDoc()\" target=\"oauthDoc\">OAuth Access Token</a> with scopes:<ul><li style='list-style-type: square'><a href=\"#\" onclick=\"this.href=oauthDoc('widget_read')\" oncontextmenu=\"this.href=oauthDoc('widget_read')\" target=\"oauthDoc\">widget_read</a></li></ul>in the format <b>'Bearer {accessToken}'. | + **widgetId** | **String**| The web form identifier, as returned by the web form creation API or retrieved from the API to fetch web forms. | + **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] + +### Return type + +[**MyAgreementInfo**](MyAgreementInfo.md) ### Authorization @@ -717,7 +815,7 @@ No authorization required # **getWidgetNoteForApiUser** > Note getWidgetNoteForApiUser(authorization, widgetId, xApiUser, xOnBehalfOfUser) -Retrieves the latest note of a widget for the API user. +Retrieves the latest note of a web form for the API user. ### Example ```java @@ -728,7 +826,7 @@ Retrieves the latest note of a widget for the API user. WidgetsApi apiInstance = new WidgetsApi(); String authorization = "authorization_example"; // String | An OAuth Access Token with scopes:in the format 'Bearer {accessToken}'. -String widgetId = "widgetId_example"; // String | The widget identifier, as returned by the widget creation API or retrieved from the API to fetch widgets. +String widgetId = "widgetId_example"; // String | The web form identifier, as returned by the web form creation API or retrieved from the API to fetch web forms. String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or email in the format userid:{userId} OR email:{email}. of the user that has shared his/her account try { @@ -745,7 +843,7 @@ try { Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **authorization** | **String**| An <a href=\"#\" onclick=\"this.href=oauthDoc()\" oncontextmenu=\"this.href=oauthDoc()\" target=\"oauthDoc\">OAuth Access Token</a> with scopes:<ul><li style='list-style-type: square'><a href=\"#\" onclick=\"this.href=oauthDoc('widget_read')\" oncontextmenu=\"this.href=oauthDoc('widget_read')\" target=\"oauthDoc\">widget_read</a></li></ul>in the format <b>'Bearer {accessToken}'. | - **widgetId** | **String**| The widget identifier, as returned by the widget creation API or retrieved from the API to fetch widgets. | + **widgetId** | **String**| The web form identifier, as returned by the web form creation API or retrieved from the API to fetch web forms. | **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] **xOnBehalfOfUser** | **String**| The userId or email in the format <b>userid:{userId} OR email:{email}.</b> of the user that has shared his/her account | [optional] @@ -764,7 +862,7 @@ No authorization required # **getWidgetSecurityOptionsForParticipation** -> ParticipantSecurityOption getWidgetSecurityOptionsForParticipation(authorization, widgetId, participantSetId, participantId, ifNoneMatch, xApiUser) +> ParticipantSecurityOption getWidgetSecurityOptionsForParticipation(authorization, widgetId, participantSetId, participantId, ifNoneMatch, xApiUser, xOnBehalfOfUser) Retrieves the security options for a particular participant. @@ -777,13 +875,14 @@ Retrieves the security options for a particular participant. WidgetsApi apiInstance = new WidgetsApi(); String authorization = "authorization_example"; // String | An OAuth Access Token with scopes:in the format 'Bearer {accessToken}'. -String widgetId = "widgetId_example"; // String | The widget identifier, as returned by the widget creation API or retrieved from the API to fetch widgets. +String widgetId = "widgetId_example"; // String | The web form identifier, as returned by the web form creation API or retrieved from the API to fetch web forms. String participantSetId = "participantSetId_example"; // String | The participant set identifier String participantId = "participantId_example"; // String | The participant identifier String ifNoneMatch = "ifNoneMatch_example"; // String | Pass the value of the e-tag header obtained from the previous response to the same request to get a RESOURCE_NOT_MODIFIED(304) if the resource hasn't changed. String xApiUser = "xApiUser_example"; // String | The userId or email of API caller using the account or group token in the format userid:{userId} OR email:{email}. If it is not specified, then the caller is inferred from the token. +String xOnBehalfOfUser = "xOnBehalfOfUser_example"; // String | The userId or email in the format userid:{userId} OR email:{email}. of the user that has shared his/her account try { - ParticipantSecurityOption result = apiInstance.getWidgetSecurityOptionsForParticipation(authorization, widgetId, participantSetId, participantId, ifNoneMatch, xApiUser); + ParticipantSecurityOption result = apiInstance.getWidgetSecurityOptionsForParticipation(authorization, widgetId, participantSetId, participantId, ifNoneMatch, xApiUser, xOnBehalfOfUser); System.out.println(result); } catch (ApiException e) { System.err.println("Exception when calling WidgetsApi#getWidgetSecurityOptionsForParticipation"); @@ -796,11 +895,12 @@ try { Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **authorization** | **String**| An <a href=\"#\" onclick=\"this.href=oauthDoc()\" oncontextmenu=\"this.href=oauthDoc()\" target=\"oauthDoc\">OAuth Access Token</a> with scopes:<ul><li style='list-style-type: square'><a href=\"#\" onclick=\"this.href=oauthDoc('widget_read')\" oncontextmenu=\"this.href=oauthDoc('widget_read')\" target=\"oauthDoc\">widget_read</a></li></ul>in the format <b>'Bearer {accessToken}'. | - **widgetId** | **String**| The widget identifier, as returned by the widget creation API or retrieved from the API to fetch widgets. | + **widgetId** | **String**| The web form identifier, as returned by the web form creation API or retrieved from the API to fetch web forms. | **participantSetId** | **String**| The participant set identifier | **participantId** | **String**| The participant identifier | **ifNoneMatch** | **String**| Pass the value of the e-tag header obtained from the previous response to the same request to get a RESOURCE_NOT_MODIFIED(304) if the resource hasn't changed. | [optional] **xApiUser** | **String**| The userId or email of API caller using the account or group token in the format <b>userid:{userId} OR email:{email}.</b> If it is not specified, then the caller is inferred from the token. | [optional] + **xOnBehalfOfUser** | **String**| The userId or email in the format <b>userid:{userId} OR email:{email}.</b> of the user that has shared his/her account | [optional] ### Return type @@ -819,7 +919,7 @@ No authorization required # **getWidgetView** > WidgetViews getWidgetView(authorization, widgetId, widgetViewInfo, xApiUser, xOnBehalfOfUser) -Retrieves the requested views for a widget. +Retrieves the requested views for a web form. ### Example ```java @@ -829,8 +929,8 @@ Retrieves the requested views for a widget. WidgetsApi apiInstance = new WidgetsApi(); -String authorization = "authorization_example"; // String | An OAuth Access Token with scopes: