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
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. |
{
"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"
}
}
}
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 |
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 |
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 5mo ago