/v1/comms/callsRead the call log
Every call this workspace logged, newest first, across every thread — including threads filed under no record. Narrow with direction, or by record: definitionKey (the page's key, like "leads") or definitionId (its uuid), with rowId repeated for several records (rowId=a&rowId=b) or left out for every record on the page. ONE CALL FOR MANY RECORDS — never one call per record (2026-10-08: a review of 30 leads read their calls one at a time and ran out of time). Start here for "who called them, when, and how long did it go".
Access class: workspace.
Send request
Use the documented inputs to call this endpoint directly.
Parameters
Values are applied to the request and the example on the right.
"inbound" · "outbound"
Responses
the action's answer
{
"calls": [
"string"
],
"total": 1.5
}a refusal: {"error": "<what a person needs to read>"}. 401 no credential, 402 the plan does not include this, 403 the seat does not, 404 the thing does not exist or is not yours to see.
{
"error": "string"
}