PUT v3/plantings/{plantingId}.json
Updates a planting
Request Information
URI Parameters
Name | Description | Type | Additional information |
---|---|---|---|
plantingId | integer |
Required |
Body Parameters
PlantingParamsExternalName | Description | Type | Additional information |
---|---|---|---|
DefaultCropTypeId |
Default crop type ID. The ranch must first be associated with this default crop type in Ranch Settings before this ID can be used. |
integer |
Required |
Name |
Name of the planting |
string |
Required |
WetDate |
Planting wet date. WetDate must be earlier than HarvestDate. Example: "4-1-2022" |
date |
Required |
HarvestDate |
Planting harvest date. For perennial crops, this date may be the end of the season. HarvestDate must be later than WetDate. Example: "4-1-2022" |
date |
Required |
LotId |
ID of the planting area associated with the planting. |
integer |
Required |
Coordinates |
Planting coordinates. Example: "40.531876,-116.157271" |
string |
Required |
Acres |
Planting acres. Must be a number between 0 and 5000. |
decimal number |
Required Range: inclusive between 0.001 and 10000 |
IrrigationSettings |
Irrigation related configuration settings |
PlantingIrrigationParams |
Required |
AdvancedSettings |
(Optional) Advanced settings which specifies optional fields like soil obstruction depth, and PreviousCropDays |
PlantingAdvancedSettings |
None. |
MacroTunnelSettings |
(Optional) Macro tunnel settings, if macro tunnels are used. |
PlantingMacroTunnelSettings |
None. |
StressSettings |
(Optional) Stress settings for crops that are stressed near the tail end of harvest Only used for tree crops (almonds, walnuts, etc) and processing tomatoes |
PlantingStresssSettings |
None. |
PerennialCropSettings |
(Optional) Settings for perennial crops, like almonds, pears, walnuts, and alfalfa. Not used for caneberries. |
PlantingPerennialSettings |
None. |
Request Formats
application/json, text/json, text/html
{ "DefaultCropTypeId": 1, "Name": "sample string 2", "WetDate": "2025-05-23T14:39:31.8213147-07:00", "HarvestDate": "2025-05-23T14:39:31.8213147-07:00", "LotId": 5, "Coordinates": "sample string 6", "Acres": 7.0, "IrrigationSettings": { "IrrigationMethods": [ 1, 2 ], "DeficitType": 1, "ControlPoints": [ { "Date": "2025-05-23T14:39:31.8213147-07:00", "CropETPercentage": 4 }, { "Date": "2025-05-23T14:39:31.8213147-07:00", "CropETPercentage": 4 } ], "ApplicationRates": { "Drip": 1.0, "Sprinkler": 1.0, "MicroSprinkler": 1.0 }, "DistributionUniformities": { "Drip": 1.0, "Sprinkler": 1.0, "Flood": 1.0, "MicroSprinkler": 1.0, "GerminationSprinkler": 1.0 }, "LeechingFactor": 1.0 }, "AdvancedSettings": { "ObstructionDepth": 1.0, "PreviousCropDays": 1, "PreviousCropTypeId": 1 }, "MacroTunnelSettings": { "IsEnabled": true, "IsFullSeason": true, "StartDate": "2025-05-23T14:39:31.8213147-07:00", "EndDate": "2025-05-23T14:39:31.8213147-07:00" }, "StressSettings": { "IsEnabled": true, "StartDate": "2025-05-23T14:39:31.8213147-07:00", "EndDate": "2025-05-23T14:39:31.8213147-07:00" }, "PerennialCropSettings": { "CropAge": 1, "YieldTarget": 1.0, "YieldActual": 1.0, "IsHighVigor": true, "IsCoverCropEnabled": true, "LeafSenesceDate": "2025-05-23T14:39:31.8213147-07:00" } }
Response Information
Resource Description
booleanResponse Formats
application/json, text/json, text/html
true
application/xml, text/xml
<boolean>true</boolean>