飞书项目 icon

飞书项目

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

Actions75

工作项配置 → 更新自定义字段

AI-generated

Overview

This node operation updates custom fields in a work item configuration within a specified project space. It is useful for managing and customizing work item fields dynamically in project management workflows, such as modifying field names, keys, values, and related display settings. For example, it can be used to update the description or default value of a custom field in a work item type within a project space.

Use Case Examples

  1. Updating the alias and help description of a custom field in a work item type.
  2. Changing the default value or authorized roles for a custom field in a project space's work item configuration.

Properties

Name Meaning
空间 The project space where the work item configuration exists. Can be selected from a list or entered manually as a project key.
工作项类型 Name or ID The work item type within the selected project space. This is required to specify which work item type's custom fields are being updated. Options are loaded dynamically based on the selected space.
请求体参数 The complete JSON request body containing the parameters for updating the custom field, including field name, key, value, default value, alias, help description, authorized roles, and related display information.
Options Additional options such as batching (to enable concurrent requests with batch size and interval) and timeout settings for the request.

Output

JSON

  • field_name - The name of the updated custom field.
  • field_key - The unique key identifier of the custom field.
  • field_value - The updated value of the custom field.
  • free_add - Indicates if free addition of values is allowed (0 or 1).
  • work_item_relation_uuid - UUID for work item relation if applicable.
  • default_value - The default value set for the custom field.
  • field_alias - Alias name for the custom field.
  • help_description - Help description or tooltip for the custom field.
  • authorized_roles - List of roles authorized to access or modify the field.
  • related_field_extra_display_infos - Additional display information related to the field, including project key, work item type key, display field keys, role keys, and controls.

Dependencies

  • Requires an API key credential for Feishu Project API to authenticate requests.

Troubleshooting

  • Ensure the 'project_key' and 'work_item_type_key' are correctly selected or input; missing or incorrect values will cause errors.
  • The JSON request body must be correctly formatted and include all required fields; invalid JSON or missing required fields will cause the update to fail.
  • If batching is enabled, ensure batch size and interval are set appropriately to avoid rate limiting or timeouts.
  • Timeout settings should be configured based on expected server response times to prevent premature request abortion.

Links

Discussion