List Assets with Filtering

View as Markdown

Retrieve a list of assets with optional filtering by asset type. This operation returns all assets accessible to the authenticated user, optionally filtered to start from a specific asset type level (e.g., only structures, only floors, etc.). Each asset includes its basic properties and immediate children.

Authentication

X-Trebellar-Api-Keystring
API Key authentication via header
OR
AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

fromAssetTypeenumOptional

Asset type identifier defining the hierarchy level: ROOT (top-level), STRUCTURE (buildings), FLOOR (building levels), SPACE (rooms/areas), DESK (workstations), SENSOR (IoT devices), SENSOR_GROUP (sensor collections)

Response

Assets retrieved successfully, potentially filtered by type
datalist of objects

Errors