Retrieves a filtered and paginated list of reusable task template definitions within a workspace. Task templates serve as pre-configured blueprints for standardized recurring tasks, containing default settings for title, description, planned duration, assignees, status workflows, priority levels, and custom properties. This endpoint enables discovery and selection of templates when creating new tasks or programs, building template catalogs for common workflows such as QA reviews, content approvals, release cycles, onboarding checklists, or compliance processes. Supports extensive filtering by planned dates, creation/update timestamps, title search, priority levels, associated entities, and custom property values, with flexible sorting and cursor-based pagination for responsive user interfaces displaying template libraries.
Key Features:
- Query reusable task templates with comprehensive filtering options including planned dates, creation dates, title search, priority levels, custom properties, and associated entities
- Perform flexible multi-field sorting to organize templates by creation date, update date, planned start/end dates, or priority
- Navigate template catalogs efficiently with cursor-based pagination for building template selection interfaces
- Results automatically filtered based on user's access permissions ensuring proper security
- Templates returned with complete metadata enabling immediate cloning or inspection of configurations
Authorization Logic:
- User must have a valid JWT token with viewing or management scopes
- User can only view templates they have permission to access
- Results are filtered based on user's access rights
Usage Examples:
- Get all task templates for space w5PmrE9p0kicqqRSVJ3VBQ filtered by priority='high' and createdAt range to build a template library for critical workflows
- Search templates by title 'Review' to find all review-related templates for selection during program creation
- Query templates with customProperties filter to find templates tagged for specific departments or processes
- Retrieve templates sorted by updatedAt:desc to display recently modified templates in a template management UI