Skip to main content

Delete Lark Base records

Sophie avatar
Written by Sophie
Updated this week

Definition and Usage

Use this command to delete one or more records from a specified table in Lark Base. You first point to a connected Lark Base object, then choose how to locate the table (by name or by unique ID). Finally, select whether to delete a single record or multiple records. For single deletion, provide one record ID. For bulk deletion, provide a list of record IDs.

Parameter Values

Input Parameters

Parameter Name

Description

Possible Values

Required

Options / Notes

Lark Base

The connected Lark Base instance to operate on.

Connected Lark Base object

Yes

Obtain this from a prior “Connect Lark Base” action; ensure the connection is valid.

Locating mode

How to identify the target table.

By name, By ID

Yes

Choose By name if table names are stable; choose By ID for reliability when names may change.

Data table name

The name of the table to delete records from.

Any table name

Conditionally

Required when Locating mode = By name; must exactly match the table name.

Data table ID

The unique ID of the table to delete records from.

Any valid table ID

Conditionally

Required when Locating mode = By ID; copy from Lark Base to avoid typos.

Deletion Mode

Delete a single record or multiple records.

Delete single record, Delete multiple records

Yes

Select based on how many records you need to remove.

Record ID

The record ID to delete.

Any valid record ID

Conditionally

Required when Deletion Mode = Delete single record; ensure the ID exists in the target table.

Record ID list

The list of record IDs to delete.

List of valid record IDs

Conditionally

Required when Deletion Mode = Delete multiple records; verify all IDs belong to the chosen table.

Advanced Settings

No advanced settings available.

Error Handling

Parameter Name

Description

Throw error & stop

When an error occurs, the action will stop execution.

Retry command

The action retries the command if an error occurs.

Ignore error & continue

The action ignores the error and continues workflow execution.

Variables Produced

This action doesn't produce any variables.

Using Variables in Conditions

You can use variables to pass dynamic values from earlier steps, such as the connected Lark Base object, table name or ID, and record IDs. If the UI marks fields with {x}, those fields accept variables. Common patterns include:

  • Passing the table ID obtained from a lookup step.

  • Supplying a record ID captured from a search or creation step.

  • Providing a list of record IDs generated by a filter or query.

Notes

  • Ensure you have already connected to Lark Base using the Connect Lark Base command and that the connection has sufficient permissions to delete records.

  • Choose Locating mode carefully: using By ID prevents ambiguity when multiple tables have similar names.

  • Provide either Data table name or Data table ID based on the selected Locating mode; not both.

  • Use Deletion Mode to match your need: single deletion for one record; bulk deletion for multiple records for efficiency.

  • Validate record IDs before deletion to avoid errors due to nonexistent or cross-table IDs.

  • Deletions are permanent; confirm you are targeting the correct table and records.

Did this answer your question?