visits.addRecording

Add a walkthrough recording the worker sent you, during or after the visit. Listen to it yourself first: if it is clearly a different job or not a walkthrough, tell the worker and ask before you add it. Send what the worker said it is (described_as), your transcript, and recorded_at (when the clip was made, from the file) if you have it. Core keeps no audio: keep the clip on your side and send your clip_ref. The transcript and measurements become a voice memo note on the visit. worker_notes are private truck notes (things not said in front of the customer). They are stored on the recording only, not in that note, and are never fed into the recap. Do not put worker_notes in a recap, quote, scope of work, or anything the customer sees. Getting any consent the law requires to record is up to the worker and the shop.

WhoAgents can call this
RESTPOST /v1/visits/recording
MCP toolvisits_addRecording
Writesyes, send an Idempotency-Key
AreaScheduling and visits

When to use it

Add a walkthrough recording the worker sent you, during or after the visit. Listen to it yourself first: if it is clearly a different job or not a walkthrough, tell the worker and ask before you add it.

What to tell the owner

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

Input

FieldTypeRequired
visit_idstring (uuid)yes
described_asstringno
transcriptstringyes
recorded_atstring (date-time)no
duration_secondsintegerno
transcribed_withstringno
clip_refstringno
worker_notesstringno
measurementsarrayno
measurements[].labelstringyes
measurements[].valuenumberyes
measurements[].unitstringno

Example

POST https://doingwork.work/v1/visits/recording
content-type: application/json
Idempotency-Key: 3f1c...

{
  "visit_id": "00000000-0000-4000-8000-000000000000",
  "transcript": "..."
}

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.