REST API Developer Guide
jsObject 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.
Then, the resource finds more 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.
Syntax
URI: /services/data/vXX.X/sobjects/relevantItems
Formats: JSON
HTTP Method: GET
Authentication: Authorization: Bearer token
Parameters
| Parameter | Description |
|---|---|
| lastUpdatedId | Optional. Compares the entire 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.lastUpdatedId | Optional. Compares the current list of relevant items for this particular object to a previous version, if available. Specify the lastUpdatedId value returned in a previous response. |
Note: sObject names are case-sensitive.
Note: You can only specify the sobject.lastUpdatedId parameter for the sObjects specified in the sobjects parameter.
Response header
The response contains headers unique to this resource.
| Name | Type | Description |
|---|---|---|
| lastUpdatedId | string | A unique code that can be used in subsequent calls to compare the results for a complete result set 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. |
Response body
The response contains an array of records for each object returned, including the following information for each record.
| Name | Type | Description |
|---|---|---|
| apiName | string | The object’s unique name, such as Account |
| key | ID | The first 3 characters of the sObject’s ID that indicates the object type. |
| label | string | The object’s plural label, such as Accounts. |
| lastUpdatedId | string | A unique code that can be used in subsequent calls to compare the results for the new result set with the current results for this object. |
| qualifiedApiName | string | A unique external name for the sObject. |
| recordIds | ID | A comma-separated list of IDs for the matching records. |
Example
See Get Relevant Items.