飞书 icon

飞书

飞书 API 集成,支持多种飞书功能

Actions112

通讯录 → 获取部门直属用户列表

AI-generated

Summary

Lists users directly assigned to a specified Feishu department. Choose user-level or app-level credentials, then set the department ID and its ID type; the operation may return duplicate users when users belong to multiple departments.

Inputs

  • 凭证类型 — Select user-level or app-level Feishu credentials; app-level credentials are the default.
  • 部门 ID (required) — Department to list users for. Defaults to 0, the root department. Use an ID format matching the selected department ID type.
  • 用户 ID 类型 — Choose whether returned user identifiers use Open ID, Union ID, or User ID. Defaults to Open ID.
  • 部门 ID 类型 — Choose Department ID or Open Department ID for the department ID. Defaults to Open Department ID.
  • Return All — Choose whether to return all results or limit the number returned. Defaults to false.
  • Limit — Maximum number of results when Return All is false. Defaults to 50; allowed range is 1–50.
  • Options.Batching — Adding batching enables concurrent processing of input items. Configure items per batch (default 50) and the delay between batches in milliseconds (default 1000).
  • Options.Timeout — Request timeout in milliseconds; 0 means no timeout. The UI declares a default of 0.

Output shape

A list of user records, subject to the selected pagination setting.

The operation is declared to support pagination, but its exact response fields and runtime pagination behavior are not present in the supplied source pack. Duplicate user records can occur when users belong to multiple departments; use Remove Duplicates downstream if needed.

Examples

Example 1: List direct users in the root department

Keep Department ID at 0, use Department ID type Open Department ID, and select the desired user ID type.

Links

Discussion