PUT /locations/{locationId}/tariff

Link a tariff to a Location using a daily schedule. Each new schedule overwrites any previous requests. Devices positioned at this location will use the schedule to calculate electricity costs. The schedule must ensure that there are no overlapping intervals, although gaps are permissible. In case of gaps, the system will default to market prices.

Servers

Path parameters

Name Type Required Description
locationId String Yes

Request headers

Name Type Required Description
Content-Type String Yes The media type of the request body.

Default value: "application/json"

Request body fields

Name Type Required Description
tariffId String Yes

The Tariff ID

tariffIntervals[] Array Yes

List of time intervals at which to apply the specified tariff rates.

tariffIntervals[].to String Yes

Interval to time (exclusive), format HH:mm. Interpreted in the timezone specified in the timezoneName field of the Location.

tariffIntervals[].name String Yes

Rate name

tariffIntervals[].weekdays[] Array No

An array of weekdays to apply the named tariff. A weekday starts with 0 for Monday, and ends with 6 for Sunday. If not specified, named tariff is applied for entire week

tariffIntervals[].from String Yes

Interval from time (inclusive), format HH:mm. Interpreted in the timezone specified in the timezoneName field of the Location.

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.