Tasks
Update task
Update mutable fields on a task. Only provided fields are touched.
PUT
Authentication
Requires a key with thetasks:write scope.
Path parameters
Task UUID.
Request body
All fields optional. Only provided fields are updated. Settingstatus to completed auto-populates completedDate if not already set.
UUID. Must be owned by the user. Reparents the task.
1–200 characters.
Pass
null to clear.One of
pending, in_progress, completed, overdue, cancelled.One of
low, medium, high, urgent.One of the 10 task categories.
ISO 8601. Pass
null to clear.ISO 8601. Pass
null to clear.ISO 8601. Pass
null to clear (also resets status if desired).Free text. Pass
null to clear.Pass
null to clear.Pass
null to clear.Pass
null to clear.Pass
null to clear.UUID. Pass
null to clear.UUID. Pass
null to clear.UUID. Pass
null to clear.Response
Returns the updated task wrapped underdata.
Errors
| Status | When |
|---|---|
400 INVALID_ID | {id} is not a valid UUID |
400 VALIDATION_ERROR | Body validation failed |
401 | Missing, malformed, expired, or revoked API key |
403 INSUFFICIENT_SCOPE | Key lacks tasks:write scope |
404 NOT_FOUND | Task or new farmId doesn’t exist or belongs to another user |
429 RATE_LIMIT_EXCEEDED | Per-user rate limit reached |
5xx | Server error |