Update Records Using sObject Relationships

Updates a parent record based on the specified object, record ID, and relationship field name. Field values provided in the request body replace the existing values in the record. Only a child-to-parent relationship can be traversed when you update records.

If the fields parameter is used with fields that don’t exist or aren’t visible to the consumer by field-level security, a 400 error response is returned. For other error messages, see Status Codes and Error Responses.

URI: /services/data/vXX.X/sobjects/sObject/id/relationshipFieldName

Formats: JSON, XML

HTTP Method: PATCH

Authentication: Authorization: Bearer token

Parameters

ParameterDescription
sObjectThe name of the object. For example, Contact.
idThe identifier of the record. For example, 003R0000005hDFYIA2, the contact ID.
relationshipFieldNameThe name of the field that contains the relationship. For example, Account. Account is the name of the relationship on the child Contact object.

For an example of updating a record using PATCH, see

Update a Record.

See Also