quotes.send
Lock the quote and get a single-use signing link for the customer (the customer signs on the hosted page; an agent cannot sign or accept a quote). Who may send is shops.sendPermissions: the owner always may, office for any job, a lead for jobs on their crew, and a field worker for jobs assigned to them, until the owner turns that off. Lines an agent drafted are refused until a person who may send quotes sends the quote. An agent token cannot send those lines. A quote imported as history cannot be sent.
| Who | Agents can call this |
| REST | POST /v1/quotes/send |
| MCP tool | quotes_send |
| Writes | yes, send an Idempotency-Key |
| Area | Quotes (unlimited) |
When to use it
A person whose role may send quotes says to send it. The owner can always send. Office can send for any job, a lead for jobs on their crew, and field for jobs assigned to them, until the owner turns send_quotes off. Lock it and send the customer the signing link. An agent token cannot send lines an agent drafted.
What to tell the owner
The quote is locked. Here's the signing link for your customer.
Input
| Field | Type | Required |
|---|---|---|
quote_id | string | yes |
email_customer | boolean | no |
Example
POST https://doingwork.work/v1/quotes/send
content-type: application/json
Idempotency-Key: 3f1c...
{
"quote_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 |
|---|---|---|
conflict | 409 | The record is in the wrong state for this, for example sending a quote that's already signed. Read it again and pick the next step. |
not_found | 404 | No such record, or this worker can't see it. |
invalid_input, invalid_token, rate_limited | Can happen on any call. See errors. |