forms.requestSignOff

Ask for a signature on a submitted form and get the signing link (owner or office). The signer (the customer by default, or a shop member) signs the stored PDF exactly as submitted.


Who	Agents can call this
REST	`POST /v1/forms/sign-off`
MCP tool	`forms_requestSignOff`
Writes	yes, send an Idempotency-Key
Area	Field work (checklists, forms, time, notes, change orders, subcontractors)

When to use it

Keep form templates (forms.saveTemplate: ordered fields of type heading, text, long_text, number, yes_no, choice, multi_choice, date or photos, each optionally required). Start a form on a job or one visit (forms.start) from a template, from an earlier form (copy_from_form_id, which also carries its answers), or with fields given on the spot; the form keeps its own copy of the fields.

What to tell the owner

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

Input

Field	Type	Required
`form_id`	string (uuid)	yes
`signer_role`	string (one of customer, member)	no
`signer_email`	string	no
`link_days`	integer	no

Example

POST https://doingwork.work/v1/forms/sign-off
content-type: application/json
Idempotency-Key: 3f1c...

{
  "form_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.