Get task templates

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:

  1. User must have a valid JWT token with viewing or management scopes
  2. User can only view templates they have permission to access
  3. 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
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required
length between 7 and 22

The unique identifier of the space containing the target entity. This determines the scope of entity queries and ensures proper access control. The space must be accessible to the authenticated user with appropriate permissions. It can be the unique identifier (GUID) of the space or the word "default" to indicate the default programs space. Common values include "default" and "rkr83lapKkyCJuLLWqLqzB".

Query Params
date-time

Filter by task "plannedEndDate/dueDate" (inclusive)

date-time

Filter by task "plannedEndDate/dueDate" (exclusive)

date-time

Filter by task "plannedStartDate/startDate" (inclusive)

date-time

Filter by task "plannedStartDate/startDate" (exclusive)

date-time

Filter by task "createdAt" (inclusive)

date-time

Filter by task "createdAt" (exclusive)

date-time

Filter by task "updatedAt" (inclusive)

date-time

Filter by task "updatedAt" (exclusive)

ids
array of strings

Filter by a list of task IDs

ids
string

Filter by task title

string

Filter by task description

assigneeIds
array of strings

List of user IDs to filter by assignee

assigneeIds
priorities
array of strings

Filter by list of priorities

priorities
string

Filter by keywords

assignerIds
array of strings

List of user IDs to filter by user that assigned the task

assignerIds
stepIds
array of int32s

Filter by status value IDs

stepIds
string

Filter by status schema IDs

string

Cursor used for pagination

int32

Number to limit returned records

sort
array of strings

Sort by query

sort
boolean

Include subtasks within the returned list

programIds
array of strings

Filter by program IDs

programIds
boolean

Filter by task templates that are associated with a program

customProperties
object

Filter by custom property values using property ID and value criteria.

Syntax: customProperties[{propertyId}][operator]={operator}&customProperties[{propertyId}][id]=%22{valueId}%22

Note: Both id and value parameters must be enclosed in quotes and URL-encoded (%22).

Example: customProperties[abc][operator]=Equal&customProperties[abc][value]=%22Active%22

followerIds
array of strings

List of user IDs to filter by followers

followerIds
associatedNodeIds
array of strings

List of association IDs to filter by

associatedNodeIds
creatorIds
array of strings

List of user IDs to filter by creator

creatorIds
boolean

Include association data in the response

string

Filter tasks by parent Id, noParent returns tasks that do not have a parent

Responses

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json