Ticket follow ups

Save

Schedules or edits a one-time status change if the ticket's last outbound reply remains unanswered. The worker checks deadlines every two minutes.

PUT /api/{tenant:minlength(2)}/v{version:apiVersion}/ticket_follow_ups/{ticket_id}

Request arguments

Name	Type	Source
ticket_id	Int32
input	DTO_ticket_follow_up_input	Body

Request body example

Response body example

Name	Type	Description
operation_id	String	Unique operation UUID. Reuse it when retrying the same request.
expected_version	String	Version of the saved follow-up being edited, or null when creating one.
mode	String	MOVE_STATUS (default) moves the ticket to target_status_id when no customer reply has arrived. REMIND keeps the status: the follow-up becomes DUE instead, until a reply is sent or it is turned off.
target_status_id	Int32	Workspace status id to move to when no customer reply has arrived. Ignored for REMIND.
due_at	DateTimeOffset	Future deadline with a UTC offset. Checked every two minutes.

Name	Type	Description
version	String	Activation version used to prevent overwriting another User's changes.
state	String	ACTIVE (waiting for its due time), DUE (a reminder whose time came without a customer reply), COMPLETED, CANCELED or UNAVAILABLE (deployment prerequisites are not enabled).
mode	String	MOVE_STATUS (moves the ticket to target_status) or REMIND (keeps the status and becomes DUE).
due_at	DateTime	Deadline in UTC.
target_status	DTO_reference_color	Future status, resolved from the workspace's configured statuses. Null for REMIND.
expected_status_id	Int32	Current status expected when this follow-up runs.
created_by	DTO_reference_user	User who scheduled this follow-up.
created_at	DateTime	When this activation was saved, in UTC.
reason	String	Reason a completed or canceled follow-up stopped waiting: NO_REPLY, FOLLOWED_UP (a reply was sent to a due reminder), CUSTOMER_REPLIED, STATUS_CHANGED, USER_CANCELED, TICKET_DELETED, TICKET_MERGED, TICKET_CHANGED, STATUS_UNAVAILABLE or EXECUTION_FAILED.

Name	Type	ReadOnly	Description
bg_color	String	ReadOnly	Bg color
text_color	String	ReadOnly	Text color
id	Int32		Id
label	Object	ReadOnly	Label

Name	Type	ReadOnly	Description
profile_pic	String	ReadOnly	Profile pic
email	String	ReadOnly	Email
id	Int32		Id
label	Object	ReadOnly	Label

Generated Nov 3, 2026 05:19