Deskhero Developer Hub
Back to deskhero.com
Ticket follow ups

Cancel

Cancels the specified follow-up version. Retrying the same operation UUID does not cancel a replacement.

POST /api/{tenant:minlength(2)}/v{version:apiVersion}/ticket_follow_ups/{ticket_id}/cancel
Authorisation
Minimum role: USER

Request arguments

Name Type Source
ticket_idInt32
inputDTO_ticket_follow_up_cancelBody
Request body example

Response

Status
0 (0)
Type
DTO_ticket_follow_up
Wrapper
DTO_response_wrap
Other statuses
429 (TooManyRequests)
Response body example
DTO_ticket_follow_up_cancel
NameTypeReadOnlyDescription
expected_versionStringVersion of the follow-up to cancel.
operation_idStringUnique operation UUID. Reuse it when retrying cancellation.
DTO_ticket_follow_up
NameTypeReadOnlyDescription
versionStringActivation version used to prevent overwriting another User's changes.
stateStringACTIVE, COMPLETED, CANCELED or UNAVAILABLE (deployment prerequisites are not enabled).
due_atDateTimeDeadline in UTC.
target_statusDTO_reference_colorFuture status, resolved from the workspace's configured statuses.
expected_status_idInt32Current status expected when this follow-up runs.
created_byDTO_reference_userUser who scheduled this follow-up.
created_atDateTimeWhen this activation was saved, in UTC.
reasonStringReason a completed or canceled follow-up stopped waiting.
DTO_reference_color
NameTypeReadOnlyDescription
bg_colorStringReadOnlyBg color
text_colorStringReadOnlyText color
idInt32Id
labelObjectReadOnlyLabel
DTO_reference_user
NameTypeReadOnlyDescription
profile_picStringReadOnlyProfile pic
emailStringReadOnlyEmail
idInt32Id
labelObjectReadOnlyLabel

Generated Sep 26, 2026 15:50