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-01"
}'
{
"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"
}
}
{ "error": "Not found", "code": "NOT_FOUND", "message": "Farm not found" }
Tasks
Create task
Create a task on a farm owned by the authenticated user.
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-01"
}'
{
"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"
}
}
{ "error": "Not found", "code": "NOT_FOUND", "message": "Farm not found" }
POST https://www.wiseyield.co/api/v1/tasks
Authentication
Requires a key with thetasks:write scope.
Request body
string
required
UUID of the parent farm.
string
required
1–200 characters.
string
required
One of
planting, irrigation, fertilization, pest_control, harvesting, soil_management, maintenance, planning, inspection, other.string
Free text.
string
default:"pending"
One of
pending, in_progress, completed, overdue, cancelled.string
default:"medium"
One of
low, medium, high, urgent.string
Calendar date as
YYYY-MM-DD. A full ISO 8601 datetime is accepted too, but only its date part is kept.string
Calendar date as
YYYY-MM-DD. A full ISO 8601 datetime is accepted too, but only its date part is kept.string
Free-text assignee.
string
Free-text field reference (denormalized).
string
Free text (e.g.
"2h", "half day").string
Free text.
string
UUID of a linked crop (Blueprint §9.5).
string
UUID of a linked field.
string
UUID of a linked block.
Response
Returns the created task wrapped underdata. 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-01"
}'
{
"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"
}
}
{ "error": "Not found", "code": "NOT_FOUND", "message": "Farm not found" }
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 |