All URIs are relative to https://api.hellosign.com/v3
Method | HTTP request | Description |
---|---|---|
SignatureRequestBulkCreateEmbeddedWithTemplate | POST /signature_request/bulk_create_embedded_with_template | Embedded Bulk Send with Template |
SignatureRequestBulkSendWithTemplate | POST /signature_request/bulk_send_with_template | Bulk Send with Template |
SignatureRequestCancel | POST /signature_request/cancel/{signature_request_id} | Cancel Incomplete Signature Request |
SignatureRequestCreateEmbedded | POST /signature_request/create_embedded | Create Embedded Signature Request |
SignatureRequestCreateEmbeddedWithTemplate | POST /signature_request/create_embedded_with_template | Create Embedded Signature Request with Template |
SignatureRequestFiles | GET /signature_request/files/{signature_request_id} | Download Files |
SignatureRequestFilesAsDataUri | GET /signature_request/files_as_data_uri/{signature_request_id} | Download Files as Data Uri |
SignatureRequestFilesAsFileUrl | GET /signature_request/files_as_file_url/{signature_request_id} | Download Files as File Url |
SignatureRequestGet | GET /signature_request/{signature_request_id} | Get Signature Request |
SignatureRequestList | GET /signature_request/list | List Signature Requests |
SignatureRequestReleaseHold | POST /signature_request/release_hold/{signature_request_id} | Release On-Hold Signature Request |
SignatureRequestRemind | POST /signature_request/remind/{signature_request_id} | Send Request Reminder |
SignatureRequestRemove | POST /signature_request/remove/{signature_request_id} | Remove Signature Request Access |
SignatureRequestSend | POST /signature_request/send | Send Signature Request |
SignatureRequestSendWithTemplate | POST /signature_request/send_with_template | Send with Template |
SignatureRequestUpdate | POST /signature_request/update/{signature_request_id} | Update Signature Request |
BulkSendJobSendResponse SignatureRequestBulkCreateEmbeddedWithTemplate (SignatureRequestBulkCreateEmbeddedWithTemplateRequest signatureRequestBulkCreateEmbeddedWithTemplateRequest)
Embedded Bulk Send with Template
Creates BulkSendJob which sends up to 250 SignatureRequests in bulk based off of the provided Template(s) specified with the template_ids
parameter to be signed in an embedded iFrame. These embedded signature requests can only be signed in embedded iFrames whereas normal signature requests can only be signed on Dropbox Sign. NOTE: Only available for Standard plan and higher.
using System;
using System.Collections.Generic;
using System.IO;
using Dropbox.Sign.Api;
using Dropbox.Sign.Client;
using Dropbox.Sign.Model;
public class Example
{
public static void Main()
{
var config = new Configuration();
// Configure HTTP basic authorization: api_key
config.Username = "YOUR_API_KEY";
// or, configure Bearer (JWT) authorization: oauth2
// config.AccessToken = "YOUR_BEARER_TOKEN";
var signatureRequestApi = new SignatureRequestApi(config);
var signerList1Signer = new SubSignatureRequestTemplateSigner(
role: "Client",
name: "George",
emailAddress: "george@example.com",
pin: "d79a3td"
);
var signerList1CustomFields = new SubBulkSignerListCustomField(
name: "company",
value: "ABC Corp"
);
var signerList1 = new SubBulkSignerList(
signers: new List<SubSignatureRequestTemplateSigner>(){signerList1Signer},
customFields: new List<SubBulkSignerListCustomField>(){signerList1CustomFields}
);
var signerList2Signer = new SubSignatureRequestTemplateSigner(
role: "Client",
name: "Mary",
emailAddress: "mary@example.com",
pin: "gd9as5b"
);
var signerList2CustomFields = new SubBulkSignerListCustomField(
name: "company",
value: "123 Corp"
);
var signerList2 = new SubBulkSignerList(
signers: new List<SubSignatureRequestTemplateSigner>(){signerList2Signer},
customFields: new List<SubBulkSignerListCustomField>(){signerList2CustomFields}
);
var cc1 = new SubCC(
role: "Accounting",
emailAddress: "accouting@email.com"
);
var data = new SignatureRequestBulkCreateEmbeddedWithTemplateRequest(
clientId: "1a659d9ad95bccd307ecad78d72192f8",
templateIds: new List<string>(){"c26b8a16784a872da37ea946b9ddec7c1e11dff6"},
subject: "Purchase Order",
message: "Glad we could come to an agreement.",
signerList: new List<SubBulkSignerList>(){signerList1, signerList2},
ccs: new List<SubCC>(){cc1},
testMode: true
);
try
{
var result = signatureRequestApi.SignatureRequestBulkCreateEmbeddedWithTemplate(data);
Console.WriteLine(result);
}
catch (ApiException e)
{
Console.WriteLine("Exception when calling Dropbox Sign API: " + e.Message);
Console.WriteLine("Status Code: " + e.ErrorCode);
Console.WriteLine(e.StackTrace);
}
}
}
This returns an ApiResponse object which contains the response data, status code and headers.
try
{
// Embedded Bulk Send with Template
ApiResponse<BulkSendJobSendResponse> response = apiInstance.SignatureRequestBulkCreateEmbeddedWithTemplateWithHttpInfo(signatureRequestBulkCreateEmbeddedWithTemplateRequest);
Debug.Write("Status Code: " + response.StatusCode);
Debug.Write("Response Headers: " + response.Headers);
Debug.Write("Response Body: " + response.Data);
}
catch (ApiException e)
{
Debug.Print("Exception when calling SignatureRequestApi.SignatureRequestBulkCreateEmbeddedWithTemplateWithHttpInfo: " + e.Message);
Debug.Print("Status Code: " + e.ErrorCode);
Debug.Print(e.StackTrace);
}
Name | Type | Description | Notes |
---|---|---|---|
signatureRequestBulkCreateEmbeddedWithTemplateRequest | SignatureRequestBulkCreateEmbeddedWithTemplateRequest |
- Content-Type: application/json, multipart/form-data
- Accept: application/json
Status code | Description | Response headers |
---|---|---|
200 | successful operation | * X-RateLimit-Limit - * X-RateLimit-Remaining - * X-Ratelimit-Reset - |
4XX | failed_operation | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
BulkSendJobSendResponse SignatureRequestBulkSendWithTemplate (SignatureRequestBulkSendWithTemplateRequest signatureRequestBulkSendWithTemplateRequest)
Bulk Send with Template
Creates BulkSendJob which sends up to 250 SignatureRequests in bulk based off of the provided Template(s) specified with the template_ids
parameter. NOTE: Only available for Standard plan and higher.
using System;
using System.Collections.Generic;
using System.IO;
using Dropbox.Sign.Api;
using Dropbox.Sign.Client;
using Dropbox.Sign.Model;
public class Example
{
public static void Main()
{
var config = new Configuration();
// Configure HTTP basic authorization: api_key
config.Username = "YOUR_API_KEY";
// or, configure Bearer (JWT) authorization: oauth2
// config.AccessToken = "YOUR_BEARER_TOKEN";
var signatureRequestApi = new SignatureRequestApi(config);
var signerList1Signer = new SubSignatureRequestTemplateSigner(
role: "Client",
name: "George",
emailAddress: "george@example.com",
pin: "d79a3td"
);
var signerList1CustomFields = new SubBulkSignerListCustomField(
name: "company",
value: "ABC Corp"
);
var signerList1 = new SubBulkSignerList(
signers: new List<SubSignatureRequestTemplateSigner>(){signerList1Signer},
customFields: new List<SubBulkSignerListCustomField>(){signerList1CustomFields}
);
var signerList2Signer = new SubSignatureRequestTemplateSigner(
role: "Client",
name: "Mary",
emailAddress: "mary@example.com",
pin: "gd9as5b"
);
var signerList2CustomFields = new SubBulkSignerListCustomField(
name: "company",
value: "123 Corp"
);
var signerList2 = new SubBulkSignerList(
signers: new List<SubSignatureRequestTemplateSigner>(){signerList2Signer},
customFields: new List<SubBulkSignerListCustomField>(){signerList2CustomFields}
);
var cc1 = new SubCC(
role: "Accounting",
emailAddress: "accouting@email.com"
);
var data = new SignatureRequestBulkSendWithTemplateRequest(
templateIds: new List<string>(){"c26b8a16784a872da37ea946b9ddec7c1e11dff6"},
subject: "Purchase Order",
message: "Glad we could come to an agreement.",
signerList: new List<SubBulkSignerList>(){signerList1, signerList2},
ccs: new List<SubCC>(){cc1},
testMode: true
);
try
{
var result = signatureRequestApi.SignatureRequestBulkSendWithTemplate(data);
Console.WriteLine(result);
}
catch (ApiException e)
{
Console.WriteLine("Exception when calling Dropbox Sign API: " + e.Message);
Console.WriteLine("Status Code: " + e.ErrorCode);
Console.WriteLine(e.StackTrace);
}
}
}
This returns an ApiResponse object which contains the response data, status code and headers.
try
{
// Bulk Send with Template
ApiResponse<BulkSendJobSendResponse> response = apiInstance.SignatureRequestBulkSendWithTemplateWithHttpInfo(signatureRequestBulkSendWithTemplateRequest);
Debug.Write("Status Code: " + response.StatusCode);
Debug.Write("Response Headers: " + response.Headers);
Debug.Write("Response Body: " + response.Data);
}
catch (ApiException e)
{
Debug.Print("Exception when calling SignatureRequestApi.SignatureRequestBulkSendWithTemplateWithHttpInfo: " + e.Message);
Debug.Print("Status Code: " + e.ErrorCode);
Debug.Print(e.StackTrace);
}
Name | Type | Description | Notes |
---|---|---|---|
signatureRequestBulkSendWithTemplateRequest | SignatureRequestBulkSendWithTemplateRequest |
- Content-Type: application/json, multipart/form-data
- Accept: application/json
Status code | Description | Response headers |
---|---|---|
200 | successful operation | * X-RateLimit-Limit - * X-RateLimit-Remaining - * X-Ratelimit-Reset - |
4XX | failed_operation | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
void SignatureRequestCancel (string signatureRequestId)
Cancel Incomplete Signature Request
Cancels an incomplete signature request. This action is not reversible. The request will be canceled and signers will no longer be able to sign. If they try to access the signature request they will receive a HTTP 410 status code indicating that the resource has been deleted. Cancelation is asynchronous and a successful call to this endpoint will return an empty 200 OK response if the signature request is eligible to be canceled and has been successfully queued. This 200 OK response does not indicate a successful cancelation of the signature request itself. The cancelation is confirmed via the signature_request_canceled
event. It is recommended that a callback handler be implemented to listen for the signature_request_canceled
event. This callback will be sent only when the cancelation has completed successfully. If a callback handler has been configured and the event has not been received within 60 minutes of making the call, check the status of the request in the API Dashboard and retry the cancelation if necessary. To be eligible for cancelation, a signature request must have been sent successfully, must not yet have been signed by all signers, and you must either be the sender or own the API app under which it was sent. A partially signed signature request can be canceled. NOTE: To remove your access to a completed signature request, use the endpoint: POST /signature_request/remove/[:signature_request_id]
.
using System;
using System.Collections.Generic;
using System.IO;
using Dropbox.Sign.Api;
using Dropbox.Sign.Client;
using Dropbox.Sign.Model;
public class Example
{
public static void Main()
{
var config = new Configuration();
// Configure HTTP basic authorization: api_key
config.Username = "YOUR_API_KEY";
// or, configure Bearer (JWT) authorization: oauth2
// config.AccessToken = "YOUR_BEARER_TOKEN";
var signatureRequestApi = new SignatureRequestApi(config);
var signatureRequestId = "2f9781e1a8e2045224d808c153c2e1d3df6f8f2f";
try
{
signatureRequestApi.SignatureRequestCancel(signatureRequestId);
}
catch (ApiException e)
{
Console.WriteLine("Exception when calling Dropbox Sign API: " + e.Message);
Console.WriteLine("Status Code: " + e.ErrorCode);
Console.WriteLine(e.StackTrace);
}
}
}
This returns an ApiResponse object which contains the response data, status code and headers.
try
{
// Cancel Incomplete Signature Request
apiInstance.SignatureRequestCancelWithHttpInfo(signatureRequestId);
}
catch (ApiException e)
{
Debug.Print("Exception when calling SignatureRequestApi.SignatureRequestCancelWithHttpInfo: " + e.Message);
Debug.Print("Status Code: " + e.ErrorCode);
Debug.Print(e.StackTrace);
}
Name | Type | Description | Notes |
---|---|---|---|
signatureRequestId | string | The id of the incomplete SignatureRequest to cancel. |
void (empty response body)
- Content-Type: Not defined
- Accept: application/json
Status code | Description | Response headers |
---|---|---|
200 | successful operation | * X-RateLimit-Limit - * X-RateLimit-Remaining - * X-Ratelimit-Reset - |
4XX | failed_operation | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
SignatureRequestGetResponse SignatureRequestCreateEmbedded (SignatureRequestCreateEmbeddedRequest signatureRequestCreateEmbeddedRequest)
Create Embedded Signature Request
Creates a new SignatureRequest with the submitted documents to be signed in an embedded iFrame. If form_fields_per_document is not specified, a signature page will be affixed where all signers will be required to add their signature, signifying their agreement to all contained documents. Note that embedded signature requests can only be signed in embedded iFrames whereas normal signature requests can only be signed on Dropbox Sign.
using System;
using System.Collections.Generic;
using System.IO;
using Dropbox.Sign.Api;
using Dropbox.Sign.Client;
using Dropbox.Sign.Model;
public class Example
{
public static void Main()
{
var config = new Configuration();
// Configure HTTP basic authorization: api_key
config.Username = "YOUR_API_KEY";
// or, configure Bearer (JWT) authorization: oauth2
// config.AccessToken = "YOUR_BEARER_TOKEN";
var signatureRequestApi = new SignatureRequestApi(config);
var signer1 = new SubSignatureRequestSigner(
emailAddress: "jack@example.com",
name: "Jack",
order: 0
);
var signer2 = new SubSignatureRequestSigner(
emailAddress: "jill@example.com",
name: "Jill",
order: 1
);
var signingOptions = new SubSigningOptions(
draw: true,
type: true,
upload: true,
phone: true,
defaultType: SubSigningOptions.DefaultTypeEnum.Draw
);
var files = new List<Stream> {
new FileStream(
"./example_signature_request.pdf",
FileMode.Open,
FileAccess.Read,
FileShare.Read
)
};
var data = new SignatureRequestCreateEmbeddedRequest(
clientId: "ec64a202072370a737edf4a0eb7f4437",
title: "NDA with Acme Co.",
subject: "The NDA we talked about",
message: "Please sign this NDA and then we can discuss more. Let me know if you have any questions.",
signers: new List<SubSignatureRequestSigner>(){signer1, signer2},
ccEmailAddresses: new List<string>(){"lawyer1@dropboxsign.com", "lawyer2@dropboxsign.com"},
files: files,
signingOptions: signingOptions,
testMode: true
);
try
{
var result = signatureRequestApi.SignatureRequestCreateEmbedded(data);
Console.WriteLine(result);
}
catch (ApiException e)
{
Console.WriteLine("Exception when calling Dropbox Sign API: " + e.Message);
Console.WriteLine("Status Code: " + e.ErrorCode);
Console.WriteLine(e.StackTrace);
}
}
}
This returns an ApiResponse object which contains the response data, status code and headers.
try
{
// Create Embedded Signature Request
ApiResponse<SignatureRequestGetResponse> response = apiInstance.SignatureRequestCreateEmbeddedWithHttpInfo(signatureRequestCreateEmbeddedRequest);
Debug.Write("Status Code: " + response.StatusCode);
Debug.Write("Response Headers: " + response.Headers);
Debug.Write("Response Body: " + response.Data);
}
catch (ApiException e)
{
Debug.Print("Exception when calling SignatureRequestApi.SignatureRequestCreateEmbeddedWithHttpInfo: " + e.Message);
Debug.Print("Status Code: " + e.ErrorCode);
Debug.Print(e.StackTrace);
}
Name | Type | Description | Notes |
---|---|---|---|
signatureRequestCreateEmbeddedRequest | SignatureRequestCreateEmbeddedRequest |
- Content-Type: application/json, multipart/form-data
- Accept: application/json
Status code | Description | Response headers |
---|---|---|
200 | successful operation | * X-RateLimit-Limit - * X-RateLimit-Remaining - * X-Ratelimit-Reset - |
4XX | failed_operation | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
SignatureRequestGetResponse SignatureRequestCreateEmbeddedWithTemplate (SignatureRequestCreateEmbeddedWithTemplateRequest signatureRequestCreateEmbeddedWithTemplateRequest)
Create Embedded Signature Request with Template
Creates a new SignatureRequest based on the given Template(s) to be signed in an embedded iFrame. Note that embedded signature requests can only be signed in embedded iFrames whereas normal signature requests can only be signed on Dropbox Sign.
using System;
using System.Collections.Generic;
using Dropbox.Sign.Api;
using Dropbox.Sign.Client;
using Dropbox.Sign.Model;
public class Example
{
public static void Main()
{
var config = new Configuration();
// Configure HTTP basic authorization: api_key
config.Username = "YOUR_API_KEY";
// or, configure Bearer (JWT) authorization: oauth2
// config.AccessToken = "YOUR_BEARER_TOKEN";
var signatureRequestApi = new SignatureRequestApi(config);
var signer1 = new SubSignatureRequestTemplateSigner(
role: "Client",
name: "George"
);
var subSigningOptions = new SubSigningOptions(
draw: true,
type: true,
upload: true,
phone: false,
defaultType: SubSigningOptions.DefaultTypeEnum.Draw
);
var data = new SignatureRequestCreateEmbeddedWithTemplateRequest(
clientId: "ec64a202072370a737edf4a0eb7f4437",
templateIds: new List<string>(){"c26b8a16784a872da37ea946b9ddec7c1e11dff6"},
subject: "Purchase Order",
message: "Glad we could come to an agreement.",
signers: new List<SubSignatureRequestTemplateSigner>(){signer1},
signingOptions: subSigningOptions,
testMode: true
);
try
{
var result = signatureRequestApi.SignatureRequestCreateEmbeddedWithTemplate(data);
Console.WriteLine(result);
}
catch (ApiException e)
{
Console.WriteLine("Exception when calling Dropbox Sign API: " + e.Message);
Console.WriteLine("Status Code: " + e.ErrorCode);
Console.WriteLine(e.StackTrace);
}
}
}
This returns an ApiResponse object which contains the response data, status code and headers.
try
{
// Create Embedded Signature Request with Template
ApiResponse<SignatureRequestGetResponse> response = apiInstance.SignatureRequestCreateEmbeddedWithTemplateWithHttpInfo(signatureRequestCreateEmbeddedWithTemplateRequest);
Debug.Write("Status Code: " + response.StatusCode);
Debug.Write("Response Headers: " + response.Headers);
Debug.Write("Response Body: " + response.Data);
}
catch (ApiException e)
{
Debug.Print("Exception when calling SignatureRequestApi.SignatureRequestCreateEmbeddedWithTemplateWithHttpInfo: " + e.Message);
Debug.Print("Status Code: " + e.ErrorCode);
Debug.Print(e.StackTrace);
}
Name | Type | Description | Notes |
---|---|---|---|
signatureRequestCreateEmbeddedWithTemplateRequest | SignatureRequestCreateEmbeddedWithTemplateRequest |
- Content-Type: application/json, multipart/form-data
- Accept: application/json
Status code | Description | Response headers |
---|---|---|
200 | successful operation | * X-RateLimit-Limit - * X-RateLimit-Remaining - * X-Ratelimit-Reset - |
4XX | failed_operation | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
System.IO.Stream SignatureRequestFiles (string signatureRequestId, string? fileType = null)
Download Files
Obtain a copy of the current documents specified by the signature_request_id
parameter. Returns a PDF or ZIP file. If the files are currently being prepared, a status code of 409
will be returned instead.
using System;
using System.Collections.Generic;
using Dropbox.Sign.Api;
using Dropbox.Sign.Client;
using Dropbox.Sign.Model;
public class Example
{
public static void Main()
{
var config = new Configuration();
// Configure HTTP basic authorization: api_key
config.Username = "YOUR_API_KEY";
// or, configure Bearer (JWT) authorization: oauth2
// config.AccessToken = "YOUR_BEARER_TOKEN";
var signatureRequestApi = new SignatureRequestApi(config);
var signatureRequestId = "fa5c8a0b0f492d768749333ad6fcc214c111e967";
try
{
var result = signatureRequestApi.SignatureRequestFiles(signatureRequestId, "pdf");
var fileStream = File.Create("file_response.pdf");
result.Seek(0, SeekOrigin.Begin);
result.CopyTo(fileStream);
fileStream.Close();
}
catch (ApiException e)
{
Console.WriteLine("Exception when calling Dropbox Sign API: " + e.Message);
Console.WriteLine("Status Code: " + e.ErrorCode);
Console.WriteLine(e.StackTrace);
}
}
}
This returns an ApiResponse object which contains the response data, status code and headers.
try
{
// Download Files
ApiResponse<System.IO.Stream> response = apiInstance.SignatureRequestFilesWithHttpInfo(signatureRequestId, fileType);
Debug.Write("Status Code: " + response.StatusCode);
Debug.Write("Response Headers: " + response.Headers);
Debug.Write("Response Body: " + response.Data);
}
catch (ApiException e)
{
Debug.Print("Exception when calling SignatureRequestApi.SignatureRequestFilesWithHttpInfo: " + e.Message);
Debug.Print("Status Code: " + e.ErrorCode);
Debug.Print(e.StackTrace);
}
Name | Type | Description | Notes |
---|---|---|---|
signatureRequestId | string | The id of the SignatureRequest to retrieve. | |
fileType | string? | Set to pdf for a single merged document or zip for a collection of individual documents. |
[optional] [default to pdf] |
System.IO.Stream
- Content-Type: Not defined
- Accept: application/pdf, application/zip, application/json
Status code | Description | Response headers |
---|---|---|
200 | successful operation | * X-RateLimit-Limit - * X-RateLimit-Remaining - * X-Ratelimit-Reset - |
4XX | failed_operation | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
FileResponseDataUri SignatureRequestFilesAsDataUri (string signatureRequestId)
Download Files as Data Uri
Obtain a copy of the current documents specified by the signature_request_id
parameter. Returns a JSON object with a data_uri
representing the base64 encoded file (PDFs only). If the files are currently being prepared, a status code of 409
will be returned instead.
using System;
using System.Collections.Generic;
using Dropbox.Sign.Api;
using Dropbox.Sign.Client;
using Dropbox.Sign.Model;
public class Example
{
public static void Main()
{
var config = new Configuration();
// Configure HTTP basic authorization: api_key
config.Username = "YOUR_API_KEY";
// or, configure Bearer (JWT) authorization: oauth2
// config.AccessToken = "YOUR_BEARER_TOKEN";
var signatureRequestApi = new SignatureRequestApi(config);
var signatureRequestId = "fa5c8a0b0f492d768749333ad6fcc214c111e967";
try
{
var result = signatureRequestApi.SignatureRequestFilesAsDataUri(signatureRequestId);
Console.WriteLine(result);
}
catch (ApiException e)
{
Console.WriteLine("Exception when calling Dropbox Sign API: " + e.Message);
Console.WriteLine("Status Code: " + e.ErrorCode);
Console.WriteLine(e.StackTrace);
}
}
}
This returns an ApiResponse object which contains the response data, status code and headers.
try
{
// Download Files as Data Uri
ApiResponse<FileResponseDataUri> response = apiInstance.SignatureRequestFilesAsDataUriWithHttpInfo(signatureRequestId);
Debug.Write("Status Code: " + response.StatusCode);
Debug.Write("Response Headers: " + response.Headers);
Debug.Write("Response Body: " + response.Data);
}
catch (ApiException e)
{
Debug.Print("Exception when calling SignatureRequestApi.SignatureRequestFilesAsDataUriWithHttpInfo: " + e.Message);
Debug.Print("Status Code: " + e.ErrorCode);
Debug.Print(e.StackTrace);
}
Name | Type | Description | Notes |
---|---|---|---|
signatureRequestId | string | The id of the SignatureRequest to retrieve. |
- Content-Type: Not defined
- Accept: application/json
Status code | Description | Response headers |
---|---|---|
200 | successful operation | * X-RateLimit-Limit - * X-RateLimit-Remaining - * X-Ratelimit-Reset - |
4XX | failed_operation | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
FileResponse SignatureRequestFilesAsFileUrl (string signatureRequestId, int? forceDownload = null)
Download Files as File Url
Obtain a copy of the current documents specified by the signature_request_id
parameter. Returns a JSON object with a url to the file (PDFs only). If the files are currently being prepared, a status code of 409
will be returned instead.
using System;
using System.Collections.Generic;
using Dropbox.Sign.Api;
using Dropbox.Sign.Client;
using Dropbox.Sign.Model;
public class Example
{
public static void Main()
{
var config = new Configuration();
// Configure HTTP basic authorization: api_key
config.Username = "YOUR_API_KEY";
// or, configure Bearer (JWT) authorization: oauth2
// config.AccessToken = "YOUR_BEARER_TOKEN";
var signatureRequestApi = new SignatureRequestApi(config);
var signatureRequestId = "fa5c8a0b0f492d768749333ad6fcc214c111e967";
try
{
var result = signatureRequestApi.SignatureRequestFilesAsFileUrl(signatureRequestId);
Console.WriteLine(result);
}
catch (ApiException e)
{
Console.WriteLine("Exception when calling Dropbox Sign API: " + e.Message);
Console.WriteLine("Status Code: " + e.ErrorCode);
Console.WriteLine(e.StackTrace);
}
}
}
This returns an ApiResponse object which contains the response data, status code and headers.
try
{
// Download Files as File Url
ApiResponse<FileResponse> response = apiInstance.SignatureRequestFilesAsFileUrlWithHttpInfo(signatureRequestId, forceDownload);
Debug.Write("Status Code: " + response.StatusCode);
Debug.Write("Response Headers: " + response.Headers);
Debug.Write("Response Body: " + response.Data);
}
catch (ApiException e)
{
Debug.Print("Exception when calling SignatureRequestApi.SignatureRequestFilesAsFileUrlWithHttpInfo: " + e.Message);
Debug.Print("Status Code: " + e.ErrorCode);
Debug.Print(e.StackTrace);
}
Name | Type | Description | Notes |
---|---|---|---|
signatureRequestId | string | The id of the SignatureRequest to retrieve. | |
forceDownload | int? | By default when opening the file_url a browser will download the PDF and save it locally. When set to 0 the PDF file will be displayed in the browser. |
[optional] [default to 1] |
- Content-Type: Not defined
- Accept: application/json
Status code | Description | Response headers |
---|---|---|
200 | successful operation | * X-RateLimit-Limit - * X-RateLimit-Remaining - * X-Ratelimit-Reset - |
4XX | failed_operation | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
SignatureRequestGetResponse SignatureRequestGet (string signatureRequestId)
Get Signature Request
Returns the status of the SignatureRequest specified by the signature_request_id
parameter.
using System;
using System.Collections.Generic;
using Dropbox.Sign.Api;
using Dropbox.Sign.Client;
using Dropbox.Sign.Model;
public class Example
{
public static void Main()
{
var config = new Configuration();
// Configure HTTP basic authorization: api_key
config.Username = "YOUR_API_KEY";
// or, configure Bearer (JWT) authorization: oauth2
// config.AccessToken = "YOUR_BEARER_TOKEN";
var signatureRequestApi = new SignatureRequestApi(config);
var signatureRequestId = "fa5c8a0b0f492d768749333ad6fcc214c111e967";
try
{
var result = signatureRequestApi.SignatureRequestGet(signatureRequestId);
Console.WriteLine(result);
}
catch (ApiException e)
{
Console.WriteLine("Exception when calling Dropbox Sign API: " + e.Message);
Console.WriteLine("Status Code: " + e.ErrorCode);
Console.WriteLine(e.StackTrace);
}
}
}
This returns an ApiResponse object which contains the response data, status code and headers.
try
{
// Get Signature Request
ApiResponse<SignatureRequestGetResponse> response = apiInstance.SignatureRequestGetWithHttpInfo(signatureRequestId);
Debug.Write("Status Code: " + response.StatusCode);
Debug.Write("Response Headers: " + response.Headers);
Debug.Write("Response Body: " + response.Data);
}
catch (ApiException e)
{
Debug.Print("Exception when calling SignatureRequestApi.SignatureRequestGetWithHttpInfo: " + e.Message);
Debug.Print("Status Code: " + e.ErrorCode);
Debug.Print(e.StackTrace);
}
Name | Type | Description | Notes |
---|---|---|---|
signatureRequestId | string | The id of the SignatureRequest to retrieve. |
- Content-Type: Not defined
- Accept: application/json
Status code | Description | Response headers |
---|---|---|
200 | successful operation | * X-RateLimit-Limit - * X-RateLimit-Remaining - * X-Ratelimit-Reset - |
4XX | failed_operation | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
SignatureRequestListResponse SignatureRequestList (string? accountId = null, int? page = null, int? pageSize = null, string? query = null)
List Signature Requests
Returns a list of SignatureRequests that you can access. This includes SignatureRequests you have sent as well as received, but not ones that you have been CCed on. Take a look at our search guide to learn more about querying signature requests.
using System;
using System.Collections.Generic;
using Dropbox.Sign.Api;
using Dropbox.Sign.Client;
using Dropbox.Sign.Model;
public class Example
{
public static void Main()
{
var config = new Configuration();
// Configure HTTP basic authorization: api_key
config.Username = "YOUR_API_KEY";
// or, configure Bearer (JWT) authorization: oauth2
// config.AccessToken = "YOUR_BEARER_TOKEN";
var signatureRequestApi = new SignatureRequestApi(config);
var accountId = "accountId";
try
{
var result = signatureRequestApi.SignatureRequestList(accountId);
Console.WriteLine(result);
}
catch (ApiException e)
{
Console.WriteLine("Exception when calling Dropbox Sign API: " + e.Message);
Console.WriteLine("Status Code: " + e.ErrorCode);
Console.WriteLine(e.StackTrace);
}
}
}
This returns an ApiResponse object which contains the response data, status code and headers.
try
{
// List Signature Requests
ApiResponse<SignatureRequestListResponse> response = apiInstance.SignatureRequestListWithHttpInfo(accountId, page, pageSize, query);
Debug.Write("Status Code: " + response.StatusCode);
Debug.Write("Response Headers: " + response.Headers);
Debug.Write("Response Body: " + response.Data);
}
catch (ApiException e)
{
Debug.Print("Exception when calling SignatureRequestApi.SignatureRequestListWithHttpInfo: " + e.Message);
Debug.Print("Status Code: " + e.ErrorCode);
Debug.Print(e.StackTrace);
}
Name | Type | Description | Notes |
---|---|---|---|
accountId | string? | Which account to return SignatureRequests for. Must be a team member. Use all to indicate all team members. Defaults to your account. |
[optional] |
page | int? | Which page number of the SignatureRequest List to return. Defaults to 1 . |
[optional] [default to 1] |
pageSize | int? | Number of objects to be returned per page. Must be between 1 and 100 . Default is 20 . |
[optional] [default to 20] |
query | string? | String that includes search terms and/or fields to be used to filter the SignatureRequest objects. | [optional] |
- Content-Type: Not defined
- Accept: application/json
Status code | Description | Response headers |
---|---|---|
200 | successful operation | * X-RateLimit-Limit - * X-RateLimit-Remaining - * X-Ratelimit-Reset - |
4XX | failed_operation | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
SignatureRequestGetResponse SignatureRequestReleaseHold (string signatureRequestId)
Release On-Hold Signature Request
Releases a held SignatureRequest that was claimed and prepared from an UnclaimedDraft. The owner of the Draft must indicate at Draft creation that the SignatureRequest created from the Draft should be held. Releasing the SignatureRequest will send requests to all signers.
using System;
using System.Collections.Generic;
using Dropbox.Sign.Api;
using Dropbox.Sign.Client;
using Dropbox.Sign.Model;
public class Example
{
public static void Main()
{
var config = new Configuration();
// Configure HTTP basic authorization: api_key
config.Username = "YOUR_API_KEY";
// or, configure Bearer (JWT) authorization: oauth2
// config.AccessToken = "YOUR_BEARER_TOKEN";
var signatureRequestApi = new SignatureRequestApi(config);
var signatureRequestId = "2f9781e1a8e2045224d808c153c2e1d3df6f8f2f";
try
{
var result = signatureRequestApi.SignatureRequestReleaseHold(signatureRequestId);
Console.WriteLine(result);
}
catch (ApiException e)
{
Console.WriteLine("Exception when calling Dropbox Sign API: " + e.Message);
Console.WriteLine("Status Code: " + e.ErrorCode);
Console.WriteLine(e.StackTrace);
}
}
}
This returns an ApiResponse object which contains the response data, status code and headers.
try
{
// Release On-Hold Signature Request
ApiResponse<SignatureRequestGetResponse> response = apiInstance.SignatureRequestReleaseHoldWithHttpInfo(signatureRequestId);
Debug.Write("Status Code: " + response.StatusCode);
Debug.Write("Response Headers: " + response.Headers);
Debug.Write("Response Body: " + response.Data);
}
catch (ApiException e)
{
Debug.Print("Exception when calling SignatureRequestApi.SignatureRequestReleaseHoldWithHttpInfo: " + e.Message);
Debug.Print("Status Code: " + e.ErrorCode);
Debug.Print(e.StackTrace);
}
Name | Type | Description | Notes |
---|---|---|---|
signatureRequestId | string | The id of the SignatureRequest to release. |
- Content-Type: Not defined
- Accept: application/json
Status code | Description | Response headers |
---|---|---|
200 | successful operation | * X-RateLimit-Limit - * X-RateLimit-Remaining - * X-Ratelimit-Reset - |
4XX | failed_operation | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
SignatureRequestGetResponse SignatureRequestRemind (string signatureRequestId, SignatureRequestRemindRequest signatureRequestRemindRequest)
Send Request Reminder
Sends an email to the signer reminding them to sign the signature request. You cannot send a reminder within 1 hour of the last reminder that was sent. This includes manual AND automatic reminders. NOTE: This action can not be used with embedded signature requests.
using System;
using System.Collections.Generic;
using Dropbox.Sign.Api;
using Dropbox.Sign.Client;
using Dropbox.Sign.Model;
public class Example
{
public static void Main()
{
var config = new Configuration();
// Configure HTTP basic authorization: api_key
config.Username = "YOUR_API_KEY";
// or, configure Bearer (JWT) authorization: oauth2
// config.AccessToken = "YOUR_BEARER_TOKEN";
var signatureRequestApi = new SignatureRequestApi(config);
var data = new SignatureRequestRemindRequest(
emailAddress: "john@example.com"
);
var signatureRequestId = "2f9781e1a8e2045224d808c153c2e1d3df6f8f2f";
try
{
var result = signatureRequestApi.SignatureRequestRemind(signatureRequestId, data);
Console.WriteLine(result);
}
catch (ApiException e)
{
Console.WriteLine("Exception when calling Dropbox Sign API: " + e.Message);
Console.WriteLine("Status Code: " + e.ErrorCode);
Console.WriteLine(e.StackTrace);
}
}
}
This returns an ApiResponse object which contains the response data, status code and headers.
try
{
// Send Request Reminder
ApiResponse<SignatureRequestGetResponse> response = apiInstance.SignatureRequestRemindWithHttpInfo(signatureRequestId, signatureRequestRemindRequest);
Debug.Write("Status Code: " + response.StatusCode);
Debug.Write("Response Headers: " + response.Headers);
Debug.Write("Response Body: " + response.Data);
}
catch (ApiException e)
{
Debug.Print("Exception when calling SignatureRequestApi.SignatureRequestRemindWithHttpInfo: " + e.Message);
Debug.Print("Status Code: " + e.ErrorCode);
Debug.Print(e.StackTrace);
}
Name | Type | Description | Notes |
---|---|---|---|
signatureRequestId | string | The id of the SignatureRequest to send a reminder for. | |
signatureRequestRemindRequest | SignatureRequestRemindRequest |
- Content-Type: application/json
- Accept: application/json
Status code | Description | Response headers |
---|---|---|
200 | successful operation | * X-RateLimit-Limit - * X-RateLimit-Remaining - * X-Ratelimit-Reset - |
4XX | failed_operation | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
void SignatureRequestRemove (string signatureRequestId)
Remove Signature Request Access
Removes your access to a completed signature request. This action is not reversible. The signature request must be fully executed by all parties (signed or declined to sign). Other parties will continue to maintain access to the completed signature request document(s). Unlike /signature_request/cancel, this endpoint is synchronous and your access will be immediately removed. Upon successful removal, this endpoint will return a 200 OK response.
using System;
using System.Collections.Generic;
using Dropbox.Sign.Api;
using Dropbox.Sign.Client;
using Dropbox.Sign.Model;
public class Example
{
public static void Main()
{
var config = new Configuration();
// Configure HTTP basic authorization: api_key
config.Username = "YOUR_API_KEY";
// or, configure Bearer (JWT) authorization: oauth2
// config.AccessToken = "YOUR_BEARER_TOKEN";
var signatureRequestApi = new SignatureRequestApi(config);
var signatureRequestId = "2f9781e1a8e2045224d808c153c2e1d3df6f8f2f";
try
{
signatureRequestApi.SignatureRequestRemove(signatureRequestId);
}
catch (ApiException e)
{
Console.WriteLine("Exception when calling Dropbox Sign API: " + e.Message);
Console.WriteLine("Status Code: " + e.ErrorCode);
Console.WriteLine(e.StackTrace);
}
}
}
This returns an ApiResponse object which contains the response data, status code and headers.
try
{
// Remove Signature Request Access
apiInstance.SignatureRequestRemoveWithHttpInfo(signatureRequestId);
}
catch (ApiException e)
{
Debug.Print("Exception when calling SignatureRequestApi.SignatureRequestRemoveWithHttpInfo: " + e.Message);
Debug.Print("Status Code: " + e.ErrorCode);
Debug.Print(e.StackTrace);
}
Name | Type | Description | Notes |
---|---|---|---|
signatureRequestId | string | The id of the SignatureRequest to remove. |
void (empty response body)
- Content-Type: Not defined
- Accept: application/json
Status code | Description | Response headers |
---|---|---|
200 | successful operation | * X-RateLimit-Limit - * X-RateLimit-Remaining - * X-Ratelimit-Reset - |
4XX | failed_operation | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
SignatureRequestGetResponse SignatureRequestSend (SignatureRequestSendRequest signatureRequestSendRequest)
Send Signature Request
Creates and sends a new SignatureRequest with the submitted documents. If form_fields_per_document
is not specified, a signature page will be affixed where all signers will be required to add their signature, signifying their agreement to all contained documents.
using System;
using System.Collections.Generic;
using System.IO;
using Dropbox.Sign.Api;
using Dropbox.Sign.Client;
using Dropbox.Sign.Model;
public class Example
{
public static void Main()
{
var config = new Configuration();
// Configure HTTP basic authorization: api_key
config.Username = "YOUR_API_KEY";
// or, configure Bearer (JWT) authorization: oauth2
// config.AccessToken = "YOUR_BEARER_TOKEN";
var signatureRequestApi = new SignatureRequestApi(config);
var signer1 = new SubSignatureRequestSigner(
emailAddress: "jack@example.com",
name: "Jack",
order: 0
);
var signer2 = new SubSignatureRequestSigner(
emailAddress: "jill@example.com",
name: "Jill",
order: 1
);
var signingOptions = new SubSigningOptions(
draw: true,
type: true,
upload: true,
phone: true,
defaultType: SubSigningOptions.DefaultTypeEnum.Draw
);
var subFieldOptions = new SubFieldOptions(
dateFormat: SubFieldOptions.DateFormatEnum.DDMMYYYY
);
var metadata = new Dictionary<string, object>()
{
["custom_id"] = 1234,
["custom_text"] = "NDA #9"
};
var files = new List<Stream> {
new FileStream(
"./example_signature_request.pdf",
FileMode.Open,
FileAccess.Read,
FileShare.Read
)
};
var data = new SignatureRequestSendRequest(
title: "NDA with Acme Co.",
subject: "The NDA we talked about",
message: "Please sign this NDA and then we can discuss more. Let me know if you have any questions.",
signers: new List<SubSignatureRequestSigner>(){signer1, signer2},
ccEmailAddresses: new List<string>(){"lawyer1@dropboxsign.com", "lawyer2@dropboxsign.com"},
files: files,
metadata: metadata,
signingOptions: signingOptions,
fieldOptions: subFieldOptions,
testMode: true
);
try
{
var result = signatureRequestApi.SignatureRequestSend(data);
Console.WriteLine(result);
}
catch (ApiException e)
{
Console.WriteLine("Exception when calling Dropbox Sign API: " + e.Message);
Console.WriteLine("Status Code: " + e.ErrorCode);
Console.WriteLine(e.StackTrace);
}
}
}
This returns an ApiResponse object which contains the response data, status code and headers.
try
{
// Send Signature Request
ApiResponse<SignatureRequestGetResponse> response = apiInstance.SignatureRequestSendWithHttpInfo(signatureRequestSendRequest);
Debug.Write("Status Code: " + response.StatusCode);
Debug.Write("Response Headers: " + response.Headers);
Debug.Write("Response Body: " + response.Data);
}
catch (ApiException e)
{
Debug.Print("Exception when calling SignatureRequestApi.SignatureRequestSendWithHttpInfo: " + e.Message);
Debug.Print("Status Code: " + e.ErrorCode);
Debug.Print(e.StackTrace);
}
Name | Type | Description | Notes |
---|---|---|---|
signatureRequestSendRequest | SignatureRequestSendRequest |
- Content-Type: application/json, multipart/form-data
- Accept: application/json
Status code | Description | Response headers |
---|---|---|
200 | successful operation | * X-RateLimit-Limit - * X-RateLimit-Remaining - * X-Ratelimit-Reset - |
4XX | failed_operation | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
SignatureRequestGetResponse SignatureRequestSendWithTemplate (SignatureRequestSendWithTemplateRequest signatureRequestSendWithTemplateRequest)
Send with Template
Creates and sends a new SignatureRequest based off of the Template(s) specified with the template_ids
parameter.
using System;
using System.Collections.Generic;
using Dropbox.Sign.Api;
using Dropbox.Sign.Client;
using Dropbox.Sign.Model;
public class Example
{
public static void Main()
{
var config = new Configuration();
// Configure HTTP basic authorization: api_key
config.Username = "YOUR_API_KEY";
// or, configure Bearer (JWT) authorization: oauth2
// config.AccessToken = "YOUR_BEARER_TOKEN";
var signatureRequestApi = new SignatureRequestApi(config);
var signer1 = new SubSignatureRequestTemplateSigner(
role: "Client",
emailAddress: "george@example.com",
name: "George"
);
var cc1 = new SubCC(
role: "Accounting",
emailAddress: "accouting@emaple.com"
);
var customField1 = new SubCustomField(
name: "Cost",
value: "$20,000",
editor: "Client",
required: true
);
var signingOptions = new SubSigningOptions(
draw: true,
type: true,
upload: true,
phone: false,
defaultType: SubSigningOptions.DefaultTypeEnum.Draw
);
var data = new SignatureRequestSendWithTemplateRequest(
templateIds: new List<string>(){"c26b8a16784a872da37ea946b9ddec7c1e11dff6"},
subject: "Purchase Order",
message: "Glad we could come to an agreement.",
signers: new List<SubSignatureRequestTemplateSigner>(){signer1},
ccs: new List<SubCC>(){cc1},
customFields: new List<SubCustomField>(){customField1},
signingOptions: signingOptions,
testMode: true
);
try
{
var result = signatureRequestApi.SignatureRequestSendWithTemplate(data);
Console.WriteLine(result);
}
catch (ApiException e)
{
Console.WriteLine("Exception when calling Dropbox Sign API: " + e.Message);
Console.WriteLine("Status Code: " + e.ErrorCode);
Console.WriteLine(e.StackTrace);
}
}
}
This returns an ApiResponse object which contains the response data, status code and headers.
try
{
// Send with Template
ApiResponse<SignatureRequestGetResponse> response = apiInstance.SignatureRequestSendWithTemplateWithHttpInfo(signatureRequestSendWithTemplateRequest);
Debug.Write("Status Code: " + response.StatusCode);
Debug.Write("Response Headers: " + response.Headers);
Debug.Write("Response Body: " + response.Data);
}
catch (ApiException e)
{
Debug.Print("Exception when calling SignatureRequestApi.SignatureRequestSendWithTemplateWithHttpInfo: " + e.Message);
Debug.Print("Status Code: " + e.ErrorCode);
Debug.Print(e.StackTrace);
}
Name | Type | Description | Notes |
---|---|---|---|
signatureRequestSendWithTemplateRequest | SignatureRequestSendWithTemplateRequest |
- Content-Type: application/json, multipart/form-data
- Accept: application/json
Status code | Description | Response headers |
---|---|---|
200 | successful operation | * X-RateLimit-Limit - * X-RateLimit-Remaining - * X-Ratelimit-Reset - |
4XX | failed_operation | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
SignatureRequestGetResponse SignatureRequestUpdate (string signatureRequestId, SignatureRequestUpdateRequest signatureRequestUpdateRequest)
Update Signature Request
Updates the email address and/or the name for a given signer on a signature request. You can listen for the signature_request_email_bounce
event on your app or account to detect bounced emails, and respond with this method. Updating the email address of a signer will generate a new signature_id
value. NOTE: This action cannot be performed on a signature request with an appended signature page.
using System;
using System.Collections.Generic;
using Dropbox.Sign.Api;
using Dropbox.Sign.Client;
using Dropbox.Sign.Model;
public class Example
{
public static void Main()
{
var config = new Configuration();
// Configure HTTP basic authorization: api_key
config.Username = "YOUR_API_KEY";
// or, configure Bearer (JWT) authorization: oauth2
// config.AccessToken = "YOUR_BEARER_TOKEN";
var signatureRequestApi = new SignatureRequestApi(config);
var signatureRequestId = "2f9781e1a8e2045224d808c153c2e1d3df6f8f2f";
var data = new SignatureRequestUpdateRequest(
emailAddress: "john@example.com",
signatureId: "78caf2a1d01cd39cea2bc1cbb340dac3"
);
try
{
var result = signatureRequestApi.SignatureRequestUpdate(signatureRequestId, data);
Console.WriteLine(result);
}
catch (ApiException e)
{
Console.WriteLine("Exception when calling Dropbox Sign API: " + e.Message);
Console.WriteLine("Status Code: " + e.ErrorCode);
Console.WriteLine(e.StackTrace);
}
}
}
This returns an ApiResponse object which contains the response data, status code and headers.
try
{
// Update Signature Request
ApiResponse<SignatureRequestGetResponse> response = apiInstance.SignatureRequestUpdateWithHttpInfo(signatureRequestId, signatureRequestUpdateRequest);
Debug.Write("Status Code: " + response.StatusCode);
Debug.Write("Response Headers: " + response.Headers);
Debug.Write("Response Body: " + response.Data);
}
catch (ApiException e)
{
Debug.Print("Exception when calling SignatureRequestApi.SignatureRequestUpdateWithHttpInfo: " + e.Message);
Debug.Print("Status Code: " + e.ErrorCode);
Debug.Print(e.StackTrace);
}
Name | Type | Description | Notes |
---|---|---|---|
signatureRequestId | string | The id of the SignatureRequest to update. | |
signatureRequestUpdateRequest | SignatureRequestUpdateRequest |
- Content-Type: application/json
- Accept: application/json
Status code | Description | Response headers |
---|---|---|
200 | successful operation | * X-RateLimit-Limit - * X-RateLimit-Remaining - * X-Ratelimit-Reset - |
4XX | failed_operation | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]