Update block - WiseYield

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"
  }
}

PUT

api

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"
  }
}

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

Authentication

Requires a key with the fields:write scope.

Path parameters

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

Status	When
`400 INVALID_ID`	Any path UUID is malformed
`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, block, or new `cropId` doesn’t exist or doesn’t belong to the resolved hierarchy
`429 RATE_LIMIT_EXCEEDED`	Per-user rate limit reached
`5xx`	Server error

Get block Delete block

​Authentication

​Path parameters

​Request body

​Response

​Errors

Authentication

Path parameters

Request body

Response

Errors