Deskhero Developer Hub
Back to deskhero.com
Custom instructions

Get one

Returns one custom instruction with its text, its trigger and the sort key that fixes its place in the order the AI receives them.

GET /api/{tenant:minlength(2)}/v{version:apiVersion}/custom_instructions/{id}
Authorisation
Minimum role: USER

Request arguments

Name Type Source
idInt32
Request body example

Response

Status
200 (OK)
Type
DTO_custom_instruction
Wrapper
DTO_response_wrap
Other statuses
400 (BadRequest), 403 (Forbidden)
Response body example
DTO_custom_instruction
NameTypeReadOnlyDescription
created_byDTO_reference_userReadOnlyCreated by
last_updated_byDTO_reference_userReadOnlyLast updated by
idInt32ReadOnlyLeave empty when Creating object
valueStringThe instruction text, 2 to 500 characters, which may contain placeholders as long as every one of them is a placeholder Deskhero knows
lexo_rankStringReadOnlyLexo rank
triggerENUM custom_instruction_triggerTrigger
createdDateTimeReadOnlyCreated
last_updatedDateTimeReadOnlyLast updated
DTO_reference_user
NameTypeReadOnlyDescription
profile_picStringReadOnlyProfile pic
emailStringReadOnlyEmail
idInt32Id
labelObjectReadOnlyLabel
ENUM custom_instruction_trigger
ValueNameDescription
0UNKNOWNUNKNOWN
1NEW_TICKET_SUGGESTED_REPLYNEW_TICKET_SUGGESTED_REPLY

Generated Aug 4, 2026 18:37