quotes.finishDraft
Make the quote from a draft once the worker decided every line. Only approved lines go on it, entered as the worker's. scope_of_work or notes on the draft is copied onto the quote as the written scope. Pass either here to set or replace it. The customer quote page and PDF show it. Do not include private worker notes. The quote is a draft: send it with quotes.send only when the worker says so.
| Who | Agents can call this |
| REST | POST /v1/quotes/drafts/finish |
| MCP tool | quotes_finishDraft |
| Writes | yes, send an Idempotency-Key |
| Area | Shop |
When to use it
Make the quote from a draft once the worker decided every line. Only approved lines go on it, entered as the worker's.
What to tell the owner
Say what you did in plain words and what happens next.
Input
| Field | Type | Required |
|---|---|---|
draft_id | string (uuid) | yes |
scope_of_work | ['string', 'null'] | no |
notes | ['string', 'null'] | no |
tax_rate_id | ['string', 'null', ' ', '(', 'u', 'u', 'i', 'd', ')'] | no |
Example
POST https://doingwork.work/v1/quotes/drafts/finish
content-type: application/json
Idempotency-Key: 3f1c...
{
"draft_id": "00000000-0000-4000-8000-000000000000"
}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 |
|---|---|---|
invalid_input, invalid_token, rate_limited | Can happen on any call. See errors. |