Skip to content

Commit edc823a

Browse files
Add edit&resend to OpenAPI docs, and note that it uses quota
1 parent f2e8a6c commit edc823a

24 files changed

Lines changed: 167 additions & 51 deletions

bin/check-clean-git-status

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,6 @@ if [[ $(git status --porcelain) != '' ]]; then
77
printf "\t./run-build\n"
88

99
git status
10-
git diff
1110

1211
exit 1
1312
else

docs/SignatureRequestApi.md

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -613,7 +613,7 @@ Edit Signature Request
613613
614614
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.
615615
616-
**NOTE:** Edit and resend will not deduct your signature request quota.
616+
**NOTE:** Edit and resend *will* deduct your signature request quota.
617617
618618
### Example
619619
@@ -738,6 +738,8 @@ Edit Embedded Signature Request
738738
739739
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.
740740
741+
**NOTE:** Edit and resend *will* deduct your signature request quota.
742+
741743
### Example
742744
743745
* Basic Authentication (api_key):
@@ -849,6 +851,8 @@ Edit Embedded Signature Request with Template
849851
850852
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.
851853
854+
**NOTE:** Edit and resend *will* deduct your signature request quota.
855+
852856
### Example
853857
854858
* Basic Authentication (api_key):
@@ -952,7 +956,7 @@ Edit Signature Request With Template
952956
953957
Edits and sends a SignatureRequest based off of the Template(s) specified with the template_ids parameter.
954958
955-
**NOTE:** Edit and resend will not deduct your signature request quota.
959+
**NOTE:** Edit and resend *will* deduct your signature request quota.
956960
957961
### Example
958962

dropbox_sign/api/signature_request_api.py

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1476,7 +1476,7 @@ def signature_request_edit(
14761476
) -> SignatureRequestGetResponse:
14771477
"""Edit Signature Request
14781478
1479-
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.
1479+
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* deduct your signature request quota.
14801480
14811481
:param signature_request_id: The id of the SignatureRequest to edit. (required)
14821482
:type signature_request_id: str
@@ -1547,7 +1547,7 @@ def signature_request_edit_with_http_info(
15471547
) -> ApiResponse[SignatureRequestGetResponse]:
15481548
"""Edit Signature Request
15491549
1550-
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.
1550+
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* deduct your signature request quota.
15511551
15521552
:param signature_request_id: The id of the SignatureRequest to edit. (required)
15531553
:type signature_request_id: str
@@ -1618,7 +1618,7 @@ def signature_request_edit_without_preload_content(
16181618
) -> RESTResponseType:
16191619
"""Edit Signature Request
16201620
1621-
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.
1621+
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* deduct your signature request quota.
16221622
16231623
:param signature_request_id: The id of the SignatureRequest to edit. (required)
16241624
:type signature_request_id: str
@@ -1774,7 +1774,7 @@ def signature_request_edit_embedded(
17741774
) -> SignatureRequestGetResponse:
17751775
"""Edit Embedded Signature Request
17761776
1777-
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.
1777+
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.
17781778
17791779
:param signature_request_id: The id of the SignatureRequest to edit. (required)
17801780
:type signature_request_id: str
@@ -1845,7 +1845,7 @@ def signature_request_edit_embedded_with_http_info(
18451845
) -> ApiResponse[SignatureRequestGetResponse]:
18461846
"""Edit Embedded Signature Request
18471847
1848-
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.
1848+
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.
18491849
18501850
:param signature_request_id: The id of the SignatureRequest to edit. (required)
18511851
:type signature_request_id: str
@@ -1916,7 +1916,7 @@ def signature_request_edit_embedded_without_preload_content(
19161916
) -> RESTResponseType:
19171917
"""Edit Embedded Signature Request
19181918
1919-
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.
1919+
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.
19201920
19211921
:param signature_request_id: The id of the SignatureRequest to edit. (required)
19221922
:type signature_request_id: str
@@ -2072,7 +2072,7 @@ def signature_request_edit_embedded_with_template(
20722072
) -> SignatureRequestGetResponse:
20732073
"""Edit Embedded Signature Request with Template
20742074
2075-
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.
2075+
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.
20762076
20772077
:param signature_request_id: The id of the SignatureRequest to edit. (required)
20782078
:type signature_request_id: str
@@ -2143,7 +2143,7 @@ def signature_request_edit_embedded_with_template_with_http_info(
21432143
) -> ApiResponse[SignatureRequestGetResponse]:
21442144
"""Edit Embedded Signature Request with Template
21452145
2146-
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.
2146+
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.
21472147
21482148
:param signature_request_id: The id of the SignatureRequest to edit. (required)
21492149
:type signature_request_id: str
@@ -2214,7 +2214,7 @@ def signature_request_edit_embedded_with_template_without_preload_content(
22142214
) -> RESTResponseType:
22152215
"""Edit Embedded Signature Request with Template
22162216
2217-
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.
2217+
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.
22182218
22192219
:param signature_request_id: The id of the SignatureRequest to edit. (required)
22202220
:type signature_request_id: str
@@ -2373,7 +2373,7 @@ def signature_request_edit_with_template(
23732373
) -> SignatureRequestGetResponse:
23742374
"""Edit Signature Request With Template
23752375
2376-
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.
2376+
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.
23772377
23782378
:param signature_request_id: The id of the SignatureRequest to edit. (required)
23792379
:type signature_request_id: str
@@ -2444,7 +2444,7 @@ def signature_request_edit_with_template_with_http_info(
24442444
) -> ApiResponse[SignatureRequestGetResponse]:
24452445
"""Edit Signature Request With Template
24462446
2447-
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.
2447+
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.
24482448
24492449
:param signature_request_id: The id of the SignatureRequest to edit. (required)
24502450
:type signature_request_id: str
@@ -2515,7 +2515,7 @@ def signature_request_edit_with_template_without_preload_content(
25152515
) -> RESTResponseType:
25162516
"""Edit Signature Request With Template
25172517
2518-
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.
2518+
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.
25192519
25202520
:param signature_request_id: The id of the SignatureRequest to edit. (required)
25212521
:type signature_request_id: str

dropbox_sign/configuration.py

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -546,7 +546,9 @@ def to_debug_report(self) -> str:
546546
"OS: {env}\n"
547547
"Python Version: {pyversion}\n"
548548
"Version of the API: 3.0.0\n"
549-
"SDK Package Version: 1.9.0".format(env=sys.platform, pyversion=sys.version)
549+
"SDK Package Version: 1.9.0".format(
550+
env=sys.platform, pyversion=sys.version
551+
)
550552
)
551553

552554
def get_host_settings(self) -> List[HostSetting]:

dropbox_sign/models/api_app_create_request.py

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -45,7 +45,9 @@ class ApiAppCreateRequest(BaseModel):
4545
description="The URL at which the ApiApp should receive event callbacks.",
4646
)
4747
custom_logo_file: Optional[
48-
Union[StrictBytes, StrictStr, io.IOBase, Tuple[StrictStr, StrictBytes, io.IOBase]]
48+
Union[
49+
StrictBytes, StrictStr, io.IOBase, Tuple[StrictStr, StrictBytes, io.IOBase]
50+
]
4951
] = Field(
5052
default=None,
5153
description="An image file to use as a custom logo in embedded contexts. (Only applies to some API plans)",

dropbox_sign/models/api_app_update_request.py

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -41,7 +41,9 @@ class ApiAppUpdateRequest(BaseModel):
4141
description="The URL at which the API App should receive event callbacks.",
4242
)
4343
custom_logo_file: Optional[
44-
Union[StrictBytes, StrictStr, io.IOBase, Tuple[StrictStr, StrictBytes, io.IOBase]]
44+
Union[
45+
StrictBytes, StrictStr, io.IOBase, Tuple[StrictStr, StrictBytes, io.IOBase]
46+
]
4547
] = Field(
4648
default=None,
4749
description="An image file to use as a custom logo in embedded contexts. (Only applies to some API plans)",

dropbox_sign/models/fax_send_request.py

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,14 @@ class FaxSendRequest(BaseModel):
3939
default=None, description="Fax Send From Sender (used only with fax number)"
4040
)
4141
files: Optional[
42-
List[Union[StrictBytes, StrictStr, io.IOBase, Tuple[StrictStr, StrictBytes, io.IOBase]]]
42+
List[
43+
Union[
44+
StrictBytes,
45+
StrictStr,
46+
io.IOBase,
47+
Tuple[StrictStr, StrictBytes, io.IOBase],
48+
]
49+
]
4350
] = Field(
4451
default=None,
4552
description="Use `files[]` to indicate the uploaded file(s) to fax This endpoint requires either **files** or **file_urls[]**, but not both.",

dropbox_sign/models/signature_request_bulk_create_embedded_with_template_request.py

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,9 @@ class SignatureRequestBulkCreateEmbeddedWithTemplateRequest(BaseModel):
4343
description="Client id of the app you're using to create this embedded signature request. Used for security purposes."
4444
)
4545
signer_file: Optional[
46-
Union[StrictBytes, StrictStr, io.IOBase, Tuple[StrictStr, StrictBytes, io.IOBase]]
46+
Union[
47+
StrictBytes, StrictStr, io.IOBase, Tuple[StrictStr, StrictBytes, io.IOBase]
48+
]
4749
] = Field(
4850
default=None,
4951
description="`signer_file` is a CSV file defining values and options for signer fields. Required unless a `signer_list` is used, you may not use both. The CSV can have the following columns: - `name`: the name of the signer filling the role of RoleName - `email_address`: email address of the signer filling the role of RoleName - `pin`: the 4- to 12-character access code that will secure this signer's signature page (optional) - `sms_phone_number`: An E.164 formatted phone number that will receive a code via SMS to access this signer's signature page. (optional) By using the feature, you agree you are responsible for obtaining a signer's consent to receive text messages from Dropbox Sign related to this signature request and confirm you have obtained such consent from all signers prior to enabling SMS delivery for this signature request. [Learn more](https://faq.hellosign.com/hc/en-us/articles/15815316468877-Dropbox-Sign-SMS-tools-add-on). **NOTE:** Not available in test mode and requires a Standard plan or higher. - `*_field`: any column with a _field\" suffix will be treated as a custom field (optional) You may only specify field values here, any other options should be set in the custom_fields request parameter. Example CSV: ``` name, email_address, pin, company_field George, george@example.com, d79a3td, ABC Corp Mary, mary@example.com, gd9as5b, 123 LLC ```",

dropbox_sign/models/signature_request_bulk_send_with_template_request.py

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -40,7 +40,9 @@ class SignatureRequestBulkSendWithTemplateRequest(BaseModel):
4040
description="Use `template_ids` to create a SignatureRequest from one or more templates, in the order in which the template will be used."
4141
)
4242
signer_file: Optional[
43-
Union[StrictBytes, StrictStr, io.IOBase, Tuple[StrictStr, StrictBytes, io.IOBase]]
43+
Union[
44+
StrictBytes, StrictStr, io.IOBase, Tuple[StrictStr, StrictBytes, io.IOBase]
45+
]
4446
] = Field(
4547
default=None,
4648
description="`signer_file` is a CSV file defining values and options for signer fields. Required unless a `signer_list` is used, you may not use both. The CSV can have the following columns: - `name`: the name of the signer filling the role of RoleName - `email_address`: email address of the signer filling the role of RoleName - `pin`: the 4- to 12-character access code that will secure this signer's signature page (optional) - `sms_phone_number`: An E.164 formatted phone number that will receive a code via SMS to access this signer's signature page. (optional) By using the feature, you agree you are responsible for obtaining a signer's consent to receive text messages from Dropbox Sign related to this signature request and confirm you have obtained such consent from all signers prior to enabling SMS delivery for this signature request. [Learn more](https://faq.hellosign.com/hc/en-us/articles/15815316468877-Dropbox-Sign-SMS-tools-add-on). **NOTE:** Not available in test mode and requires a Standard plan or higher. - `*_field`: any column with a _field\" suffix will be treated as a custom field (optional) You may only specify field values here, any other options should be set in the custom_fields request parameter. Example CSV: ``` name, email_address, pin, company_field George, george@example.com, d79a3td, ABC Corp Mary, mary@example.com, gd9as5b, 123 LLC ```",

dropbox_sign/models/signature_request_create_embedded_request.py

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -58,7 +58,14 @@ class SignatureRequestCreateEmbeddedRequest(BaseModel):
5858
description="Client id of the app you're using to create this embedded signature request. Used for security purposes."
5959
)
6060
files: Optional[
61-
List[Union[StrictBytes, StrictStr, io.IOBase, Tuple[StrictStr, StrictBytes, io.IOBase]]]
61+
List[
62+
Union[
63+
StrictBytes,
64+
StrictStr,
65+
io.IOBase,
66+
Tuple[StrictStr, StrictBytes, io.IOBase],
67+
]
68+
]
6269
] = Field(
6370
default=None,
6471
description="Use `files[]` to indicate the uploaded file(s) to send for signature. This endpoint requires either **files** or **file_urls[]**, but not both.",

0 commit comments

Comments
 (0)