add_filter: Add a new filter

View source: R/filters.R

add_filterR Documentation

Add a new filter

Description

Add a new filter

Usage

add_filter(
  name,
  query,
  color = NULL,
  is_favorite = FALSE,
  verbose = TRUE,
  token = get_todoist_api_token()
)

Arguments

name

name of the filter

query

filter query string (e.g., "today | overdue", "p1 & #Work")

color

color of the filter

is_favorite

boolean to mark as favorite

verbose

boolean that make the function verbose

token

todoist API token

Value

id of the new filter

Examples

## Not run: 
add_filter("Urgent Today", query = "today & p1")
add_filter("Work Tasks", query = "#Work", color = "blue")

## End(Not run)

rtodoist documentation built on Feb. 14, 2026, 5:06 p.m.