Update a Record

PATCH {{_endpoint}}/services/data/v{{version}}/ui-api/records/:RECORD_ID

Update a record's data. User Interface API enforces Salesforce validation rules. If a validation rule fails, the response is an Error with Output.

When you make a PATCH request to update a record, make sure that the record hasn’t changed since the user started editing it. To find out whether it’s safe to save a record, pass the If-Modified-Since HTTP header in the request.

As of API version 43.0, if you pass read-only fields in a request body, the response is an Error with Output.

Request Body

{"allowSaveOnDuplicate"=>false, "fields"=>{"FieldAPIName"=>"FieldValue"}}

HEADERS

KeyDatatypeRequiredDescription
Content-Typestring

RESPONSES

status: OK

{"apiName":"Account","childRelationships":{},"eTag":"1be6f040e46732e79a0999d6fea9fe7d","fields":{"AccountNumber":{"displayValue":null,"value":null},"Active__c":{"displayValue":null,"value":null},"AnnualRevenue":{"displayValue":null,"value":null},"BillingCity":{"displayValue":null,"value":null},"BillingCountry":{"displayValue":null,"value":null},"BillingPostalCode":{"displayValue":null,"value":null},"BillingState":{"displayValue":null,"value":null},"BillingStreet":{"displayValue":null,"value":null},"CreatedBy":{"displayValue":"Philippe Ozil","value":{"apiName":"User","childRelationships":{},"eTag":"cc07f7ef1b08ddbd75074c69512dd388","fields":{"Id":{"displayValue":null,"value":"005B0000003TOI6IAO"},"Name":{"displayValue":null,"value":"Philippe Ozil"}},"id":"005B0000003TOI6IAO","lastModifiedById":"005B0000003TOI6IAO","lastModifiedDate":"2023-02-02T10:32:12.000Z","recordTypeId":null,"recordTypeInfo":null,"systemModstamp":"2023-09-27T15:47:51.000Z","weakEtag":1695829671000}},"CreatedById":{"displayValue":null,"value":"005B0000003TOI6IAO"},"CreatedDate":{"displayValue":"27/09/2023 18:01","value":"2023-09-27T16:01:14.000Z"},"CustomerPriority__c":{"displayValue":null,"value":null},"Description":{"displayValue":null,"value":null},"Fax":{"displayValue":null,"value":null},"Industry":{"displayValue":null,"value":null},"LastModifiedBy":{"displayValue":"Philippe Ozil","value":{"apiName":"User","childRelationships":{},"eTag":"cc07f7ef1b08ddbd75074c69512dd388","fields":{"Id":{"displayValue":null,"value":"005B0000003TOI6IAO"},"Name":{"displayValue":null,"value":"Philippe Ozil"}},"id":"005B0000003TOI6IAO","lastModifiedById":"005B0000003TOI6IAO","lastModifiedDate":"2023-02-02T10:32:12.000Z","recordTypeId":null,"recordTypeInfo":null,"systemModstamp":"2023-09-27T15:47:51.000Z","weakEtag":1695829671000}},"LastModifiedById":{"displayValue":null,"value":"005B0000003TOI6IAO"},"LastModifiedDate":{"displayValue":"27/09/2023 18:04","value":"2023-09-27T16:04:41.000Z"},"Name":{"displayValue":null,"value":"My Renamed Account"},"NumberOfEmployees":{"displayValue":null,"value":null},"NumberofLocations__c":{"displayValue":null,"value":null},"Owner":{"displayValue":"Philippe Ozil","value":{"apiName":"User","childRelationships":{},"eTag":"cc07f7ef1b08ddbd75074c69512dd388","fields":{"Id":{"displayValue":null,"value":"005B0000003TOI6IAO"},"Name":{"displayValue":null,"value":"Philippe Ozil"}},"id":"005B0000003TOI6IAO","lastModifiedById":"005B0000003TOI6IAO","lastModifiedDate":"2023-02-02T10:32:12.000Z","recordTypeId":null,"recordTypeInfo":null,"systemModstamp":"2023-09-27T15:47:51.000Z","weakEtag":1695829671000}},"OwnerId":{"displayValue":null,"value":"005B0000003TOI6IAO"},"Ownership":{"displayValue":null,"value":null},"Parent":{"displayValue":null,"value":null},"ParentId":{"displayValue":null,"value":null},"Phone":{"displayValue":null,"value":null},"Rating":{"displayValue":null,"value":null},"SLAExpirationDate__c":{"displayValue":null,"value":null},"SLASerialNumber__c":{"displayValue":null,"value":null},"SLA__c":{"displayValue":null,"value":null},"ShippingCity":{"displayValue":null,"value":null},"ShippingCountry":{"displayValue":null,"value":null},"ShippingPostalCode":{"displayValue":null,"value":null},"ShippingState":{"displayValue":null,"value":null},"ShippingStreet":{"displayValue":null,"value":null},"Sic":{"displayValue":null,"value":null},"Site":{"displayValue":null,"value":null},"TickerSymbol":{"displayValue":null,"value":null},"Type":{"displayValue":null,"value":null},"UpsellOpportunity__c":{"displayValue":null,"value":null},"Website":{"displayValue":null,"value":null}},"id":"0011Q00002Z2P5jQAF","lastModifiedById":"005B0000003TOI6IAO","lastModifiedDate":"2023-09-27T16:04:41.000Z","recordTypeId":"012000000000000AAA","recordTypeInfo":null,"systemModstamp":"2023-09-27T16:04:41.000Z","weakEtag":1695830681000}