com.docusign.esign.api

Class BulkEnvelopesApi

java.lang.Object

com.docusign.esign.api.BulkEnvelopesApi

public class BulkEnvelopesApi
extends Object

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	BulkEnvelopesApi.GetOptions
class	BulkEnvelopesApi.GetRecipientsOptions
class	BulkEnvelopesApi.ListOptions

Constructor Summary

Constructors

Constructor and Description
BulkEnvelopesApi()
BulkEnvelopesApi(ApiClient apiClient)

Method Summary

Modifier and Type	Method and Description
BulkRecipientsUpdateResponse	deleteRecipients(String accountId, String envelopeId, String recipientId) Deletes the bulk recipient file from an envelope.
BulkEnvelopeStatus	get(String accountId, String batchId) Gets the status of a specified bulk send operation.
BulkEnvelopeStatus	get(String accountId, String batchId, BulkEnvelopesApi.GetOptions options) Gets the status of a specified bulk send operation.
ApiClient	getApiClient()
BulkRecipientsResponse	getRecipients(String accountId, String envelopeId, String recipientId) Gets the bulk recipient file from an envelope.
BulkRecipientsResponse	getRecipients(String accountId, String envelopeId, String recipientId, BulkEnvelopesApi.GetRecipientsOptions options) Gets the bulk recipient file from an envelope.
BulkEnvelopesResponse	list(String accountId) Gets status information about bulk recipient batches.
BulkEnvelopesResponse	list(String accountId, BulkEnvelopesApi.ListOptions options) Gets status information about bulk recipient batches.
void	setApiClient(ApiClient apiClient)
BulkRecipientsSummaryResponse	updateRecipients(String accountId, String envelopeId, String recipientId, byte[] bulkRecipientsRequest) Adds or replaces envelope bulk recipients.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

BulkEnvelopesApi

public BulkEnvelopesApi()

BulkEnvelopesApi

public BulkEnvelopesApi(ApiClient apiClient)

Method Detail

getApiClient

public ApiClient getApiClient()

setApiClient

public void setApiClient(ApiClient apiClient)

deleteRecipients

public BulkRecipientsUpdateResponse deleteRecipients(String accountId,
                                                     String envelopeId,
                                                     String recipientId)
                                              throws ApiException

Deletes the bulk recipient file from an envelope. Deletes the bulk recipient file from an envelope. This cannot be used if the envelope has been sent. After using this, the `bulkRecipientsUri` property is not returned in subsequent GET calls for the envelope, but the recipient will remain as a bulk recipient.

Parameters:

accountId - The external account number (int) or account ID Guid. (required)

envelopeId - The envelopeId Guid of the envelope being accessed. (required)

recipientId - The ID of the recipient being accessed. (required)

Returns:

BulkRecipientsUpdateResponse

Throws:

ApiException - if fails to make API call

get

public BulkEnvelopeStatus get(String accountId,
                              String batchId)
                       throws ApiException

Gets the status of a specified bulk send operation. Retrieves the status information of a single bulk recipient batch. A bulk recipient batch is the set of envelopes sent from a single bulk recipient file.

Parameters:

accountId - The external account number (int) or account ID Guid. (required)

batchId - (required)

Returns:

BulkEnvelopeStatus

Throws:

ApiException

get

public BulkEnvelopeStatus get(String accountId,
                              String batchId,
                              BulkEnvelopesApi.GetOptions options)
                       throws ApiException

Gets the status of a specified bulk send operation. Retrieves the status information of a single bulk recipient batch. A bulk recipient batch is the set of envelopes sent from a single bulk recipient file.

Parameters:

accountId - The external account number (int) or account ID Guid. (required)

batchId - (required)

options - for modifying the method behavior.

Returns:

BulkEnvelopeStatus

Throws:

ApiException - if fails to make API call

getRecipients

public BulkRecipientsResponse getRecipients(String accountId,
                                            String envelopeId,
                                            String recipientId)
                                     throws ApiException

Gets the bulk recipient file from an envelope. Retrieves the bulk recipient file information from an envelope that has a bulk recipient.

Parameters:

accountId - The external account number (int) or account ID Guid. (required)

envelopeId - The envelopeId Guid of the envelope being accessed. (required)

recipientId - The ID of the recipient being accessed. (required)

Returns:

BulkRecipientsResponse

Throws:

ApiException

getRecipients

public BulkRecipientsResponse getRecipients(String accountId,
                                            String envelopeId,
                                            String recipientId,
                                            BulkEnvelopesApi.GetRecipientsOptions options)
                                     throws ApiException

Gets the bulk recipient file from an envelope. Retrieves the bulk recipient file information from an envelope that has a bulk recipient.

Parameters:

accountId - The external account number (int) or account ID Guid. (required)

envelopeId - The envelopeId Guid of the envelope being accessed. (required)

recipientId - The ID of the recipient being accessed. (required)

options - for modifying the method behavior.

Returns:

BulkRecipientsResponse

Throws:

ApiException - if fails to make API call

list

public BulkEnvelopesResponse list(String accountId)
                           throws ApiException

Gets status information about bulk recipient batches. Retrieves status information about all the bulk recipient batches. A bulk recipient batch is the set of envelopes sent from a single bulk recipient file. The response includes general information about each bulk recipient batch. The response returns information about the envelopes sent with bulk recipient batches, including the `batchId` property, which can be used to retrieve a more detailed status of individual bulk recipient batches.

Parameters:

accountId - The external account number (int) or account ID Guid. (required)

Returns:

BulkEnvelopesResponse

Throws:

ApiException

list

public BulkEnvelopesResponse list(String accountId,
                                  BulkEnvelopesApi.ListOptions options)
                           throws ApiException

Gets status information about bulk recipient batches. Retrieves status information about all the bulk recipient batches. A bulk recipient batch is the set of envelopes sent from a single bulk recipient file. The response includes general information about each bulk recipient batch. The response returns information about the envelopes sent with bulk recipient batches, including the `batchId` property, which can be used to retrieve a more detailed status of individual bulk recipient batches.

Parameters:

accountId - The external account number (int) or account ID Guid. (required)

options - for modifying the method behavior.

Returns:

BulkEnvelopesResponse

Throws:

ApiException - if fails to make API call

updateRecipients

public BulkRecipientsSummaryResponse updateRecipients(String accountId,
                                                      String envelopeId,
                                                      String recipientId,
                                                      byte[] bulkRecipientsRequest)
                                               throws ApiException

Adds or replaces envelope bulk recipients. Updates the bulk recipients in a draft envelope using a file upload. The Content-Type supported for uploading a bulk recipient file is CSV (text/csv). The REST API does not support modifying individual rows or values in the bulk recipients file. It only allows the entire file to be added or replaced with a new file.

Parameters:

accountId - The external account number (int) or account id GUID. (required)

envelopeId - The envelope's GUID. Eg 93be49ab-afa0-4adf-933c-f752070d71ec (required)

recipientId - A local reference that senders use to map recipients to other objects, such as specific document tabs. Within an envelope, each `recipientId` must be unique, but there is no uniqueness requirement across envelopes. For example, many envelopes assign the first recipient a `recipientId` of `1`. (required)

bulkRecipientsRequest - (required)

Returns:

BulkRecipientsSummaryResponse

Throws:

ApiException - if fails to make API call