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 External Client Apps or 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

Note: This release is in preview. Features described here don’t become generally available until the latest general availability date that Salesforce announces for this release. Before then, and where features are noted as beta, pilot, or developer preview, we can’t guarantee general availability within any particular time frame or at all. Make your purchase decisions only on the basis of generally available products and features.

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.

The MRU header can be used with these resources.

  • sObject Basic Information for POST requests
  • sObject Rows
  • sObject Rows by External ID
  • sObject Relationships

For examples of some 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.

Header Field Name and Values

The default value for the updateMru field 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 the updateMru field to false to improve performance. MRU isn’t relevant for integration users using only 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 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