--- title: visits.draftRecap | Doing Work API description: Draft the recap email for the customer after a visit. For a detailed recap, pass body (the full email) or what_happened, options_discussed and next_steps. url: https://doingwork.work/docs/reference/visits-draftrecap/ --- # visits.draftRecap Draft the recap email for the customer after a visit. For a detailed recap, pass body (the full email) or what_happened, options_discussed and next_steps. Leave those out to use the short template: what_we_saw in the worker's own words (or measurements from a saved recording) and the next step. Private worker_notes from a recording are never included, and a draft that contains them is refused. Nothing is sent: show the worker the draft, edit it with visits.editRecap, and send only when they approve with visits.approveRecap. Drafting again replaces the open draft. | | | |---|---| | Who | Agents can call this | | REST | `POST /v1/visits/recap/draft` | | MCP tool | `visits_draftRecap` | | Writes | yes, send an Idempotency-Key | | Area | [Scheduling and visits](https://doingwork.work/docs/reference/#scheduling-and-visits) | ## When to use it Draft the recap email for the customer after a visit. For a detailed recap, pass body (the full email) or what_happened, options_discussed and next_steps. ## What to tell the owner Say what you did in plain words and what happens next. ## Input | Field | Type | Required | |---|---|---| | `visit_id` | string (uuid) | yes | | `what_we_saw` | array | no | | `next_step` | string | no | | `subject` | string | no | | `body` | string | no | | `what_happened` | string | no | | `options_discussed` | string | no | | `next_steps` | string | no | ## Example ```http POST https://doingwork.work/v1/visits/recap/draft content-type: application/json Idempotency-Key: 3f1c... { "visit_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](https://doingwork.work/docs/errors/). |