quotes.sign
Sign a quote after accepting electronic signing and typing a name. Hosted page only. The link is enough. The signer recorded is the job customer's email and the typed name, never whoever is signed in on the browser.
| Who | Hosted page only (a person does it in the browser) |
| REST | POST /v1/quotes/sign |
| MCP tool | Not an MCP tool |
| Writes | yes, send an Idempotency-Key |
| Area | Quotes (unlimited) |
When to use it
Never call it. The customer opens the link from the email or text and types signer_name. They do not need a Doing Work account, and a signed-in browser session is not the signer. n is the hidden value printed on the quote page and bound to this link.
What to tell the owner
Your customer signs on their phone. In Idaho, quotes over $2,000 show the state disclosure and they acknowledge it.
Input
| Field | Type | Required |
|---|---|---|
t | string | yes |
n | string | no |
document_hash | string (sha256) | yes |
esign_consent | string (one of yes) | yes |
disclosure_ack | string (one of yes) | no |
signer_name | string | yes |
option | string | no |
optional_lines | string | no |
Example
POST https://doingwork.work/v1/quotes/sign
content-type: application/json
Idempotency-Key: 3f1c...
{
"t": "...",
"document_hash": "...",
"esign_consent": "yes",
"signer_name": "..."
}Output
JSON. The response shape isn't published yet; read the fields you need and ignore the rest. Errors are {code, message, status}.
Errors
| Code | Status | What to do |
|---|---|---|
human_only | 403 | This step happens on a hosted page the person opens themselves. Send them the link; don't try another route. |
consent_required | 400 | A person must tick a consent box on a hosted page (for example e-sign). Send them the link. |
disclosure_ack_required | 400 | The customer must acknowledge the Idaho disclosure on the hosted signing page. |
invalid_link | 400 | The link was used, expired, or replaced by a newer one. Get a new link. |
invalid_input, invalid_token, rate_limited | Can happen on any call. See errors. |