Skip to main content
PATCH
/
devices
/
{device_id}
Update a device
curl --request PATCH \
  --url https://api.flatpeak.com/devices/{device_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "locations": [
    "loc_641b90b758fb8e6293716e40"
  ]
}
'
{
  "id": "dev_63a6087272941ef077a8fd3e",
  "object": "device",
  "reference_id": "DEV1234567890",
  "live_mode": true,
  "locations": [
    "loc_641b90b758fb8e6293716e40"
  ],
  "manufacturer": "Nova Systems",
  "model_code": "PICOXN2",
  "model_name": "Pico Ultimate",
  "time_created": "2022-01-24T14:15:22Z",
  "account_id": "acc_661677911f2197045e6cf1b1",
  "properties": {
    "power_rating_kw": 7.2,
    "capacity_kwh": 14.2,
    "pv_azimuth": 0,
    "pv_tilt": 23,
    "pv_terrain_shading": false,
    "pv_forecasts_enabled": false,
    "install_date": "2022-03-22T11:12:21Z"
  },
  "last_seen": "2022-03-22T11:12:21Z",
  "tariffs": [
    {
      "tariff_id": "trf_66ba584eb6923d7c3b942ef6",
      "location_id": "loc_641b90b758fb8e6293716e40",
      "type": "COMMODITY",
      "direction": "IMPORT",
      "status": "CONNECTED",
      "connection_type": "DIRECT",
      "display_name": "Agile Octopus v3 2024",
      "is_temporary": true,
      "provider": {
        "id": "prv_63a6087272921ef075a8fd3e",
        "display_name": "Octopus Energy",
        "logo_url": "https://s.flatpeak.com/83b06a60e38c2.png"
      }
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Authenticate with bearer you obtained from authentication endpoint.

Path Parameters

​
device_id
string
required

Flatpeak Device ID

Body

application/json

Updates a Device

​
locations
string[]
required

Flatpeak Location IDs where this device may be located.

​
properties
DeviceProperties · object

Response

This object represents a device or another asset of a compatible type.

​
id
string
required
read-only

Flatpeak unique object id.

Example:

"dev_63a6087272941ef077a8fd3e"

​
object
string
required
read-only

Represents the object’s type.

Example:

"device"

​
reference_id
string
required
read-only

A reference that is meaningful to you, for example, an ID from your system.

Example:

"DEV1234567890"

​
live_mode
boolean
required

Has the value true if the object exists in live mode or the value false if the object exists in test mode.

​
locations
string[]
required

Flatpeak Location IDs where this device may be located.

​
manufacturer
string
required

Name of device manufacturer.

Example:

"Nova Systems"

​
model_code
string
required

Device model code, as declared by the manufacturer.

Example:

"PICOXN2"

​
model_name
string
required

Model name, as declared by the manufacturer.

Example:

"Pico Ultimate"

​
time_created
string
required

Time when the object was created, in UTC.

Example:

"2022-01-24T14:15:22Z"

​
account_id
string
required
read-only

Flatpeak account ID.

Example:

"acc_661677911f2197045e6cf1b1"

​
properties
DeviceProperties · object
​
last_seen
string<date-time>

Timestamp of when the device has last queried the service.

Example:

"2022-03-22T11:12:21Z"

​
tariffs
TariffElement · object[]