Skip to main content
PUT
/
api
/
v1
/
tasks
/
{id}
curl -X PUT 'https://www.wiseyield.co/api/v1/tasks/aaaaaaaa.../...' \
  -H "Authorization: Bearer $WISEYIELD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "status": "in_progress", "actualDuration": "45m" }'

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/tasks/{id}

​
Authentication

Requires a key with the tasks:write scope.

​
Path parameters

​
id
string
required
Task UUID.

​
Request body

All fields optional. Only provided fields are updated. Setting status to completed auto-populates completedDate if not already set.
​
farmId
string
UUID. Must be owned by the user. Reparents the task.
​
title
string
1–200 characters.
​
description
string
Pass null to clear.
​
status
string
One of pending, in_progress, completed, overdue, cancelled.
​
priority
string
One of low, medium, high, urgent.
​
category
string
One of the 10 task categories.
​
dueDate
string
ISO 8601. Pass null to clear.
​
startDate
string
ISO 8601. Pass null to clear.
​
completedDate
string
ISO 8601. Pass null to clear (also resets status if desired).
​
assignedTo
string
Free text. Pass null to clear.
​
fieldName
string
Pass null to clear.
​
estimatedDuration
string
Pass null to clear.
​
actualDuration
string
Pass null to clear.
​
notes
string
Pass null to clear.
​
cropId
string
UUID. Pass null to clear.
​
fieldId
string
UUID. Pass null to clear.
​
blockId
string
UUID. Pass null to clear.

​
Response

Returns the updated task wrapped under data. 
curl -X PUT 'https://www.wiseyield.co/api/v1/tasks/aaaaaaaa.../...' \
  -H "Authorization: Bearer $WISEYIELD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "status": "in_progress", "actualDuration": "45m" }'

​
Errors

StatusWhen
400 INVALID_ID{id} is not a valid UUID
400 VALIDATION_ERRORBody validation failed
401Missing, malformed, expired, or revoked API key
403 INSUFFICIENT_SCOPEKey lacks tasks:write scope
404 NOT_FOUNDTask or new farmId doesn’t exist or belongs to another user
429 RATE_LIMIT_EXCEEDEDPer-user rate limit reached
5xxServer error