Feedback:

listinv

Use the listinv operator to retrieve a list of ThreatStream investigations.

Syntax

|listinv [inv_status="<status>"]

inv_status="<status>"

Filter results by status. Specify all, completed, pending, in-progress, unassigned.

If this option is not specified, all investigations are returned.

Usage

You can use the listinv operator to retrieve a list of ThreatStream investigations.

For information about ThreatStream investigations, refer to ThreatStream online help.

Examples

Example 1: Returns all investigations using the default status filter.

Copy
|listinv

Example 2: Returns all investigations regardless of status.

Copy
|listinv inv_status="all"

Example 3: Returns only investigations in a pending state.

Copy
|listinv inv_status="pending"

Example 4: Retrieves all investigations regardless of status, then counts them grouped by status to give a quick breakdown of open, closed, and other investigation statuses.

Copy
ocsf | listinv inv_status='all' | aggr count by status