Skip to main content
PUT
/
api
/
v1
/
farms
/
{id}
/
fields
/
{fieldId}
/
blocks
/
{blockId}
curl -X PUT 'https://www.wiseyield.co/api/v1/farms/11111111.../fields/88888888.../blocks/aaaaaaaa...' \
  -H "Authorization: Bearer $WISEYIELD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "status": "harvested" }'

{
  "data": {
    "id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
    "status": "harvested",
    "updatedAt": "2026-05-17T17:15: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.

PUT https://www.wiseyield.co/api/v1/farms/{id}/fields/{fieldId}/blocks/{blockId}

​
Authentication

Requires a key with the fields:write scope.

​
Path parameters

​
id
string
required
Farm UUID.
​
fieldId
string
required
Field UUID.
​
blockId
string
required
Block UUID.

​
Request body

All fields are optional. Only fields you include in the body are updated. To re-parent the block to a different crop, the new cropId must belong to the same field.
​
cropId
string
UUID. Must belong to the block’s current field.
​
varietyId
string
UUID. Pass null to clear.
​
name
string
1–200 characters.
​
description
string
Up to 2,000 characters. Pass null to clear.
​
plantingDate
string
ISO 8601 datetime. Pass null to clear.
​
plantCount
integer
1–1,000,000. Pass null to clear.
​
spacingX
number
0–10,000 meters. Pass null to clear.
​
spacingY
number
0–10,000 meters. Pass null to clear.
​
plantDensity
number
0–1,000,000 plants/ha. Pass null to clear.
​
area
number
0–1,000,000. Pass null to clear.
​
status
string
One of planned, planted, established, mature, declined, harvested, removed.
​
notes
string
Up to 5,000 characters. Pass null to clear.

​
Response

Returns the updated block wrapped under data. 
curl -X PUT 'https://www.wiseyield.co/api/v1/farms/11111111.../fields/88888888.../blocks/aaaaaaaa...' \
  -H "Authorization: Bearer $WISEYIELD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "status": "harvested" }'

{
  "data": {
    "id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
    "status": "harvested",
    "updatedAt": "2026-05-17T17:15:00.000Z"
  }
}

​
Errors

StatusWhen
400 INVALID_IDAny path UUID is malformed
400 VALIDATION_ERRORBody validation failed
401Missing, malformed, expired, or revoked API key
403 INSUFFICIENT_SCOPEKey lacks fields:write scope
404 NOT_FOUNDFarm, field, block, or new cropId doesn’t exist or doesn’t belong to the resolved hierarchy
429 RATE_LIMIT_EXCEEDEDPer-user rate limit reached
5xxServer error