visits.recordings

Recordings on a visit, newest first: when each was recorded, what the worker said it was, the note its transcript became, and private worker_notes. worker_notes are truck notes for the shop only. Never put them in a recap, quote, scope of work, or anything the customer sees.

WhoAgents can call this
RESTGET /v1/visits/recordings
MCP toolvisits_recordings
Writesno
AreaScheduling and visits

When to use it

Recordings on a visit, newest first: when each was recorded, what the worker said it was, the note its transcript became, and private worker_notes. worker_notes are truck notes for the shop only.

What to tell the owner

Tell them what you found in plain words. Don't read back raw fields.

Input

FieldTypeRequired
visit_idstring (uuid)yes

Example

GET https://doingwork.work/v1/visits/recordings?visit_id=00000000-0000-4000-8000-000000000000

Output

FieldTypeAlways there
recordingsarrayyes
recordings[].recording_idstring (uuid)yes
recordings[].visit_idstring (uuid)yes
recordings[].job_idstring (uuid)yes
recordings[].statusstringyes
recordings[].recorded_atstring (date-time)yes
recordings[].added_at['string', 'null', ' ', '(', 'd', 'a', 't', 'e', '-', 't', 'i', 'm', 'e', ')']yes
recordings[].described_as['string', 'null']yes
recordings[].clip_ref['string', 'null']yes
recordings[].note_id['string', 'null', ' ', '(', 'u', 'u', 'i', 'd', ')']yes
recordings[].measurementsarrayyes
recordings[].worker_notes['string', 'null']yes
{
  "recordings": [
    {
      "recording_id": "00000000-0000-4000-8000-000000000000",
      "visit_id": "00000000-0000-4000-8000-000000000000",
      "job_id": "00000000-0000-4000-8000-000000000000",
      "status": "...",
      "recorded_at": "...",
      "added_at": "...",
      "described_as": "...",
      "clip_ref": "...",
      "note_id": "00000000-0000-4000-8000-000000000000",
      "measurements": [
        "..."
      ],
      "worker_notes": "..."
    }
  ]
}

Errors

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