API Docs / Schemas / SavedTaskFilterDto

SavedTaskFilterDto

A saved task filter belonging to a tenant user, defining reusable criteria for filtering task lists

Properties

Name Type Description
codestring

Unique identifier within the tenant

Unique identifier within the tenant

namestring

User-friendly name for this saved filter

User-friendly name for this saved filter

descriptionstring

Optional description providing more details about this filter's purpose

Optional description providing more details about this filter's purpose

includeInMenuboolean

Whether this filter should be included in the filter menu/quick access list

Whether this filter should be included in the filter menu/quick access list

dateRangeenum

ThisWeek NextWeek Last7Days Next7Days Last30Days Next30Days PreviousMonth ThisMonth NextMonth PreviousQuarter ThisQuarter NextQuarter PreviousYear ThisYear NextYear YearToDate PreviousFinancialYear ThisFinancialYear NextFinancialYear FinancialYearToDate Today CustomDateRange

ThisWeek NextWeek Last7Days Next7Days Last30Days Next30Days PreviousMonth ThisMonth NextMonth PreviousQuarter ThisQuarter NextQuarter PreviousYear ThisYear NextYear YearToDate PreviousFinancialYear ThisFinancialYear NextFinancialYear FinancialYearToDate Today CustomDateRange

startDatestring

Custom start date (only used when DateRange = CustomDateRange)

Custom start date (only used when DateRange = CustomDateRange)

endDatestring

Custom end date (only used when DateRange = CustomDateRange)

Custom end date (only used when DateRange = CustomDateRange)

dateBasisenum

StartDate DueDate

StartDate DueDate

clientCodesarray of string

Filter by client code(s)

Filter by client code(s)

userCodesarray of string

Filter by user code(s)

Filter by user code(s)

recurringTaskCodesarray of string

Filter by recurring task code(s)

Filter by recurring task code(s)

categoryCodesarray of string

Filter by category code(s)

Filter by category code(s)

teamCodesarray of string

Filter by team code(s)

Filter by team code(s)

statusesarray of enum

Filter by task status(es)

NotStarted InProgress Blocked Completed Skipped

Filter by task status(es)

NotStarted InProgress Blocked Completed Skipped

isOverdueboolean

Filter to only overdue tasks

Filter to only overdue tasks

isUnassignedboolean

Include tasks with no assigned user. Can be combined with UserCodes to show
tasks that are either unassigned OR assigned to specific users.

Include tasks with no assigned user. Can be combined with UserCodes to show
tasks that are either unassigned OR assigned to specific users.

includeProjectedboolean

Include projected (virtual) tasks in the results

Include projected (virtual) tasks in the results

includeWorkflowStepsboolean

Include workflow steps in the results (Agenda mode)

Include workflow steps in the results (Agenda mode)

defaultSortFieldenum

Name DueDate StartDate Category ClientName AssignedUser

Name DueDate StartDate Category ClientName AssignedUser

defaultSortDescboolean

Sort in descending order (true) or ascending order (false)

Sort in descending order (true) or ascending order (false)

iconNamestring

Optional Lucide icon name for visual identification (e.g., "Calendar", "Users", "Star")

Optional Lucide icon name for visual identification (e.g., "Calendar", "Users", "Star")

colorstring

Optional hex color for visual identification (e.g., "#FF5733")

Optional hex color for visual identification (e.g., "#FF5733")

createdDatestring

When the filter was created

When the filter was created

updatedDatestring

When the filter was last updated

When the filter was last updated

JSON Example

{
  "code": "string",
  "name": "string",
  "description": "string",
  "includeInMenu": false,
  "dateRange": "ThisWeek"
}

Used By Operations

Contained in Schemas