Task Templates
Apply template
Instantiate a task from a template. Template fields supply defaults; body fields override.
POST
Authentication
Requires a key with thetasks:write scope.
Path parameters
Template UUID. Template must be
isActive=true.Request body
All fields optional. Override template defaults by passing them here.UUID. Required if the template doesn’t have a bound farm. Must be owned by the user.
Defaults to template’s
name.Defaults to template’s
description.One of
low, medium, high, urgent. Defaults to template’s priority.ISO 8601 datetime.
ISO 8601 datetime.
Defaults to template’s
defaultAssignee.Free-text field reference (denormalized).
Defaults to template’s
estimatedDuration.Free text.
Response
Returns the newly-created task wrapped underdata. See Get task for the task shape.
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 |