飞书项目 icon

飞书项目

飞书项目管理 API 集成,支持工作项、空间、用户、工作流等完整功能

Actions75

工作项实例读写 → 更新工作项

AI-generated

Overview

This node operation updates a work item instance within a specified project space in Feishu Project. It is useful for automating updates to work items by specifying the project space, work item type, work item ID, and the fields to update. For example, it can be used to programmatically change the status, assign users, or modify custom fields of a work item instance based on workflow triggers.

Use Case Examples

  1. Updating the status field of a work item instance when a related task is completed.
  2. Changing the assignee of a work item instance based on a condition in an automated workflow.

Properties

Name Meaning
空间 The project space where the work item instance exists. Can be selected from a list or entered manually as a project key.
工作项类型 Name or ID The type of work item within the selected project space. This is required to identify the schema of the work item to update.
工作项ID The unique identifier of the work item instance to update.
字段动态赋值 A collection of fields and their new values to update on the work item instance. Supports various data types including text, multi-text, select, multi-select, user, and multi-user. Complex types require JSON string input.
Options Additional options such as batching parameters for concurrent requests and timeout settings for the update operation.

Output

JSON

  • error - Error message if the update operation fails.
  • details - Additional error details if available.

Dependencies

  • Feishu Project API with appropriate API key credentials

Troubleshooting

  • Ensure the project_key and work_item_type_key are correctly specified and exist in Feishu Project.
  • Field keys and values must conform to the expected data types and formats, especially for complex JSON fields.
  • Batching options must be configured properly to avoid request overload or timeouts.
  • Common errors include missing required parameters, invalid field values, or API authentication failures. Check error messages for details and verify credentials and input data.

Links

Discussion