Skip to main content
POST
/
weatherdata
Create Weather Data
curl --request POST \
  --url https://api.example.com/weatherdata

​
POST /weatherdata

Create a weather data record by supplying hourly (or sub-hourly) weather arrays directly. This is the manual creation path — use POST /weatherdata/fetch instead if you want the server to retrieve data from an external source like NSRDB or PVGIS.

​
Notes

  • Requires a valid JWT with write access.
  • At minimum, provide the four required irradiance and meteorological arrays: ghi, dhi, windSpeed, and temperature. Optional arrays include dni, relativeHumidity, poa, and date (Unix timestamps in milliseconds).
  • All provided arrays must have the same length. Standard hourly datasets have 8,760 timesteps; sub-hourly datasets are also supported and auto-detected.
  • Optionally link to an existing location by providing locationId (workspace-scoped) or globalLocationId (Snowflake ID). Returns 404 if the referenced location does not exist.
  • weatherDataSource defaults to "provided" when supplying arrays directly.
  • soiling accepts monthly soiling factors (Jan—Dec, values 0—1) as a keyed object.
  • See POST /weatherdata/fetch to create weather data from an external source instead.
  • See GET /weatherdata/{weather_data_id} to retrieve the created record with full arrays.