Deskhero Developer Hub
Back to deskhero.com
Templates

List auto replies

Returns the workspace's auto-reply templates sorted by name and never paged. Workspace owners and admins see all of them, while other Users only see auto replies bound to a group they administer.

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

Request arguments

Name Type Source
Request body example
No input arguments

Response

Status
200 (OK)
Type
DTO_template[]
Wrapper
DTO_response_wrap
Other statuses
400 (BadRequest), 403 (Forbidden)
Response body example
DTO_template
NameTypeReadOnlyDescription
created_byDTO_reference_userReadOnlyFor signatures this is the User the signature belongs to, since only the default signature of the replying User is offered on a reply
last_updated_byDTO_reference_userReadOnlyLast updated by
groupsDTO_reference[]Groups the template applies to, required when type is AUTO_REPLY (a group can only be used by one auto reply) and rejected when type is SIGNATURE
sys_attachmentsDTO_reference_attachment[]Sys attachments
idInt32ReadOnlyAssigned by the server, and must be left empty when creating a template
createdDateTimeReadOnlySet by the server in UTC when the template is first stored
last_updatedDateTimeReadOnlySet by the server in UTC every time the template is changed
nameStringBetween 2 and 100 characters, unique among the auto replies of the workspace and unique per User among signatures
is_defaultBooleanMarks the default signature of the User, stored only when type is SIGNATURE and cleared by the server for every other type
typeENUM template_typeSIGNATURE for a reply signature, or AUTO_REPLY for the response sent automatically on new tickets
sys_content_richDTO_rich_textFor backward-compability, this is used as the "static / fallback" auto-reply
auto_replyDTO_template_auto_replyWhen auto-reply, the content is passed here
DTO_reference_user
NameTypeReadOnlyDescription
profile_picStringReadOnlyProfile pic
emailStringReadOnlyEmail
idInt32Id
labelObjectReadOnlyLabel
DTO_reference
NameTypeReadOnlyDescription
idInt32The id of the reference
labelObjectReadOnlyName/Label from referenced object.
DTO_reference_attachment
NameTypeReadOnlyDescription
size_kbInt32ReadOnlySize kb
statusENUM attachment_statusReadOnlyStatus
status_messageStringReadOnlyStatus message
download_urlStringReadOnlyDownload url
idInt32Id
labelObjectReadOnlyLabel
DTO_rich_text
NameTypeReadOnlyDescription
plain_previewStringReadOnlyPlain preview
htmlStringHtml
editorjsDTO_editorjsEditorjs
tiptapDTO_tiptapTiptap
read_minutesInt32Read minutes
DTO_editorjs
NameTypeReadOnlyDescription
timeInt64Time
versionStringVersion
blocksDTO_editorjs_block[]Blocks
DTO_editorjs_block
NameTypeReadOnlyDescription
idStringId
typeStringType
dataObjectData
DTO_tiptap
NameTypeReadOnlyDescription
typeStringType
contentDTO_tiptap_node[]Content
DTO_tiptap_node
NameTypeReadOnlyDescription
typeStringType
attrsDTO_tiptap_attrsAttrs
contentDTO_tiptap_node[]Content
textStringText
marksDTO_tiptap_mark[]Marks
DTO_tiptap_attrs
NameTypeReadOnlyDescription
textAlignStringTextalign
levelInt32 (nullable)Level
checkedBoolean (nullable)Checked
idInt32 (nullable)Id
altStringAlt
titleStringTitle
widthStringWidth
wrapperStyleStringWrapperstyle
filesDTO_tiptap_file_ref[]Files
hrefStringHref
targetStringTarget
colspanInt32 (nullable)Colspan
rowspanInt32 (nullable)Rowspan
colorStringColor
textStringText
nameStringFor emoji
nativeStringFor emoji
DTO_tiptap_file_ref
NameTypeReadOnlyDescription
idInt32Id
labelStringLabel
DTO_tiptap_mark
NameTypeReadOnlyDescription
typeStringType
attrsDTO_tiptap_attrsAttrs
DTO_template_auto_reply
NameTypeReadOnlyDescription
sys_content_rich_ai_replyDTO_rich_textFrame that wraps the generated answer, and it must contain the [ai-auto-reply-message] placeholder when ai_reply_enabled is true
ai_reply_enabledBooleanWhen true the answer is generated by AI and merged into sys_content_rich_ai_reply, and at least one of ai_reply_enabled and fallback_reply_enabled must be true
fallback_reply_enabledBooleanWhen true the static sys_content_rich is sent whenever the AI branch produces no approved answer, and the server forces it on for auto replies stored without an AI body
ENUM attachment_status
ValueNameDescription
0UNKNOWNUNKNOWN
1UNAVAILABLEUNAVAILABLE, processing in progress
2OKOK
3WARNINGWARNING
4ERRORERROR
ENUM template_type
ValueNameDescription
0UNKNOWNUNKNOWN
1SIGNATURESIGNATURE
2AUTO_REPLYAUTO_REPLY

Generated Aug 4, 2026 18:37