Update a Call activity
Most commonly used to update note_html or outcome_id. Some fields (status, duration, direction) cannot be updated for internal calls made through Close’s VoIP system.
note_html and note: setting one overwrites the other. If both are provided, note_html takes precedence. note_html supports rich-text HTML; note is plaintext only.
Deleting recordings: for internal calls, setting recording_url, voicemail_url, or recording_transcript to null permanently deletes the corresponding recording, voicemail, or transcript. A delete requires the delete_own_activities permission for your own calls, or manage_others_activities for other users’ calls and calls not assigned to a user. Without the required permission, the request fails with a 400 error. Any other new value for recording_url or voicemail_url also fails with a 400 error.
Authentication
Bearer authentication of the form Bearer <token>, where token is your auth token.
Path parameters
Request
HTTPS URL of the recording of a call that you log through the API. For a call made through Close, only null can change this field, and it deletes the recording.
HTTPS URL of the voicemail that the caller left, for a call that you log through the API. The call must be inbound and completed, with a duration of 0. For a call made through Close, only null can change this field, and it deletes the voicemail.
Response
Source of a phone activity. Describes whether the phone activity (such as a call or an SMS) was handled by Close’s telephony provider or handled externally by a 3rd party and is merely logged in Close.
URL of the call recording, or null if the call has no recording or the recording expired. A GET request to this URL needs the same authentication as other API requests. The response is a redirect to the audio file. For a call that you logged through the API, the redirect goes to the recording URL that you sent.
URL of the voicemail that the caller left on an inbound call, or null if the call has no voicemail. A GET request to this URL needs the same authentication as other API requests. The response is a redirect to the audio file. For a call that you logged through the API, the redirect goes to the voicemail URL that you sent.