Update Layout

PATCH {{baseUrl}}/api/v1/layouts/:layout_id

This API updates details of an existing layout.

OAuth Scope

  • Desk.settings.UPDATE

Attributes

Attribute NameData TypeDescription
isDefaultLayout<boolean>
Key that returns if the layout is the default layout in the module
sections<list>
sections in the layout
module<string>
max chars : 100
mdoule name

HEADERS

KeyDatatypeRequiredDescription
Authorizationstring

RESPONSES

status: OK

{&quot;modifiedTime&quot;:&quot;2017-07-01T07:36:04.000Z&quot;,&quot;skipDeptAccessValidation&quot;:false,&quot;createdBy&quot;:&quot;4000000009118&quot;,&quot;departmentId&quot;:&quot;4000000007175&quot;,&quot;layoutDisplayName&quot;:&quot;ClonedLayout&quot;,&quot;createdTime&quot;:&quot;2017-07-01T07:36:04.000Z&quot;,&quot;modifiedBy&quot;:&quot;&quot;,&quot;id&quot;:&quot;4000000007177&quot;,&quot;isDefaultLayout&quot;:true,&quot;sections&quot;:[{&quot;name&quot;:&quot;Ticket Information&quot;,&quot;isCustomSection&quot;:false,&quot;id&quot;:1,&quot;fields&quot;:[{&quot;displayLabel&quot;:&quot;Department&quot;,&quot;apiName&quot;:&quot;departmentId&quot;,&quot;isCustomField&quot;:false,&quot;isEncryptedField&quot;:false,&quot;id&quot;:&quot;4000000000353&quot;,&quot;isSystemMandatory&quot;:false,&quot;isRemovable&quot;:false,&quot;type&quot;:&quot;LookUp&quot;,&quot;maxLength&quot;:50,&quot;isMandatory&quot;:true},{&quot;displayLabel&quot;:&quot;Contact Name&quot;,&quot;apiName&quot;:&quot;contactId&quot;,&quot;isCustomField&quot;:false,&quot;isEncryptedField&quot;:false,&quot;id&quot;:&quot;4000000000357&quot;,&quot;isSystemMandatory&quot;:true,&quot;isRemovable&quot;:false,&quot;type&quot;:&quot;LookUp&quot;,&quot;maxLength&quot;:300,&quot;isMandatory&quot;:true},{&quot;displayLabel&quot;:&quot;Account Name&quot;,&quot;apiName&quot;:&quot;accountId&quot;,&quot;isCustomField&quot;:false,&quot;isEncryptedField&quot;:false,&quot;id&quot;:&quot;4000000000355&quot;,&quot;isSystemMandatory&quot;:false,&quot;isRemovable&quot;:true,&quot;type&quot;:&quot;LookUp&quot;,&quot;maxLength&quot;:300,&quot;isMandatory&quot;:false},{&quot;displayLabel&quot;:&quot;Email&quot;,&quot;apiName&quot;:&quot;email&quot;,&quot;isCustomField&quot;:false,&quot;isEncryptedField&quot;:false,&quot;id&quot;:&quot;4000000000359&quot;,&quot;isSystemMandatory&quot;:false,&quot;isRemovable&quot;:false,&quot;type&quot;:&quot;Email&quot;,&quot;maxLength&quot;:120,&quot;isMandatory&quot;:false},{&quot;displayLabel&quot;:&quot;Phone&quot;,&quot;apiName&quot;:&quot;phone&quot;,&quot;isCustomField&quot;:false,&quot;isEncryptedField&quot;:false,&quot;id&quot;:&quot;4000000000361&quot;,&quot;isSystemMandatory&quot;:false,&quot;isRemovable&quot;:true,&quot;type&quot;:&quot;Phone&quot;,&quot;maxLength&quot;:120,&quot;isMandatory&quot;:false},{&quot;displayLabel&quot;:&quot;Sub Category&quot;,&quot;allowedValues&quot;:[&quot;Sub General&quot;,&quot;Sub Defects&quot;],&quot;apiName&quot;:&quot;subCategory&quot;,&quot;isCustomField&quot;:false,&quot;defaultValue&quot;:&quot;Sub General&quot;,&quot;isSystemMandatory&quot;:false,&quot;type&quot;:&quot;Picklist&quot;,&quot;isEncryptedField&quot;:false,&quot;sortBy&quot;:&quot;userDefined&quot;,&quot;id&quot;:&quot;4000000000423&quot;,&quot;isRemovable&quot;:true,&quot;maxLength&quot;:120,&quot;isMandatory&quot;:false},{&quot;displayLabel&quot;:&quot;Category&quot;,&quot;allowedValues&quot;:[&quot;General&quot;,&quot;Defects&quot;],&quot;apiName&quot;:&quot;category&quot;,&quot;isCustomField&quot;:false,&quot;defaultValue&quot;:&quot;General&quot;,&quot;isSystemMandatory&quot;:false,&quot;type&quot;:&quot;Picklist&quot;,&quot;isEncryptedField&quot;:false,&quot;sortBy&quot;:&quot;userDefined&quot;,&quot;id&quot;:&quot;4000000000421&quot;,&quot;isRemovable&quot;:true,&quot;maxLength&quot;:120,&quot;isMandatory&quot;:false},{&quot;displayLabel&quot;:&quot;Subject&quot;,&quot;apiName&quot;:&quot;subject&quot;,&quot;isCustomField&quot;:false,&quot;isEncryptedField&quot;:false,&quot;id&quot;:&quot;4000000000363&quot;,&quot;isSystemMandatory&quot;:true,&quot;isRemovable&quot;:false,&quot;type&quot;:&quot;Text&quot;,&quot;maxLength&quot;:255,&quot;isMandatory&quot;:true},{&quot;displayLabel&quot;:&quot;Description&quot;,&quot;apiName&quot;:&quot;description&quot;,&quot;isCustomField&quot;:false,&quot;isEncryptedField&quot;:false,&quot;id&quot;:&quot;4000000000365&quot;,&quot;isSystemMandatory&quot;:false,&quot;isRemovable&quot;:false,&quot;type&quot;:&quot;Textarea&quot;,&quot;maxLength&quot;:1000000,&quot;isMandatory&quot;:false},{&quot;displayLabel&quot;:&quot;Status&quot;,&quot;allowedValues&quot;:[&quot;Open&quot;,&quot;Open_july&quot;,&quot;On Hold&quot;,&quot;Escalated&quot;,&quot;Closed1&quot;,&quot;Closed&quot;,&quot;newDeptClosed&quot;],&quot;apiName&quot;:&quot;status&quot;,&quot;isCustomField&quot;:false,&quot;defaultValue&quot;:&quot;Open&quot;,&quot;isSystemMandatory&quot;:true,&quot;type&quot;:&quot;Picklist&quot;,&quot;restoreOnReplyValues&quot;:[&quot;Open_july&quot;,&quot;newDeptClosed&quot;,&quot;Escalated&quot;,&quot;On Hold&quot;,&quot;Closed&quot;,&quot;Closed1&quot;,&quot;Open&quot;],&quot;isEncryptedField&quot;:false,&quot;sortBy&quot;:&quot;userDefined&quot;,&quot;id&quot;:&quot;4000000000367&quot;,&quot;isRemovable&quot;:false,&quot;maxLength&quot;:120,&quot;isMandatory&quot;:true},{&quot;displayLabel&quot;:&quot;Case Owner&quot;,&quot;apiName&quot;:&quot;assigneeId&quot;,&quot;isCustomField&quot;:false,&quot;isEncryptedField&quot;:false,&quot;id&quot;:&quot;4000000000371&quot;,&quot;isSystemMandatory&quot;:false,&quot;isRemovable&quot;:false,&quot;type&quot;:&quot;LookUp&quot;,&quot;maxLength&quot;:120,&quot;isMandatory&quot;:false},{&quot;displayLabel&quot;:&quot;Product Name&quot;,&quot;apiName&quot;:&quot;productId&quot;,&quot;isCustomField&quot;:false,&quot;isEncryptedField&quot;:false,&quot;id&quot;:&quot;4000000000369&quot;,&quot;isSystemMandatory&quot;:false,&quot;isRemovable&quot;:true,&quot;type&quot;:&quot;LookUp&quot;,&quot;maxLength&quot;:120,&quot;isMandatory&quot;:false}]},{&quot;name&quot;:&quot;Additional Information&quot;,&quot;isCustomSection&quot;:false,&quot;id&quot;:2,&quot;fields&quot;:[{&quot;displayLabel&quot;:&quot;Due Date&quot;,&quot;apiName&quot;:&quot;dueDate&quot;,&quot;isCustomField&quot;:false,&quot;isEncryptedField&quot;:false,&quot;id&quot;:&quot;4000000000405&quot;,&quot;isSystemMandatory&quot;:false,&quot;isRemovable&quot;:false,&quot;type&quot;:&quot;DateTime&quot;,&quot;maxLength&quot;:300,&quot;isMandatory&quot;:false},{&quot;displayLabel&quot;:&quot;Priority&quot;,&quot;allowedValues&quot;:[&quot;-None-&quot;,&quot;High&quot;,&quot;Medium&quot;,&quot;Low&quot;],&quot;apiName&quot;:&quot;priority&quot;,&quot;isCustomField&quot;:false,&quot;defaultValue&quot;:&quot;-None-&quot;,&quot;isSystemMandatory&quot;:false,&quot;type&quot;:&quot;Picklist&quot;,&quot;isEncryptedField&quot;:false,&quot;sortBy&quot;:&quot;userDefined&quot;,&quot;id&quot;:&quot;4000000000407&quot;,&quot;isRemovable&quot;:false,&quot;maxLength&quot;:120,&quot;isMandatory&quot;:false},{&quot;displayLabel&quot;:&quot;Mode&quot;,&quot;allowedValues&quot;:[&quot;Phone&quot;,&quot;Email&quot;,&quot;Web&quot;,&quot;Twitter&quot;,&quot;Facebook&quot;,&quot;Chat&quot;,&quot;Forums&quot;,&quot;Feedback Widget&quot;],&quot;apiName&quot;:&quot;channel&quot;,&quot;isCustomField&quot;:false,&quot;defaultValue&quot;:&quot;Phone&quot;,&quot;isSystemMandatory&quot;:false,&quot;type&quot;:&quot;Picklist&quot;,&quot;isEncryptedField&quot;:false,&quot;sortBy&quot;:&quot;userDefined&quot;,&quot;id&quot;:&quot;4000000000409&quot;,&quot;isRemovable&quot;:false,&quot;maxLength&quot;:120,&quot;isMandatory&quot;:false},{&quot;displayLabel&quot;:&quot;Is Overdue&quot;,&quot;apiName&quot;:&quot;Is Overdue&quot;,&quot;isCustomField&quot;:false,&quot;defaultValue&quot;:&quot;true&quot;,&quot;isEncryptedField&quot;:false,&quot;id&quot;:&quot;4000000000411&quot;,&quot;isSystemMandatory&quot;:false,&quot;isRemovable&quot;:true,&quot;type&quot;:&quot;Boolean&quot;,&quot;maxLength&quot;:50,&quot;isMandatory&quot;:false},{&quot;displayLabel&quot;:&quot;Is Escalated&quot;,&quot;apiName&quot;:&quot;Is Escalated&quot;,&quot;isCustomField&quot;:false,&quot;defaultValue&quot;:&quot;true&quot;,&quot;isEncryptedField&quot;:false,&quot;id&quot;:&quot;4000000000413&quot;,&quot;isSystemMandatory&quot;:false,&quot;isRemovable&quot;:true,&quot;type&quot;:&quot;Boolean&quot;,&quot;maxLength&quot;:50,&quot;isMandatory&quot;:false},{&quot;displayLabel&quot;:&quot;Classification&quot;,&quot;allowedValues&quot;:[&quot;-None-&quot;,&quot;Question&quot;,&quot;Problem&quot;,&quot;Feature&quot;,&quot;Others&quot;],&quot;apiName&quot;:&quot;classification&quot;,&quot;isCustomField&quot;:false,&quot;defaultValue&quot;:&quot;-None-&quot;,&quot;isSystemMandatory&quot;:false,&quot;type&quot;:&quot;Picklist&quot;,&quot;isEncryptedField&quot;:false,&quot;sortBy&quot;:&quot;userDefined&quot;,&quot;id&quot;:&quot;4000000000415&quot;,&quot;isRemovable&quot;:true,&quot;maxLength&quot;:120,&quot;isMandatory&quot;:false},{&quot;displayLabel&quot;:&quot;Resolution&quot;,&quot;apiName&quot;:&quot;resolution&quot;,&quot;isCustomField&quot;:false,&quot;isEncryptedField&quot;:false,&quot;id&quot;:&quot;4000000000417&quot;,&quot;isSystemMandatory&quot;:false,&quot;isRemovable&quot;:false,&quot;type&quot;:&quot;Textarea&quot;,&quot;maxLength&quot;:1000000,&quot;isMandatory&quot;:false},{&quot;displayLabel&quot;:&quot;Sample TextArea&quot;,&quot;apiName&quot;:&quot;cf_sample_textarea&quot;,&quot;isCustomField&quot;:true,&quot;toolTipType&quot;:&quot;placeHolder&quot;,&quot;isEncryptedField&quot;:false,&quot;toolTip&quot;:&quot;Sample Field&quot;,&quot;id&quot;:&quot;4000000000447&quot;,&quot;isSystemMandatory&quot;:false,&quot;isRemovable&quot;:false,&quot;type&quot;:&quot;Textarea&quot;,&quot;maxLength&quot;:1000000,&quot;isMandatory&quot;:false}]}],&quot;layoutDesc&quot;:&quot;Layout cloned from default layout&quot;,&quot;layoutName&quot;:&quot;Default Ticket Layout&quot;}