Skip to main content
POST
/
api
/
v1
/
farms
/
{id}
/
fields
curl -X POST 'https://www.wiseyield.co/api/v1/farms/11111111-2222-3333-4444-555555555555/fields' \
  -H "Authorization: Bearer $WISEYIELD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "North Field", "area": 4.2, "soilType": "sandy loam", "status": "active" }'

{
  "data": {
    "id": "88888888-9999-aaaa-bbbb-cccccccccccc",
    "farmId": "11111111-2222-3333-4444-555555555555",
    "name": "North Field",
    "area": "4.2",
    "soilType": "sandy loam",
    "status": "active",
    "createdAt": "2026-05-17T17:00:00.000Z"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.wiseyield.co/llms.txt

Use this file to discover all available pages before exploring further.

POST https://www.wiseyield.co/api/v1/farms/{id}/fields

​
Authentication

Requires a key with the fields:write scope.

​
Path parameters

​
id
string
required
Farm UUID.

​
Request body

​
name
string
required
1–200 characters.
​
area
number | string
required
Positive number in the farm’s areaUnit.
​
description
string
Up to 2,000 characters.
​
boundaries
object
GeoJSON Polygon ({ type: "Polygon", coordinates: number[][][] }).
​
soilType
string
Up to 100 characters.
​
soilPh
number | string
Soil pH.
​
status
string
default:"active"
One of active, fallow, preparing, planted.
​
notes
string
Up to 5,000 characters.

​
Response

Returns the created field wrapped under data. See List fields for the full field reference. 
curl -X POST 'https://www.wiseyield.co/api/v1/farms/11111111-2222-3333-4444-555555555555/fields' \
  -H "Authorization: Bearer $WISEYIELD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "North Field", "area": 4.2, "soilType": "sandy loam", "status": "active" }'

{
  "data": {
    "id": "88888888-9999-aaaa-bbbb-cccccccccccc",
    "farmId": "11111111-2222-3333-4444-555555555555",
    "name": "North Field",
    "area": "4.2",
    "soilType": "sandy loam",
    "status": "active",
    "createdAt": "2026-05-17T17:00:00.000Z"
  }
}

​
Errors

StatusWhen
400 VALIDATION_ERRORBody validation failed (details carries per-field messages)
401Missing, malformed, expired, or revoked API key
403 INSUFFICIENT_SCOPEKey lacks fields:write scope
404 NOT_FOUNDFarm doesn’t exist or is not owned by the user
429 RATE_LIMIT_EXCEEDEDPer-user rate limit reached
5xxServer error