feishu-block-type-values-limits.md

domain	contrib
title	feishu block type values limits
verification	metadata-normalized
created	2026-07-06
source	unknown

---{"title": "飞书 Block Type 正确值与已知Limit", "domain": "feishu", "subdomain": "block-api", "source": "bootstrap", "status": "published", "confidence": "0.7", "created": "2026-05-03"}---

飞书 Block Type 正确值与已知限制

Problem

飞书 block API 的 type 字段使用数字 ID，错误值导致静默失败或 400。

Root Cause

文档中 heading type 值不正确，实际可用值与社区文档有出入。

已知正确的 type 值

type	含义	稳定性
2	paragraph	✅ 稳态
12	bullet	✅ 稳态
1770001	heading（全级别）	⚠️ 文档写错，不可查
19	divider	⚠️ 易触发 429，非稳态
27	image	❌ 返回成功但 token 被静默清空

Solution

• heading 全用 1770001（不可查但实测可用）
• 图片不传 type=27，改用 paragraph 嵌 URL 替代
• divider（type=19）慎用，批量操作时加限流保护

Verification

单接口测试各 type，验证响应中返回的 block 结构与预期一致。