LookupAsset

get

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

Retrieves the asset that currently holds an alternate identifier (serial
number, EDR device id, inventory tag, ...) in an environment. At most one
asset holds a given identifier at a time; returns NOT_FOUND when no asset
currently holds it.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

environment

string

required

Environment to look the identifier up in.

Query Params

alias.type

string

Kind of identifier. Well-known types include serial_number,
bios_serial_number, hardware_uuid, machine_id, asset_tag, and
edr..; any type matching the pattern above is accepted.

alias.value

string

The identifier itself, as entered (e.g. "C02XL0ZTJGH5").

alias.state

string

enum

Whether this asset still holds the identifier.

Allowed:

alias.supersededBy

string

Resource name of the asset that took this identifier
(e.g. assets/VXKCDN-GSPRN8-M4QW7Z-2TPLJHK9). May be empty even when state
is SUPERSEDED - a copied environment keeps the history but not necessarily
the asset that superseded it.

alias.createTime

date-time

When this identifier was attached to this asset.

Response

200OK