NetSuite REST icon

NetSuite REST

Call NetSuite SuiteTalk REST operations.

Actions979

Gift Certificate Item → Update record

AI-generated

Summary

Patch an existing Gift Certificate Item record in NetSuite, optionally updating standard or custom fields and including request/response details when debug mode is enabled.

Inputs

  • isDebugMode — Include full request and response information in the node output.
  • id (required) — Internal identifier of the Gift Certificate Item to update.
  • additionalFields — Standard fields for the Gift Certificate Item such as displayName, description, price, etc., provided as a collection of key/value pairs.
  • customFields — Apply or modify custom fields on the Gift Certificate Item. Provide a list of custom field definitions, each with fieldName, fieldType and corresponding value.
  • X-NetSuite-Idempotency-Key — Unique idempotency key for asynchronous requests; ignored for synchronous ones.
  • X-NetSuite-PropertyNameValidation — Controls strictness of property name validation: Error, Warning, or Ignore.
  • X-NetSuite-PropertyValueValidation — Controls strictness of property value validation: Error, Warning, or Ignore.

Output shape

A single record representing the updated Gift Certificate Item, or the node output envelope containing request and response details when debug mode is enabled. If the update succeeds without debug mode, the body may be empty and only status information is returned.

The NodeOperationExecutor sends a PATCH request to /giftCertificateItem/{id}. The response contains the updated item data (excluding sensitive or calculated fields). In debug mode, the node returns an object with request and response properties showing the full HTTP request and reply. Errors in validation or missing required fields will be reported as node execution errors.

Examples

Example 1: Update the Display Name and Description of an existing Gift Certificate Item

Set "Id" to 12345, enable "isDebugMode", fill "additionalFields" with "displayName": "Holiday Gift", "description": "Special holiday gift certificate."

Example 2: Add a custom field to the Gift Certificate Item

Set "Id" to 12345, enable the "Custom Fields" collection with a custom field entry where "fieldName": "gift_category", "fieldType": "string", "value": "Holiday".

Example 3: Perform an idempotent update via idempotency key

Set "Id" to 12345, set "X-NetSuite-Idempotency-Key" to a UUID string, and provide the desired field updates in "additionalFields".

Discussion