API Reference

Create asset

post
https://api.sensos.io/v1/accounts//assets

Register a new returnable physical asset in the Sensos system. You can optionally pair the asset with a Sensos Smart Label by providing its deviceId to stream real-time IoT sensor telemetry.

Path Params
string
required

Unique identifier of the Sensos account.

Body Params
string
required
length ≤ 40
^[^$%^*{}@]*$

Human-readable label or asset name (max 40 chars, restricted special chars).

string
length ≤ 300

Detailed operational notes or container specifications.

string
enum
required

Physical category and form factor classification of the returnable transport item.

string
length ≤ 70
^[a-zA-Z0-9._\-\s]*$

Sensos Smart Label device ID currently paired with this asset.

uuid

Configuration set ID assigned to this asset.

tags
array of strings

Searchable category labels and business tags.

tags
string
enum

Current health condition and maintenance readiness of the physical asset.

Allowed:
customProperties
object

Key-value metadata dictionary (max 30 entries, max key length 50 chars).

items
array of objects

Cargo line items packaged inside this asset container (max 10 items).

items
homeLocation
object
Response

Updated 12 days ago

Did this page help you?
Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 12 days ago

Did this page help you?