Skip to main content
POST
/
api
/
v1
/
recurring-tasks
curl -X POST 'https://www.wiseyield.co/api/v1/recurring-tasks' \
  -H "Authorization: Bearer $WISEYIELD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "farmId": "11111111-2222-3333-4444-555555555555",
    "templateId": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
    "pattern": "weekly",
    "interval": 1,
    "daysOfWeek": [1, 4],
    "startDate": "2026-06-01T08: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/recurring-tasks

​
Authentication

Requires a key with the tasks:write scope.

​
Request body

​
farmId
string
required
UUID of the parent farm. Must be owned by the user.
​
templateId
string
required
UUID of an existing task template. Must be either user-owned or global.
​
pattern
string
required
One of daily, weekly, monthly, yearly, custom.
​
startDate
string
required
ISO 8601 datetime for first occurrence.
​
interval
integer
Pattern interval (default 1). Range 1–365.
​
daysOfWeek
array
For weekly: array of 0–6 (0 = Sunday).
​
dayOfMonth
integer
For monthly: 1–31.
​
monthOfYear
integer
For yearly: 1–12.
​
endDate
string
ISO 8601 — schedule stops generating after this date.
​
generateDaysBefore
integer
0–90. Generate the task this many days before its nextOccurrence.
​
assignedTo
string
Default assignee for generated tasks.
​
fieldName
string
Free-text field reference (denormalized).

​
Response

Returns the created schedule wrapped under data. nextOccurrence is initialized to startDate. 
curl -X POST 'https://www.wiseyield.co/api/v1/recurring-tasks' \
  -H "Authorization: Bearer $WISEYIELD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "farmId": "11111111-2222-3333-4444-555555555555",
    "templateId": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
    "pattern": "weekly",
    "interval": 1,
    "daysOfWeek": [1, 4],
    "startDate": "2026-06-01T08: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 or template doesn’t exist or isn’t accessible
429 RATE_LIMIT_EXCEEDEDPer-user rate limit reached
5xxServer error