NetSuite SuiteTalk icon

NetSuite SuiteTalk

NetSuite REST API

Actions15

Batch Remove Records

AI-generated

Summary

Delete multiple NetSuite records in batch by specifying their record type and internal or external IDs, optionally waiting for the batch job results to complete.

Inputs

  • Record Type (required) — Choose the type of the NetSuite records to delete. Includes standard and custom record types; if 'Custom Record' is selected, specify the Custom Record Script ID.
  • Custom Record Script ID (required) — Specify the internal identifier of the Custom Record type when 'Custom Record' is selected as the record type (normally starts with 'customrecord').
  • ID (Per Item) (required) — Provide the record identifier for each input item. Supports expressions to supply different IDs per item. Prefix with 'eid:' to use external IDs.
  • Wait For Results — Optionally wait for the batch delete jobs to complete, returning individual results per input record. When disabled, returns only job submission details.
  • Batch Options — Configure batch job parameters, including idempotency key (to avoid duplicate jobs), parallel processing mode, polling interval, and timeout duration.
  • Options — Additional settings such as full response return and maximum retry attempts on errors.

Output shape

a list of objects, one per submitted batch job or one per input record if waiting for results; each object contains success status, record ID (if applicable), and error details if failures occurred.

If 'Wait For Results' is false, the node outputs one item per batch job containing job ID and submission info. If true, it waits for completion and outputs one item per record with detailed success or error result. Batch jobs split input into chunks of up to 100 items according to NetSuite limits.

Examples

Example 1: Remove multiple sales orders by internal IDs without waiting for completion

Select 'Sales Order' as Record Type, provide internal IDs per item, leave 'Wait For Results' unchecked.

Example 2: Remove multiple custom records by external IDs and wait for completion

Select 'Custom Record' as Record Type, set 'Custom Record Script ID', provide external IDs per item with 'eid:' prefix, enable 'Wait For Results'.

Links

Discussion