飞书项目 icon

飞书项目

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

Actions75

工作项配置 → 创建自定义字段

AI-generated

Overview

This node operation creates a custom field within a specified work item type in a project space. It is useful for users who want to extend the metadata of work items by adding tailored fields to capture additional information specific to their workflows. For example, a project manager might add a custom field to track priority levels or special instructions for tasks.

Use Case Examples

  1. Create a custom text field named 'Client Feedback' for a work item type 'Task' in a project space.
  2. Add a multi-select custom field to categorize work items by department or team.

Properties

Name Meaning
空间 The project space where the custom field will be created. Users can select from a list or manually input the project_key.
工作项类型 Name or ID The work item type within the selected project space where the custom field will be added. This is selected from a list of available work item types or specified by ID.
请求体参数 The complete JSON request body defining the custom field's properties such as field name, type, default value, authorization roles, and display settings.
Options Additional options for the request such as batching parameters (batch size and interval) and request timeout settings.

Output

JSON

  • field_name - The name of the created custom field.
  • field_type_key - The type key of the custom field.
  • value_type - The value type of the custom field.
  • reference_work_item_type_key - Reference to another work item type if applicable.
  • reference_field_key - Reference to another field key if applicable.
  • field_value - The value of the custom field.
  • free_add - Indicates if free addition of values is allowed.
  • work_item_relation_uuid - UUID for work item relation if applicable.
  • default_value - The default value of the custom field.
  • field_alias - Alias for the custom field.
  • help_description - Help description or tooltip for the custom field.
  • authorized_roles - Roles authorized to access or modify the field.
  • is_multi - Indicates if the field supports multiple values.
  • format - Indicates if the field has a specific format.
  • related_field_extra_display_infos - Additional display information for related fields.

Dependencies

  • An API key credential for Feishu Project API

Troubleshooting

  • Ensure the project_key and work_item_type_key are correctly specified and exist in the Feishu project space.
  • Verify the JSON request body is correctly formatted and includes all required fields.
  • If batching is enabled, ensure batch size and interval are set appropriately to avoid request throttling or timeouts.
  • Check API credentials and permissions to ensure the node can create custom fields in the specified project space.

Links

Discussion