PUT v3/plantings/{plantingId}.json

Updates a planting

Request Information

URI Parameters

NameDescriptionTypeAdditional information
plantingId

integer

Required

Body Parameters

PlantingParamsExternal
NameDescriptionTypeAdditional 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": "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

Sample:
<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

boolean

Response Formats

application/json, text/json, text/html

Sample:
true

application/xml, text/xml

Sample:
<boolean>true</boolean>