Qodex.ai

Update call

PATCH {{baseUrl}}/v1/calls/:call_id

This API updates the details of a call.

OAuth Scope

  • Desk.activities.calls.UPDATE
  • Desk.activities.UPDATE
  • Desk.calls.UPDATE

Attributes

Attribute NameData TypeDescription
customFields<list>
User-defined fields related to the call
cf<list>
User-defined fields related to the call
departmentId<long>
ID of the department associated with the call and ticket
subject<string>
max chars : 300		Subject of the call
startTime<timestamp>
Time when the call started. The value of this key must be recorded in the ISO date format of yyyy-MM-ddThh:mm:ss.SSSZ.
direction<string>
max chars : 100		Direction of the call: inbound or outbound
duration<integer>
Duration of the call in seconds
status<string>
max chars : 120		Completion status of the call
ownerId<long>
ID of the user to whom the call is assigned
priority<string>
max chars : 120		Priority of the call
description<string>
max chars : 65535		Description of the call
ticketId<long>
ID of the ticket associated with the call
contactId<long>
ID of the contact associated with the call
reminder<JSONArray>
Details of the reminder associated with the call

HEADERS

KeyDatatypeRequiredDescription
Authorizationstring

RESPONSES

status: OK

{&quot;modifiedTime&quot;:&quot;2016-07-14T08:29:26.000Z&quot;,&quot;cf&quot;:{},&quot;contactId&quot;:&quot;30000000088017&quot;,&quot;subject&quot;:&quot;New Testing Call&quot;,&quot;completedTime&quot;:&quot;2016-07-14T08:29:26.000Z&quot;,&quot;departmentId&quot;:&quot;3000000007043&quot;,&quot;creatorId&quot;:&quot;3000000008692&quot;,&quot;description&quot;:&quot;Call completed with a callback request&quot;,&quot;ownerId&quot;:null,&quot;priority&quot;:&quot;High&quot;,&quot;duration&quot;:&quot;120&quot;,&quot;webUrl&quot;:&quot;https://desk.zoho.com/support/zylker/ShowHomePage.do#Calls/dv/51123033fe97b2f886f750280ded9c40&quot;,&quot;createdTime&quot;:&quot;2016-07-14T08:27:26.000Z&quot;,&quot;modifiedBy&quot;:{&quot;firstName&quot;:&quot;George&quot;,&quot;lastName&quot;:&quot;McKinson&quot;,&quot;photoURL&quot;:null,&quot;id&quot;:&quot;5000000015911&quot;},&quot;id&quot;:&quot;3000000054002&quot;,&quot;isSpam&quot;:false,&quot;ticketId&quot;:&quot;3000000008753&quot;,&quot;direction&quot;:&quot;inbound&quot;,&quot;status&quot;:&quot;completed&quot;}