valuesetItemUpdate
Update an existing value set item's data and metadata.
Modifies item details including value, localized descriptions, and extra metadata. Only provided fields will be updated, others remain unchanged. The parent value set association cannot be changed after creation.
Restrictions: • Items in SYSTEM type value sets cannot be modified • Value changes must maintain uniqueness within the parent value set • Parent value set association is immutable • Value must not exceed 512 characters if provided
Use this mutation to: • Update item values for better clarity or accuracy • Add or modify localized descriptions for internationalization • Update additional metadata stored in the extra field • Maintain item data without affecting parent value set
Possible errors:
- VALUESET_ITEM_UPDATE_ERROR: Failed to update the value set item due to system error
- VALUESET_ITEM_NOT_FOUND_ERROR: Value set item with the specified ID does not exist
- VALUESET_ALREADY_EXISTS_ERROR: Updated value conflicts with another item in the same value set
- VALUESET_NOT_ALLOWED_TO_MODIFY_ERROR: Attempt to modify item in SYSTEM type value set
AUTH: Role=[configuration.OWNER,configuration.EDITOR]
valuesetItemUpdate(
id: Int!
input: ValuesetItemUpdateInput!
): ValuesetItem!
Arguments
valuesetItemUpdate.id ● Int! non-null scalar
Unique identifier of the value set item to update.
Must be a positive integer representing a valid, existing value set item ID. The item must belong to a CUSTOM type value set to allow modifications.
valuesetItemUpdate.input ● ValuesetItemUpdateInput! non-null input
Updated value set item information with partial field updates.
Contains the item properties to update. All fields are optional - only provided fields will be changed, others remain unchanged.
Validation constraints: • value: 1-512 characters if provided, must be unique within parent value set • descriptions: Valid language codes with meaningful descriptions • extra: Optional metadata up to 512 characters