Skip to main content
POST
/
api
/
v1
/
tasks
curl -X POST 'https://www.wiseyield.co/api/v1/tasks' \
  -H "Authorization: Bearer $WISEYIELD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "farmId": "11111111-2222-3333-4444-555555555555",
    "title": "Spring NPK application",
    "category": "fertilization",
    "priority": "high",
    "dueDate": "2026-06-01T00:00:00.000Z"
  }'

{
  "data": {
    "id": "...",
    "farmId": "11111111-2222-3333-4444-555555555555",
    "title": "Spring NPK application",
    "category": "fertilization",
    "status": "pending",
    "priority": "high",
    "dueDate": "2026-06-01T00:00:00.000Z",
    "createdAt": "2026-05-17T18:00:00.000Z"
  }
}

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.

POST https://www.wiseyield.co/api/v1/tasks

​
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. 
curl -X POST 'https://www.wiseyield.co/api/v1/tasks' \
  -H "Authorization: Bearer $WISEYIELD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "farmId": "11111111-2222-3333-4444-555555555555",
    "title": "Spring NPK application",
    "category": "fertilization",
    "priority": "high",
    "dueDate": "2026-06-01T00:00:00.000Z"
  }'

{
  "data": {
    "id": "...",
    "farmId": "11111111-2222-3333-4444-555555555555",
    "title": "Spring NPK application",
    "category": "fertilization",
    "status": "pending",
    "priority": "high",
    "dueDate": "2026-06-01T00:00:00.000Z",
    "createdAt": "2026-05-17T18:00:00.000Z"
  }
}

​
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