Skip to main content
PUT
/
Project
/
{projectId}
/
Prediction
/
{predictionId}
/
ShadeScene
Update shade scene properties
curl --request PUT \
  --url https://api.plantpredict.terabase.energy/Project/{projectId}/Prediction/{predictionId}/ShadeScene \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "id": 4297,
  "name": "Custom Shade Scene",
  "createdDateUTC": "2025-11-25T16:41:49.847",
  "createdById": 8903,
  "sceneSurfaceArea": 34952.621141703195,
  "dcFieldSurfaceArea": 14461.598249999997,
  "collectorCount": 177,
  "objectCount": 0,
  "orientationTargetDCField": 3387869,
  "calculationSettingsTargetDCField": 3387869,
  "siteTableCount": 177,
  "rotation": false,
  "customTableRotationScheduleName": null,
  "customTableRotationUploadDate": null,
  "binType": 2,
  "collectorType": 0,
  "trackerRotationModel": 0,
  "shadingModel": 6,
  "fractionalShadingPercentage": 100,
  "numberOfModuleFractions": 3,
  "shadeObjectType": 1
}
'
"Shade Scene Properties Updated Successfully"

Authorizations

​
Authorization
string
header
required

Pass Authorization: Bearer <token> on every request. See the Authentication section of the API description for how to fetch a token.

Path Parameters

​
projectId
integer
required
​
predictionId
integer
required

Body

application/json
​
id
integer
​
name
string
​
createdDateUTC
string

ISO-8601 datetime as returned by the PlantPredict API. May or may not include a timezone offset; treat as server-local when no offset is present.

​
createdById
integer
​
sceneSurfaceArea
number
​
dcFieldSurfaceArea
number
​
collectorCount
integer
​
objectCount
integer
​
orientationTargetDCField
integer
​
calculationSettingsTargetDCField
integer
​
siteTableCount
integer
​
rotation
number
​
binType
enum<integer>

ShadeSceneBinTypes

Available options:
0,
1,
2
​
collectorType
enum<integer>

CollectorType

Available options:
0,
1,
2
​
trackerRotationModel
enum<integer>

TrackerRotationModel

Available options:
0,
1,
2
​
shadingModel
enum<integer>

Shading3DModel

Available options:
0,
1
​
fractionalShadingPercentage
number
​
numberOfModuleFractions
integer
​
shadeObjectType
enum<integer>

ShadeObjectType

Available options:
0,
1

Response

Updated