Tasks
Create task
Create a task on a farm owned by the authenticated user.
POST
Authentication
Requires a key with thetasks:write scope.
Request body
UUID of the parent farm.
1–200 characters.
One of
planting, irrigation, fertilization, pest_control, harvesting, soil_management, maintenance, planning, inspection, other.Free text.
One of
pending, in_progress, completed, overdue, cancelled.One of
low, medium, high, urgent.ISO 8601 datetime.
ISO 8601 datetime.
Free-text assignee.
Free-text field reference (denormalized).
Free text (e.g.
"2h", "half day").Free text.
UUID of a linked crop (Blueprint §9.5).
UUID of a linked field.
UUID of a linked block.
Response
Returns the created task wrapped underdata. See List tasks for the full field reference.
Errors
| Status | When |
|---|---|
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 | Farm doesn’t exist or is not owned by the user |
429 RATE_LIMIT_EXCEEDED | Per-user rate limit reached |
5xx | Server error |