Private preview of the new site. Not live.

changes.send

Owner or office: ask the customer to approve a change order. Doing Work writes the document (the lines, totals and the job's total before and after) and returns a single-use sign_url for the agent to deliver; the customer signs it on a hosted page and the change order becomes approved. To send again after the request was cancelled, call this again; for a fresh link on an open request use signatures.newLink.

WhoAgents can call this
RESTPOST /v1/change-orders/send
MCP toolchanges_send
Writesyes, send an Idempotency-Key
AreaField work (checklists, forms, time, notes, change orders, subcontractors)

When to use it

A change order is a priced change to a job's scope: extra work, or a credit for work taken out. A worker writes the lines (changes.create; never fill prices in yourself).

What to tell the owner

Say what you did in plain words and what happens next.

Input

FieldTypeRequired
change_order_idstring (uuid)yes
signer_emailstringno
link_daysintegerno

Example

POST https://doingwork.work/v1/change-orders/send
content-type: application/json
Idempotency-Key: 3f1c...

{
  "change_order_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

CodeStatusWhat to do
invalid_input, invalid_token, rate_limitedCan happen on any call. See errors.