Tooling API

Introducing Tooling API
When to Use Tooling API
Release Notes
REST Overview
REST Resources
REST Resource Examples
REST Headers
REST Header Examples
Improve Performance with the Composite Resource
Group Operations for Fewer Round Trips with SObject Collections
Create Multiple Records with Fewer Round-Trips
Retrieve Multiple Records with Fewer Round-Trips
Update Multiple Records with Fewer Round-Trips
Delete Multiple Records with Fewer Round-Trips
API End-of-Life Policy
SOAP Calls
Tooling API Objects and Namespaces
Tooling API Objects
SOAP Headers for Tooling API
REST Headers for Tooling API
PDF

Newer Version Available

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

Create Multiple Records with Fewer Round-Trips

Use a POST request with sObject Collections to add multiple records, returning a list of SaveResult objects. You can choose whether to roll back the entire request when an error occurs.

Where possible, we changed noninclusive terms to align with our company value of Equality. Because changing terms in our code can break current implementations, we maintained this object’s name.

Important

Request Syntax

POST /vXX.X/composite/sobjects

Parameters

Parameter Description
allOrNone Optional. Indicates whether to roll back the entire request when the creation of any object fails (true) or to continue with the independent creation of other objects in the request. The default is false.
records Required. A list of sObjects. In a POST request using sObject Collections, set the type attribute for each object, but don’t set the id field for any object.

Usage Guidelines

  • The maximum number of objects in the list can be different for each Tooling API object.
  • The list can contain objects of different types, including custom objects.
  • Each object must contain an attributes map. The map must contain a value for type.
  • Objects are created in the order they’re listed. The SaveResult objects are returned in the order in which the create requests were specified.
  • If the request body includes objects of more than one type, they’re processed as chunks. For example, if the incoming objects are {account1, account2, contact1, account3}, the request is processed in three chunks: {{account1, account2}, {contact1}, {account3}}. A single request can process up to 10 chunks.
  • Although SObject Collections is also supported in SOAP API, you can’t use SOAP API objects in a Tooling API SObject Collections call.

Checking for Errors

  • If the request isn’t well formed, the API returns a 400 Bad Request HTTP Status. Fix the syntax of the request and try again.
  • If the request is well formed, the API returns a 200 OK HTTP Status. If an item was processed successfully, the success flag shows for that item. Error information is returned in the errors array.