Declare crop + sowing date, observed depth, or manual depth.
/modules/{id}/crop Side effect: clears the per-depth weights entered by hand (back to automatic computation).
Two exclusive modes: crop (cropId + plantingDate, plus zrCapCm if needed) or manual (manualZrCm). The declaration replaces the active crop; the previous one is closed, never erased.
Path parameters
-
idinteger required
Headers
-
Idempotency-KeystringReplays the same 2xx response (24 h)
Request body
-
cropIdintegerCrop:
codefromGET /reference/crops. Exclusive withmanualZrCm. -
plantingDatestring datePlanting or sowing date. Required with
cropId. -
manualZrCmnumberManual mode: root depth in cm, > 0. Exclusive with
cropId. -
zrCapCmnumberRooting depth observed on the plot, in cm (crop mode only): it replaces the crop’s, downwards (water table, plough pan, bedrock) as well as upwards (deep soil, widely spaced irrigation).
-
notesstring
Response
Declaration recorded
-
successboolean always present -
rowobject always presentShow 2 attributes Hide attributes
-
idinteger always presentThe declaration created:
idofGET /modules/{id}/crop. -
timestamp_startstring date-time always present
-
Errors
- 400
Entry refused
invalid_idinvalid_body - 401
Not authenticated
- 403
Insufficient scope/role, or outside your company