飞书项目 icon

飞书项目

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

Actions75

工作项实例读写 → 删除工时登记记录

AI-generated

Overview

This node operation deletes work hour records associated with a specific work item instance in a project management space. It is useful for managing and cleaning up time tracking data within work items, such as removing incorrect or outdated work hour entries. For example, a project manager can use this node to delete specific work hour records from a task to maintain accurate project time logs.

Use Case Examples

  1. Deleting work hour records from a work item instance by specifying the project space, work item type, and work item ID along with the IDs of the work hour records to be deleted.
  2. Automating cleanup of work hour entries in bulk by batching requests to delete multiple records efficiently.

Properties

Name Meaning
空间 The project space where the work item instance resides, identified by project_key. It can be selected from a list or entered manually.
工作项类型 Name or ID The type of work item within the selected space. This is required to specify the context of the work item instance.
工作项ID The unique identifier of the work item instance from which work hour records will be deleted.
请求体参数 The JSON formatted request body containing the IDs of the work hour records to delete, e.g., {"working_hour_record_ids": [0]}.
Options Additional options such as batching parameters (items per batch, batch interval) and request timeout settings.

Output

JSON

  • error - Error message if the deletion operation fails.
  • details - Additional error details if available.

Dependencies

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

Troubleshooting

  • Ensure the project_key and work_item_type_key are correctly specified and valid in the selected space.
  • Verify that the work_item_id corresponds to an existing work item instance.
  • Check that the working_hour_record_ids in the request body are valid and exist.
  • If batching is enabled, ensure batch size and interval are set appropriately to avoid rate limiting or timeouts.
  • Common errors include invalid parameters, unauthorized access due to missing or incorrect API credentials, and network timeouts. Verify credentials and network connectivity.

Links

Discussion