Decline a task

post

https://api.dottedsign.com/v1/sign_tasks/decline

Decline a task.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Allow authentication via Bearer Token or JWT Code.

scope: sign_tasks.signing.write
available user plans: all

Body Params

Sign task decline.

task_id

integer

required

Task ID.

decline_option_id

integer

required

Decline option ID.

reason

string

required

The reason to decline the task.

reply_to

array of strings

The email list to reply to. Only works if informable is set to true in the task and stage setting.
Only allows emails from owner, signer, or cc members. Defaults to all emails that have received notifications for this task.

reply_to

verify_info

object

Verify information for identity verification, account protection, and quick sign. See Verify Identity with OTP for more details about the verification process.

Headers

Authorization

string

OAuth2 Bearer token.

Code

string

JWT code for quick sign authentication. Use it instead of the Authorization bearer token to read or sign a task on behalf of a signer who is not a DottedSign member.

The Get the share link API returns a share_link such as https://www.dottedsign.com/task?code=eyJhbGciOiJIUzUxMiJ9....

JWT code is the value of that URL's code query parameter; it is not returned as a separate field in the response.

Quick sign authentication is only available to signers who do not have a DottedSign account. If the signer is a registered DottedSign member, the request is rejected with the login_required (401_030) error and the signer must sign in to read and sign the task, no matter how the quick sign setting is configured.

Responses

200200

400400

401401

403403

404404