create_okr_progress_record
Add a progress note to an OKR objective or key result with optional percentage and status updates.
Instructions
[Official API + UAT, v1.3.7] Add a progress note to an OKR objective or key result. Feishu requires source_title, source_url, and a block-structured content; this tool exposes a simple content_text and auto-wraps it into the single-paragraph block format. Pass richer content directly if you need lists / mentions / docs links / images.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| target_id | Yes | ID of the OKR objective or key result. Get from get_okrs response (`objective_list[].id` or `objective_list[].kr_list[].id`). | |
| target_type | Yes | 1 = objective, 2 = key result. Pick based on which level target_id refers to. | |
| content_text | No | Plain-text progress note. Auto-wrapped into the Feishu block format. Use `content` instead for rich text. | |
| content | No | Optional: full Feishu block structure ({blocks:[...]}). If provided, overrides content_text. | |
| source_title | No | Source label (default "Progress update"). Shown next to the note in the OKR UI. | |
| source_url | No | Source URL (default https://feishu.cn/). Feishu requires a URL even for plain notes. | |
| source_url_pc | No | Optional PC-specific source URL. | |
| source_url_mobile | No | Optional mobile-specific source URL. | |
| progress_percent | No | Optional progress percent (0-100) to bump alongside the note. | |
| progress_status | No | Optional status code (Feishu enum: 1=on track, 2=at risk, 3=blocked, etc). | |
| user_id_type | No | Type of user IDs in mentioned_user_list etc. (default open_id) |