飞书项目 icon

飞书项目

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

Actions75

工作项实例搜索 → 获取指定的关联工作项列表（单空间）

AI-generated

Overview

This node operation fetches a list of related work item instances within a single space in Feishu Project. It is useful for scenarios where you need to retrieve work items that are linked by a specific relation key and type, such as dependencies or associations between tasks in a project management context. For example, you can use it to get all tasks related to a particular work item by specifying the work item ID, the type of related work items, and the relation key.

Use Case Examples

  1. Retrieve all related work items of a specific type linked to a given work item ID within a project space.
  2. Fetch related tasks based on a custom relation key to analyze dependencies in a project.

Properties

Name Meaning
空间 The project space to search within, identified by project_key. Can be selected from a list or entered manually.
工作项类型 Name or ID The type of work item within the space. Must be selected after choosing the space. This identifies the category of the main work item.
工作项ID The ID of the specific work item instance to find related items for.
Relation Work Item Type Key The type key of the related work items to retrieve.
Relation Key The key identifying the relation field that binds two work items together.
Relation Type The type of relation key used: 0 for relation field ID, 1 for relation field docking identifier.
Return All Whether to return all related work items or limit the number of results.
Limit Maximum number of related work items to return if Return All is false.
Options Additional options such as request timeout in milliseconds.

Output

JSON

  • id - The unique identifier of the related work item instance.
  • type_key - The type key of the related work item.
  • fields - The fields and their values of the related work item instance.

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 work_item_id is valid and corresponds to an existing work item instance.
  • Check the relation_key and relation_type to ensure they correctly identify the relation field binding the work items.
  • If the node returns no results, confirm that related work items exist for the specified parameters.
  • Timeout errors can be resolved by increasing the timeout option value.

Links

Discussion