Skip to main content
PUT
/
api
/
partners
/
v2.0
/
org
/
{org_id}
/
users
/
{user_id}
/
inverters
/
{inverter_id}
Update details of a user's solar inverter
curl --request PUT \
  --url https://api.example.com/api/partners/v2.0/org/{org_id}/users/{user_id}/inverters/{inverter_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "is_pause_power_active": false,
  "is_smart_optimization_active": false,
  "device_model": {
    "device_type": {
      "short_name": "<string>",
      "long_name": "<string>"
    },
    "manufacturer": "<string>",
    "model": "<string>",
    "year": 123,
    "cloud_service_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  },
  "battery_policy": "Optimize self consumption",
  "price_zone": "AT",
  "building_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "pause_power_until": "2023-11-07T05:31:56Z",
  "comment": "<string>",
  "last_monitoring_executed_at": "2023-11-07T05:31:56Z",
  "is_inverter_forced_mode_enabled": false,
  "is_forecasting_enabled": false,
  "is_trading_enabled": false,
  "actual_steering_state": "unknown",
  "solar_power_rating_kw": 123,
  "battery_capacity_kwh": 123,
  "is_battery_connected": false,
  "is_curtailment_active": false,
  "max_battery_charge": 123,
  "min_battery_charge": 123,
  "user_limits_enabled": false,
  "current_power_to_grid_w": 123
}
'
{
  "connection_status": "ok",
  "monitoring_status": "ok",
  "steering_status": "ok",
  "device_model": {
    "device_type": {
      "short_name": "<string>",
      "long_name": "<string>"
    },
    "manufacturer": "<string>",
    "model": "<string>",
    "cloud_service_instructions": "<string>",
    "cloud_service_signup_link": "<string>",
    "year": 123,
    "cloud_service": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  },
  "owner": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "email": "<string>",
    "first_name": "<string>",
    "last_name": "<string>",
    "external_id": "<string>"
  },
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "price_zone": "AT",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "building": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "pause_power_until": "2023-11-07T05:31:56Z",
  "is_pause_power_active": false,
  "external_device_id": "",
  "is_authenticated": false,
  "is_smart_optimization_active": false,
  "current_mode": "<string>",
  "comment": "<string>",
  "current_state_last_updated_at": "2023-11-07T05:31:56Z",
  "last_monitoring_executed_at": "2023-11-07T05:31:56Z",
  "is_inverter_forced_mode_enabled": false,
  "is_inverter_forced_mode_active": false,
  "inverter_forced_mode_since": "0001-01-01T00:00:00Z",
  "is_forecasting_enabled": false,
  "is_trading_enabled": false,
  "actual_steering_state": "unknown",
  "solar_power_rating_kw": 123,
  "battery_capacity_kwh": 123,
  "is_battery_connected": false,
  "is_curtailment_active": false,
  "max_battery_charge": 123,
  "min_battery_charge": 123,
  "user_limits_enabled": false,
  "information_last_updated_at": "2023-11-07T05:31:56Z",
  "battery_policy": "Optimize self consumption",
  "battery_policy_last_updated_at": "2023-11-07T05:31:56Z",
  "current_solar_production_w": 123,
  "current_power_to_grid_w": 123,
  "household_consumption_w": 123,
  "solar_surplus_w": 123,
  "battery_charge_discharge_power_w": 123,
  "battery_charge_level_percent": 123,
  "production_last_day_kwh": 123,
  "production_last_week_kwh": 123,
  "production_last_month_kwh": 123,
  "production_last_updated_at": "2023-11-07T05:31:56Z",
  "needs_gateway": false,
  "embeddable_url": "<string>",
  "authorization_url": "<string>"
}

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

org_id
string<uuid>
required

The organization ID of the user's organization

user_id
string<uuid>
required

The user ID of the user whom the solar inverter belongs to

inverter_id
string<uuid>
required

The ID of the modified solar inverter

Body

application/json
is_pause_power_active
boolean
default:false
is_smart_optimization_active
boolean
default:false
device_model
DeviceModelInput · object
battery_policy
enum<string> | null
Available options:
Optimize self consumption,
Optimize grid balancing,
Export all
price_zone
enum<string>
default:AT
Available options:
AT,
BE,
EE,
DE_LU,
PT,
SE_1,
SE_2,
SE_3,
SE_4,
UK
building_id
string<uuid> | null
pause_power_until
string<date-time> | null
comment
string | null
Maximum string length: 300
last_monitoring_executed_at
string<date-time> | null
is_inverter_forced_mode_enabled
boolean
default:false
is_forecasting_enabled
boolean
default:false
is_trading_enabled
boolean
default:false
actual_steering_state
string
default:unknown
Maximum string length: 20
solar_power_rating_kw
battery_capacity_kwh
is_battery_connected
boolean | null
default:false
is_curtailment_active
boolean | null
default:false
max_battery_charge
min_battery_charge
user_limits_enabled
boolean | null
default:false
current_power_to_grid_w

Response

200 - application/json

OK

connection_status
enum<string>
required
Available options:
ok,
warning,
error,
unknown
monitoring_status
enum<string>
required
Available options:
ok,
warning,
error,
unknown
steering_status
enum<string>
required
Available options:
ok,
warning,
error,
unknown
device_model
DeviceModelOutput · object
required
owner
OwnerOutput · object
required
created_at
string<date-time>
required
updated_at
string<date-time>
required
price_zone
enum<string>
default:AT
Available options:
AT,
BE,
EE,
DE_LU,
PT,
SE_1,
SE_2,
SE_3,
SE_4,
UK
id
string<uuid> | null
building
string<uuid> | null
pause_power_until
string<date-time> | null
is_pause_power_active
boolean
default:false
external_device_id
string | null
default:""
Maximum string length: 255
is_authenticated
boolean | null
default:false
is_smart_optimization_active
boolean
default:false
current_mode
string | null
comment
string | null
Maximum string length: 300
current_state_last_updated_at
string<date-time> | null
last_monitoring_executed_at
string<date-time> | null
is_inverter_forced_mode_enabled
boolean
default:false
is_inverter_forced_mode_active
boolean
default:false
inverter_forced_mode_since
string<date-time> | null
default:0001-01-01T00:00:00Z
is_forecasting_enabled
boolean
default:false
is_trading_enabled
boolean
default:false
actual_steering_state
string
default:unknown
Maximum string length: 20
solar_power_rating_kw
battery_capacity_kwh
is_battery_connected
boolean | null
default:false
is_curtailment_active
boolean | null
default:false
max_battery_charge
min_battery_charge
user_limits_enabled
boolean | null
default:false
information_last_updated_at
string<date-time> | null
battery_policy
string | null
default:Optimize self consumption
Maximum string length: 100
battery_policy_last_updated_at
string<date-time> | null
current_solar_production_w
current_power_to_grid_w
household_consumption_w
solar_surplus_w
battery_charge_discharge_power_w
battery_charge_level_percent
production_last_day_kwh
production_last_week_kwh
production_last_month_kwh
production_last_updated_at
string<date-time> | null
needs_gateway
boolean | null
default:false
embeddable_url
string | null

URL to embeddable onboarding form

authorization_url
string | null

Base URL for authorizing with the Podero server