support_thread_list

Tool

support_thread_list

List support threads for this product, newest first — by creation time by default, or by last modification with sort='updated'.

List support threads for this product, newest first — by creation time by default, or by last modification with sort='updated'. Every filter lives here: type, status, status category, assignee, external author, creation window, rating range (ratingMin/ratingMax, inclusive — a thread nobody rated matches neither bound), plus pagination

Behavior

HTTP: GET /support/threads

Arguments

Name	Type	Required	Description
sort	string	—	Ordering of the page, newest first either way (default 'created')
type	string	—	Only threads of this type
limit	integer	—	Page size, 1..100 (default 25)
offset	integer	—	Number of threads to skip
category	string	—	Only threads whose status belongs to this category. Resolved through a join on the status dictionary — the category is never stored on the thread
labelIds	string	—	Only threads carrying ALL of these labels. Every other filter here narrows the result and so does this one: each additional label id makes the answer smaller, never bigger
statusId	string	—	Only threads sitting on this exact status
createdTo	string	—	Only threads created at or before this ISO-8601 timestamp
ratingMax	integer	—	Only threads rated at or below this score (0..10, inclusive). An unrated thread never matches a rating filter — not even at the bottom of the scale
ratingMin	integer	—	Only threads rated at or above this score (0..10, inclusive). An unrated thread never matches a rating filter — not even at the bottom of the scale
createdFrom	string	—	Only threads created at or after this ISO-8601 timestamp
assignedAgentId	string	—	Only threads assigned to this agent
authorExternalId	string	—	Only threads opened by this external author, matched verbatim

Response

Field	Type	Always	Description
limit	integer	•	Page size that was applied
offset	integer	•	Offset that was applied
threads	array	•	The requested page of threads, newest first by the requested sort

Try it

List support threads for this product, newest first — by creation time by default, or by last modification with sort='updated'.

When to use

Example

Ask your agent something like this:

List support threads for this product, newest first — by creation time by default, or by last modification with sort='updated'.

The agent will invoke support_thread_list with these arguments:

{}