Skip to main content
POST

Authentication

Requires a key with the crops:write scope. See Authentication.

Request body

string
required
UUID of the parent farm. Must be owned by the authenticated user.
string
required
UUID of the field. Must belong to farmId. Required per the Operations Attachment Principle.
string
required
1–200 characters. Free-text crop name (e.g. "wheat", "date palm").
number | string
required
Positive number in the farm’s areaUnit. Accepts string or number.
string
Up to 200 characters. Free-text variety.
string
UUID linking to the admin Crop Library. Prefer this over cropType when the crop is in the catalog.
string
UUID linking to the admin variety record.
string
Calendar date as YYYY-MM-DD. A full ISO 8601 datetime is accepted too, but only its date part is kept.
string
Calendar date as YYYY-MM-DD. A full ISO 8601 datetime is accepted too, but only its date part is kept.
string
One of winter, summer, autumn, spring, year_round.
integer
2000–2100.
number | string
Tons.
number | string
In the farm’s currency.
number | string
In the farm’s currency.
string
default:"planned"
One of planned, planted, growing, harvested, failed.
string
Up to 5,000 characters.

Response

Returns the created crop wrapped under data. See List crops for the full field reference.

Errors