Upsert asset

PUT

/assets/

Creates or updates an asset and returns its ID.

When an external ID is provided: updates the matching asset, or creates
one if none exists.

When a custom ID is provided: updates the first matching asset, or creates
one if none exists.

Either an external ID or a custom ID is required.

A site or customer reference is required for a new asset depending on
the business asset owner mode.

Only the fields provided are changed; omitted fields remain unchanged.

Request

Body Params application/jsonRequired

Example

{
    "external_id": "ASSET-1001",
    "asset_type": "65",
    "model": "65",
    "qty": 1,
    "supplier": "83",
    "custom_id": "A-1001",
    "notes": "Rooftop unit, access via loading dock.",
    "customer_reference": "SITE-AC-01",
    "installer": "Northwind HVAC Services",
    "installation_date": "2024-05-15",
    "commissioning_date": "2024-05-20",
    "expiry_date": "2029-05-20",
    "make": "Carrier",
    "serial_number": "CN24ACC636A00312",
    "site": "67",
    "company": "80",
    "customer": "80",
    "custom_fields": [
        {
            "field": "1",
            "value": "R-410A"
        }
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PUT 'https://app.fieldinsight.com/public-api//assets/' \
--header 'Content-Type: application/json' \
--data '{
    "external_id": "ASSET-1001",
    "asset_type": "65",
    "model": "65",
    "qty": 1,
    "supplier": "83",
    "custom_id": "A-1001",
    "notes": "Rooftop unit, access via loading dock.",
    "customer_reference": "SITE-AC-01",
    "installer": "Northwind HVAC Services",
    "installation_date": "2024-05-15",
    "commissioning_date": "2024-05-20",
    "expiry_date": "2029-05-20",
    "make": "Carrier",
    "serial_number": "CN24ACC636A00312",
    "site": "67",
    "company": "80",
    "customer": "80",
    "custom_fields": [
        {
            "field": "1",
            "value": "R-410A"
        }
    ]
}'

Responses

🟢200OK

application/json

Successful response.

Bodyapplication/json

Example

{
    "id": "1001"
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🟠409

🟠422Parameter Error

🟠429

Modified at 2026-10-30 03:40:11

Patch asset

Remove asset