Skip to main content
POST

Authentication

Requires a key with the fields:write scope.

Path parameters

string
required
Farm UUID.
string
required
Field UUID.

Request body

string
required
UUID of the crop. Must belong to fieldId (so the block is consistent with the field’s planting).
string
required
1–200 characters.
string
UUID of an admin variety record. Pulls spacing / density defaults if provided.
string
Up to 2,000 characters.
string
Calendar date as YYYY-MM-DD. A full ISO 8601 datetime is accepted too, but only its date part is kept.
integer
1–1,000,000.
number
Row spacing in meters, 0–10,000.
number
Plant spacing in meters, 0–10,000.
number
Plants per hectare, 0–1,000,000.
number
Block area, 0–1,000,000 (in the farm’s areaUnit).
object
GeoJSON Polygon or Point covering the block. Polygon: { type: "Polygon", coordinates: number[][][] }. Point: { type: "Point", coordinates: [lng, lat] }.
object
Grid metadata. { pattern: "square" | "hexagonal" | "triangular" | "custom", rowCount, columnCount, rowOrientation, originLatLng: [lat, lng] }.
string
default:"planned"
One of planned, planted, established, mature, declined, harvested, removed.
string
Up to 5,000 characters.

Response

Returns the created block wrapped under data.

Errors