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
nameparameter is specified. If thedepthparameter 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
nameparameter 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.
