Skip to main content
POST

Authentication

Requires a key with the tasks:write scope.

Request body

name
string
required
1–200 characters.
category
string
required
One of planting, irrigation, fertilization, pest_control, harvesting, soil_management, maintenance, planning, inspection, other.
description
string
Up to 2,000 characters.
farmId
string
Bind to a specific farm. null (or omitted) = farm-agnostic.
priority
string
default:"medium"
One of low, medium, high, urgent.
estimatedDuration
string
Free text (e.g. "2h").
defaultAssignee
string
Default assignee for tasks created from this template.
isGlobal
boolean
default:"false"
When true, the template is visible to all users.

Response

Returns the created template wrapped under data.

Errors

StatusWhen
400 VALIDATION_ERRORBody validation failed
401Missing, malformed, expired, or revoked API key
403 INSUFFICIENT_SCOPEKey lacks tasks:write scope
429 RATE_LIMIT_EXCEEDEDPer-user rate limit reached
5xxServer error