Force.com REST API Developer Guide

Introducing Force.com REST API
Quick Start
Examples
Reference
Versions
Resources by Version
Limits
Describe Global
SObject Basic Information
SObject Describe
SObject Get Deleted
SObject Get Updated
SObject Named Layouts
SObject Rows
SObject Rows by External ID
SObject Blob Retrieve
SObject ApprovalLayouts
SObject CompactLayouts
Describe Layouts
SObject PlatformAction
SObject Quick Actions
SObject Relationships
SObject Suggested Articles for Case
SObject User Password
AppMenu
Compact Layouts
FlexiPage
Invocable Actions
List View Describe
List View Results
List Views
Parameterized Search
Process Approvals
Process Rules
Query
QueryAll
Quick Actions
Recent List Views
Recently Viewed Items
Relevant Items
Search
Search Scope and Order
Search Result Layouts
Search Suggested Records
Search Suggested Article Title Matches
Search Suggested Queries
Tabs
Themes
Composite Resources
Headers
Status Codes and Error Responses
PDF

Newer Version Available

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

Relevant Items

Gets the current user’s most relevant items. Relevant items include records for objects in the user’s global search scope and also most recently used (MRU) objects.
Relevant items include up to 50 of the most recently viewed or updated records for each object in the user’s global search scope.

The user’s global search scope includes the objects the user interacted with most in the last 30 days, including objects the user pinned from the search results page in the Salesforce Classic.

Note

Then, the resource finds additional recent records for each most recently used (MRU) object until the maximum number of records, which is 2,000, is returned.

This resource only accesses the relevant item information. Modifying the list of relevant items is not currently supported.

This resource is available in API version 35.0 and later.

URI
/vXX.X/sobjects/relevantItems
Formats
JSON
HTTP Method
GET
Authentication
Authorization: Bearer token
Parameters
Parameter Description
lastUpdatedId Optional. Compares the current list of relevant items to a previous version, if available. Specify the lastUpdatedId value returned in a previous response.
sobjects Optional. To scope the results to a particular object or set of objects, specify the name for one or more sobjects.

sobject names are case sensitive.

Note
Response body
The response contains an array of records for each object returned. The response includes the following information.
Name Type Description
lastUpdatedId string A unique code that can be used in subsequent calls to compare the results with the results in this response list.
newResultSetSinceLastQuery boolean (true or false) If a response was previously requested for the current user, indicates whether the current response matches the previous response, or the one specified by a lastUpdatedId.
key ID The first three characters of the sobject’s ID that indicates the object type.
label string The sobject’s plural label, such as Accounts.
recordIds ID A list of IDs for the matching records.
Example
See View Relevant Items.