curl 'https://www.wiseyield.co/api/v1/tasks?status=pending&limit=50' \
-H "Authorization: Bearer $WISEYIELD_API_KEY"
const res = await fetch(
'https://www.wiseyield.co/api/v1/tasks?status=pending&limit=50',
{ headers: { Authorization: `Bearer ${process.env.WISEYIELD_API_KEY}` } }
);
const { data, pagination } = await res.json();
{
"data": [
{
"id": "<string>",
"farmId": "<string>",
"title": "<string>",
"description": {},
"status": "<string>",
"priority": "<string>",
"category": "<string>",
"dueDate": {},
"startDate": {},
"completedDate": {},
"assignedTo": {},
"createdBy": "<string>",
"cropId": {},
"fieldId": {},
"blockId": {},
"sopTemplateId": {},
"notes": {},
"createdAt": "<string>",
"updatedAt": "<string>"
}
],
"pagination": {}
}Tasks
List tasks
List tasks across all farms owned by the authenticated user.
GET
/
api
/
v1
/
tasks
curl 'https://www.wiseyield.co/api/v1/tasks?status=pending&limit=50' \
-H "Authorization: Bearer $WISEYIELD_API_KEY"
const res = await fetch(
'https://www.wiseyield.co/api/v1/tasks?status=pending&limit=50',
{ headers: { Authorization: `Bearer ${process.env.WISEYIELD_API_KEY}` } }
);
const { data, pagination } = await res.json();
{
"data": [
{
"id": "<string>",
"farmId": "<string>",
"title": "<string>",
"description": {},
"status": "<string>",
"priority": "<string>",
"category": "<string>",
"dueDate": {},
"startDate": {},
"completedDate": {},
"assignedTo": {},
"createdBy": "<string>",
"cropId": {},
"fieldId": {},
"blockId": {},
"sopTemplateId": {},
"notes": {},
"createdAt": "<string>",
"updatedAt": "<string>"
}
],
"pagination": {}
}GET https://www.wiseyield.co/api/v1/tasks
Authentication
Requires a key with thetasks:read scope. See Authentication.
Query parameters
integer
default:"1"
Page number (≥ 1).
integer
default:"20"
Results per page (1–100; values above 100 clamped to 100).
string
Filter by status:
pending, in_progress, completed, overdue, cancelled.string
Filter to tasks on a specific farm (UUID).
string
default:"createdAt"
Sort field:
createdAt, dueDate, priority, title.string
default:"desc"
asc or desc.Response
array
Array of task objects.
Show Task
Show Task
string
UUID.
string
Parent farm UUID.
string
Task title.
string | null
Free text.
string
One of
pending, in_progress, completed, overdue, cancelled.string
One of
low, medium, high, urgent.string
One of
planting, irrigation, fertilization, pest_control, harvesting, soil_management, maintenance, planning, inspection, other.string | null
ISO 8601.
string | null
ISO 8601.
string | null
ISO 8601. Auto-set when transitioning to
completed.string | null
Free-text assignee.
string
Creator user ID.
string | null
Linked crop (Blueprint §9.5).
string | null
Linked field.
string | null
Linked block.
string | null
SOP template (Blueprint §9.5) — read-only via v1.
string | null
Free text.
string
ISO 8601.
string
ISO 8601.
object
Offset pagination envelope (
page, limit, total, totalPages). See Pagination.curl 'https://www.wiseyield.co/api/v1/tasks?status=pending&limit=50' \
-H "Authorization: Bearer $WISEYIELD_API_KEY"
const res = await fetch(
'https://www.wiseyield.co/api/v1/tasks?status=pending&limit=50',
{ headers: { Authorization: `Bearer ${process.env.WISEYIELD_API_KEY}` } }
);
const { data, pagination } = await res.json();
Errors
| Status | When |
|---|---|
401 | Missing, malformed, expired, or revoked API key |
403 INSUFFICIENT_SCOPE | Key lacks tasks:read scope |
429 RATE_LIMIT_EXCEEDED | Per-user rate limit reached |
5xx | Server error |