飞书项目 icon

飞书项目

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

Actions75

用户 → 搜索租户内的用户列表

AI-generated

Overview

This node operation searches for users within a tenant based on a provided keyword and project space. It supports filtering users by a search query (e.g., user name) and selecting a specific project space either from a list or by manually entering a project key. The operation is useful for scenarios where you need to find and retrieve user information within a specific organizational space or project context, such as managing user access or displaying user lists in an application.

Use Case Examples

  1. Search for users by name within a specific project space to manage user roles.
  2. Retrieve a list of users matching a keyword in a tenant for reporting or auditing purposes.

Properties

Name Meaning
搜索关键词 The keyword used to search for users, such as a user name.
空间 The project space to search within, selectable from a list or by entering a project key manually.
Options Additional options to control batching and timeout settings for the search requests.

Output

JSON

  • userList - Array of user objects matching the search criteria within the specified tenant and project space.

Dependencies

  • Requires an API key credential for authentication to the Feishu Project API.

Troubleshooting

  • Ensure the project_key is correctly specified; an empty or invalid project_key will cause the search to fail.
  • If the search keyword is empty, the operation may return a large number of users or no results depending on the API behavior.
  • Timeout settings should be adjusted based on network conditions to avoid premature request abortion.
  • Batching options should be configured carefully to balance between performance and API rate limits.

Links

Discussion