ListThreatReports

get

https://app.stairwell.com/v1/environments/{environment}/threatReports

Lists threat reports, newest upload first, across one environment or a
set of them. Name one environment in the path, or environments/- to
list across the environments named in environments (every environment
the caller can read when that is empty). Every row carries the
environment it belongs to.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

environment

string

required

The environment to list threat reports in, or - to list across the environments named in the environments parameter.

Query Params

environments

array of strings

Environments to list across, as resource names (e.g.
"environments/VXKCDN-..."), when parent is environments/-.
Intersected with the caller's readable environments; any env the caller
can't read is silently dropped. If empty, the list covers every
environment the caller can read. A fully-disjoint list (caller can't read
any of them) yields PermissionDenied. With a concrete parent this must
be empty.

environments

pageSize

int32

Maximum number of threat reports to return per page. Default 100,
maximum 1000.

pageToken

string

Page token from a previous ListThreatReports call. A token is valid only
for the environment set it was issued for.

filterTerms

array of strings

Free-text filter terms, in the grammar of the Stairwell UI's report
filter box; every term must match. Whitespace separates terms and a
double-quoted segment keeps its whitespace, so one element may carry a
whole query. A term tag:<value> matches reports tagged

filterTerms

startTime

date-time

Only reports uploaded at or after this time.

endTime

date-time

Only reports uploaded at or before this time.

sources

array of strings

Only reports from any of these sources.
THREAT_REPORT_SOURCE_UNSPECIFIED is ignored: it never narrows the
list.

sources

onlyWithIocs

boolean

Only reports that carry at least one indicator.

Response

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200OK