REST API Developer Guide

Introduction to REST API
About REST API
Release Notes
Supported Editions and Required Permissions
REST Resources and Requests
REST API Architecture
Authorization Through Connected Apps and OAuth 2.0
Headers
Assignment Rule Header
Call Options Header
Compression Headers
Conditional Request Headers
Duplicate Rule Header
Limit Info Header
MRU Header
Package Version Header
Query Options Header
Warning Header
Send REST Requests with cURL
Valid Date and DateTime Formats
Status Codes and Error Responses
API End-of-Life Policy
Quick Start
Examples
Generating an OpenAPI 3.0 Document for sObjects REST API (Beta)
Reference
PDF

Newer Version Available

This content describes an older version of this product. View Latest

MRU Header

Defines if the record that is created, updated, upserted, or retrieved updates the list of most recently used (MRU) items. MRU items are shown in the Recent Items section of the sidebar in the Salesforce user interface. This header is available in API version 60.0 and later.

REST APIs that create, update, upsert, or retrieve records support this header. For examples of these APIs, see sObject Rows and sObject Rows by External ID in the See Also section. REST APIs used to query records via SOQL never update the MRU, so the header field has no impact on the MRU and is always set to false.

Note

Header Field Name and Values

The default value for all fields is true, except for with REST APIs that query records via SOQL. The default value is subject to change.

For integration users who make only API calls, Salesforce recommends setting this field to false to improve performance. MRU isn’t relevant for integration users using solely APIs because they don’t use the Salesforce user interface.

Field name
updateMru
Field values
  • true—Update MRU with related records if the No MRU Updates field isn’t enabled for the user on the Users page in Setup. For more information on how to enable this field, see the Edit Users page in the See Also section. 
  • false—Don’t update MRU with related records.
Example
Indicates that the record updates the MRU. 
1Sforce-Mru: updateMru=true