Sign in
latestOpenAPI 3.1.02026-08-233001841.3 MB

0dcf3303e9d7

activities.calls

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, changing or clearing recording_url or voicemail_url, or setting recording_transcript to null, permanently deletes the corresponding recording, voicemail, or transcript. This 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.

put/activity/call/{id}/

Path parameters

idstring required

Request body

activity_atstring date-time nullable
contact_idstring nullable
conversation_type_idstring nullable
durationinteger nullable
lead_idstring nullable
notestring nullable
note_htmlstring nullable
outcome_idstring nullable
phonestring nullable

Phone number in E.164 format

playbook_idstring nullable
quality_infostring nullable
recording_urlstring uri nullable
status'created' | 'in-progress' | 'completed' | 'cancel' | 'no-answer' | 'busy' | 'failed' | 'timeout' | 'null' nullable
user_idstring nullable
voicemail_urlstring uri nullable

Response

Successful response

_typestring required
activity_atstring date-time nullable required
contact_idstring nullable required
created_bystring nullable required
created_by_namestring nullable
date_createdstring date-time required
date_updatedstring date-time required
idstring required
lead_idstring nullable required
organization_idstring required
outcome_idstring nullable required
sequence_idstring nullable
sequence_namestring nullable
sequence_subscription_idstring nullable
source'Close.io' | 'External' required

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.

status'created' | 'in-progress' | 'completed' | 'cancel' | 'no-answer' | 'busy' | 'failed' | 'timeout' required

Current status of the call.

updated_bystring nullable required
updated_by_namestring nullable
user_idstring nullable required
user_namestring nullable
usersstring[] required