ListAssets

get

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

Lists assets in an environment.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

environment

string

required

Environment to list assets from.

Query Params

pageSize

int32

Maximum number of assets to return per page.

pageToken

string

Page token from a previous ListAssets call. The token encodes position
only, not filter/sort state: pass the same filter and order_by/
order_direction fields on every subsequent page call.

createTimeAfter

date-time

If set, only return assets registered at or after this time (inclusive).
Combine with order_by=ORDER_BY_CREATE_TIME to incrementally sync only
newly-registered assets: page through, record the max create_time seen, and
pass it here on the next run. Because the bound is inclusive, the asset(s)
at exactly that timestamp are returned again on the next run — dedupe by
asset name on the client. RFC3339, e.g. "2025-06-01T00:00:00Z".

createTimeBefore

date-time

If set, only return assets registered at or before this time, inclusive
(RFC3339).

lastCheckinAfter

date-time

If set, only return assets whose most recent check-in was at or after this
time, inclusive (RFC3339).

lastCheckinBefore

date-time

If set, only return assets whose most recent check-in was at or before this
time, inclusive (RFC3339).

state

array of strings

If non-empty, only return assets in one of these states.

state

Allowed:

array of strings

If non-empty, only return assets running one of these operating systems.
Filters on the structured OS, which may differ from the free-form
Asset.os display string.

Allowed:

nameContains

string

If set, only return assets whose name (label) contains this substring,
case-insensitively.

forwarderVersion

array of strings

If non-empty, only return assets running one of these forwarder versions,
each formatted as "MAJOR.MINOR.PATCH" (e.g. "1.2.3"). Each component is
matched exactly ("1.2.3" matches only 1.2.3); a zero component (e.g. the
trailing 0 in "1.5.0") also matches assets that have not reported that
component.

forwarderVersion

orderBy

string

enum

Field to sort the returned assets by. Defaults to registration time.

Allowed:

orderDirection

string

enum

Direction to sort the returned assets in. Defaults to ascending.

Allowed:

Response

200OK