flowus-block

FlowUs Block Skill

Use the flowus CLI with --json for every command.

Commands

• Get block: flowus --json block get <block_id>
• Get children: flowus --json block children <block_id>
• Get children page: flowus --json block children <block_id> --start-cursor <cursor> --page-size <n>
• Append children: flowus --json block append <block_id> --body <children.json>
• Update block: flowus --json block update <block_id> --body <patch.json>
• Delete block: flowus --json block delete <block_id>

Rules

• If authentication is unclear, use flowus --json doctor; use flowus login for interactive login.
• Credential precedence is --token, then FLOWUS_TOKEN, then the token saved by flowus login.
• Do not call FlowUs V2 API with curl.
• Do not print or save bearer tokens.
• Use the markdown skill when replacing or reading large page content is simpler than block-level operations.
• Before appending children, confirm the block ID and body file come from user-authorized input.
• Before updating a block, confirm the block ID and body file come from user-authorized input.
• Confirm destructive block deletes before running them.
• Before deleting a block, confirm the block ID comes from explicit user authorization; deletion is destructive.
• Treat ok: false as a failed operation even if the process output is parseable JSON.