Blocks
Create block
Create a block on a field. Block must belong to a crop that already lives on the field.
POST
Authentication
Requires a key with thefields:write scope.
Path parameters
Farm UUID.
Field UUID.
Request body
UUID of the crop. Must belong to
fieldId (so the block is consistent with the field’s planting).1–200 characters.
UUID of an admin variety record. Pulls spacing / density defaults if provided.
Up to 2,000 characters.
ISO 8601 datetime.
1–1,000,000.
Row spacing in meters, 0–10,000.
Plant spacing in meters, 0–10,000.
Plants per hectare, 0–1,000,000.
Block area, 0–1,000,000 (in the farm’s
areaUnit).GeoJSON
Polygon or Point covering the block. Polygon: { type: "Polygon", coordinates: number[][][] }. Point: { type: "Point", coordinates: [lng, lat] }.Grid metadata.
{ pattern: "square" | "hexagonal" | "triangular" | "custom", rowCount, columnCount, rowOrientation, originLatLng: [lat, lng] }.One of
planned, planted, established, mature, declined, harvested, removed.Up to 5,000 characters.
Response
Returns the created block wrapped underdata.
Errors
| Status | When |
|---|---|
400 VALIDATION_ERROR | Body validation failed |
401 | Missing, malformed, expired, or revoked API key |
403 INSUFFICIENT_SCOPE | Key lacks fields:write scope |
404 NOT_FOUND | Farm, field, or cropId doesn’t exist, is soft-deleted, or doesn’t belong to the resolved hierarchy |
429 RATE_LIMIT_EXCEEDED | Per-user rate limit reached |
5xx | Server error |