Skip to main content
POST
Decommission an asset

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string
required
Example:

"ha_b7q2m1k8v4n0x3c9l5p2r7td"

Response

The decommissioned asset

A device in a household, or one of the two assets Nomos creates per household. It carries the type data object named like its type, with every field present and null where unknown.

object
enum<string>
required
Available options:
asset
id
string
required
Example:

"ha_b7q2m1k8v4n0x3c9l5p2r7td"

household
string
required
Example:

"dom_k3v9x2m7n1b4v8c2x6z0q5wd"

parent_inverter
string | null
required

The Nomos ID of the inverter the asset sits behind. Set on solar and on a battery behind a hybrid inverter.

Example:

"ha_i9k3l7w2e5r8t1y4u6o0p3as"

external_id
string | null
required

Your own ID. Null on household_net and household_residual.

Example:

"partner-bat-1"

status
enum<string>
required

A decommissioned asset stays readable, by its ID and in the list.

Available options:
active,
decommissioned
Example:

"active"

is_steerable
boolean
required
Example:

true

manufacturer
string | null
required
Example:

"BYD"

model
string | null
required
Example:

"Battery-Box Premium HVS 10.2"

installed_at
required
Example:

null

metadata
object | null
required
Example:
decommissioned_at
required
Example:

null

created_at
required
Example:

"2026-10-06T09:12:44Z"

type
enum<string>
required
Available options:
battery
battery
object
required