Create or replace a device
curl --request PUT \
--url https://app.trelica.com/api/assets/v1/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"id": "646fcb4fb829ba9df2a94471",
"status": "Deployed",
"statusType": "Deployed",
"hardwareVendor": "Apple Inc.",
"modelName": "MacBook Pro (16-inch, 2021)",
"serialNumber": "KOGITG04P5",
"assetTag": "A0000002",
"purchasedDate": "2016-03-06T00:00:00Z",
"warrantyExpirationDate": "2017-03-06T00:00:00Z",
"lifespanExpirationDate": "2019-03-06T00:00:00Z",
"assignedTo": {
"userId": "6a127db661b442c1afdd77611ad99824",
"name": "Joshua Burns",
"email": "joshua.burns@example.com"
},
"assignedToEmail": "joshua.burns@example.com",
"netPrice": 1615,
"netPriceCurrency": "USD",
"platform": "Mac",
"isEncrypted": false,
"customFields": {
"user_department": "Engineering",
"user_ram_gb": 32,
"user_accessories": [
"Charger",
"Dock"
]
},
"createdBy": {
"userId": "b1fb51a7c13f4cbf832b304348c8270e",
"name": "System",
"email": "admin@example.com"
},
"createdDtm": "2023-05-25T20:55:43.048Z",
"lastModifiedBy": {
"userId": "b1fb51a7c13f4cbf832b304348c8270e",
"name": "System",
"email": "admin@example.com"
},
"lastModifiedDtm": "2024-05-27T01:03:26.679Z"
}
'const url = 'https://app.trelica.com/api/assets/v1/{id}';
const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
id: '646fcb4fb829ba9df2a94471',
status: 'Deployed',
statusType: 'Deployed',
hardwareVendor: 'Apple Inc.',
modelName: 'MacBook Pro (16-inch, 2021)',
serialNumber: 'KOGITG04P5',
assetTag: 'A0000002',
purchasedDate: '2016-03-06T00:00:00Z',
warrantyExpirationDate: '2017-03-06T00:00:00Z',
lifespanExpirationDate: '2019-03-06T00:00:00Z',
assignedTo: {
userId: '6a127db661b442c1afdd77611ad99824',
name: 'Joshua Burns',
email: 'joshua.burns@example.com'
},
assignedToEmail: 'joshua.burns@example.com',
netPrice: 1615,
netPriceCurrency: 'USD',
platform: 'Mac',
isEncrypted: false,
customFields: {
user_department: 'Engineering',
user_ram_gb: 32,
user_accessories: ['Charger', 'Dock']
},
createdBy: {
userId: 'b1fb51a7c13f4cbf832b304348c8270e',
name: 'System',
email: 'admin@example.com'
},
createdDtm: '2023-05-25T20:55:43.048Z',
lastModifiedBy: {
userId: 'b1fb51a7c13f4cbf832b304348c8270e',
name: 'System',
email: 'admin@example.com'
},
lastModifiedDtm: '2024-05-27T01:03:26.679Z'
})
};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));import requests
url = "https://app.trelica.com/api/assets/v1/{id}"
payload = {
"id": "646fcb4fb829ba9df2a94471",
"status": "Deployed",
"statusType": "Deployed",
"hardwareVendor": "Apple Inc.",
"modelName": "MacBook Pro (16-inch, 2021)",
"serialNumber": "KOGITG04P5",
"assetTag": "A0000002",
"purchasedDate": "2016-03-06T00:00:00Z",
"warrantyExpirationDate": "2017-03-06T00:00:00Z",
"lifespanExpirationDate": "2019-03-06T00:00:00Z",
"assignedTo": {
"userId": "6a127db661b442c1afdd77611ad99824",
"name": "Joshua Burns",
"email": "joshua.burns@example.com"
},
"assignedToEmail": "joshua.burns@example.com",
"netPrice": 1615,
"netPriceCurrency": "USD",
"platform": "Mac",
"isEncrypted": False,
"customFields": {
"user_department": "Engineering",
"user_ram_gb": 32,
"user_accessories": ["Charger", "Dock"]
},
"createdBy": {
"userId": "b1fb51a7c13f4cbf832b304348c8270e",
"name": "System",
"email": "admin@example.com"
},
"createdDtm": "2023-05-25T20:55:43.048Z",
"lastModifiedBy": {
"userId": "b1fb51a7c13f4cbf832b304348c8270e",
"name": "System",
"email": "admin@example.com"
},
"lastModifiedDtm": "2024-05-27T01:03:26.679Z"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://app.trelica.com/api/assets/v1/{id}"
payload := strings.NewReader("{\n \"id\": \"646fcb4fb829ba9df2a94471\",\n \"status\": \"Deployed\",\n \"statusType\": \"Deployed\",\n \"hardwareVendor\": \"Apple Inc.\",\n \"modelName\": \"MacBook Pro (16-inch, 2021)\",\n \"serialNumber\": \"KOGITG04P5\",\n \"assetTag\": \"A0000002\",\n \"purchasedDate\": \"2016-03-06T00:00:00Z\",\n \"warrantyExpirationDate\": \"2017-03-06T00:00:00Z\",\n \"lifespanExpirationDate\": \"2019-03-06T00:00:00Z\",\n \"assignedTo\": {\n \"userId\": \"6a127db661b442c1afdd77611ad99824\",\n \"name\": \"Joshua Burns\",\n \"email\": \"joshua.burns@example.com\"\n },\n \"assignedToEmail\": \"joshua.burns@example.com\",\n \"netPrice\": 1615,\n \"netPriceCurrency\": \"USD\",\n \"platform\": \"Mac\",\n \"isEncrypted\": false,\n \"customFields\": {\n \"user_department\": \"Engineering\",\n \"user_ram_gb\": 32,\n \"user_accessories\": [\n \"Charger\",\n \"Dock\"\n ]\n },\n \"createdBy\": {\n \"userId\": \"b1fb51a7c13f4cbf832b304348c8270e\",\n \"name\": \"System\",\n \"email\": \"admin@example.com\"\n },\n \"createdDtm\": \"2023-05-25T20:55:43.048Z\",\n \"lastModifiedBy\": {\n \"userId\": \"b1fb51a7c13f4cbf832b304348c8270e\",\n \"name\": \"System\",\n \"email\": \"admin@example.com\"\n },\n \"lastModifiedDtm\": \"2024-05-27T01:03:26.679Z\"\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}using RestSharp;
var options = new RestClientOptions("https://app.trelica.com/api/assets/v1/{id}");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "Bearer <token>");
request.AddJsonBody("{\n \"id\": \"646fcb4fb829ba9df2a94471\",\n \"status\": \"Deployed\",\n \"statusType\": \"Deployed\",\n \"hardwareVendor\": \"Apple Inc.\",\n \"modelName\": \"MacBook Pro (16-inch, 2021)\",\n \"serialNumber\": \"KOGITG04P5\",\n \"assetTag\": \"A0000002\",\n \"purchasedDate\": \"2016-03-06T00:00:00Z\",\n \"warrantyExpirationDate\": \"2017-03-06T00:00:00Z\",\n \"lifespanExpirationDate\": \"2019-03-06T00:00:00Z\",\n \"assignedTo\": {\n \"userId\": \"6a127db661b442c1afdd77611ad99824\",\n \"name\": \"Joshua Burns\",\n \"email\": \"joshua.burns@example.com\"\n },\n \"assignedToEmail\": \"joshua.burns@example.com\",\n \"netPrice\": 1615,\n \"netPriceCurrency\": \"USD\",\n \"platform\": \"Mac\",\n \"isEncrypted\": false,\n \"customFields\": {\n \"user_department\": \"Engineering\",\n \"user_ram_gb\": 32,\n \"user_accessories\": [\n \"Charger\",\n \"Dock\"\n ]\n },\n \"createdBy\": {\n \"userId\": \"b1fb51a7c13f4cbf832b304348c8270e\",\n \"name\": \"System\",\n \"email\": \"admin@example.com\"\n },\n \"createdDtm\": \"2023-05-25T20:55:43.048Z\",\n \"lastModifiedBy\": {\n \"userId\": \"b1fb51a7c13f4cbf832b304348c8270e\",\n \"name\": \"System\",\n \"email\": \"admin@example.com\"\n },\n \"lastModifiedDtm\": \"2024-05-27T01:03:26.679Z\"\n}", false);
var response = await client.PutAsync(request);
Console.WriteLine("{0}", response.Content);
HttpResponse<String> response = Unirest.put("https://app.trelica.com/api/assets/v1/{id}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"id\": \"646fcb4fb829ba9df2a94471\",\n \"status\": \"Deployed\",\n \"statusType\": \"Deployed\",\n \"hardwareVendor\": \"Apple Inc.\",\n \"modelName\": \"MacBook Pro (16-inch, 2021)\",\n \"serialNumber\": \"KOGITG04P5\",\n \"assetTag\": \"A0000002\",\n \"purchasedDate\": \"2016-03-06T00:00:00Z\",\n \"warrantyExpirationDate\": \"2017-03-06T00:00:00Z\",\n \"lifespanExpirationDate\": \"2019-03-06T00:00:00Z\",\n \"assignedTo\": {\n \"userId\": \"6a127db661b442c1afdd77611ad99824\",\n \"name\": \"Joshua Burns\",\n \"email\": \"joshua.burns@example.com\"\n },\n \"assignedToEmail\": \"joshua.burns@example.com\",\n \"netPrice\": 1615,\n \"netPriceCurrency\": \"USD\",\n \"platform\": \"Mac\",\n \"isEncrypted\": false,\n \"customFields\": {\n \"user_department\": \"Engineering\",\n \"user_ram_gb\": 32,\n \"user_accessories\": [\n \"Charger\",\n \"Dock\"\n ]\n },\n \"createdBy\": {\n \"userId\": \"b1fb51a7c13f4cbf832b304348c8270e\",\n \"name\": \"System\",\n \"email\": \"admin@example.com\"\n },\n \"createdDtm\": \"2023-05-25T20:55:43.048Z\",\n \"lastModifiedBy\": {\n \"userId\": \"b1fb51a7c13f4cbf832b304348c8270e\",\n \"name\": \"System\",\n \"email\": \"admin@example.com\"\n },\n \"lastModifiedDtm\": \"2024-05-27T01:03:26.679Z\"\n}")
.asString();<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.trelica.com/api/assets/v1/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'id' => '646fcb4fb829ba9df2a94471',
'status' => 'Deployed',
'statusType' => 'Deployed',
'hardwareVendor' => 'Apple Inc.',
'modelName' => 'MacBook Pro (16-inch, 2021)',
'serialNumber' => 'KOGITG04P5',
'assetTag' => 'A0000002',
'purchasedDate' => '2016-03-06T00:00:00Z',
'warrantyExpirationDate' => '2017-03-06T00:00:00Z',
'lifespanExpirationDate' => '2019-03-06T00:00:00Z',
'assignedTo' => [
'userId' => '6a127db661b442c1afdd77611ad99824',
'name' => 'Joshua Burns',
'email' => 'joshua.burns@example.com'
],
'assignedToEmail' => 'joshua.burns@example.com',
'netPrice' => 1615,
'netPriceCurrency' => 'USD',
'platform' => 'Mac',
'isEncrypted' => false,
'customFields' => [
'user_department' => 'Engineering',
'user_ram_gb' => 32,
'user_accessories' => [
'Charger',
'Dock'
]
],
'createdBy' => [
'userId' => 'b1fb51a7c13f4cbf832b304348c8270e',
'name' => 'System',
'email' => 'admin@example.com'
],
'createdDtm' => '2023-05-25T20:55:43.048Z',
'lastModifiedBy' => [
'userId' => 'b1fb51a7c13f4cbf832b304348c8270e',
'name' => 'System',
'email' => 'admin@example.com'
],
'lastModifiedDtm' => '2024-05-27T01:03:26.679Z'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}$headers=@{}
$headers.Add("Authorization", "Bearer <token>")
$headers.Add("Content-Type", "application/json")
$response = Invoke-WebRequest -Uri 'https://app.trelica.com/api/assets/v1/{id}' -Method PUT -Headers $headers -ContentType 'application/json' -Body '{
"id": "646fcb4fb829ba9df2a94471",
"status": "Deployed",
"statusType": "Deployed",
"hardwareVendor": "Apple Inc.",
"modelName": "MacBook Pro (16-inch, 2021)",
"serialNumber": "KOGITG04P5",
"assetTag": "A0000002",
"purchasedDate": "2016-03-06T00:00:00Z",
"warrantyExpirationDate": "2017-03-06T00:00:00Z",
"lifespanExpirationDate": "2019-03-06T00:00:00Z",
"assignedTo": {
"userId": "6a127db661b442c1afdd77611ad99824",
"name": "Joshua Burns",
"email": "joshua.burns@example.com"
},
"assignedToEmail": "joshua.burns@example.com",
"netPrice": 1615,
"netPriceCurrency": "USD",
"platform": "Mac",
"isEncrypted": false,
"customFields": {
"user_department": "Engineering",
"user_ram_gb": 32,
"user_accessories": [
"Charger",
"Dock"
]
},
"createdBy": {
"userId": "b1fb51a7c13f4cbf832b304348c8270e",
"name": "System",
"email": "admin@example.com"
},
"createdDtm": "2023-05-25T20:55:43.048Z",
"lastModifiedBy": {
"userId": "b1fb51a7c13f4cbf832b304348c8270e",
"name": "System",
"email": "admin@example.com"
},
"lastModifiedDtm": "2024-05-27T01:03:26.679Z"
}'require 'uri'
require 'net/http'
url = URI("https://app.trelica.com/api/assets/v1/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"id\": \"646fcb4fb829ba9df2a94471\",\n \"status\": \"Deployed\",\n \"statusType\": \"Deployed\",\n \"hardwareVendor\": \"Apple Inc.\",\n \"modelName\": \"MacBook Pro (16-inch, 2021)\",\n \"serialNumber\": \"KOGITG04P5\",\n \"assetTag\": \"A0000002\",\n \"purchasedDate\": \"2016-03-06T00:00:00Z\",\n \"warrantyExpirationDate\": \"2017-03-06T00:00:00Z\",\n \"lifespanExpirationDate\": \"2019-03-06T00:00:00Z\",\n \"assignedTo\": {\n \"userId\": \"6a127db661b442c1afdd77611ad99824\",\n \"name\": \"Joshua Burns\",\n \"email\": \"joshua.burns@example.com\"\n },\n \"assignedToEmail\": \"joshua.burns@example.com\",\n \"netPrice\": 1615,\n \"netPriceCurrency\": \"USD\",\n \"platform\": \"Mac\",\n \"isEncrypted\": false,\n \"customFields\": {\n \"user_department\": \"Engineering\",\n \"user_ram_gb\": 32,\n \"user_accessories\": [\n \"Charger\",\n \"Dock\"\n ]\n },\n \"createdBy\": {\n \"userId\": \"b1fb51a7c13f4cbf832b304348c8270e\",\n \"name\": \"System\",\n \"email\": \"admin@example.com\"\n },\n \"createdDtm\": \"2023-05-25T20:55:43.048Z\",\n \"lastModifiedBy\": {\n \"userId\": \"b1fb51a7c13f4cbf832b304348c8270e\",\n \"name\": \"System\",\n \"email\": \"admin@example.com\"\n },\n \"lastModifiedDtm\": \"2024-05-27T01:03:26.679Z\"\n}"
response = http.request(request)
puts response.read_body{
"id": "646fcb4fb829ba9df2a94471",
"status": "Deployed",
"statusType": "Deployed",
"hardwareVendor": "Apple Inc.",
"modelName": "MacBook Pro (16-inch, 2021)",
"serialNumber": "KOGITG04P5",
"assetTag": "A0000002",
"purchasedDate": "2016-03-06T00:00:00Z",
"warrantyExpirationDate": "2017-03-06T00:00:00Z",
"lifespanExpirationDate": "2019-03-06T00:00:00Z",
"assignedTo": {
"userId": "6a127db661b442c1afdd77611ad99824",
"name": "Joshua Burns",
"email": "joshua.burns@example.com"
},
"assignedToEmail": "joshua.burns@example.com",
"netPrice": 1615,
"netPriceCurrency": "USD",
"platform": "Mac",
"isEncrypted": false,
"customFields": {
"user_department": "Engineering",
"user_ram_gb": 32,
"user_accessories": [
"Charger",
"Dock"
]
},
"createdBy": {
"userId": "b1fb51a7c13f4cbf832b304348c8270e",
"name": "System",
"email": "admin@example.com"
},
"createdDtm": "2023-05-25T20:55:43.048Z",
"lastModifiedBy": {
"userId": "b1fb51a7c13f4cbf832b304348c8270e",
"name": "System",
"email": "admin@example.com"
},
"lastModifiedDtm": "2024-05-27T01:03:26.679Z"
}{
"type": "about:blank",
"title": "One or more validation errors occurred.",
"status": 400,
"detail": "The request body failed validation. See errors for the offending fields.",
"errors": {
"email": [
"The email field is required."
]
},
"traceId": "00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01"
}{
"type": "about:blank",
"title": "Not found.",
"status": 404,
"detail": "The requested resource does not exist or you do not have access to it.",
"traceId": "00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01"
}Devices
Create or replace a device
Creates a new device, or fully replaces an existing one when an ID is supplied (in the route
or in the body). When creating, hardwareVendor and modelName are required.
Assign the device to a person with assignedToEmail and to a location with
locationName (a location is created if needed). netPrice is converted to your
base currency.
Required scope: Assets.Write (Write access to devices)
PUT
/
api
/
assets
/
v1
/
{id}
Create or replace a device
curl --request PUT \
--url https://app.trelica.com/api/assets/v1/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"id": "646fcb4fb829ba9df2a94471",
"status": "Deployed",
"statusType": "Deployed",
"hardwareVendor": "Apple Inc.",
"modelName": "MacBook Pro (16-inch, 2021)",
"serialNumber": "KOGITG04P5",
"assetTag": "A0000002",
"purchasedDate": "2016-03-06T00:00:00Z",
"warrantyExpirationDate": "2017-03-06T00:00:00Z",
"lifespanExpirationDate": "2019-03-06T00:00:00Z",
"assignedTo": {
"userId": "6a127db661b442c1afdd77611ad99824",
"name": "Joshua Burns",
"email": "joshua.burns@example.com"
},
"assignedToEmail": "joshua.burns@example.com",
"netPrice": 1615,
"netPriceCurrency": "USD",
"platform": "Mac",
"isEncrypted": false,
"customFields": {
"user_department": "Engineering",
"user_ram_gb": 32,
"user_accessories": [
"Charger",
"Dock"
]
},
"createdBy": {
"userId": "b1fb51a7c13f4cbf832b304348c8270e",
"name": "System",
"email": "admin@example.com"
},
"createdDtm": "2023-05-25T20:55:43.048Z",
"lastModifiedBy": {
"userId": "b1fb51a7c13f4cbf832b304348c8270e",
"name": "System",
"email": "admin@example.com"
},
"lastModifiedDtm": "2024-05-27T01:03:26.679Z"
}
'const url = 'https://app.trelica.com/api/assets/v1/{id}';
const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
id: '646fcb4fb829ba9df2a94471',
status: 'Deployed',
statusType: 'Deployed',
hardwareVendor: 'Apple Inc.',
modelName: 'MacBook Pro (16-inch, 2021)',
serialNumber: 'KOGITG04P5',
assetTag: 'A0000002',
purchasedDate: '2016-03-06T00:00:00Z',
warrantyExpirationDate: '2017-03-06T00:00:00Z',
lifespanExpirationDate: '2019-03-06T00:00:00Z',
assignedTo: {
userId: '6a127db661b442c1afdd77611ad99824',
name: 'Joshua Burns',
email: 'joshua.burns@example.com'
},
assignedToEmail: 'joshua.burns@example.com',
netPrice: 1615,
netPriceCurrency: 'USD',
platform: 'Mac',
isEncrypted: false,
customFields: {
user_department: 'Engineering',
user_ram_gb: 32,
user_accessories: ['Charger', 'Dock']
},
createdBy: {
userId: 'b1fb51a7c13f4cbf832b304348c8270e',
name: 'System',
email: 'admin@example.com'
},
createdDtm: '2023-05-25T20:55:43.048Z',
lastModifiedBy: {
userId: 'b1fb51a7c13f4cbf832b304348c8270e',
name: 'System',
email: 'admin@example.com'
},
lastModifiedDtm: '2024-05-27T01:03:26.679Z'
})
};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));import requests
url = "https://app.trelica.com/api/assets/v1/{id}"
payload = {
"id": "646fcb4fb829ba9df2a94471",
"status": "Deployed",
"statusType": "Deployed",
"hardwareVendor": "Apple Inc.",
"modelName": "MacBook Pro (16-inch, 2021)",
"serialNumber": "KOGITG04P5",
"assetTag": "A0000002",
"purchasedDate": "2016-03-06T00:00:00Z",
"warrantyExpirationDate": "2017-03-06T00:00:00Z",
"lifespanExpirationDate": "2019-03-06T00:00:00Z",
"assignedTo": {
"userId": "6a127db661b442c1afdd77611ad99824",
"name": "Joshua Burns",
"email": "joshua.burns@example.com"
},
"assignedToEmail": "joshua.burns@example.com",
"netPrice": 1615,
"netPriceCurrency": "USD",
"platform": "Mac",
"isEncrypted": False,
"customFields": {
"user_department": "Engineering",
"user_ram_gb": 32,
"user_accessories": ["Charger", "Dock"]
},
"createdBy": {
"userId": "b1fb51a7c13f4cbf832b304348c8270e",
"name": "System",
"email": "admin@example.com"
},
"createdDtm": "2023-05-25T20:55:43.048Z",
"lastModifiedBy": {
"userId": "b1fb51a7c13f4cbf832b304348c8270e",
"name": "System",
"email": "admin@example.com"
},
"lastModifiedDtm": "2024-05-27T01:03:26.679Z"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://app.trelica.com/api/assets/v1/{id}"
payload := strings.NewReader("{\n \"id\": \"646fcb4fb829ba9df2a94471\",\n \"status\": \"Deployed\",\n \"statusType\": \"Deployed\",\n \"hardwareVendor\": \"Apple Inc.\",\n \"modelName\": \"MacBook Pro (16-inch, 2021)\",\n \"serialNumber\": \"KOGITG04P5\",\n \"assetTag\": \"A0000002\",\n \"purchasedDate\": \"2016-03-06T00:00:00Z\",\n \"warrantyExpirationDate\": \"2017-03-06T00:00:00Z\",\n \"lifespanExpirationDate\": \"2019-03-06T00:00:00Z\",\n \"assignedTo\": {\n \"userId\": \"6a127db661b442c1afdd77611ad99824\",\n \"name\": \"Joshua Burns\",\n \"email\": \"joshua.burns@example.com\"\n },\n \"assignedToEmail\": \"joshua.burns@example.com\",\n \"netPrice\": 1615,\n \"netPriceCurrency\": \"USD\",\n \"platform\": \"Mac\",\n \"isEncrypted\": false,\n \"customFields\": {\n \"user_department\": \"Engineering\",\n \"user_ram_gb\": 32,\n \"user_accessories\": [\n \"Charger\",\n \"Dock\"\n ]\n },\n \"createdBy\": {\n \"userId\": \"b1fb51a7c13f4cbf832b304348c8270e\",\n \"name\": \"System\",\n \"email\": \"admin@example.com\"\n },\n \"createdDtm\": \"2023-05-25T20:55:43.048Z\",\n \"lastModifiedBy\": {\n \"userId\": \"b1fb51a7c13f4cbf832b304348c8270e\",\n \"name\": \"System\",\n \"email\": \"admin@example.com\"\n },\n \"lastModifiedDtm\": \"2024-05-27T01:03:26.679Z\"\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}using RestSharp;
var options = new RestClientOptions("https://app.trelica.com/api/assets/v1/{id}");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "Bearer <token>");
request.AddJsonBody("{\n \"id\": \"646fcb4fb829ba9df2a94471\",\n \"status\": \"Deployed\",\n \"statusType\": \"Deployed\",\n \"hardwareVendor\": \"Apple Inc.\",\n \"modelName\": \"MacBook Pro (16-inch, 2021)\",\n \"serialNumber\": \"KOGITG04P5\",\n \"assetTag\": \"A0000002\",\n \"purchasedDate\": \"2016-03-06T00:00:00Z\",\n \"warrantyExpirationDate\": \"2017-03-06T00:00:00Z\",\n \"lifespanExpirationDate\": \"2019-03-06T00:00:00Z\",\n \"assignedTo\": {\n \"userId\": \"6a127db661b442c1afdd77611ad99824\",\n \"name\": \"Joshua Burns\",\n \"email\": \"joshua.burns@example.com\"\n },\n \"assignedToEmail\": \"joshua.burns@example.com\",\n \"netPrice\": 1615,\n \"netPriceCurrency\": \"USD\",\n \"platform\": \"Mac\",\n \"isEncrypted\": false,\n \"customFields\": {\n \"user_department\": \"Engineering\",\n \"user_ram_gb\": 32,\n \"user_accessories\": [\n \"Charger\",\n \"Dock\"\n ]\n },\n \"createdBy\": {\n \"userId\": \"b1fb51a7c13f4cbf832b304348c8270e\",\n \"name\": \"System\",\n \"email\": \"admin@example.com\"\n },\n \"createdDtm\": \"2023-05-25T20:55:43.048Z\",\n \"lastModifiedBy\": {\n \"userId\": \"b1fb51a7c13f4cbf832b304348c8270e\",\n \"name\": \"System\",\n \"email\": \"admin@example.com\"\n },\n \"lastModifiedDtm\": \"2024-05-27T01:03:26.679Z\"\n}", false);
var response = await client.PutAsync(request);
Console.WriteLine("{0}", response.Content);
HttpResponse<String> response = Unirest.put("https://app.trelica.com/api/assets/v1/{id}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"id\": \"646fcb4fb829ba9df2a94471\",\n \"status\": \"Deployed\",\n \"statusType\": \"Deployed\",\n \"hardwareVendor\": \"Apple Inc.\",\n \"modelName\": \"MacBook Pro (16-inch, 2021)\",\n \"serialNumber\": \"KOGITG04P5\",\n \"assetTag\": \"A0000002\",\n \"purchasedDate\": \"2016-03-06T00:00:00Z\",\n \"warrantyExpirationDate\": \"2017-03-06T00:00:00Z\",\n \"lifespanExpirationDate\": \"2019-03-06T00:00:00Z\",\n \"assignedTo\": {\n \"userId\": \"6a127db661b442c1afdd77611ad99824\",\n \"name\": \"Joshua Burns\",\n \"email\": \"joshua.burns@example.com\"\n },\n \"assignedToEmail\": \"joshua.burns@example.com\",\n \"netPrice\": 1615,\n \"netPriceCurrency\": \"USD\",\n \"platform\": \"Mac\",\n \"isEncrypted\": false,\n \"customFields\": {\n \"user_department\": \"Engineering\",\n \"user_ram_gb\": 32,\n \"user_accessories\": [\n \"Charger\",\n \"Dock\"\n ]\n },\n \"createdBy\": {\n \"userId\": \"b1fb51a7c13f4cbf832b304348c8270e\",\n \"name\": \"System\",\n \"email\": \"admin@example.com\"\n },\n \"createdDtm\": \"2023-05-25T20:55:43.048Z\",\n \"lastModifiedBy\": {\n \"userId\": \"b1fb51a7c13f4cbf832b304348c8270e\",\n \"name\": \"System\",\n \"email\": \"admin@example.com\"\n },\n \"lastModifiedDtm\": \"2024-05-27T01:03:26.679Z\"\n}")
.asString();<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.trelica.com/api/assets/v1/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'id' => '646fcb4fb829ba9df2a94471',
'status' => 'Deployed',
'statusType' => 'Deployed',
'hardwareVendor' => 'Apple Inc.',
'modelName' => 'MacBook Pro (16-inch, 2021)',
'serialNumber' => 'KOGITG04P5',
'assetTag' => 'A0000002',
'purchasedDate' => '2016-03-06T00:00:00Z',
'warrantyExpirationDate' => '2017-03-06T00:00:00Z',
'lifespanExpirationDate' => '2019-03-06T00:00:00Z',
'assignedTo' => [
'userId' => '6a127db661b442c1afdd77611ad99824',
'name' => 'Joshua Burns',
'email' => 'joshua.burns@example.com'
],
'assignedToEmail' => 'joshua.burns@example.com',
'netPrice' => 1615,
'netPriceCurrency' => 'USD',
'platform' => 'Mac',
'isEncrypted' => false,
'customFields' => [
'user_department' => 'Engineering',
'user_ram_gb' => 32,
'user_accessories' => [
'Charger',
'Dock'
]
],
'createdBy' => [
'userId' => 'b1fb51a7c13f4cbf832b304348c8270e',
'name' => 'System',
'email' => 'admin@example.com'
],
'createdDtm' => '2023-05-25T20:55:43.048Z',
'lastModifiedBy' => [
'userId' => 'b1fb51a7c13f4cbf832b304348c8270e',
'name' => 'System',
'email' => 'admin@example.com'
],
'lastModifiedDtm' => '2024-05-27T01:03:26.679Z'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}$headers=@{}
$headers.Add("Authorization", "Bearer <token>")
$headers.Add("Content-Type", "application/json")
$response = Invoke-WebRequest -Uri 'https://app.trelica.com/api/assets/v1/{id}' -Method PUT -Headers $headers -ContentType 'application/json' -Body '{
"id": "646fcb4fb829ba9df2a94471",
"status": "Deployed",
"statusType": "Deployed",
"hardwareVendor": "Apple Inc.",
"modelName": "MacBook Pro (16-inch, 2021)",
"serialNumber": "KOGITG04P5",
"assetTag": "A0000002",
"purchasedDate": "2016-03-06T00:00:00Z",
"warrantyExpirationDate": "2017-03-06T00:00:00Z",
"lifespanExpirationDate": "2019-03-06T00:00:00Z",
"assignedTo": {
"userId": "6a127db661b442c1afdd77611ad99824",
"name": "Joshua Burns",
"email": "joshua.burns@example.com"
},
"assignedToEmail": "joshua.burns@example.com",
"netPrice": 1615,
"netPriceCurrency": "USD",
"platform": "Mac",
"isEncrypted": false,
"customFields": {
"user_department": "Engineering",
"user_ram_gb": 32,
"user_accessories": [
"Charger",
"Dock"
]
},
"createdBy": {
"userId": "b1fb51a7c13f4cbf832b304348c8270e",
"name": "System",
"email": "admin@example.com"
},
"createdDtm": "2023-05-25T20:55:43.048Z",
"lastModifiedBy": {
"userId": "b1fb51a7c13f4cbf832b304348c8270e",
"name": "System",
"email": "admin@example.com"
},
"lastModifiedDtm": "2024-05-27T01:03:26.679Z"
}'require 'uri'
require 'net/http'
url = URI("https://app.trelica.com/api/assets/v1/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"id\": \"646fcb4fb829ba9df2a94471\",\n \"status\": \"Deployed\",\n \"statusType\": \"Deployed\",\n \"hardwareVendor\": \"Apple Inc.\",\n \"modelName\": \"MacBook Pro (16-inch, 2021)\",\n \"serialNumber\": \"KOGITG04P5\",\n \"assetTag\": \"A0000002\",\n \"purchasedDate\": \"2016-03-06T00:00:00Z\",\n \"warrantyExpirationDate\": \"2017-03-06T00:00:00Z\",\n \"lifespanExpirationDate\": \"2019-03-06T00:00:00Z\",\n \"assignedTo\": {\n \"userId\": \"6a127db661b442c1afdd77611ad99824\",\n \"name\": \"Joshua Burns\",\n \"email\": \"joshua.burns@example.com\"\n },\n \"assignedToEmail\": \"joshua.burns@example.com\",\n \"netPrice\": 1615,\n \"netPriceCurrency\": \"USD\",\n \"platform\": \"Mac\",\n \"isEncrypted\": false,\n \"customFields\": {\n \"user_department\": \"Engineering\",\n \"user_ram_gb\": 32,\n \"user_accessories\": [\n \"Charger\",\n \"Dock\"\n ]\n },\n \"createdBy\": {\n \"userId\": \"b1fb51a7c13f4cbf832b304348c8270e\",\n \"name\": \"System\",\n \"email\": \"admin@example.com\"\n },\n \"createdDtm\": \"2023-05-25T20:55:43.048Z\",\n \"lastModifiedBy\": {\n \"userId\": \"b1fb51a7c13f4cbf832b304348c8270e\",\n \"name\": \"System\",\n \"email\": \"admin@example.com\"\n },\n \"lastModifiedDtm\": \"2024-05-27T01:03:26.679Z\"\n}"
response = http.request(request)
puts response.read_body{
"id": "646fcb4fb829ba9df2a94471",
"status": "Deployed",
"statusType": "Deployed",
"hardwareVendor": "Apple Inc.",
"modelName": "MacBook Pro (16-inch, 2021)",
"serialNumber": "KOGITG04P5",
"assetTag": "A0000002",
"purchasedDate": "2016-03-06T00:00:00Z",
"warrantyExpirationDate": "2017-03-06T00:00:00Z",
"lifespanExpirationDate": "2019-03-06T00:00:00Z",
"assignedTo": {
"userId": "6a127db661b442c1afdd77611ad99824",
"name": "Joshua Burns",
"email": "joshua.burns@example.com"
},
"assignedToEmail": "joshua.burns@example.com",
"netPrice": 1615,
"netPriceCurrency": "USD",
"platform": "Mac",
"isEncrypted": false,
"customFields": {
"user_department": "Engineering",
"user_ram_gb": 32,
"user_accessories": [
"Charger",
"Dock"
]
},
"createdBy": {
"userId": "b1fb51a7c13f4cbf832b304348c8270e",
"name": "System",
"email": "admin@example.com"
},
"createdDtm": "2023-05-25T20:55:43.048Z",
"lastModifiedBy": {
"userId": "b1fb51a7c13f4cbf832b304348c8270e",
"name": "System",
"email": "admin@example.com"
},
"lastModifiedDtm": "2024-05-27T01:03:26.679Z"
}{
"type": "about:blank",
"title": "One or more validation errors occurred.",
"status": 400,
"detail": "The request body failed validation. See errors for the offending fields.",
"errors": {
"email": [
"The email field is required."
]
},
"traceId": "00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01"
}{
"type": "about:blank",
"title": "Not found.",
"status": 404,
"detail": "The requested resource does not exist or you do not have access to it.",
"traceId": "00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01"
}Authorizations
OAuth 2.0. Obtain an access token via the Client Credentials or Authorization Code flow, then send it as Authorization: Bearer <token>.
Scopes
Assets.Write
Write access to devices
Path Parameters
Optional SaaS Manager device ID to replace. If omitted a new device is created.
Body
application/json
An asset (device)
The asset's SaaS Manager ID. Supply to replace an existing asset.
The device's status. This is the status's reference ID; custom statuses are prefixed user_. Defaults to New on creation.
The hardware vendor (manufacturer). Required when creating an asset.
The model name. Required when creating an asset.
The asset type, e.g. Laptop
The serial number
The asset tag
(ISO format) The purchase date
(ISO format) The disposal date
(ISO format) The warranty expiration date
(ISO format) The end of the asset's useful life
Notes about the asset
Assign the asset to a person by email address. Pass null to unassign.
The net price, in the currency given by netPriceCurrency
The ISO currency code for netPrice. Defaults to your base currency.
(ISO format) The date the asset was enrolled
The asset's operating system platform
Available options:
Mac, Windows, iOS, Android, ChromeOS, Linux The operating system version
Whether the asset's storage is encrypted
Custom field values, keyed by the field's lookup key. Each value is the field's value directly: a string (text/single-select), a number, an ISO-8601 date, an array of strings (multi-select), or a link object ({ href, description }).
Show child attributes
Show child attributes
Assign the asset to a location by name (a location is found or created). Pass null to clear.
Response
OK
An asset (device)
The asset's SaaS Manager ID. Supply to replace an existing asset.
The asset's external ID, sourced from the integration that imported it.
The device's status. This is the status's reference ID; custom statuses are prefixed user_. Defaults to New on creation.
The base status the device's status maps to. Custom statuses always map to one of these.
Available options:
New, ReadyToDeploy, Deployed, OutForRepair, Retired The hardware vendor (manufacturer). Required when creating an asset.
The model name. Required when creating an asset.
The asset type, e.g. Laptop
The serial number
A description of the asset, sourced from integrations.
The device name, sourced from integrations.
The asset tag
(ISO format) The purchase date
(ISO format) The disposal date
(ISO format) The warranty expiration date
(ISO format) The end of the asset's useful life
Notes about the asset
The person the asset is assigned to. To set the assignee, use assignedToEmail.
Show child attributes
Show child attributes
Assign the asset to a person by email address. Pass null to unassign.
The net price, in the currency given by netPriceCurrency
The ISO currency code for netPrice. Defaults to your base currency.
(ISO format) The date the asset was enrolled
The timestamp of the asset's last sync from an integration.
The asset's operating system platform
Available options:
Mac, Windows, iOS, Android, ChromeOS, Linux The operating system version
Whether the asset's storage is encrypted
Custom field values, keyed by the field's lookup key. Each value is the field's value directly: a string (text/single-select), a number, an ISO-8601 date, an array of strings (multi-select), or a link object ({ href, description }).
Show child attributes
Show child attributes
The user that created the asset record
Show child attributes
Show child attributes
The timestamp for when the asset record was created
The user that last modified the asset record
Show child attributes
Show child attributes
The timestamp for when the asset record was last modified
The asset's location. To set the location, use locationName.
Show child attributes
Show child attributes
Assign the asset to a location by name (a location is found or created). Pass null to clear.
Was this page helpful?