View Relevant Items

Use the Relevant Items resource to get a list of relevant records.

Example usage for getting a list of the current user’s most relevant records

/vXX.X/sobjects/relevantItems

Example request body

None required

Example response body

1[ {
2"key" : "003",
3"label" : "Contacts",
4"recordIds" : [ "003xx000004TxBA" ]
5}, {
6"key" : "001",
7"label" : "Accounts",
8"recordIds" : [ "001xx000003DWsT" ]
9}, {
10"key" : "005",
11"label" : "Users",
12"recordIds" : [ "005xx000001Svqw", "005xx000001SvwK", "005xx000001SvwA" ]
13}, {
14"key" : "069",
15"label" : "Content Documents",
16"recordIds" : [ "069xx0000000006", "069xx0000000001", "069xx0000000002" ]
17} ]

Example usage for filtering the response to certain objects

/v35.0/sobjects/relevantItems?sobjects=Account,User

Example request body

None required

Example response body

1[ {
2"key" : "001",
3"label" : "Accounts",
4"recordIds" : [ "001xx000003DWsT" ]
5}, {
6"key" : "005",
7"label" : "Users",
8"recordIds" : [ "005xx000001Svqw", "005xx000001SvwK", "005xx000001SvwA" ]
9} ]

Example usage for comparing the user’s current list of relevant records to a previous version

/v35.0/sobjects/relevantItems?lastUpdatedId=08ses9Fjkjs8sNFO28423q

Example request body

None required

Example response body

1[  lastUpdatedId: 08ses9Fjkjs8sNFO28423r
2newResultSetSinceLastQuery: true
3   {
4"key" : "003",
5"label" : "Contacts",
6"recordIds" : [ "003xx000004TxBA" ]
7}, {
8"key" : "001",
9"label" : "Accounts",
10"recordIds" : [ "001xx000003DWsT" ]
11}, {
12"key" : "005",
13"label" : "Users",
14"recordIds" : [ "005xx000001Svqw", "005xx000001SvwA" ]
15} ]

Force.com REST API Developer Guide

View Relevant Items