Resource Coverage
This page maps each SDK namespace to core methods and API routes.locations
weather_data
modules
inverters
projects
energy_models
create() keeps an SDK-level async-default convenience. The API itself is
sync-first unless ?async=true is supplied.
For sync energy-model create/rerun calls, the SDK uses a 90s request timeout
by default unless you pass an explicit timeout=.... This gives multi-block
sync fan-out runs room to complete inline; if you want immediate queued/task
responses, prefer async_mode=True.
For current /energymodels result shaping, send canonical output fields in
the request body:
output.timeSeriesfor plant-leveltimeSeriesoutput.fullTimeSeriesfor extended plant-level seriesoutput.blockResultsforblockTimeSeriesoutput.blockIndexto filter the returnedblockTimeSeriesmap to one zero-based blockoutput.lossBreakdownTimestampsfor timestamped loss detail underblockTimeSeries[<blockIndex>].lossBreakdownoutput.irradianceLossDetailfor additive annual detail underlosses.irradianceLossDetail
create()forwards the canonical body as-is; selected-block behavior is a response filter, not single-block execution.- Legacy adapters such as
create_legacy_query(...)still mapblock_results/block_results_indexinto deprecated API compatibility fields. - Returned
blockTimeSerieskeys preserve the API’s original zero-based block numbering. - Returned additive block outputs already represent the full configured
numberOfInverterscount for that block type.
shading_scenes
Legacy API compatibility note:
- Older clients may still call
GET /shadingscenes/{scene_id}withreturnshading=true,returnmodel=true, orreturntableshading=true. - Those query params are still supported on the API as additive compatibility shims for historical workflows.
- New SDK usage should prefer
get(scene_id)for scene data,get_results(scene_id, include_status=...)for shading outputs, and the dedicated viewer route when viewer-oriented geometry or aggregate shading data is needed.
tasks
workflows
workspaces
File Upload Support
projects, modules, inverters, and shading_scenes support disk-path and/or open-file-object upload patterns.