List tasks - WiseYield

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

api

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 the tasks:read scope. See Authentication.

Query parameters

page

integer

default:"1"

Page number (≥ 1).

limit

integer

default:"20"

Results per page (1–100; values above 100 clamped to 100).

status

string

Filter by status: pending, in_progress, completed, overdue, cancelled.

farmId

string

Filter to tasks on a specific farm (UUID).

sort

string

default:"createdAt"

Sort field: createdAt, dueDate, priority, title.

order

string

default:"desc"

asc or desc.

Response

data

array

Array of task objects.

Show Task

string

UUID.

farmId

string

Parent farm UUID.

title

string

Task title.

description

string | null

Free text.

status

string

One of pending, in_progress, completed, overdue, cancelled.

priority

string

One of low, medium, high, urgent.

category

string

One of planting, irrigation, fertilization, pest_control, harvesting, soil_management, maintenance, planning, inspection, other.

dueDate

string | null

ISO 8601.

startDate

string | null

ISO 8601.

completedDate

string | null

ISO 8601. Auto-set when transitioning to completed.

assignedTo

string | null

Free-text assignee.

createdBy

string

Creator user ID.

cropId

string | null

Linked crop (Blueprint §9.5).

fieldId

string | null

Linked field.

blockId

string | null

Linked block.

sopTemplateId

string | null

SOP template (Blueprint §9.5) — read-only via v1.

notes

string | null

Free text.

createdAt

string

ISO 8601.

updatedAt

string

ISO 8601.

pagination

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

Delete plant Create task

​Authentication

​Query parameters

​Response

​Errors

Authentication

Query parameters

Response

Errors