Skip to content

List signals

Tool name: list_signals

Returns signals across the member’s customers, most recently raised first, each with the customer it is on. A signal flags something about a customer that needs attention, such as a concern about renewal or an opportunity to expand. Use it for questions such as "what signals are open on my customers", "which detected signals need reviewing" or "which of the team’s customers might churn". For one customer’s signals, use list_customer_signals. Active signals only, unless statuses says otherwise.

Input schema

scopestring

mine: customers the member is assigned to. team: customers the member or their team is assigned to. all: every customer the member can see

Default:"mine"
Enum:"mine""team""all"
statusesArray of strings, non-empty

Which signals to return. Give several to combine them, such as active and detected

Default:["active"]
Items Enum:"active""cleared""detected""dismissed"
typeIdsArray of integers, non-empty

Only signals of these types, by the type’s ID from get_organization_context

categoryIdsArray of integers, non-empty

Only signals in these categories, by the category’s ID from get_organization_context

limitinteger, [ 1 .. 100 ]

How many to return, up to 100. Ask for more only if the first results were not enough

Default:10
offsetinteger, [ 0 .. 9007199254740991 ]

How many to skip from the start of the list. To continue a list, give how many have been returned so far

Default:0
Input example
{ "scope": "mine", "statuses": [ "active" ], "typeIds": [ -9007199254740991 ], "categoryIds": [ -9007199254740991 ], "limit": 10, "offset": 0 }