Skip to main content
PATCH
Update a Call
Reach the call by the _id the log answered, or by the externalId you sent. Only calls logged through POST /calls can be updated here: the status, the note and the media of a call made with the lemlist dialer, Aircall or Ringover are lemlist’s own, and such a call answers 404 CALLS_API_CALL_NOT_UPDATABLE even though GET /calls/{id} reads it. The status, the note and the duration reach the CRM call. The recording is fetched in the background: read the call back with GET /calls/{id} until hasRecording turns true, and send the PATCH again with a reachable URL when it does not.

Authorizations

Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Path Parameters

id
string
required

The call's _id (act_…) or its externalId.

Body

application/json
callStatus
string

A key of the team's call statuses (GET /call-statuses). Runs the automations that status carries, as the team configured them, and reaches the CRM call.

Example:

"left-voicemail"

note
string
Maximum string length: 10000
Example:

"Left a voicemail, call back Thursday."

duration
integer

Seconds. Moves the end of the call accordingly, and reaches the CRM call (HubSpot, Salesforce, Pipedrive).

Required range: 0 <= x <= 86400
Example:

45

recordingUrl
string<uri>

An https URL of the recording, reachable from the public internet. An empty string means no recording, so it does not count as a field to update.

Maximum string length: 2048
Example:

"https://recordings.dialer.example/8f2c1.mp3"

transcript
string

The transcript as plain text.

Maximum string length: 200000
Example:

"Hi Jane, this is Alex from lemlist…"

Response

The call, re-read after the update. hasRecording turns true once the recording is stored, a moment later.

success
boolean
Example:

true

data
object

A call logged through POST /calls, as the calls API returns it.