Kaizen

Kaizen Create Buckets

Create buckets in bulk with manual input, block references, or AI-generated buckets

The Kaizen Create Buckets block creates multiple buckets at once. You can provide bucket data manually (JSON or form), reference data from another block, or use AI Generated mode to create buckets from a text prompt, similar existing buckets, or search results. Use the bucketIds output with Kaizen Manage Todo Buckets or Kaizen Add Todos.

Block Type

kaizen_create_buckets

Input Fields

Input Mode

ValueDescription
Manual (JSON)Provide a JSON array of bucket objects. Each must have title; optional: notes, visibility (PUBLIC/PRIVATE/FOLLOWERS), priority (LOW/MEDIUM/HIGH/URGENT), tags, links.
Manual (Form)Single-bucket form: title, description, visibility, priority, tags.
Reference from BlockReference a block output (e.g. <block_name.buckets>) that contains an array of bucket-like objects.
AI GeneratedAI generates buckets from a prompt. Configure prompt, goal, success criteria, time horizon, visibility, and options (deduplicate, merge similar, normalize titles, infer priority).

Common Fields

FieldDescription
skipErrorsContinue if individual bucket creation fails (default: true). Recommended for batch operations.
reasonOptional reason for audit/tracking.

AI Mode Fields (when Input Mode = AI Generated)

FieldDescription
Prompt / instructionsNatural language description of buckets to create.
Goal (Intent)One-sentence goal for the generated buckets.
Success CriteriaOptional criteria (one per line or comma-separated).
Time Horizontoday, week, month, long_term.
Default VisibilityPUBLIC, PRIVATE, FOLLOWERS.
Deduplicate, Merge Similar, Normalize Titles, Infer PriorityOptions to clean and refine generated buckets.

Outputs

OutputTypeDescription
successbooleanWhether the overall operation succeeded
messagestringHuman-readable result message
bucketIdsarrayIDs of created buckets. Use with kaizen_manage_todo_buckets or kaizen_add_todos.
bucketsarrayCreated bucket objects (id, title, notes, etc.). For AI mode, may include confidence/reasoning.
createdBucketsarrayDetailed results per creation attempt
summaryobjectTotal requested, successfulCreations, failedCreations, aiGenerated, etc.
aiInsightsobjectWhen AI mode: coverageScore, missingAreas, assumptionsMade

Common Use Cases

Create buckets from JSON

Set Input Mode to Manual (JSON) and provide an array of { "title": "...", "notes": "...", "visibility": "PUBLIC" }. Use <kaizen_create_buckets_1.bucketIds> downstream.

AI: generate buckets from a prompt

Set Input Mode to AI Generated, enter a prompt (e.g. "5 project buckets for a home renovation"), set default visibility and optional goal/success criteria. Enable Skip Errors for batch runs.

Chain to Add Todos or Manage Todo Buckets

After creating buckets, pass bucketIds to Kaizen Manage Todo Buckets or Kaizen Add Todos (e.g. bucketIdsReference: "<kaizen_create_buckets_1.bucketIds>").

Referencing Outputs

bucketIds: "<kaizen_create_buckets_1.bucketIds>"

Use Skip Errors for batch operations so one failure does not stop the rest. The bucketIds output is the main reference for downstream blocks.

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