Kaizen Buckets
Fetch and filter buckets from the Kaizen platform with comprehensive filtering options
The Kaizen Buckets block fetches buckets from the Kaizen platform with powerful filtering capabilities. Use this block to retrieve buckets by collection, creator, tags, or todos contained in buckets. Works with Kaizen Todos and Kaizen Add Todos for workflow automation.
Block Type
kaizen_bucketsInput Fields
Pagination
| Field | Default | Description |
|---|---|---|
page | 1 | Page number |
limit | 20 | Results per page (max: 100) |
Search and Filters
| Field | Description |
|---|---|
search | Text search across bucket titles and notes |
tagIds | Filter by specific tags (tag-selector or comma-separated IDs) |
collectionFilter | Filter by collection: "" (all), owned, library, liked, saved, featured |
creatorId | Filter buckets by specific creator (creator-selector) |
todoIds | Filter buckets containing these todos; use todo-selector or <block_id.todoIds> |
Sorting
| Field | Options | Description |
|---|---|---|
sortBy | "", createdAt, updatedAt, title, numberOfTodos | Field to sort by |
sortOrder | desc, asc | Sort direction |
Options
| Field | Default | Description |
|---|---|---|
includeStats | false | Include statistics (likes, saves, comments, todos) in the response |
Outputs
| Output | Type | Description |
|---|---|---|
buckets | array | Array of bucket objects |
bucketIds | array | Array of bucket IDs |
pagination | object | Pagination info |
Common Use Cases
Fetch Buckets for Current User Library
inputs:
collectionFilter: library
limit: 20Find Buckets Containing Specific Todos
inputs:
todoIds: "<kaizen_todos_1.todoIds>"
limit: 10Get a Single Bucket by ID (via reference)
Use Kaizen Todos or another block to get a bucket ID, or use the bucket-selector in the UI. Downstream blocks can reference: <kaizen_buckets_1.bucketIds> or the first bucket's ID.
Referencing Outputs
Use the <block_id.bucketIds> or <block_id.buckets> syntax in downstream blocks:
bucketId: "<kaizen_buckets_1.bucketIds>"
# or for Add Todos / Manage Todo Buckets
bucketIdsReference: "<kaizen_buckets_1.bucketIds>"The bucketIds output is ideal for passing to Kaizen Add Todos, Kaizen Manage Todo Buckets, or Kaizen Todos (bucket filter).