UpsertItem Class

Represents a single upsert operation targeting a record by its alternate key.

Used with upsert to upsert one or more records identified by alternate keys rather than primary GUIDs.

Example:

   item = UpsertItem(
       alternate_key={"accountnumber": "ACC-001", "address1_postalcode": "98052"},
       record={"name": "Contoso Ltd", "telephone1": "555-0100"},
   )

Constructor

UpsertItem(alternate_key: Dict[str, Any], record: Dict[str, Any])

Parameters

Name	Description
alternate_key Required	dict[str, Any] Dictionary mapping alternate key attribute names to their values. String values are automatically quoted and escaped in the OData URL. Integer and other non-string values are included without quotes.
record Required	dict[str, Any] Dictionary of attribute names to values for the record payload. Keys are automatically lowercased. Picklist labels are resolved to integer option values when a matching option set is found.

Attributes

alternate_key

alternate_key: Dict[str, Any]

record

record: Dict[str, Any]