Tesla Energy · Capability

Tesla Fleet Energy API — Time Of Use

Update the time-of-use tariff schedule and optimization strategy for the site, plus off-grid vehicle charging reserve. Requires the energy_cmds scope.

Tesla Fleet Energy API — Time Of Use is a Naftiko capability published by Tesla Energy, one of 5 capabilities the APIs.io network indexes for this provider.

Can be deployed as a REST endpoint, MCP tool, or Agent Skill via Naftiko.

Tagged areas include Tesla, Energy, Powerwall, Time Of Use, and Off Grid Charging.

Run with Naftiko TeslaEnergyPowerwallTime Of UseOff Grid Charging

Capability Spec

naftiko: 1.0.0-alpha2
info:
  label: Tesla Fleet Energy API — Time Of Use
  description: Update the time-of-use tariff schedule and optimization strategy for the site, plus
    off-grid vehicle charging reserve. Requires the energy_cmds scope.
  tags:
    - Tesla
    - Energy
    - Powerwall
    - Time Of Use
    - Off Grid Charging
  created: '2026-05-25'
  modified: '2026-05-25'
binds:
  - namespace: env
    keys:
      TESLA_FLEET_TOKEN: TESLA_FLEET_TOKEN
capability:
  consumes:
    - type: http
      namespace: fleet-energy-tou
      baseUri: https://fleet-api.prd.na.vn.cloud.tesla.com/api/1
      description: Tesla Fleet Energy API — time-of-use and off-grid reserve write capability.
      headers:
        Authorization: Bearer ${env.TESLA_FLEET_TOKEN}
        Content-Type: application/json
      resources:
        - name: energy-sites-time-of-use
          path: /energy_sites/{site_id}/time_of_use_settings
          operations:
            - name: settimeofusesettings
              method: POST
              description: Tesla Set Time Of Use Settings — peak/off-peak schedule and optimization
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
              inputParameters:
                - name: site_id
                  in: path
                  type: string
                  required: true
                - name: body
                  in: body
                  type: object
                  description: Time-of-use settings payload (tou_settings.schedule[]).
                  required: true
        - name: energy-sites-off-grid-vehicle-charging-reserve
          path: /energy_sites/{site_id}/off_grid_vehicle_charging_reserve
          operations:
            - name: setoffgridvehiclechargingreserve
              method: POST
              description: Tesla Set Off-Grid Vehicle Charging Reserve Percent (0-100)
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
              inputParameters:
                - name: site_id
                  in: path
                  type: string
                  required: true
                - name: body
                  in: body
                  type: object
                  description: '{ "off_grid_vehicle_charging_reserve_percent": <int 0-100> }'
                  required: true