Get Assets

get

https://talk.perspio.io/assets/v3/

Fetch all assets. Operates on assets in the current tenant.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

signals

array of strings

signals

includedisabledassets

boolean

orderby

string

Field to order the results by (e.g. "name"). See the API reference for sortable fields.

page_size

integer

Maximum number of items per page. When greater than 0 the response is paged and returns the ContinuationToken, ResultCount and TotalCount response headers.

Headers

x-perspio-filter

string

Global data filter (JSON-serialised) scoping results to matching assets. Optional keys, each an array of strings: locationHierarchyL1..L3, productHierarchyL1..L3, operationalHierarchyL1..L3, groupIds; plus boolean 'enabled'. Omit for no additional filtering (security-group scoping always applies). Example: {"locationHierarchyL1":["NSW"],"enabled":true}

includedisabledassets

boolean

When true, disabled assets are included in the tenant scope applied to this request. Defaults to false.

ContinuationToken

string

Opaque token from a previous response's ContinuationToken header, to fetch the next page.

Responses

400

Invalid Request

401

Unauthorized. The response body's error code identifies which credential failed: invalid_subscription_key, invalid_token, expired_token, or invalid_tenant.

500

Internal Server Error

200Success