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": "2023-09-24T07:25:44.3419082-07:00", "HarvestDate": "2023-09-24T07:25:44.3419082-07:00", "LotId": 5, "Coordinates": "sample string 6", "Acres": 7.0, "IrrigationSettings": { "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": "2023-09-24T07:25:44.3419082-07:00", "EndDate": "2023-09-24T07:25:44.3419082-07:00" }, "StressSettings": { "IsEnabled": true, "StartDate": "2023-09-24T07:25:44.3419082-07:00", "EndDate": "2023-09-24T07:25:44.3419082-07:00" }, "PerennialCropSettings": { "CropAge": 1, "YieldTarget": 1.0, "YieldActual": 1.0, "IsHighVigor": true, "IsCoverCropEnabled": true, "LeafSenesceDate": "2023-09-24T07:25:44.3419082-07:00" } }
application/xml, text/xml
<PlantingParamsExternal xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <Name>sample string 2</Name> <WetDate>2023-09-24T07:25:44.3419082-07:00</WetDate> <HarvestDate>2023-09-24T07:25:44.3419082-07:00</HarvestDate> <LotId>5</LotId> <Coordinates>sample string 6</Coordinates> <Acres>7</Acres> <IrrigationSettings> <ApplicationRates> <Drip>1</Drip> <Sprinkler>1</Sprinkler> <MicroSprinkler>1</MicroSprinkler> </ApplicationRates> <DistributionUniformities> <Drip>1</Drip> <Sprinkler>1</Sprinkler> <Flood>1</Flood> <MicroSprinkler>1</MicroSprinkler> <GerminationSprinkler>1</GerminationSprinkler> </DistributionUniformities> <LeechingFactor>1</LeechingFactor> </IrrigationSettings> <AdvancedSettings> <ObstructionDepth>1</ObstructionDepth> <PreviousCropDays>1</PreviousCropDays> <PreviousCropTypeId>1</PreviousCropTypeId> </AdvancedSettings> <MacroTunnelSettings> <IsEnabled>true</IsEnabled> <IsFullSeason>true</IsFullSeason> <StartDate>2023-09-24T07:25:44.3419082-07:00</StartDate> <EndDate>2023-09-24T07:25:44.3419082-07:00</EndDate> </MacroTunnelSettings> <StressSettings> <IsEnabled>true</IsEnabled> <StartDate>2023-09-24T07:25:44.3419082-07:00</StartDate> <EndDate>2023-09-24T07:25:44.3419082-07:00</EndDate> </StressSettings> <PerennialCropSettings> <CropAge>1</CropAge> <YieldTarget>1</YieldTarget> <YieldActual>1</YieldActual> <IsHighVigor>true</IsHighVigor> <IsCoverCropEnabled>true</IsCoverCropEnabled> <LeafSenesceDate>2023-09-24T07:25:44.3419082-07:00</LeafSenesceDate> </PerennialCropSettings> <DefaultCropTypeId>1</DefaultCropTypeId> </PlantingParamsExternal>
Response Information
Resource Description
booleanResponse Formats
application/json, text/json, text/html
true
application/xml, text/xml
<boolean>true</boolean>