In this version of the App SDK, we have upgraded Node to the current LTS version 20.12.2. Make sure to upgrade your workspace to at least Node v20.12.2.

If using volta, you can install the latest LTS version of Node by running:

volta install node@lts

Otherwise, you can download the latest LTS version of Node from the Node.js website.

In this version of our App SDK, we have upgraded NX to v18.3.3. Make sure to upgrade your extensions to the latest version of NX.

npx nx migrate 18.3.3
npx nx migrate --run-migrations

Please refer to Maintaining Your Application for more information.

Released stable version v1 of Customer API as REST and GraphQL endpoint.
For more information, see the documentation and introduction of the endpoints.

➕ Trackunit Iris GraphQL API

Example:

query GetCustomers(
  $before: Cursor
  $after: Cursor
  $last: Int
  $first: Int = 20
) {
  customers(before: $before, after: $after, first: $first, last: $last) {
    edges {
      node {
        id
        name
        type
      }
    }
    pageInfo {
      hasPreviousPage
      hasNextPage
      startCursor
      endCursor
      count
    }
  }
}

See all relevant GQL documentation

REST

Below a list of all available REST endpoints:

Customer:​

➕ GET: /customer/v1/customers/{customerId}

Get customer

➕ GET: /customer/v1/customers

Get customers

➕ POST: /customer/v1/customers

Create customer

➕ PATCH: /customer/v1/customers/{customerId}

Update customer

➕ DELETE: /customer/v1/customers/{customerId}

Delete customer

Customer Contact:​

➕ GET: customer/v1/customers/{customerId}/contacts/{contactId}

Get contact

➕ GET: customer/v1/customers/{customerid}/contacts

Get contacts

➕ POST: customer/v1/customers/{customerid}/contacts

Create contact

➕ PATCH: customer/v1/customers/{customerid}/contacts/{contactId}

Update contact

➕ DELETE: customer/v1/customers/{customerid}/contacts/{contactId}

Delete contact

Customer Asset assignments:​

➕ GET: customer/v1/customers/{customerid}/assets

Get assets

➕ POST: customer/v1/customers/{customerid}/assets

Update assets

Released stable version v1 of Custom Fields API.

The Custom Fields API provides a way to define new fields in the Trackunit data model. Allowing to extend and customize Trackunit Manager. In this version 1 we support extending the data model of assets, accounts, groups and sites with new fields.

Below all available endpoints:

To define a custom field, you first need to add a definition using the API.

➕ GET: /custom-fields/v1/definitions

Get definitions

➕ POST: /custom-fields/v1/definitions

Create definition

➕ PATCH: /custom-fields/v1/definitions/{definitionId}

Update definition

➕ DELETE: /custom-fields/v1/definitions/{definitionId}

Delete definition

Use the Custom Fields Values API to set values on your defined custom fields

➕ GET: /custom-fields/v1/values

Get values

➕ POST: /custom-fields/v1/values

Create value

➕ PATCH: /custom-fields/v1/values/{valueId}

Update value

➕ DELETE: /custom-fields/v1/values/{valueId}

Delete value

Released stable support of webhooks.

With the addition of webhooks, we are extending our Iris capabilities to make it easier to set up meaningful workflows by e.g. triggering actions and notifications in external systems that help you run your business. The Trackunit Iris platform collects and stores data about every event that happened to an asset. Via our webhooks technology you can subscribe to relevant event types and get event data served in real-time.

All available event types in this release:

• alerts.asset.on
• alerts.asset.off
• faults.asset.on
• faults.asset.off
• service-management.service-status.updated
• sites.asset.enter
• sites.asset.leave
• sites.asset.archive

For more information see our Webhooks guide section.

We are aligning pricing plan names with the official pricing plan names. So if you specify installation.pricingPlans in your app manifest you will need to update it when upgrading to this version.

Released stable version v1 of Alerts API.

Discover the power of our Alerts API, that allows you to manage your alert setup through API integrations. Here alert configurations can be created, read, updated and deleted. For more information see the documentation of the endpoint.

Below all available endpoints:

➕ GET: /alerts/v1/configurations

Get all alert configurations

➕ GET: /alerts/v1/configurations/{alertConfigurationId}

Get specific alert configuration

➕ POST: /alerts/v1/configurations

Create alert configuration

➕ PATCH: /alerts/v1/configurations/{alertConfigurationId}

Update alert configuration

➕ DELETE: /alerts/v1/configurations/{alertConfigurationId}

Delete alert configuration

Added new Endpoints to the Emissions API to enable filtering by asset Ids, as well as getting emissions value for sites.

Below is a list of all the new endpoints:

➕ GET: /emissions/period

Get period

➕ POST: /emissions/period

Filter period

➕ GET: /emissions/period/kpis

Get period KPIs

➕ POST: /emissions/period/kpis

Filter period KPIs

➕ POST: /emissions/monthly

Filter monthly

➕ GET: /emissions/monthly/summary

Get monthly summary

➕ POST: /emissions/monthly/summary

Filter monthly summary

➕ POST: /emissions/lifetime

Filter lifetime

➕ GET: /emissions/lifetime/kpis

Get Lifetime KPIs

➕ POST: /emissions/lifetime/kpis

Filter Lifetime KPIs

➕ POST: /emissions/daily

Filter daily

➕ GET: /emissions/daily/summary

Get daily summary

➕ POST: /emissions/daily/summary

Filter daily summary

➕ GET: /emissions/daily/kpis

Get daily KPIs

➕ POST: /emissions/daily/kpis

Filter daily KPIs

➕ GET: /sites/{siteId}/emissions

Get site

Released support for querying Time Series data in the GraphQL API.

The new timeSeries field supports using instantQuery and rangeQuery to leverage promQL and gain advanced insights about an asset. Read more about how to build queries with the Time Series API

➕ GQL: Query.timeSeries

See all relevant GQL documentation

Released stable version v1 of Time Series API - Supercharge your data exploration with advanced querying capabilities using PromQL!

Discover the power of our new Time Series REST API, your gateway to a wealth of machine insights and advanced sensor data. Designed to empower your exploration of time series data, our new API offers seamless access to endpoints that can be queried using PromQL.

Below a list of all available endpoints:

➕ GET: /time-series/v1/assets/{assetId}/prometheus/api/v1/query

Get for instant queries

➕ POST: /time-series/v1/assets/{assetId}/prometheus/api/v1/query

Post for instant queries

➕ GET: /time-series/v1/assets/{assetId}/prometheus/api/v1/query_range

Get for range queries

➕ POST: /time-series/v1/assets/{assetId}/prometheus/api/v1/query_range

Post for range queries

➕ GET: /time-series/v1/assets/{assetId}/metrics

Get metrics