UpdateOptions
The UpdateOptions object defines the ability to save, update, or delete data extension fields using a container. If the Container property contains an instance of DataExtensionField, and the Action is DELETE, then the call drops any child fields. Otherwise, the call adds or updates all child fields depending upon whether they exist.
| Name | Data Type | Description |
|---|---|---|
| Action | xsd | Defines the action to take for the specified object. Valid values include:
|
| CallsInConversation | xsd | Indicates the number of calls that are part of a conversation. Marketing Cloud doesn't begin processing the conversation until the specified number of calls have been received. This is an optional property. When you specify this property, you must also specify the ConversationID property. |
| Client | ClientID | Specifies the account ownership and context of an object. |
| Container | ContainerID | Reserved for future use. |
| ConversationID | xsd | A unique ID for grouping multiple calls into a single conversation. All calls with the same ConversationID are processed as a single unit. This is an optional property. |
| Priority | xsd | This property is being deprecated. Important: The Marketing Cloud API still honors this property. However, we recommend that you use the QueuePriority property in new API calls. |
| QueuePriority | Priority | Defines the priority for asynchronous sends. Accepted values: High, Medium, and Low. The default value is Medium. |
| RequestType | RequestType | Defines a request as synchronous or asynchronous. |
| SaveOptions | SaveOption[] | Allows upsert on selected objects. |
| ScheduledTime | xsd | Keeps requests in an asynchronous queue until the time specified in the call. To maintain compliance with data privacy regulations, avoid scheduling tasks in the future. Scheduling async tasks in the future can reintroduce deleted or restricted contacts into the system. |
| SendResponseTo | AsyncResponse[] | Defines how responses are returned and under what conditions. Optional. |
| SequenceCode | xsd | Specifies the processing sequence of a multi-step conversation. This optional property requires the use of ConversationID. |