Analytics OData API Reference
Read-only, tenant-isolated OData v4 interface for Mesh analytics data. Browse the entity sets below and query them with standard OData options (for example from Power BI Desktop via Get Data → OData Feed).
Authentication
Method: OAuth 2.0 / OIDC (user-authenticated)
The API is read-only and strictly tenant-isolated. Requests are authenticated with organization-approved user credentials (SSO / OAuth2 / OIDC), aligned with Mesh Dashboard authentication; each dataset is scoped to a single tenant. Send the bearer token in the Authorization header.
Entity sets
Entity types
MachineAsset
| Property | Type | Nullable | Key |
|---|
id | Edm.String | No | Yes |
name | Edm.String | No | No |
assetType | Edm.String | Yes | No |
riskScore | Edm.Int32 | Yes | No |
lastSeen | Edm.DateTimeOffset | Yes | No |
SoftwareAsset
| Property | Type | Nullable | Key |
|---|
id | Edm.String | No | Yes |
name | Edm.String | No | No |
version | Edm.String | Yes | No |
vendor | Edm.String | Yes | No |
riskScore | Edm.Int32 | Yes | No |
CryptoElement
| Property | Type | Nullable | Key |
|---|
id | Edm.String | No | Yes |
algorithm | Edm.String | No | No |
keyLength | Edm.Int32 | Yes | No |
deprecated | Edm.Boolean | Yes | No |
NhiAsset
| Property | Type | Nullable | Key |
|---|
id | Edm.String | No | Yes |
name | Edm.String | No | No |
assetType | Edm.String | Yes | No |
riskScore | Edm.Int32 | Yes | No |
Query options
| Option | Description |
|---|
$filter | Filter the collection by a boolean expression. |
$select | Return only the named properties. |
$orderby | Sort the collection by one or more properties. |
$top | Return at most N records (pagination). |
$skip | Skip the first N records (pagination). |
$count | Include the total match count with the response. |