Yext Knowledge API icon

Yext Knowledge API

Interact with Yext Knowledge API

Actions176

Knowledge Manager → Update Custom Field

AI-generated

Summary

Update a Custom Field in the Yext Knowledge Manager by specifying its name, group, description, options (if applicable), language behavior, validation rules, and entity availability.

Inputs

  • Name (required) — The JSON object representing the Custom Field's name with default value and optional translations for multiple languages.
  • Options — A JSON array of options with keys, values, and translations, relevant only if the Custom Field type is SINGLE_OPTION or MULTI_OPTION; existing options not included will be deleted, specified keys update options, and specifying value without a key adds a new option.
  • Group — The group to which the Custom Field belongs, selected from predefined groups (NONE to GROUP_30).
  • Description — A JSON object for the Custom Field's description and optional translations; shown as a tooltip in the Knowledge Manager.
  • Alternate Language Behavior — Defines multi-language profile behavior: PRIMARY_ONLY, OVERRIDABLE, or LANGUAGE_SPECIFIC.
  • Validation — A JSON object describing validation rules for setting or updating values of the Custom Field.
  • Entity Availability — A JSON array of entity types indicating where the Custom Field is available.

Output shape

a single JSON object representing the updated Custom Field

The operation returns the updated Custom Field object as received from the Yext Knowledge API. Inputs must be JSON-stringified for fields like name, description, options, validation, and entityAvailability. Options handling in updates can delete unspecified existing options.

Discussion