飞书项目 icon

飞书项目

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

Actions75

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

AI-generated

Overview

This node operation fetches a list of work item instances from a specified single space in Feishu Project. It allows filtering by various criteria such as work item types, names, user keys, IDs, creation and update times, statuses, priorities, tags, and more. It supports returning all results or limiting the number of results, and can include additional details like workflow information, rich text, and related fields. This operation is useful for project management automation, reporting, and integration scenarios where detailed work item data retrieval is needed from a specific project space.

Use Case Examples

  1. Retrieve all work items of certain types within a project space for reporting purposes.
  2. Filter work items by creation date and status to monitor project progress.
  3. Fetch work items assigned to specific users to automate task tracking.

Properties

Name Meaning
空间 The project space to search within, selectable from a list or by manually entering the project key.
Work Item Type Names or IDs Select one or more work item types to filter the search results, based on the chosen space.
Return All Whether to return all matching results or limit the output to a specified number.
Limit Maximum number of work item results to return when not returning all.
Work Item Name Filter work items by name with support for fuzzy search.
User Keys Comma-separated list of user keys to filter work items related to those users (creator, follower, role personnel).
Work Item IDs Comma-separated list or expression array of specific work item IDs to retrieve.
Options Additional filtering and output options including creation/update time ranges, statuses, business lines, priorities, tags, search ID, workflow inclusion, rich text details, related fields details, and request timeout.

Output

JSON

  • work_item_list - Array of work item instances matching the search criteria, including detailed fields as requested.

Dependencies

  • An API key credential for Feishu Project API access

Troubleshooting

  • Ensure the project_key (space) is correctly specified; missing or incorrect keys will cause errors.
  • If filtering by work item types, ensure the types are valid and enabled in the selected space.
  • Passing a search_id disables other filters; do not combine search_id with other parameters.
  • Timeout errors may occur if the request takes too long; adjust the timeout option accordingly.
  • Errors related to permissions or authentication indicate issues with the API credential configuration.

Links

Discussion