naftiko: 1.0.0-alpha2
info:
  label: Tesla Fleet Energy API — Sites
  description: Discover energy sites and read site info, live status, calendar history, and programs.
    Self-contained Naftiko capability covering the read-side of the Tesla Fleet Energy API.
  tags:
    - Tesla
    - Energy
    - Powerwall
    - Megapack
    - Solar
    - Sites
  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-sites
      baseUri: https://fleet-api.prd.na.vn.cloud.tesla.com/api/1
      description: Tesla Fleet Energy API — read access to energy sites. Requires the energy_device_data scope.
      headers:
        Authorization: Bearer ${env.TESLA_FLEET_TOKEN}
      resources:
        - name: products
          path: /products
          operations:
            - name: listproducts
              method: GET
              description: Tesla List Products — vehicles and energy sites accessible to this token
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: energy-sites-site-info
          path: /energy_sites/{site_id}/site_info
          operations:
            - name: getenergysiteinfo
              method: GET
              description: Tesla Get Energy Site Info — components, address, version, gateway IDs
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
              inputParameters:
                - name: site_id
                  in: path
                  type: string
                  required: true
        - name: energy-sites-live-status
          path: /energy_sites/{site_id}/live_status
          operations:
            - name: getenergysitelivestatus
              method: GET
              description: Tesla Get Energy Site Live Status — real-time power flow and state-of-charge
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
              inputParameters:
                - name: site_id
                  in: path
                  type: string
                  required: true
        - name: energy-sites-calendar-history
          path: /energy_sites/{site_id}/calendar_history
          operations:
            - name: getenergysitecalendarhistory
              method: GET
              description: Tesla Get Energy Site Calendar History — historical time-series energy data
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
              inputParameters:
                - name: site_id
                  in: path
                  type: string
                  required: true
                - name: kind
                  in: query
                  type: string
                  required: true
                - name: period
                  in: query
                  type: string
                  required: false
                - name: end_date
                  in: query
                  type: string
                  required: false
        - name: energy-sites-programs
          path: /energy_sites/{site_id}/programs
          operations:
            - name: getenergysiteprograms
              method: GET
              description: Tesla Get Energy Site Programs — VPP and grid-services participation
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
              inputParameters:
                - name: site_id
                  in: path
                  type: string
                  required: true