/feishu-doc

Feishu Block Types Reference

Complete reference for Feishu document block types. Use with feishu_doc_list_blocks, feishu_doc_update_block, and feishu_doc_delete_block.

Block Type Table

Editing Guidelines

Text-based blocks (2-17, 19)

Update text content using feishu_doc_update_block:

{
  "doc_token": "ABC123",
  "block_id": "block_xxx",
  "content": "New text content"
}

Image blocks (27)

Images cannot be updated directly via update_block. Use feishu_doc_write or feishu_doc_append with markdown to add new images.

Table blocks (31)

Important: Table blocks CANNOT be created via the documentBlockChildren.create API (error 1770029). This affects feishu_doc_write and feishu_doc_append - markdown tables will be skipped with a warning.

Tables can only be read (via list_blocks) and individual cells (type 32) can be updated, but new tables cannot be inserted programmatically via markdown.

Container blocks (24, 25, 35)

Grid and QuoteContainer are layout containers. Edit their child blocks instead.

Common Patterns

Replace specific paragraph

1. feishu_doc_list_blocks - find the block_id
2. feishu_doc_update_block - update its content

Insert content at specific location

Currently, the API only supports appending to document end. For insertion at specific positions, consider:

1. Read existing content
2. Delete affected blocks
3. Rewrite with new content in desired order

Delete multiple blocks

Blocks must be deleted one at a time. Delete child blocks before parent containers.