Task Templates
Update template
Update mutable fields on a template. Only own templates can be updated; global templates owned by other users are read-only.
PUT
Authentication
Requires a key with thetasks:write scope.
Path parameters
Template UUID.
Request body
All fields optional.1–200 characters.
Up to 2,000 characters. Pass
null to clear.UUID. Pass
null to make farm-agnostic.One of
low, medium, high, urgent.One of the 10 task categories.
Pass
null to clear.Pass
null to clear.Setting
false disables the template (/apply will 404 it).Response
Returns the updated template wrapped underdata.
Errors
| Status | When |
|---|---|
400 INVALID_ID | {id} is not a valid UUID |
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 | Template doesn’t exist or wasn’t created by you |
429 RATE_LIMIT_EXCEEDED | Per-user rate limit reached |
5xx | Server error |