notes.addVoiceMemo

Save a voice memo as a note: send the transcript your agent made, the memo's length in seconds, when it was recorded, and what transcribed it. Core runs no speech-to-text and does not keep the audio. Same rules as notes.add for who sees and pins it.

WhoAgents can call this
RESTPOST /v1/notes/voice-memo
MCP toolnotes_addVoiceMemo
Writesyes, send an Idempotency-Key
AreaField work (checklists, forms, time, notes, change orders, subcontractors)

When to use it

Save a voice memo as a note: send the transcript your agent made, the memo's length in seconds, when it was recorded, and what transcribed it. Core runs no speech-to-text and does not keep the audio.

What to tell the owner

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

Input

FieldTypeRequired
target_kindstring (one of job, visit, media, customer, property, equipment, quote, invoice, request, worker, payment, pricebook_item, maintenance_plan, shop)no
target_idstring (uuid)no
job_idstring (uuid)no
visit_idstring (uuid)no
transcriptstringyes
duration_secondsintegeryes
recorded_atstring (date-time)no
transcribed_withstringno
languagestringno
audiencestring (one of team, office)no
pinnedbooleanno
media_idsarrayno
mentionsarrayno
agent_namestringno

Example

POST https://doingwork.work/v1/notes/voice-memo
content-type: application/json
Idempotency-Key: 3f1c...

{
  "transcript": "...",
  "duration_seconds": 1
}

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.