Kaizen

Kaizen Todos

Fetch and filter todos from the Kaizen platform with comprehensive filtering options

The Kaizen Todos block fetches todos from the Kaizen platform with powerful filtering capabilities. Use this block to retrieve todos based on completion status, collection, priority, buckets, tags, deadlines, and more.

When to use

Use Kaizen Todos in any workflow that needs a set of todos: scheduling (e.g. daily pick), adding to a bucket, hiding, finding similar items, or discovery prompts. Typical next blocks: kaizen_schedule_todos, kaizen_add_todos, kaizen_hide_todos, kaizen_similar, kaizen_metadata_extractor.

Block Type

kaizen_todos

Input Fields

Collection Filtering

FieldOptionsDescription
collectionFilter"" (all), library, liked, saved, featuredFilter by collection type

Completion Status

FieldOptionsDescription
completionStatusall, NOT_COMPLETED, IN_PROGRESS, COMPLETED, FAILEDFilter by completion status

Use exact option values: NOT_COMPLETED for incomplete todos, not "incomplete" or "pending".

Bucket and Tag Filters

FieldDescription
bucketIdsFilter by specific buckets (bucket-selector; comma-separated IDs)
tagTitlesFilter by specific tags (tag-selector; comma-separated tag titles)

Deadline Filter

FieldOptionsDescription
deadlineFilterany, has_deadline, no_deadline, overdue, due_today, due_this_week, due_this_month, customPreset or custom deadline filter
deadlineAfterISO 8601 dateWhen deadlineFilter is custom: deadline after this date
deadlineBeforeISO 8601 dateWhen deadlineFilter is custom: deadline before this date

Hidden Filter

FieldOptionsDescription
hiddenFilterany, only_hidden, only_visibleFilter by hidden status in buckets. Requires bucketIds.
hiddenFromUserIdUser IDWhen hiddenFilter is only_hidden: filter hidden todos for this user

Location Radius Filter

When Location Filter Enabled is Yes, you can filter todos within a radius of a location using Location Source (manual lat/lng, search, or block reference), and Radius (km).

Sorting

FieldOptionsDescription
sortBy"", createdAt, updatedAt, title, priority, deadlineField to sort by
sortOrderdesc, asc, randomSort direction or random selection

For random selection: Use sortOrder: random to get todos in random order.

Priority Filtering

FieldOptionsDescription
priority"", LOW, MEDIUM, HIGH, URGENTFilter by priority level

Pagination

FieldDefaultDescription
page1Page number
limit20Results per page (max: 100)

Outputs

OutputTypeDescription
todosarrayArray of todo objects
todoIdsarrayArray of todo IDs (use in downstream blocks)
paginationobjectPagination info (page, limit, total, totalPages, hasMore)
filtersobjectAvailable filter options (tags, buckets)

Common patterns (Copilot tips)

Use these exact option values when building workflows:

GoalInputs
Random incomplete from librarycollectionFilter: library, completionStatus: NOT_COMPLETED, sortOrder: random, limit: N
Due todaydeadlineFilter: due_today, completionStatus: NOT_COMPLETED
OverduedeadlineFilter: overdue
Due this weekdeadlineFilter: due_this_week
High priority taskscompletionStatus: NOT_COMPLETED, priority: HIGH, sortBy: priority, sortOrder: desc
From a specific bucketSet bucketIds (e.g. from bucket-selector or reference)

Common Use Cases

Fetch Random Incomplete Todos

inputs:
  collectionFilter: library
  completionStatus: NOT_COMPLETED
  sortOrder: random
  limit: 3

Fetch High Priority Tasks

inputs:
  completionStatus: NOT_COMPLETED
  priority: HIGH
  sortBy: priority
  sortOrder: desc
  limit: 5

Fetch Overdue or Due Today

# Overdue
inputs:
  deadlineFilter: overdue
  completionStatus: NOT_COMPLETED

# Due today
inputs:
  deadlineFilter: due_today
  completionStatus: NOT_COMPLETED

Referencing Outputs

Use the <block_id.todoIds> or <block_id.todos> syntax to reference outputs in downstream blocks. The block_id must match the block you added (e.g. if the block_id is fetch_todos, use <fetch_todos.todoIds>).

todoIdsReference: "<fetch_todos.todoIds>"
On this page

On this page

Start building today
Trusted by over 60,000 builders.
Build Agentic workflows visually on a drag-and-drop canvas or with natural language.
Get started