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.
target_status_id	Int32	Workspace status id to move to when no customer reply has arrived.
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, COMPLETED, CANCELED or UNAVAILABLE (deployment prerequisites are not enabled).
due_at	DateTime	Deadline in UTC.
target_status	DTO_reference_color	Future status, resolved from the workspace's configured statuses.
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.

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 Sep 26, 2026 15:50