Connect REST API Developer Guide

Connect REST API Developer Guide
Introduction
Quick Start
Work with Features
Examples
Resources
Request Bodies
Action Link Definition Input
Action Link Group Definition Input
Action Link Input
Action Link Template Binding Input
Activity Reminder Input
Address Input
Adjust Item Input
Adjust Order Item Summary Input
Alternative Input
Announcement Input
Article Topic Assignment Job Input
Asset File Input
Assigned Resource Input
Associated Actions Capability Input
Async Query Input
Audience Criterion Input
Audience Criterion Value Input
Audience Input
Available Territory Slots Input
Authorization API Payment Method Input
Authorization Input
Banner Photo Input
Batch Collection Input
Batch Input
Bookmarks Capability Input
Card Payment Method Input
Canvas Capability Input
Capture Input
Cart Input
Cart Item Input
Change Input
Change Item Input
Chatter Stream Input
Clean Input
Close Capability Input
Comment Input
Comment Capabilities Input
Community Input
Connectors Call Input
Connectors Call List Input
Content Capability Input
Create Credit Memo Input
Create Order Payment Summary Input
Custom List Audience Criteria Input
Custom Recommendation Audience Input
Custom Recommendation Definition Input
Datacloud Contact Import Input
Datacloud Order Input
Dashboard Component Snapshot Input
Digest Job Input
Direct Message Capability Input
Distinct Value Refinement Input
Duplicate Job Input
Duplicate Job Status Input
Ensure Funds Async Input
Ensure Refunds Async Input
Environment Hub SSO User Mapping Input
Extended Fields Input
Extension Input
Extensions Capability Input
Facetable Attribute Input
Facetable Attributes Collection Input
Feed Element Capabilities Input
Feed Entity Share Capability Input
Feed Favorite Input
Feed Item Input
Feed Item Topic Input
File Input
File ID Input
Files Capability Input
File Shares Input
Files Connect Field Value Input
Files Connect Item Input
Files Connect Permission Collection Input
Files Connect Permission Input
Folder Input
Folder Item Input
Following Input
Fulfillment Group Input
Fulfillment Order Input
Fulfillment Order Invoice Input
Fulfillment Order Line Item Input
Fulfillment Order Line Items To Cancel Input
Generic Batch Collection Input
Generic Batch Input
Group Chatter Settings Input
Group Information Input
Group Input
Group Member Input
Group Membership Request Update
Group Record Input
Invite Collection Input
Knowledge Article View Stat Input
Lead Input
Link Capability Input
List Current Share Collection Input
Managed Content Type Searchable Input
Managed Social Account Setup Input
Managed Topic Input
Managed Topic Position Collection Input
Managed Topic Position Input
Message Body Input
Message Segment Input: Entity Link
Message Segment Input: Hash Tag
Message Segment Input: Inline Image
Message Segment Input: Link
Message Segment Input: Markup Begin
Message Segment Input: Markup End
Message Segment Input: Mention
Message Segment Input: Text
Messaging Channel Input
Moderation Flag Input
Mute Capability Input
New User Audience Criteria Input
Next Best Action Strategy Input
Notification App Setting Input
Notification Collection Input
Notification Input
Notification Member Input
Notification Setting Input
Order Item Summary Input
Order Summary Input
Payment Group Input
Payment Method Input
Photo Input
Pin Capability Input
Poll Capability Input
Pricing Input
Pricing Line Item Input
Product Search Input
Push Notification Input
Question and Answers Capability Input
Read By Capability Input
Recommendation Reaction Input
Record Capability Input
Referenced Refund Input
Request Header Input
Scheduled Custom Recommendation Input
Searchable Attribute Input
Searchable Attributes Collection Input
Search Product Setting Collection Input
Search Product Setting Input
Service Appointment Input
Service Appointments Input
Share Captured Activity Input
Share Input
Skill Requirement Input
Social Customer Service Configuration Input
Social Customer Service Message Type Settings Input
Social Customer Service Provider Settings Input
Social Post Mass Approval Input
Status Capability Input
Stream Subscription Input
Target Collection Input
Target Collection Update Input
Target Input
Target Update Input
Topic Assignment Input
Topic Endorsement Input
Topic Input
Topic Names Input
Topics Capability Input
Up Down Vote Capability Input
User Chatter Settings Input
User ID Collection Input
User Input
User Message
User Message Recipient Input
User Message Recipient List Input
User Mission Activity Input
User Status Input
User Stream (Conversation) Input
Verified Capability Input
Wishlist Input
Wishlist Item Input
Work Type Input
Response Bodies
Appendices
PDF

Newer Version Available

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

Generic Batch Collection Input

Root XML Tag
<batch>
JSON
1{
2   "batchRequests" : [
3    {
4       "method" : "Get",
5       "url" : "/v49.0/chatter/feeds/news/me"
6    },
7    {
8       "method" : "Get",
9       "url" : "/v49.0/chatter/feeds/user-profile/me"
10    }
11   ]
12}
Properties
Name Type Description Available Version
batchRequests Generic Batch Input[] Collection of Batch Request Input request bodies containing the subrequest URLs to execute. 28.0
haltOnError Boolean Controls whether Salesforce stops processing subrequests if a subrequest fails. The default value is false.

If the value is false and a subrequest in the batch does not complete, Salesforce attempts to execute subsequent subrequests in the batch.

If the value is true and a subrequest in the batch doesn’t complete due to an HTTP response in the 400 or 500 range, Salesforce halts execution. It doesn’t attempt to execute subsequent subrequests in the batch. It returns an HTTP 412 status code and a BATCH_PROCESSING_HALTED error message for each subsequent subrequest indicating that a previous request was unsuccessful. The top-level request to /connect/batch returns HTTP 200, and the hasErrors property in the response is set to true.

Before subrequests are executed, Salesforce verifies that the entire request, including subrequests, is formed properly. If it isn't, Salesforce returns an HTTP 400 Bad Request and doesn't execute subrequests, regardless of the value of haltOnError. Examples of a bad request are a subrequest using the wrong method or having an error in its URL.

Note

 28.0