Deskhero Developer Hub
Back to deskhero.com
Auto saves

Upsert

Stores the calling User's draft for an entity plus optional_id, replacing whatever was stored under that combination, the data body is kept as free-form JSON and is not validated against the entity. Sending data as null deletes the draft instead of storing it, and drafts are private to the User who saved them.

PUT /api/{tenant:minlength(2)}/v{version:apiVersion}/auto_saves/upsert
Authorisation
Minimum role: USER

Request arguments

Name Type Source
inputDTO_auto_saveBody
Request body example

Response

Status
200 (OK)
Type
DTO_acknowledgement
Wrapper
DTO_response_wrap
Other statuses
400 (BadRequest), 403 (Forbidden)
Response body example
DTO_auto_save
NameTypeReadOnlyDescription
entityENUM entityEntity
optional_idInt32 (nullable)Optional id
dataJObjectData
DTO_acknowledgement
NameTypeReadOnlyDescription
messageStringMessage
ENUM entity
ValueNameDescription
0UNKNOWNUNKNOWN
1LISTLIST
2GROUPGROUP
3USERUSER
4LIST_ENTRYLIST_ENTRY
5TICKETTICKET
6SEARCHSEARCH
7INVOICEINVOICE
8KNOWLEDGE_BASEKNOWLEDGE_BASE
9SCRAPED_ITEMSCRAPED_ITEM
10FIELDFIELD
11TICKET_CONVERSATIONTICKET_CONVERSATION
12EXPORTEXPORT
13EXTERNAL_PRODUCTEXTERNAL_PRODUCT
14TEMPLATETEMPLATE
15PROFILE_APIPROFILE_API
16FAQFAQ

Generated Aug 4, 2026 18:37