Create recurring task

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"
  }'

POST

api

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"
  }'

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

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 or template doesn’t exist or isn’t accessible
`429 RATE_LIMIT_EXCEEDED`	Per-user rate limit reached
`5xx`	Server error

List recurring tasks Get recurring task

​Authentication

​Request body

​Response

​Errors

Authentication

Request body

Response

Errors