Fields
Create field
Create a field on a farm owned by the authenticated user.
POST
Authentication
Requires a key with thefields:write scope.
Path parameters
Farm UUID.
Request body
1–200 characters.
Positive number in the farm’s
areaUnit.Up to 2,000 characters.
GeoJSON
Polygon ({ type: "Polygon", coordinates: number[][][] }).Up to 100 characters.
Soil pH.
One of
active, fallow, preparing, planted.Up to 5,000 characters.
Response
Returns the created field wrapped underdata. See List fields for the full field reference.
Errors
| Status | When |
|---|---|
400 VALIDATION_ERROR | Body validation failed (details carries per-field messages) |
401 | Missing, malformed, expired, or revoked API key |
403 INSUFFICIENT_SCOPE | Key lacks fields:write scope |
404 NOT_FOUND | Farm doesn’t exist or is not owned by the user |
429 RATE_LIMIT_EXCEEDED | Per-user rate limit reached |
5xx | Server error |