Get Layout Rules for department or layout

GET {{baseUrl}}/api/v1/layoutRules

This API lists all the rules configured for a department/layout.

OAuth Scope

  • Desk.settings.READ

Request Params

KeyDatatypeRequiredDescription
departmentIdstringGet the rules of the department
layoutIdstringGet the rules of the layout
modulestringName of the module for which you want to fetch the layout rules. Allowed values are tickets, contacts, accounts, tasks, timeEntry, contracts, products, calls, events
activeLayoutsstringGet the rules for active layouts
activeRulesstringGet the rules that are active in the layout
executeInHelpCentrestringGet the rules that can be executed in help centre
fromstringIndex number, starting from which the rules must be fetched
limitstringNumber of rules to be fetched. Default is 50
searchStringstringGet the rules that have this search term
includestringAdditional information related to the rules. Values allowed are: creator and modifier.

HEADERS

KeyDatatypeRequiredDescription
Authorizationstring

RESPONSES

status: OK

{"data":[{"fieldConditions":[{"name":"condition 1","pattern":"(1and2)","conditions":[{"condition":"is","fieldName":"email","value":["carol@zylker.com"]},{"condition":"is","fieldName":"phone","value":["9993292892"]}],"actions":{"showSections":["Additional Information"],"showFields":["subject"],"setMandatoryFields":["priority"]}}],"modifiedTime":"2018-09-14T01:08:42.000Z","fieldName":"email","description":"Rule 1 for layout","systemGenerated":false,"layoutId":"4000000007723","executeInHelpCentre":false,"createdBy":"4000000015963","name":"Rule 1","createdTime":"2018-09-14T01:07:22.000Z","modifiedBy":"4000000015963","id":"4000000020001","status":"active"},{"fieldConditions":[{"name":"condition 2","pattern":"(1or2)","conditions":[{"condition":"is","fieldName":"phone","value":["9993292892"]},{"condition":"is","fieldName":"email","value":["carol@zylker.com"]}],"actions":{"showSections":["Additional Information"],"showFields":["subject"],"setMandatoryFields":["priority"]}}],"modifiedTime":"2018-09-14T01:08:42.000Z","fieldName":"phone","description":"Rule 2 for layout","systemGenerated":false,"layoutId":"4000000007723","executeInHelpCentre":false,"createdBy":"4000000015963","name":"Rule 2","createdTime":"2018-09-14T01:07:22.000Z","modifiedBy":"4000000015963","id":"4000000021001","status":"active"}]}