Skip to main content
POST
/
api
/
v1
/
templates
/
{id}
/
apply
curl -X POST 'https://www.wiseyield.co/api/v1/templates/aaaaaaaa.../apply' \
  -H "Authorization: Bearer $WISEYIELD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "farmId": "11111111-2222-3333-4444-555555555555",
    "dueDate": "2026-06-15T08: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/templates/{id}/apply

​
Authentication

Requires a key with the tasks:write scope.

​
Path parameters

​
id
string
required
Template UUID. Template must be isActive=true.

​
Request body

All fields optional. Override template defaults by passing them here.
​
farmId
string
UUID. Required if the template doesn’t have a bound farm. Must be owned by the user.
​
title
string
Defaults to template’s name.
​
description
string
Defaults to template’s description.
​
priority
string
One of low, medium, high, urgent. Defaults to template’s priority.
​
dueDate
string
ISO 8601 datetime.
​
startDate
string
ISO 8601 datetime.
​
assignedTo
string
Defaults to template’s defaultAssignee.
​
fieldName
string
Free-text field reference (denormalized).
​
estimatedDuration
string
Defaults to template’s estimatedDuration.
​
notes
string
Free text.

​
Response

Returns the newly-created task wrapped under data. See Get task for the task shape. 
curl -X POST 'https://www.wiseyield.co/api/v1/templates/aaaaaaaa.../apply' \
  -H "Authorization: Bearer $WISEYIELD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "farmId": "11111111-2222-3333-4444-555555555555",
    "dueDate": "2026-06-15T08:00:00.000Z"
  }'

​
Errors

StatusWhen
400 INVALID_ID{id} is not a valid UUID
400 VALIDATION_ERRORBody validation failed, OR farmId is required and wasn’t provided
401Missing, malformed, expired, or revoked API key
403 INSUFFICIENT_SCOPEKey lacks tasks:write scope
404 NOT_FOUNDTemplate doesn’t exist, is inactive, or is neither user-owned nor global; OR resolved farmId isn’t owned by you
429 RATE_LIMIT_EXCEEDEDPer-user rate limit reached
5xxServer error