Update

Definition

Updates individual objects or batches of objects.

C# Syntax

UpdateResult[] update = Update(Options, Objects, RequestID, OverallStatus)

Parameters

This method has the following parameters.

Description

The Update method allows objects to be updated-individually or in batches. Multiple object types can be updated with one call. Objects are created in the order they are added to the APIObject array.

Input

• UpdateOptions - An UpdateOptions instance is required for this parameter. However, no properties need to be defined for the instance.
• APIObjects - An array of objects to be acted upon. The objects are acted on in the order they have been added - first in, first out. This array can hold different object types. Therefore, complex interactions like updating an email, a list, and an email can be accomplished in one call.
• RequestKey - This parameter contains a string value containing an output variable of the key of the request. By default, this value will be an ExactTarget generated GUID.
• OverallStatus - This parameter returns a string value containing the overall status of the request. Valid status values include:
  • OK - Status code stating that all objects were updated successfully.
  • Has Error - Valid for Update calls with multiple APIObject objects, this status code states that some of the operations failed, while some succeeded.
  • Error - This status code states that all update operations failed during validation or processing.

NOTE: Do not use the Update method to create new objects. Trying to create new objects using the Update method will cause the overall status to not be Has Error or Error.

Output

• UpdateResult - An array of objects holding a list of return values. The objects are returned in the order acted upon-again, first in, first out. This array contains one UpdateResult object per input APIObject.

Objects

The following objects are supported by this method.