Skip to content
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Add edit&resend to OpenAPI docs, and note that it uses quota
  • Loading branch information
jtreminio-dropbox committed May 15, 2025
commit 2bb38eda550096ee1e93a0332f58e3ad33635552
8 changes: 6 additions & 2 deletions docs/SignatureRequestApi.md
Original file line number Diff line number Diff line change
Expand Up @@ -654,7 +654,7 @@ Edit Signature Request

Edits and sends a 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.

**NOTE:** Edit and resend will not deduct your signature request quota.
**NOTE:** Edit and resend *will* deduct your signature request quota.

### Example

Expand Down Expand Up @@ -787,6 +787,8 @@ Edit Embedded Signature Request

Edits a 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.

**NOTE:** Edit and resend *will* deduct your signature request quota.

### Example

```java
Expand Down Expand Up @@ -909,6 +911,8 @@ Edit Embedded Signature Request with Template

Edits a 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.

**NOTE:** Edit and resend *will* deduct your signature request quota.

### Example

```java
Expand Down Expand Up @@ -1020,7 +1024,7 @@ Edit Signature Request With Template

Edits and sends a SignatureRequest based off of the Template(s) specified with the template_ids parameter.

**NOTE:** Edit and resend will not deduct your signature request quota.
**NOTE:** Edit and resend *will* deduct your signature request quota.

### Example

Expand Down
30 changes: 14 additions & 16 deletions openapi-sdk.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -3414,7 +3414,7 @@ paths:
description: |-
Edits and sends a 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.

**NOTE:** Edit and resend will not deduct your signature request quota.
**NOTE:** Edit and resend *will* deduct your signature request quota.
operationId: signatureRequestEdit
parameters:
-
Expand Down Expand Up @@ -3455,7 +3455,7 @@ paths:
$ref: '#/components/schemas/SignatureRequestGetResponse'
examples:
example:
$ref: '#/components/examples/SignatureRequestEditResponse'
$ref: '#/components/examples/SignatureRequestSendResponse'
'4XX':
description: failed_operation
content:
Expand Down Expand Up @@ -3526,14 +3526,15 @@ paths:
seo:
title: 'Edit Signature Request | REST API | Dropbox Sign for Developers'
description: 'Dropbox Sign API allows you to build custom integrations. To find out how to edit a SignatureRequest with the submitted documents, click here.'
x-hideOn: doc
x-beta: closed
'/signature_request/edit_embedded/{signature_request_id}':
put:
tags:
- 'Signature Request'
summary: 'Edit Embedded Signature Request'
description: 'Edits a 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.'
description: |-
Edits a 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.

**NOTE:** Edit and resend *will* deduct your signature request quota.
operationId: signatureRequestEditEmbedded
parameters:
-
Expand Down Expand Up @@ -3574,7 +3575,7 @@ paths:
$ref: '#/components/schemas/SignatureRequestGetResponse'
examples:
example:
$ref: '#/components/examples/SignatureRequestEditEmbeddedResponse'
$ref: '#/components/examples/SignatureRequestCreateEmbeddedResponse'
'4XX':
description: failed_operation
content:
Expand Down Expand Up @@ -3644,14 +3645,15 @@ paths:
seo:
title: 'Edit Embedded Signature Request | Dropbox Sign for Developers'
description: 'The RESTful Dropbox Sign API easily allows you to build custom integrations. To find out how to edit a SignatureRequest in an iFrame, click here.'
x-hideOn: doc
x-beta: closed
'/signature_request/edit_embedded_with_template/{signature_request_id}':
put:
tags:
- 'Signature Request'
summary: 'Edit Embedded Signature Request with Template'
description: 'Edits a 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.'
description: |-
Edits a 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.

**NOTE:** Edit and resend *will* deduct your signature request quota.
operationId: signatureRequestEditEmbeddedWithTemplate
parameters:
-
Expand Down Expand Up @@ -3690,7 +3692,7 @@ paths:
$ref: '#/components/schemas/SignatureRequestGetResponse'
examples:
example:
$ref: '#/components/examples/SignatureRequestEditEmbeddedWithTemplateResponse'
$ref: '#/components/examples/SignatureRequestCreateEmbeddedWithTemplateResponse'
'4XX':
description: failed_operation
content:
Expand Down Expand Up @@ -3760,8 +3762,6 @@ paths:
seo:
title: 'Signature Request with Template | Dropbox Sign for Developers'
description: 'The Dropbox Sign API allows you to build custom integrations. To find out how to edit a SignatureRequest based on the given Template, click here.'
x-hideOn: doc
x-beta: closed
'/signature_request/edit_with_template/{signature_request_id}':
put:
tags:
Expand All @@ -3770,7 +3770,7 @@ paths:
description: |-
Edits and sends a SignatureRequest based off of the Template(s) specified with the template_ids parameter.

**NOTE:** Edit and resend will not deduct your signature request quota.
**NOTE:** Edit and resend *will* deduct your signature request quota.
operationId: signatureRequestEditWithTemplate
parameters:
-
Expand Down Expand Up @@ -3809,7 +3809,7 @@ paths:
$ref: '#/components/schemas/SignatureRequestGetResponse'
examples:
example:
$ref: '#/components/examples/SignatureRequestEditWithTemplateResponse'
$ref: '#/components/examples/SignatureRequestSendWithTemplateResponse'
'4XX':
description: failed_operation
content:
Expand Down Expand Up @@ -3880,8 +3880,6 @@ paths:
seo:
title: 'Edit Signature Request with Template | API Documentation | Dropbox Sign for Developers'
description: 'Dropbox Sign API allows you to build custom integrations. To find out how to edit a SignatureRequest based off of the Template, click here.'
x-hideOn: doc
x-beta: closed
'/signature_request/files/{signature_request_id}':
get:
tags:
Expand Down
16 changes: 8 additions & 8 deletions src/main/java/com/dropbox/sign/api/SignatureRequestApi.java
Original file line number Diff line number Diff line change
Expand Up @@ -383,7 +383,7 @@ public ApiResponse<SignatureRequestGetResponse> signatureRequestCreateEmbeddedWi
}
/**
* Edit Signature Request
* Edits and sends a SignatureRequest with the submitted documents. If &#x60;form_fields_per_document&#x60; 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:** Edit and resend will not deduct your signature request quota.
* Edits and sends a SignatureRequest with the submitted documents. If &#x60;form_fields_per_document&#x60; 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:** Edit and resend *will* deduct your signature request quota.
* @param signatureRequestId The id of the SignatureRequest to edit. (required)
* @param signatureRequestEditRequest (required)
* @return SignatureRequestGetResponse
Expand All @@ -403,7 +403,7 @@ public SignatureRequestGetResponse signatureRequestEdit(String signatureRequestI

/**
* Edit Signature Request
* Edits and sends a SignatureRequest with the submitted documents. If &#x60;form_fields_per_document&#x60; 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:** Edit and resend will not deduct your signature request quota.
* Edits and sends a SignatureRequest with the submitted documents. If &#x60;form_fields_per_document&#x60; 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:** Edit and resend *will* deduct your signature request quota.
* @param signatureRequestId The id of the SignatureRequest to edit. (required)
* @param signatureRequestEditRequest (required)
* @return ApiResponse&lt;SignatureRequestGetResponse&gt;
Expand Down Expand Up @@ -455,7 +455,7 @@ public ApiResponse<SignatureRequestGetResponse> signatureRequestEditWithHttpInfo
}
/**
* Edit Embedded Signature Request
* Edits a 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.
* Edits a 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. **NOTE:** Edit and resend *will* deduct your signature request quota.
* @param signatureRequestId The id of the SignatureRequest to edit. (required)
* @param signatureRequestEditEmbeddedRequest (required)
* @return SignatureRequestGetResponse
Expand All @@ -475,7 +475,7 @@ public SignatureRequestGetResponse signatureRequestEditEmbedded(String signature

/**
* Edit Embedded Signature Request
* Edits a 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.
* Edits a 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. **NOTE:** Edit and resend *will* deduct your signature request quota.
* @param signatureRequestId The id of the SignatureRequest to edit. (required)
* @param signatureRequestEditEmbeddedRequest (required)
* @return ApiResponse&lt;SignatureRequestGetResponse&gt;
Expand Down Expand Up @@ -527,7 +527,7 @@ public ApiResponse<SignatureRequestGetResponse> signatureRequestEditEmbeddedWith
}
/**
* Edit Embedded Signature Request with Template
* Edits a 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.
* Edits a 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. **NOTE:** Edit and resend *will* deduct your signature request quota.
* @param signatureRequestId The id of the SignatureRequest to edit. (required)
* @param signatureRequestEditEmbeddedWithTemplateRequest (required)
* @return SignatureRequestGetResponse
Expand All @@ -547,7 +547,7 @@ public SignatureRequestGetResponse signatureRequestEditEmbeddedWithTemplate(Stri

/**
* Edit Embedded Signature Request with Template
* Edits a 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.
* Edits a 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. **NOTE:** Edit and resend *will* deduct your signature request quota.
* @param signatureRequestId The id of the SignatureRequest to edit. (required)
* @param signatureRequestEditEmbeddedWithTemplateRequest (required)
* @return ApiResponse&lt;SignatureRequestGetResponse&gt;
Expand Down Expand Up @@ -599,7 +599,7 @@ public ApiResponse<SignatureRequestGetResponse> signatureRequestEditEmbeddedWith
}
/**
* Edit Signature Request With Template
* Edits and sends a SignatureRequest based off of the Template(s) specified with the template_ids parameter. **NOTE:** Edit and resend will not deduct your signature request quota.
* Edits and sends a SignatureRequest based off of the Template(s) specified with the template_ids parameter. **NOTE:** Edit and resend *will* deduct your signature request quota.
* @param signatureRequestId The id of the SignatureRequest to edit. (required)
* @param signatureRequestEditWithTemplateRequest (required)
* @return SignatureRequestGetResponse
Expand All @@ -619,7 +619,7 @@ public SignatureRequestGetResponse signatureRequestEditWithTemplate(String signa

/**
* Edit Signature Request With Template
* Edits and sends a SignatureRequest based off of the Template(s) specified with the template_ids parameter. **NOTE:** Edit and resend will not deduct your signature request quota.
* Edits and sends a SignatureRequest based off of the Template(s) specified with the template_ids parameter. **NOTE:** Edit and resend *will* deduct your signature request quota.
* @param signatureRequestId The id of the SignatureRequest to edit. (required)
* @param signatureRequestEditWithTemplateRequest (required)
* @return ApiResponse&lt;SignatureRequestGetResponse&gt;
Expand Down