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-15"
}'
Task Templates
Apply template
Instantiate a task from a template. Template fields supply defaults; body fields override.
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-15"
}'
POST https://www.wiseyield.co/api/v1/templates/{id}/apply
Authentication
Requires a key with thetasks:write scope.
Path parameters
string
required
Template UUID. Template must be
isActive=true.Request body
All fields optional. Override template defaults by passing them here.string
UUID. Required if the template doesn’t have a bound farm. Must be owned by the user.
string
Defaults to template’s
name.string
Defaults to template’s
description.string
One of
low, medium, high, urgent. Defaults to template’s priority.string
Calendar date as
YYYY-MM-DD. A full ISO 8601 datetime is accepted too, but only its date part is kept.string
Calendar date as
YYYY-MM-DD. A full ISO 8601 datetime is accepted too, but only its date part is kept.string
Defaults to template’s
defaultAssignee.string
Free-text field reference (denormalized).
string
Defaults to template’s
estimatedDuration.string
Free text.
Response
Returns the newly-created task wrapped underdata. 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-15"
}'
Errors
| Status | When |
|---|---|
400 INVALID_ID | {id} is not a valid UUID |
400 VALIDATION_ERROR | Body validation failed, OR farmId is required and wasn’t provided |
401 | Missing, malformed, expired, or revoked API key |
403 INSUFFICIENT_SCOPE | Key lacks tasks:write scope |
404 NOT_FOUND | Template doesn’t exist, is inactive, or is neither user-owned nor global; OR resolved farmId isn’t owned by you |
429 RATE_LIMIT_EXCEEDED | Per-user rate limit reached |
5xx | Server error |