Skip to main content
PUT

Authentication

Requires a key with the crops:write scope.

Path parameters

string
required
Crop UUID.

Request body

All fields are optional. Only fields you include in the body are updated; omitted fields are left unchanged. To change fieldId, the new field must belong to the same farm as the crop’s current field.
string
UUID. Must belong to the crop’s current farm.
string
1–200 characters.
string
Up to 200 characters. Pass null to clear.
string
UUID. Pass null to clear.
string
UUID. Pass null to clear.
number | string
In the farm’s areaUnit.
string
Calendar date as YYYY-MM-DD. A full ISO 8601 datetime is accepted too, but only its date part is kept. Pass null to clear.
string
Calendar date as YYYY-MM-DD. A full ISO 8601 datetime is accepted too, but only its date part is kept. Pass null to clear.
string
One of winter, summer, autumn, spring, year_round. Pass null to clear.
integer
2000–2100. Pass null to clear.
number | string
Tons. Pass null to clear.
number | string
In the farm’s currency. Pass null to clear.
number | string
In the farm’s currency. Pass null to clear.
string
One of planned, planted, growing, harvested, failed. To set harvested and auto-populate actualHarvestDate, prefer the dedicated status endpoint.
string
Up to 5,000 characters. Pass null to clear.

Response

Returns the updated crop wrapped under data.

Errors