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.
| |
|---|
| Who | Agents can call this |
| REST | GET /v1/visits/recordings |
| MCP tool | visits_recordings |
| Writes | no |
| Area | Scheduling 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.
| Field | Type | Required |
|---|
visit_id | string (uuid) | yes |
Example
GET https://doingwork.work/v1/visits/recordings?visit_id=00000000-0000-4000-8000-000000000000
Output
| Field | Type | Always there |
|---|
recordings | array | yes |
recordings[].recording_id | string (uuid) | yes |
recordings[].visit_id | string (uuid) | yes |
recordings[].job_id | string (uuid) | yes |
recordings[].status | string | yes |
recordings[].recorded_at | string (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[].measurements | array | yes |
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
| Code | Status | What to do |
|---|
invalid_input, invalid_token, rate_limited | | Can happen on any call. See errors. |