PUT v3/plantings/{plantingId}.json

Updates a planting

Request Information

URI Parameters

Name	Description	Type	Additional information
plantingId		integer	Required

Body Parameters

PlantingParamsExternal

Name	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

Sample:

{
  "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

boolean

Response Formats

application/json, text/json, text/html

Sample:

true

application/xml, text/xml

Sample:

<boolean>true</boolean>