Assets
The Assets API and documentation is in beta and subject to change. Please contact us if you wish to use the Assets API.
get
https://app.trelica.com/api/
assets/v1
List assets
delete
https://app.trelica.com/api/
assets/v1/{id}
Delete an asset
put
https://app.trelica.com/api/
assets/v1
Create or update an asset

Examples

Example filters

hardwareVendor co "Dell"
Assets from vendors starting with "Dell", e.g. "Dell Inc.", "Dell Boomi" etc.
status eq "Deployed"
Deployed assets.
customFieldValues.memoryGb gt 12
Assets where the value of the custom field 'memoryGb' is greater than 12.
not (lastSyncDtm pr)
Assets with no lastSyncDtm value.

Example body for creating an asset

{
"externalId": "LL123456",
"deviceName": "MacBook Air (M2, 2022)",
"hardwareVendor": "Apple",
"serialNumber": "S2VH3JKL5A",
"assetTag": "LAPT0000513",
"assignedToEmail": "[email protected]",
"notes": "Apple Care not yet purchased",
"purchasedDate": "2022-08-04",
"netPrice": 1402,
"netPriceCurrency": "USD",
"warrantyExpirationDate": "2023-08-04",
"lifespanExpirationDate": "2028-08-04",
"status": "Deployed",
"assetType": "Laptop",
"enrolledDtm": "2022-08-12T14:02:12Z",
"lastSyncDtm": "2022-08-23T23:01:00Z",
"platform": "macOS",
"osVersion": "12.5.1",
"isEncrypted": true,
"customFieldValues": {
"memoryGb": {
"numberValue": 24
},
"specUrl": {
"linkValue": {
"href": "https://www.apple.com/macbook-air-m2/specs/"
"description": "Specification link"
}
},
"resaleValue": {
"value": 1000,
"currency": "USD"
}
}
}

Data structures

Asset

Attribute
Type
Description
externalId
string
Unique identifier for the asset. This may be an internal ID from a source system.
deviceName
string
Descriptive name for the asset.
status
enum
New | ReadyToDeploy | Deployed | OutForRepair | Retired
hardwareVendor
string
Name of the vendor.
serialNumber
string
Optional. Asset serial number.
assetTag
string
Optional. Asset tag.
purchasedDate
date
Optional. (ISO format) Date purchased, e.g. "2022-01-15"
disposalDate
date
Optional. (ISO format) Date asset was disposed of, e.g. "2023-01-15"
warrantyExpirationDate
date
Optional. (ISO format) Date warranty expires on asset.
lifespanExpirationDate
date
Optional. (ISO format) Date when asset is considered at end of life.
notes
string
Optional. Text notes about the asset.
assignedToEmail
string
Optional. Person to whom asset is assigned.
netPrice
number
Optional. Price of asset.
netPriceCurrency
string
Optional. 3 digit ISO 4217 currency code, e.g. "GBP".
enrolledDtm
date/time
Optional. (ISO format) Date and time the asset was enrolled in an MDM platform.
lastSyncDtm
date/time
Optional. (ISO format) Date and time the asset last synched from an MDM platform.
platform
string
Optional. Operating system, e.g. "macOS"
osVersion
string
Optional. Version of operating system.
isEncrypted
boolean
Optional. true if the asset is encrypted, false if not.
customFieldValues
map
Optional. Map of custom fields, keyed by name.

Custom field value

Custom fields should contain one of the following attributes, depending on the type of the field.
Attribute
Text
Description
numberValue
number
Number.
optionValue
array
Array of strings.
textValue
string
Text string.
currencyValue
object
linkValue
object
​Link.

Currency value

Attribute
Text
Description
value
number
Amount.
currency
string
3 digit ISO 4217 currency code, e.g. "GBP".
Attribute
Text
Description
href
string
A URL.
description
string
Optional. Description for the link.
Last modified 28d ago
Copy link
Outline
get
List assets
delete
Delete an asset
put
Create or update an asset
Examples
Example filters
Example body for creating an asset
Data structures
Asset
Custom field value
Currency value
Link