curl --request POST \
  --url https://api.nox.energy/v1/devices/pv/flex \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "target_kw": 2.5
}
'

{
  "meta": {
    "energy_supplier": "Energy Supplier A"
  }
}

PV Control

Post Pv Control Flex

Execute pv flex controls at the current time based on % of max capacity or amount of kW in production you want to lower of its current aggregated production across the whole supplier client base. If you provide an end_time with a 1 min granularit, we will revert the curtailed amount to it’s original amount at that time. If no end_time is given, we do not automatically revert back. When you execute flex on already curtailed devices, we will overwrite their current curtailment and scheduled end time with the new flex command you provided.

Timestamp fields in UTC.

Time format examples:

2023-10-01T00:00:00Z
2023-10-01T00:00:00

control_type can be set to export_curtailment, production_curtailment or default.

100 % target_percentage means that we will enable full production on the full pv panel fleet again.

NOTE:

The pv devices might need some time to react. If using end_time please provide end_time at least 4 minutes in the future to ensure the device can react in time. Some may react slower than others.

POST

devices

flex

curl --request POST \
  --url https://api.nox.energy/v1/devices/pv/flex \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "target_kw": 2.5
}
'

{
  "meta": {
    "energy_supplier": "Energy Supplier A"
  }
}

Authorizations

x-api-key

string

header

required

API Key authentication. Enter your API key in the format: YOUR_API_KEY

Body

application/json

target_kw

number | null

Target power in kW to reduce production with.

target_percentage

number | null

Target percentage of max capacity to reduce production with.

end_time

string | null

End time for the flex request in ISO 8601 format in UTC. If not provided, the flex request will be applied indefinitely until a new request is made.

Response

All controls accepted successfully