REST API

REST API includes changed resources and new resources for record counts, flows, and platform schema events.

New Resource: Record Count

Retrieve record counts for objects with this new REST API resource.
Record Count
/vXX.X/limits/recordCount?sObjects=Object List
Lists information about object record counts in your organization. Returns record counts for the comma-delimited list of object names provided for the sObjects parameter. If sObjects is not provided, the resource returns a list of record counts for all objects in the org.
Example: Retrieving record counts for Account and Contact
Example request
/services/data/v40.0/limits/recordCount?sObjects=Account,Contact
Example response body
{
   "sobjects" : [ {
     "count" : 3,
     "name" : "Account"
   }, {
     "count" : 10,
     "name" : "Contact"
   } ]
}

New Resources: Flows and Flow Interviews (Pilot)

Have you ever wanted to build your own flow runtime experience? Here’s your chance. We’re providing two resources to describe flows and three resources to describe and manipulate interviews. If you’re an existing pilot customer, nothing has changed since the last release.
Note

Note

We provide Flow Runtime REST API to selected customers through a pilot program that requires agreement to specific terms and conditions. To be nominated to participate in the program, contact Salesforce. Pilot programs are subject to change, and we can’t guarantee acceptance. Flow Runtime REST API isn’t generally available unless or until Salesforce announces its general availability in documentation or in press releases or public statements. 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. You can provide feedback and suggestions for Flow Runtime REST API in the IdeaExchange.

Flows
Lists active flow definitions in your org.
/vXX.X/process/flows
Specific Flow
Lists summary information about a specific flow.
/vXX.X/process/flows/FlowName
Paused Interviews
Lists paused interviews that the running user can resume.
/vXX.X/process/interviews
New Interview
Starts a flow interview.
/vXX.X/process/interviews/FlowName
Specific Interview
Continues, pauses, or finishes an in-progress interview, or resumes a paused interview.
/vXX.X/process/interviews/FlowName/guid

Changed Resource: Search Suggested Records

Use the useSearchScope parameter to get suggested records from the user’s search scope, which contains the user’s most frequently used objects. Provide users with more relevant results without listing the objects for each request.

This example gets suggested records from a user’s search scope for the search term Acme.

.../search/suggestions?q=Acme&useSearchScope=true

New Resources for Platform Event Schema

Use the event schema resources to obtain the schema of a platform event and determine if the schema changed.
Platform Event Schema by Event Name
/vXX.X/sobjects/Platform_Event_Name__e/eventSchema
Gets the definition of a platform event in JSON format for a given event name.
For an example, see Platform Event Schema by Event Name in the Force.com REST API Developer Guide.
Platform Event Schema by Schema ID
/vXX.X/event/eventSchema/Schema_ID
Gets the definition of a platform event in JSON format for a given schema ID.
For an example, see Platform Event Schema by Schema ID in the Force.com REST API Developer Guide.

Changed Header: Assignment Rule

The AssignmentRule header is now applied to Accounts, in addition to Cases and Leads, when Sforce-Auto-Assign is TRUE.