Knowledge Center

Knowledge Center > API > SOAP API > SOAP API Calls > update()

update()

Updates the information in one or more objects of the same type. You can specify different types of objects in different update() calls, but each specific update() call must apply to one type of object. 

Usage

You can call update() on an array of one or more zObjects. It returns an array of SaveResults, indicating the success or failure of updating each object. The following information applies to this call:

  • You cannot pass in null zObjects.
  • You can pass in a maximum of 50 zObjects at a time.
  • All objects must be of the same type.
  • For each field in each object, you must determine that object's ID. Then populate the fields that you want update with the new information.
  • Zuora ignores unrecognized fields in update() calls. For example, if an optional field is spelled incorrectly or a field that does not exist is specified, Zuora ignores the field and continues to process the call. No error message is returned for unrecognized fields.
  • SaveResult should be in the Response section of update().

Object Limits

50 objects are supported in a single call.

System Rate Limits 

A maximum of 5,000 calls is supported per 10-minute time window per tenant.

If you approach or exceed this limit, you will receive a 429 error. Multi-threading causes you to approach this limit more quickly.

Syntax and Argument

SaveResult[] = update(zObject[])

The call takes the following arguments.

Argument Description
zObject[] An array of one or more objects of type zObject that you want to update. The objects must be of the same type.

Response

SaveResult

Example Request

<ns1:update>
<ns1:zObjects xsi:type="ns2:Subscription">
<ns2:Id>2c92c0f83f3beb33013f3f9ecb8009e9</ns2:Id>
<ns2:ServiceActivationDate>2013-06-15T15:18:58.000-08:00</ns2:ServiceActivationDate>
</ns1:zObjects>
</ns1:update>
Last modified
23:34, 8 Aug 2016

Tags

Classifications

(not set)