---
title: "Partially update a custom object record"
method: PATCH
path: "/objects/records/default/{object}/{id}"
tags: ["Custom Object Records"]
---

# Partially update a custom object record

`PATCH /objects/records/default/{object}/{id}`

Updates one or many fields of a custom object record. Patch update uses JSON Merge Patch as specified in [RFC 7386](https://tools.ietf.org/html/rfc7386).

### Limitations

* The storage of empty strings in records is not supported.
* Null values must be formatted as the following example:
  ```
  {
    "records": [
      {
        "fieldName__c": null
      }
    ]
  }
  ```
* When creating or updating custom object records with relationship-type fields, Zuora verifies the related objects against the transactional databases, which are updated in near real-time. The record creation or modification fails upon unsuccessful verifications. <br />If the related objects are newly created in your tenant, it might need some time for the transactional database synchronization.

## Path parameters

- `object` string, required
- `id` string, uuid, required

## Headers

- `Accept-Encoding` string
- `Content-Encoding` string
- `Zuora-Track-Id` string
- `Zuora-Entity-Ids` string
- `Zuora-Org-Ids` string
- `Zuora-Version` string, date

## Response `200`

OK

- CustomObjectRecordWithAllFields — Record data from an object
  - `CreatedById` string — The creator's Id
  - `CreatedDate` string, date-time — The record creation time in the date-time format
  - `Id` string, uuid — The unique Id of the custom object record
  - `UpdatedById` string — The modifier's Id
  - `UpdatedDate` string, date-time — The record modification time in the date-time format
  - `type` string — The type of the custom object record. It is the API name of the custom object definition.

## Other responses

- `404` — Object record does not exist

---

[API](https://skmtc.dev/zuora/apis/api-reference.md) · [All operations](https://skmtc.dev/zuora/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zuora/api-reference/revisions/d11e237f3e54/schema)