Skip to main content

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.timeSeries for plant-level timeSeries
  • output.fullTimeSeries for extended plant-level series
  • output.blockResults for blockTimeSeries
  • output.blockIndex to filter the returned blockTimeSeries map to one zero-based block
  • output.lossBreakdownTimestamps for timestamped loss detail under blockTimeSeries[<blockIndex>].lossBreakdown
  • output.irradianceLossDetail for additive annual detail under losses.irradianceLossDetail
SDK compatibility note:
  • 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 map block_results / block_results_index into deprecated API compatibility fields.
  • Returned blockTimeSeries keys preserve the API’s original zero-based block numbering.
  • Returned additive block outputs already represent the full configured numberOfInverters count for that block type.

shading_scenes

Legacy API compatibility note:
  • Older clients may still call GET /shadingscenes/{scene_id} with returnshading=true, returnmodel=true, or returntableshading=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.