Updates an existing task template by modifying its configuration, properties, and metadata while preserving its unique identifier and existing task instances. Task templates are reusable blueprints that define standardized task structures including title, description, priority levels, estimated duration, custom properties, default assignees, and field configurations used for creating consistent tasks across programs and workflows. This endpoint allows you to refine template definitions, update default values, modify custom property configurations, change priority settings, adjust estimated time allocations, and update descriptive content without affecting tasks already created from the template.
Key Features:
- Updates template configuration including title, description, priority defaults, and estimated duration for improved template accuracy
- Modifies custom property definitions and default values to align with evolving business requirements
- Changes default assignee, follower, and notification settings to reflect current team structures
- Updates template metadata such as visibility settings, categorization tags, and organizational labels
- Preserves template ID ensuring consistency in template references across systems and workflows
- Does not affect existing task instances created from the template - they retain their original configuration
- Supports partial updates allowing you to modify specific fields without providing complete template definition
- Validates updates against workspace constraints and custom property definitions to ensure data integrity
Authorization Logic:
- User must have a valid JWT token with management scopes
- User must have management permissions for the specified space (seismic.programs.manage)
- Returns 403 if user lacks required management permissions for the space
- Returns 401 if authentication fails due to missing, invalid, or expired token
- Returns 404 if template or space does not exist or user has no access
Usage Examples:
Example 1: Update template title and description for clarity
Call PUT /v2/spaces/w5PmrE9p0kicqqRSVJ3VBQ/tasks/template/zK95yNV8rok6PXteVFyKTi with body {"title": "Product Launch - Marketing Campaign Setup", "description": "Template for initializing marketing campaigns during product launches including social media, email, and content creation tasks"} to rename and clarify template purpose. New tasks created from this template will use the updated title/description, but existing tasks remain unchanged.
Example 2: Change default priority and estimated duration
Call PUT /v2/spaces/w5PmrE9p0kicqqRSVJ3VBQ/tasks/template/zK95yNV8rok6PXteVFyKTi with body {"priority": "high", "estimatedDuration": "PT8H"} to update default priority to high and estimated duration to 8 hours. Future tasks created from this template will inherit these new defaults.
Example 3: Update custom property definitions
Call PUT /v2/spaces/w5PmrE9p0kicqqRSVJ3VBQ/tasks/template/zK95yNV8rok6PXteVFyKTi with body {"customProperties": [{"id": "FTFcbnlcfkKZCmnew-bGxw", "value": "Marketing"}]} to set default department custom property value. This standardizes categorization for tasks created from the template.