This endpoint is used to list or filter assets by various criteria. There are two distinct modes:
-
Fetch mode. This is used to fetch specific resources by name. It is enabled when the
name
parameter is specified. If thedepth
parameter is greater than zero, then both
the assets and their children down to the specified depth are returned. -
Filter mode. This is enabled when the
name
parameter is not specified. It returns
assets matching the criteria specified by any of the other parameters.
In both modes, results are paginated in the usual fashion. The results will be ordered by the assets's create_time
in ascending order, unless the order_by
param is specified.
If you want to do a location search, both the location_start
and location_within
params must be supplied.