Create asset

post

https://api.sensos.io/v1/accounts/{accountId}/assets

Register a new asset. No field is required; healthStatus defaults to Healthy. To pair a device, send its deviceId: the device must exist in the account and is moved to the asset's set. If you omit setId, the asset is assigned automatically to the set with the lowest priority (or, if no set has a priority, the first set without one). Returns 201 with the created asset; the Location header contains /v1/accounts/{accountId}/assets/{assetId}.

Path Params

accountId

string

required

The account ID.

Body Params

Asset details.

Request data for creating or updating an asset. No field is required.

setId

uuid | null

ID of a set in the account (400 if it does not exist).

name

string | null

^[^\$\%\^\*\{\}\@]*$

Name. Up to 40 characters; cannot contain $ % ^ * { } @.

description

string | null

Description.

deviceId

string | null

^[a-zA-Z0-9._\-\s]{0,70}$

ID of the paired device. Letters, numbers, spaces, dots, hyphens and underscores, up to 70 characters. The device must exist in the account (400).

healthStatus

string | null

enum

Health status. Closed cannot be set in a request (400); defaults to Healthy on create.

Allowed:

items

array of objects | null

Items (up to 10).

items

customProperties

object | null

Custom key-value properties: up to 30 keys, keys up to 50 characters, values up to 100 characters.

type

string | null

enum

Physical category of the asset.

201Asset created.

400Invalid request. Field and query validation failures return ValidationProblemDetails; business-rule failures return ErrorResponse.