Skip to main content
POST

Authentication

Requires a key with the tasks:write scope.

Request body

farmId
string
required
UUID of the parent farm.
title
string
required
1–200 characters.
category
string
required
One of planting, irrigation, fertilization, pest_control, harvesting, soil_management, maintenance, planning, inspection, other.
description
string
Free text.
status
string
default:"pending"
One of pending, in_progress, completed, overdue, cancelled.
priority
string
default:"medium"
One of low, medium, high, urgent.
dueDate
string
ISO 8601 datetime.
startDate
string
ISO 8601 datetime.
assignedTo
string
Free-text assignee.
fieldName
string
Free-text field reference (denormalized).
estimatedDuration
string
Free text (e.g. "2h", "half day").
notes
string
Free text.
cropId
string
UUID of a linked crop (Blueprint §9.5).
fieldId
string
UUID of a linked field.
blockId
string
UUID of a linked block.

Response

Returns the created task wrapped under data. See List tasks for the full field reference.

Errors

StatusWhen
400 VALIDATION_ERRORBody validation failed
401Missing, malformed, expired, or revoked API key
403 INSUFFICIENT_SCOPEKey lacks tasks:write scope
404 NOT_FOUNDFarm doesn’t exist or is not owned by the user
429 RATE_LIMIT_EXCEEDEDPer-user rate limit reached
5xxServer error