Update an asset

curl --request PATCH \
  --url https://api.nomos.energy/assets/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "battery": {
    "capacity_kwh": 12
  }
}
'

import requests

url = "https://api.nomos.energy/assets/{id}"

payload = { "battery": { "capacity_kwh": 12 } }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({battery: {capacity_kwh: 12}})
};

fetch('https://api.nomos.energy/assets/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.nomos.energy/assets/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'battery' => [
        'capacity_kwh' => 12
    ]
  ]),
  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;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.nomos.energy/assets/{id}"

	payload := strings.NewReader("{\n  \"battery\": {\n    \"capacity_kwh\": 12\n  }\n}")

	req, _ := http.NewRequest("PATCH", 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))

}

HttpResponse<String> response = Unirest.patch("https://api.nomos.energy/assets/{id}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"battery\": {\n    \"capacity_kwh\": 12\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.nomos.energy/assets/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"battery\": {\n    \"capacity_kwh\": 12\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "object": "asset",
  "id": "ha_b7q2m1k8v4n0x3c9l5p2r7td",
  "household": "dom_k3v9x2m7n1b4v8c2x6z0q5wd",
  "parent_inverter": "ha_i9k3l7w2e5r8t1y4u6o0p3as",
  "external_id": "partner-bat-1",
  "status": "active",
  "is_steerable": true,
  "manufacturer": "BYD",
  "model": "Battery-Box Premium HVS 10.2",
  "installed_at": null,
  "metadata": {
    "serial_number": "34118573"
  },
  "decommissioned_at": null,
  "created_at": "2026-10-06T09:12:44Z",
  "type": "battery",
  "battery": {
    "capacity_kwh": 10.2,
    "max_in_kw": 5,
    "max_out_kw": 5,
    "min_soc": 0.1,
    "max_soc": 0.95
  }
}

PATCH

assets

{id}

Update an asset

curl --request PATCH \
  --url https://api.nomos.energy/assets/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "battery": {
    "capacity_kwh": 12
  }
}
'

import requests

url = "https://api.nomos.energy/assets/{id}"

payload = { "battery": { "capacity_kwh": 12 } }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({battery: {capacity_kwh: 12}})
};

fetch('https://api.nomos.energy/assets/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.nomos.energy/assets/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'battery' => [
        'capacity_kwh' => 12
    ]
  ]),
  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;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.nomos.energy/assets/{id}"

	payload := strings.NewReader("{\n  \"battery\": {\n    \"capacity_kwh\": 12\n  }\n}")

	req, _ := http.NewRequest("PATCH", 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))

}

HttpResponse<String> response = Unirest.patch("https://api.nomos.energy/assets/{id}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"battery\": {\n    \"capacity_kwh\": 12\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.nomos.energy/assets/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"battery\": {\n    \"capacity_kwh\": 12\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "object": "asset",
  "id": "ha_b7q2m1k8v4n0x3c9l5p2r7td",
  "household": "dom_k3v9x2m7n1b4v8c2x6z0q5wd",
  "parent_inverter": "ha_i9k3l7w2e5r8t1y4u6o0p3as",
  "external_id": "partner-bat-1",
  "status": "active",
  "is_steerable": true,
  "manufacturer": "BYD",
  "model": "Battery-Box Premium HVS 10.2",
  "installed_at": null,
  "metadata": {
    "serial_number": "34118573"
  },
  "decommissioned_at": null,
  "created_at": "2026-10-06T09:12:44Z",
  "type": "battery",
  "battery": {
    "capacity_kwh": 10.2,
    "max_in_kw": 5,
    "max_out_kw": 5,
    "min_soc": 0.1,
    "max_soc": 0.95
  }
}

Authorizations

Authorization

string

header

required

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

Path Parameters

string

required

Example:

"ha_b7q2m1k8v4n0x3c9l5p2r7td"

Body

application/json

A field you leave out stays as it is, and null clears it. The type data object and metadata merge key by key. Unknown fields inside the type data object, and type data for another type, are rejected. Unknown top-level fields are ignored. A different device is a new asset: add it and decommission the old one.

parent_inverter

string | null

The Nomos ID of the active inverter in the same household that the asset sits behind. Required on solar, optional on battery (a battery without it is AC-coupled), not allowed on other types.

Example:

"ha_i9k3l7w2e5r8t1y4u6o0p3as"

is_steerable

boolean

manufacturer

string | null

model

string | null

installed_at

string<date-time> | null

metadata

object | null

Show child attributes

inverter

object

Show child attributes

solar

object

Show child attributes

battery

object

Show child attributes

wallbox

object

Show child attributes

heat_pump

object

Show child attributes

Response

The updated 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

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

Show child attributes

Example:

{ "serial_number": "34118573" }

decommissioned_at

required

Example:

null

created_at

required

Example:

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

type

enum<string>

required

Available options:

battery

battery

object

required

Show child attributes