Skip to main content
PUT
A focused alternative to PUT /api/v1/crops/ when you only need to change status. The behavior is identical except for one convenience: transitioning to harvested auto-populates actualHarvestDate to the current timestamp if it isn’t already set.

Authentication

Requires a key with the crops:write scope.

Path parameters

string
required
Crop UUID.

Request body

string
required
One of planned, planted, growing, harvested, failed.

Response

Returns the updated crop wrapped under data. When transitioning to harvested, the returned actualHarvestDate reflects the auto-set value.

Errors

Notes

  • This endpoint does not trigger the dashboard’s harvest-completion notification (which only fires for session-authenticated UI users).
  • For full audit history of status transitions, see the dashboard timeline view.