Version 1.0
Connector Overview: This page documents all 76 actions for the Salesforcecrmconnector v1.0.
Actions (4)
GET Custom Invocable Actions
/data/v{version}/actions/custom
Returns the list of all custom actions. You can also get basic information for each type of action.
This resource is available in REST API version 32.0 and later.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the content type of the request; expected value is "application/json". |
|
|
Specify the API version number to use for the request, for example "58.0". |
|
|
The response format expected from the API (e.g. application/json). |
POST Launch Flow
/data/v{version}/actions/custom/flow/{flowApiName}
Launches an Autolaunched Flow with the supplied input parameters.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Flow API Name |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
Options (1)
|
Option Name |
Description |
|---|---|
|
|
Provide the input parameters for the flow as a JSON string; each input variable name maps to its value. |
GET Quick Actions
/data/v{version}/quickActions
Returns a list of global actions and object-specific actions. This resource is available in REST API version 28.0 and later. When working with actions, also refer to SObject Quick Actions.
https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/resources_quickactions.htm
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the content type of the request; expected value is "application/json". |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
GET Standard Invocable Actions
/data/v{version}/actions/standard
Returns the list of actions that can be statically invoked. You can also get basic information for each type of action.
This resource is available in REST API version 32.0 and later.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the content type of the request; expected value is "application/json". |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
Business Rules Engine Invocable Actions (2)
POST runDecisionMatrix
/data/v{version}/actions/custom/runDecisionMatrix/{UniqueName}
Decision Matrix Actions
Invoke a decision matrix in a flow with the Decision Matrix Actions. A decision matrix is a user-defined table where you can look up an output based on the inputs you provide.
For example, you can look up a candidate’s eligibility to avail medical insurance in a decision matrix based on the candidate’s age and gender.
These actions are available in API version 55.0 and later.
Supported REST HTTP Methods
URI/services/data/v55.0/actions/custom/runDecisionMatrix/{UniqueName}
Note
The value of UniqueName is the unique identifier of the record, which is sourced from the name of a decision matrix.
FormatsJSONHTTP MethodsPOSTAuthenticationAuthorization: Bearer token
Inputs
Vary depending on the selected decision matrix.
Outputs
Vary depending on the inputs of the selected decision matrix.
Usage
Sample Request
Here’s an example POST request that has the inputs, such as, age and state:
{
"inputs":[
{
"age":"25",
"state":"NY"
},
{
"age":"25",
"state":"CA"
},
{
"age":"",
"state":"WA"
}
]
}
```
Sample Response
Here’s an example response that has the premium and tax values based on the inputs provided in the example request.
[
{
"actionName":"premiumTaxLookup",
"errors":null,
"isSuccess":true,
"outputValues":{
"premium":2400.0,
"tax":200.0
}
},
{
"actionName":"premiumTaxLookup",
"errors":null,
"isSuccess":true,
"outputValues":{
"premium":2400.0,
"tax":200.0
}
},
{
"actionName":"premiumTaxLookup",
"errors":[
{
"statusCode":"REQUIRED_FIELD_MISSING",
"message":"Missing required input parameter: age",
"fields":[
]
}
],
"isSuccess":false,
"outputValues":null
}
]
```
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The value of UniqueName is the unique identifier of the record, which is sourced from the name of a decision matrix. |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
POST runExpressionSet
/data/v{version}/actions/custom/runExpressionSet/{expressionSetAPIName}
Expression Set Actions
Invoke an active expression set. An expression set is a user-defined rule that accepts an input and returns the output based on the configured function.
The configured function of an expression set can be a simple decision matrix lookup, a calculation based on a mathematical formula, a condition, or another expression set.
These actions are available in API version 55.0 and later.
Supported REST HTTP Methods
URI/services/data/v55.0/actions/custom/runExpressionSet/{ApiName}
> Note
> The API name of an expression set is unique within your Salesforce instance.
Formats
JSON
HTTP Methods
POST
Authentication
Authorization: Bearer token
Inputs
Vary depending on the selected expression set.
Outputs
Vary depending on the inputs of the selected expression set.
Usage
This section has the sample request and response for invoking an expression set that does the following:
1. Find the tax percentage and the premium corresponding to specific age and salary using a decision matrix lookup.
2. Check the age criterion to calculate the total tax.
3. Calculate the total tax to be paid based on the age group, salary, and the tax percentage.
Sample request
Here’s an example POST request that has the inputs, such as, age and salary:
{
"inputs":[
{
"Age":"25.00",
"Salary":"50000.00"
}
]
}
```
Sample response
Here’s an example response that has the premium and tax values based on the inputs provided in the example request:
[
{
"actionName":"TaxPremiumES",
"errors":null,
"isSuccess":true,
"outputValues":{
"TaxPremium__Premium":1000,
"TaxPremium__Tax":10,
"TaxToBePaid":1050,
"condition_output__2":"false",
"condition_output__1":"true"
}
}
]
```
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The API name of an expression set is unique within your Salesforce instance. |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
Options (1)
|
Option Name |
Description |
|---|---|
|
|
Provide the input parameters for the expression set as a JSON string; each input variable maps to its value. |
Download
GET Download Asset
x-oneteg-downloader-path-with-authorization
Download a specified asset using the provided URL and configuration. Use this to retrieve a file or asset from an external source.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Specify the HTTP method to use for the download request, such as "GET" or "POST". |
|
|
Provide the URL from which the asset should be downloaded. |
|
|
Specify the name to assign to the downloaded asset. |
|
|
Set the number of retry attempts if the download fails, as a string. |
|
|
Specify the maximum time in seconds to wait for data to be read. |
|
|
Specify the maximum time in seconds to establish a connection. |
|
|
This toggle enables you to load file content as the step output. Supported formats include JSON, XML, YML/YAML, CSV, TXT, and other text-based file types. Note that images, PDF files, and other binary formats cannot be loaded. Additionally, there is a file size limit for this feature; please check the logs for details. |
|
|
Enable or disable following URL redirects. If it is enabled, it will follow the URL redirects. |
|
|
Additional HTTP header name/value pairs to include in the request. |
Lightning Metrics (5)
GET Lightning Exit by Page Metrics
/data/v{version}/sobjects/LightningExitByPageMetrics
Return frequency metrics about the standard pages within which users switched from Lightning Experience to Salesforce Classic.
https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/resources_lightning_exitbypagemetrics.htm
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the content type of the request; expected value is "application/json". |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
GET Lightning Toggle Metrics
/data/v{version}/sobjects/LightningToggleMetrics
Return details about users who switched between Salesforce Classic and Lightning Experience.
https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/resources_lightning_togglemetrics.htm
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the content type of the request; expected value is "application/json". |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
GET Lightning Usage by App Type
/data/v{version}/sobjects/LightningUsageByAppTypeMetrics
Return the total number of Lightning Experience and Salesforce Mobile users.
https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/resources_lightning_usagebyapptypemetrics.htm
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the content type of the request; expected value is "application/json". |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
GET Lightning Usage by FlexiPage
/data/v{version}/sobjects/LightningUsageByFlexiPageMetrics
Return details about the custom pages viewed most frequently in Lightning Experience.
https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/resources_lightning_usagebyflexipagemetrics.htm
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the content type of the request; expected value is "application/json". |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
GET Lightning Usage by Page
/data/v{version}/sobjects/LightningUsageByBrowserMetrics
Represents standard pages users viewed most frequently in Lightning Experience.
https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/resources_lightning_usagebypagemetrics.htm
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the content type of the request; expected value is "application/json". |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
List Views (4)
GET List View Describe
/data/v{version}/sobjects/{SOBJECT_API_NAME}/listviews/{QUERY_LOCATOR}/describe
Returns detailed information about a list view, including the ID, the columns, and the SOQL query.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the API name of the sObject that the list view belongs to. |
|
|
Provide the query locator that identifies the list view to describe. |
|
|
Specify the content type of the request; expected value is "application/json". |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
GET List View Results
/data/v{version}/sobjects/{SOBJECT_API_NAME}/listviews/{LIST_VIEW_ID}/results
Returns detailed information about a list view, including the ID, the columns, and the SOQL query.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the API name of the sObject that the list view belongs to. |
|
|
Provide the ID of the list view whose results are to be retrieved. |
|
|
Specify the content type of the request; expected value is "application/json". |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
GET List Views
/data/v{version}/sobjects/{SOBJECT_API_NAME}/listviews
Returns the list of list views for the specified sObject, including the ID and other basic information about each list view. You can also get basic information for a specific list view by ID.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the API name of the sObject to retrieve list views for. |
|
|
Specify the content type of the request; expected value is "application/json". |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
GET Recently Viewed Items
/data/v{version}/sobjects/{SOBJECT_API_NAME}/listviews/recent
Gets the most recently accessed items that were viewed or referenced by the current user. Salesforce stores information about record views in the interface and uses it to generate a list of recently viewed and referenced records, such as in the sidebar and for the auto-complete options in search.
This resource only accesses most recently used item information. If you want to modify the list of recently viewed items, you’ll need to update recently viewed information directly by using a SOQL Query with a FOR VIEW or FOR REFERENCE clause.
https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/resources_recent_items.htm
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the maximum number of recently viewed items to return. |
|
|
Specify the API name of the sObject to retrieve list views for. |
|
|
Specify the content type of the request; expected value is "application/json". |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
Logs
GET Get event log file
/data/v{version}/sobjects/EventLogFile/{id}/LogFile
Download the log file content for a specific event log file record. Use this to retrieve detailed event monitoring data in CSV format.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Log event Id |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
OpenAPI Schema (Beta) (2)
POST Request OpenAPI Schema
/data/v{version}/async/specifications/oas3
Requests an Open API document for the selected SObject REST API resources.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
Options (1)
|
Option Name |
Description |
|---|---|
|
|
Provide a JSON object containing schema generation options, such as version or API category. |
GET Retrieve OpenAPI Schema
/data/v{version}/async/specifications/oas3/{schemaId}
Generate an OpenAPI 3.0 document for the sObjects REST API. This is a Beta feature that requires an activation step before it can be used.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Identifier that was returned in the original request to generate the Schema. |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
Processes (3)
GET Process Approvals
/data/v{version}/process/approvals
Returns a list of all approval processes. Can also be used to submit a particular record if that entity supports an approval process and one has already been defined. Records can be approved and rejected if the current user is an assigned approver. When using a POST request to do bulk approvals, the requests that succeed are committed and the requests that don’t succeed send back an error.
https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/resources_process_approvals.htm
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the content type of the request; expected value is "application/json". |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
POST Process Approvals Submit
/data/v{version}/process/approvals
Returns a list of all approval processes. Can also be used to submit a particular record if that entity supports an approval process and one has already been defined. Records can be approved and rejected if the current user is an assigned approver. When using a POST request to do bulk approvals, the requests that succeed are committed and the requests that don’t succeed send back an error.
https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/resources_process_approvals.htm
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
Options (7)
|
Option Name |
Description |
|---|---|
|
|
Specify the type of approval action, such as 'Submit' or 'Approve'. |
|
|
Provide the ID of the user who is performing the approval action. |
|
|
Specify the ID of the record being submitted for approval. |
|
|
Include any comments to accompany the approval submission. |
|
|
List the IDs of the next approvers in the approval chain. |
|
|
Provide the name or ID of the approval process definition to use. |
|
|
Indicate whether to skip entry criteria for the approval process (true or false). |
GET Process Rules
/data/v{version}/process/rules
Returns a list of all active workflow rules. If a rule has actions, the actions will be listed under the rule. Can also be used to trigger all workflow rules that are associated with a specified record. The actions for a rule are only fired if the rule’s criteria is met. When using a POST request, if anything fails, the whole transaction is rolled back.
Cross-object workflow rules cannot be invoked using the REST API.
To get a list of the workflow rules or to trigger one or more workflow rules, the URI is: /vXX.X/process/rules/
To get the rules for a particular object: /vXX.X/process/rules/SObjectName
To get the metadata for a particular rule: /vXX.X/process/rules/SObjectName/workflowRuleId
https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/resources_process_rules.htm
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the content type of the request; expected value is "application/json". |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
REST Copy (11)
GET Apex REST
/apexrest/{urlMapping}
Gets the list of icons and colors used by themes in the Salesforce application. Theme information is provided for objects in your organization that use icons and colors in the Salesforce UI.
The If-Modified-Since header can be used with this resource, with a date format of EEE, dd MMM yyyy HH:mm:ss z. When this header is used, if the object metadata has not changed since the provided date, a 304 Not Modified status code is returned, with no response body.
https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/resources_themes.htm
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Value of urlMapping as defined in @RestResource annotation in the Apex class. |
|
|
Specify the content type of the request; expected value is "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
GET AppMenu
/data/v{version}/appMenu
Returns a list of items in either the Salesforce app drop-down menu or the Salesforce for Android, iOS, and mobile web navigation menu.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the content type of the request; expected value is "application/json". |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
GET Consent
/data/v{version}/consent/action/action
Your users can store consent preferences in different locations and possibly inconsistently. You can locate your customers’ preferences for consent across multiple records when using API version 44.0 and later. Tracking consent preferences helps you and your users respect the most restrictive requests.
Consent API aggregates consent settings across the Contact, Contact Point Type Consent, Data Use Purpose, Individual, Lead, Person Account, and User objects when the records have a lookup relationship. The Consent API can't locate records in which the email address field is protected by Platform Encryption.
The API returns consent details based on a single action, like email or track, or—starting with API version 45.0—the multiaction endpoint allows you to request multiple actions in a single API call.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify a comma-separated list of consent action types to filter results. |
|
|
Provide a comma-separated list of record IDs to retrieve consent data for. |
|
|
Specify the content type of the request; expected value is "application/json". |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
GET Limits
/data/v{version}/limits
Lists information about limits in your org. For each limit, this resource returns the maximum allocation and the remaining allocation based on usage. This resource is available in REST API version 29.0 and later for API users with the View Setup and Configuration permission
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
GET Product Schedules
/data/v{version}/sobjects/OpportunityLineItem/{OPPORTUNITY_LINE_ITEM_ID}/OpportunityLineItemSchedules
Work with revenue and quantity schedules for opportunity products. Establish or reestablish a product schedule with multiple installments for an opportunity product. Delete all installments in a schedule.
This resource is available in REST API version 43.0 and later.
In API version 46.0 and later, established and re-established schedules support custom fields, validation rules, and Apex triggers. Deleting all schedules now also fires delete triggers.
https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/resources_opportunitylineitemschedules.htm
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the ID of the opportunity line item whose schedules are to be retrieved. |
|
|
Specify the content type of the request; expected value is "application/json". |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
GET QueryAll
/data/v{version}/queryAll
Executes the specified SOQL query. Unlike the Query resource, QueryAll will return records that have been deleted because of a merge or delete. QueryAll will also return information about archived Task and Event records. QueryAll is available in API version 29.0 and later.
If the query results are too large, the response contains the first batch of results and a query identifier in the nextRecordsUrl field of the response. The identifier can be used in an additional request to retrieve the next batch. Note that even though nextRecordsUrl has query in the URL, it will still provide remaining results from the initial QueryAll request. The remaining results will include deleted records that matched the initial query.
https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/resources_queryall.htm
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Provide a SOQL query string to execute, including the SELECT and FROM clauses. |
|
|
Specify the content type of the request; expected value is "application/json". |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
GET Record Count
/data/v{version}/limits/recordCount
Lists information about object record counts in your organization.
This resource is available in REST API version 40.0 and later for API users with the “View Setup and Configuration” permission. The returned record count is approximate, and does not include the following types of records:
Deleted records in the recycle bin.
Archived records.
https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/resources_record_count.htm
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
A comma-delimited list of object names. If a listed object is not found in the org, it is ignored and not returned in the response.
|
|
|
Specify the content type of the request; expected value is "application/json". |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
GET Resources by Version
/data/v{version}
Lists available resources for the specified API version, including resource name and URI.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the content type of the request; expected value is "application/json". |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
GET Tabs
/data/v{version}/tabs
f a survey field can be translated or is already translated into a particular language, you can add or change the translated value of the survey field.
https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/request_survey_translate_add_change.htm
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the content type of the request; expected value is "application/json". |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
GET Themes
/data/v{version}/theme
Gets the list of icons and colors used by themes in the Salesforce application. Theme information is provided for objects in your organization that use icons and colors in the Salesforce UI.
The If-Modified-Since header can be used with this resource, with a date format of EEE, dd MMM yyyy HH:mm:ss z. When this header is used, if the object metadata has not changed since the provided date, a 304 Not Modified status code is returned, with no response body.
https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/resources_themes.htm
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the content type of the request; expected value is "application/json". |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
GET Versions
/data
Lists summary information about each Salesforce version currently available, including the version, label, and a link to each version's root.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the content type of the request; expected value is "application/json". |
|
|
Specify client call options, such as the default namespace, to control the behavior of API calls. |
|
|
The response format expected from the API (e.g. application/json). |
Rest
GET Query
/data/v{version}/query
Executes the specified SOQL query.
If the query results are too large, the response contains the first batch of results and a query identifier in the nextRecordsUrl field of the response. The identifier can be used in an additional request to retrieve the next batch.
https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/resources_query.htm
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Gets the first 200 EventLogFile records ordered by most recently updated first. |
|
|
Specify the content type of the request; expected value is "application/json". |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
SObject (26)
GET Compact Layouts
/data/v{version}/compactLayouts
Returns a list of compact layouts for multiple objects. This resource is available in REST API version 31.0 and later.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
object list |
|
|
Specify the content type of the request; expected value is "application/json". |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
GET Describe Global
/data/v{version}/sobjects
Lists the available objects and their metadata for your organization’s data. In addition, it provides the organization encoding, as well as the maximum batch size permitted in queries.
You can use the If-Modified-Since header with this resource, with the date format EEE, dd MMM yyyy HH:mm:ss z. When using this header, if no available object’s metadata has changed since the provided date, a 304 Not Modified status code is returned with no response body.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the content type of the request; expected value is "application/json". |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
GET Describe Global Layouts
/data/v{version}/sobjects/Global/describe/layouts
Returns a list of layouts and descriptions. The list of fields and the layout name are returned.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the content type of the request; expected value is "application/json". |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
GET Describe SObject Layouts
/data/v{version}/sobjects/{SOBJECT_API_NAME}/describe/layouts
Returns a list of layouts and descriptions. The list of fields and the layout name are returned.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the API name of the sObject to retrieve list views for. |
|
|
Specify the content type of the request; expected value is "application/json". |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
GET Describe SObject Layouts Per Record Type
/data/v{version}/sobjects/{SOBJECT_API_NAME}/describe/layouts/{RECORD_TYPE_ID}
Returns a list of layouts and descriptions. The list of fields and the layout name are returned.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the API name of the sObject to retrieve list views for. |
|
|
The ID of the record type whose layout you want to describe. If omitted, layouts for all record types are returned. |
|
|
Specify the content type of the request; expected value is "application/json". |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
GET Download file
/data/v{version}/sobjects/ContentVersion/{content_version_id}/VersionData
Lists the available objects and their metadata for your organization’s data. In addition, it provides the organization encoding, as well as the maximum batch size permitted in queries.
You can use the If-Modified-Since header with this resource, with the date format EEE, dd MMM yyyy HH:mm:ss z. When using this header, if no available object’s metadata has changed since the provided date, a 304 Not Modified status code is returned with no response body.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the content type of the request; expected value is "application/json". |
|
|
Specify the API version number to use for the request. |
|
|
The ID of the ContentVersion record whose file data you want to download. |
|
|
The response format expected from the API (e.g. application/json). |
GET SObject ApprovalLayouts
/data/v{version}/sobjects/{SOBJECT_API_NAME}/describe/approvalLayouts/{APPROVAL_PROCESS_NAME}
Returns a list of approval layouts for a specified object. Specify a particular approval process name to limit the return value to one specific approval layout. This resource is available in REST API version 30.0 and later.
approvalProcessName parameter is optional
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the API name of the sObject to retrieve list views for. |
|
|
The name of the approval process for which to retrieve the layout. If omitted, layouts for all approval processes are returned. |
|
|
Specify the content type of the request; expected value is "application/json". |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
GET SObject Basic Information
/data/v{version}/sobjects/{SOBJECT_API_NAME}
Describes the individual metadata for the specified object. Can also be used to create a new record for a given object. For example, this can be used to retrieve the metadata for the Account object using the GET method, or create a new Account object using the POST method.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the API name of the sObject to retrieve list views for. |
|
|
Specify the content type of the request; expected value is "application/json". |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
GET SObject Blob Retrieve
/data/v{version}/sobjects/{SOBJECT_API_NAME}/{RECORD_ID}/{BLOB_FIELD}
Retrieves the specified blob field from an individual record.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the API name of the sObject to retrieve list views for. |
|
|
The ID of the record containing the blob field. |
|
|
The API name of the blob field whose data you want to retrieve. |
|
|
Specify the content type of the request; expected value is "application/json". |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
GET SObject CompactLayouts
/data/v{version}/sobjects/{SOBJECT_API_NAME}/describe/describe/compactLayouts
Returns a list of compact layouts for a specific object. This resource is available in REST API version 29.0 and later.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the API name of the sObject to retrieve list views for. |
|
|
Specify the content type of the request; expected value is "application/json". |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
POST SObject Create
/data/v{version}/sobjects/{SOBJECT_API_NAME}
Creates a new record of the specified SObject type. Use this action to insert a new record into Salesforce.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the API name of the sObject to retrieve list views for. |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
Options (1)
|
Option Name |
Description |
|---|---|
|
|
The name of the record to create, if the SObject type supports a Name field. Provide a string value. |
GET SObject Describe
/data/v{version}/sobjects/{SOBJECT_API_NAME}/describe
Describes the individual metadata for the specified object. Can also be used to create a new record for a given object. For example, this can be used to retrieve the metadata for the Account object using the GET method, or create a new Account object using the POST method.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Object API name |
|
|
Specify the content type of the request; expected value is "application/json". |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
GET SObject Get Deleted
/data/v{version}/sobjects/{SOBJECT_API_NAME}/deleted
Retrieves the list of individual records that have been deleted within the given timespan for the specified object. SObject Get Deleted is available in API version 29.0 and later.
This resource is commonly used in data replication applications. Note the following considerations:
Deleted records are written to a delete log which this resource accesses. A background process that runs every two hours purges records that have been in an organization's delete log for more than two hours if the number of records is above a certain limit. Starting with the oldest records, the process purges delete log entries until the delete log is back below the limit. This is done to protect Salesforce from performance issues related to massive delete logs
Information on deleted records are returned only if the current session user has access to them.
Results are returned for no more than 15 days previous to the day the call is executed (or earlier if an administrator has purged the Recycle Bin).
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The start of the time range in ISO 8601 format to check for deleted records. Required for the query. |
|
|
The end of the time range in ISO 8601 format to check for deleted records. Required for the query. |
|
|
Specify the API name of the sObject to retrieve list views for. |
|
|
Specify the content type of the request; expected value is "application/json". |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
GET SObject Get Updated
/data/v{version}/sobjects/{SOBJECT_API_NAME}/updated
Retrieves the list of individual records that have been updated (added or changed) within the given timespan for the specified object. SObject Get Updated is available in API version 29.0 and later.
This resource is commonly used in data replication applications. Note the following considerations:
Results are returned for no more than 30 days previous to the day the call is executed.
Your client application can replicate any objects to which it has sufficient permissions. For example, to replicate all data for your organization, your client application must be logged in with “View All Data” access rights to the specified object. Similarly, the objects must be within your sharing rules.
There is a limit of 600,000 IDs returned from this resource. If more than 600,000 IDs would be returned, EXCEEDED_ID_LIMIT is returned. You can correct the error by choosing start and end dates that are closer together.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The start of the time range in ISO 8601 format to check for updated records. |
|
|
The end of the time range in ISO 8601 format to check for updated records. |
|
|
Specify the API name of the sObject to retrieve list views for. |
|
|
Specify the content type of the request; expected value is "application/json". |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
GET SObject Named Layouts
/data/v{version}/sobjects/{SOBJECT_API_NAME}/describe/namedLayouts/{LAYOUT_NAME}
Retrieves information about alternate named layouts for a given object.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the API name of the sObject to retrieve list views for. |
|
|
The name of the layout to describe. Provide the layout name as a string. |
|
|
Specify the content type of the request; expected value is "application/json". |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
GET SObject PlatformAction
/data/v{version}/sobjects/PlatformAction
PlatformAction is a virtual read-only object. It enables you to query for actions displayed in the UI, given a user, a context, device format, and a record ID. Examples include standard and custom buttons, quick actions, and productivity actions.
Returns the description of the PlatformAction.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the content type of the request; expected value is "application/json". |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
GET SObject Quick Actions
/data/v{version}/sobjects/{SOBJECT_API_NAME}/quickActions
Returns a list of actions and their details. This resource is available in REST API version 28.0 and later. When working with actions, also refer to Quick Actions.
To return a specific object’s actions as well as global actions, use: /vXX.X/sobjects/object/quickActions/
To return a specific action, use /vXX.X/sobjects/object/quickActions/{action name}
To return a specific action’s descriptive detail, use /vXX.X/sobjects/object/quickActions/{action name}/describe/
To return a specific action’s default values, including default field values, use services/data/vXX.X/sobjects/object/quickActions/{action name}/defaultValues/
In API version 28.0, to evaluate the default values for an action, use vXX.X/sobjects/object/quickActions/{action name}/defaultValues/{parent id}
In API version 29.0 and greater, to evaluate the default values for an action, use vXX.X/sobjects/object/quickActions/{action name}/defaultValues/{context id}
This returns the default values specific to the {context id} object.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the API name of the sObject to retrieve list views for. |
|
|
Specify the content type of the request; expected value is "application/json". |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
GET SObject Relationships
/data/v{version}/sobjects/{SOBJECT_API_NAME}/{RECORD_ID}/{RELATIONSHIP_FIELD_NAME}
Accesses records by traversing object relationships via friendly URLs. You can retrieve, update, or delete the record associated with the traversed relationship field. If there are multiple related records, you can retrieve the complete set of associated records. This resource is available in REST API version 36.0 and later.
GET, PATCH, DELETE
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the API name of the sObject to retrieve list views for. |
|
|
The ID of the record containing the blob field. |
|
|
The API name of the relationship field to traverse. Provide the field name as a string. |
|
|
Specify the content type of the request; expected value is "application/json". |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
GET SObject Rich Text Image Retrieve
/data/v{version}/sobjects/{SOBJECT_API_NAME}/{RECORD_ID}/richTextImageFields/{FIELD_NAME}/{CONTENT_REFERENCE_ID}
Retrieves the specified image data from a specific rich text area field in a given record.
contentReferenceId The reference ID that uniquely identifies an image within a rich text area field.
You can obtain the reference by retrieving information for the object. The description will show the contents of the rich text area field
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the API name of the sObject to retrieve list views for. |
|
|
The ID of the record containing the blob field. |
|
|
The API name of the rich text image field. Provide the field name as a string. |
|
|
The unique identifier for the content reference of the image. Provide the reference ID as a string. |
|
|
Specify the content type of the request; expected value is "application/json". |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
GET SObject Rows
/data/v{version}/sobjects/{SOBJECT_API_NAME}/{RECORD_ID}
Accesses records based on the specified object ID. Retrieves, updates, or deletes records. This resource can also be used to retrieve field values. Use the GET method to retrieve records or fields, the DELETE method to delete records, and the PATCH method to update records.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the API name of the sObject to retrieve list views for. |
|
|
The ID of the record containing the blob field. |
|
|
Specify the content type of the request; expected value is "application/json". |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
DELETE SObject Rows Delete
/data/v{version}/sobjects/{SOBJECT_API_NAME}/{RECORD_ID}
Accesses records based on the specified object ID. Retrieves, updates, or deletes records. This resource can also be used to retrieve field values. Use the GET method to retrieve records or fields, the DELETE method to delete records, and the PATCH method to update records.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the API name of the sObject to retrieve list views for. |
|
|
The ID of the record containing the blob field. |
|
|
Specify the content type of the request; expected value is "application/json". |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
PATCH SObject Rows Update
/data/v{version}/sobjects/{SOBJECT_API_NAME}/{RECORD_ID}
Accesses records based on the specified object ID. Retrieves, updates, or deletes records. This resource can also be used to retrieve field values. Use the GET method to retrieve records or fields, the DELETE method to delete records, and the PATCH method to update records.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the API name of the sObject to retrieve list views for. |
|
|
The ID of the record containing the blob field. |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
Options (1)
|
Option Name |
Description |
|---|---|
|
|
The API name of the field whose value you want to update. |
GET SObject Rows by External ID
/data/v{version}/sobjects/{SOBJECT_API_NAME}/{FIELD_NAME}/{FIELD_VALUE}
Creates new records or updates existing records (upserts records) based on the value of a specified external ID field.
If the specified value doesn't exist, a new record is created.
If a record does exist with that value, the field values specified in the request body are updated.
If the value is not unique, the REST API returns a 300 response with the list of matching records.
HEAD, GET, PATCH, DELETE, POST
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the API name of the sObject to retrieve list views for. |
|
|
The API name of the rich text image field. Provide the field name as a string. |
|
|
The value of the external ID field to use for looking up the record. |
|
|
Specify the content type of the request; expected value is "application/json". |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
GET SObject Self Service User Password
/data/v{version}/sobjects/SelfServiceUser/{USER_ID}/password
Set, reset, or get information about a user password. This resource is available in REST API version 24.0 and later.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The unique identifier of the Self Service user whose password you want to retrieve. |
|
|
Specify the content type of the request; expected value is "application/json". |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
GET SObject Suggested Articles
/data/v{version}/sobjects/{SOBJECT_API_NAME}/suggestedArticles
Returns a list of suggested Salesforce Knowledge articles for a case, work order, or work order line item.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
A description to help refine the suggested article results. |
|
|
The language code to filter suggested articles by language. |
|
|
A subject to help refine the suggested article results. |
|
|
Specify the API name of the sObject to retrieve list views for. |
|
|
Specify the content type of the request; expected value is "application/json". |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
GET SObject User Password
/data/v{version}/sobjects/User/{USER_ID}/password
Set, reset, or get information about a user password. This resource is available in REST API version 24.0 and later.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The unique identifier of the User whose password you want to retrieve. |
|
|
Specify the content type of the request; expected value is "application/json". |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
Scheduling (3)
POST Get Appointment Candidates
/data/v{version}/scheduling/getAppointmentCandidates
Returns a list of available service resources (appointment candidates) based on work type group and service territories.
https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/requests_ls_getappointmentcandidates.htm
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
Options (9)
|
Option Name |
Description |
|---|---|
|
|
The start time for the appointment window. |
|
|
The end time for the appointment window. |
|
|
The ID of the work type group to filter candidates. |
|
|
The work type to filter candidates. |
|
|
The account ID associated with the appointment. |
|
|
The territory IDs to filter candidates. |
|
|
The required resource IDs to filter candidates. |
|
|
The scheduling policy ID to use. |
|
|
Whether to allow concurrent scheduling for candidates. |
POST Get Appointment Slots
/data/v{version}/scheduling/getAppointmentSlots
Returns a list of available appointment time slots for a resource based on given work type group and territories.
https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/requests_ls_getappointmentslots.htm
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
Options (9)
|
Option Name |
Description |
|---|---|
|
|
The start time for the appointment slot window. |
|
|
The end time for the appointment slot window. |
|
|
The ID of the work type group to filter slots. |
|
|
The work type to filter slots. |
|
|
The account ID associated with the appointment. |
|
|
The territory IDs to filter slots. |
|
|
The required resource IDs to filter slots. |
|
|
The scheduling policy ID to use. |
|
|
Whether to allow concurrent scheduling for slots. |
GET Scheduling
/data/v{version}/scheduling
Return frequency metrics about the standard pages within which users switched from Lightning Experience to Salesforce Classic.
https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/resources_lightning_exitbypagemetrics.htm
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the content type of the request; expected value is "application/json". |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
Search (7)
GET Parameterized Search
/data/v{version}/parameterizedSearch
Executes a simple RESTful search using parameters instead of a SOSL clause. Indicate parameters in a URL in the GET method. Or, use POST for more complex JSON searches.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
A search string that is properly URL-encoded |
|
|
Specify the content type of the request; expected value is "application/json". |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
GET Relevant Items
/data/v{version}/sobjects/relevantItems
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.
Note
The user’s global search scope includes the objects the user interacted with most in the last 30 days, including objects the user pinned from the search results page in the Salesforce Classic.
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
https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/resources_relevant_items.htm
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the content type of the request; expected value is "application/json". |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
GET Search
/data/v{version}/search
Executes the specified SOSL search. The search string must be URL-encoded.
https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/resources_search.htm
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
A SOSL statement that is properly URL-encoded. |
|
|
Specify the content type of the request; expected value is "application/json". |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
GET Search Result Layouts
/data/v{version}/search/layout
Returns search result layout information for the objects in the query string. For each object, this call returns the list of fields displayed on the search results page as columns, the number of rows displayed on the first page, and the label used on the search results page.
This call supports bulk fetch for up to 100 objects in a query.
https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/resources_search_layouts.htm
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Comma delimited object list |
|
|
Specify the content type of the request; expected value is "application/json". |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
GET Search Scope and Order
/data/v{version}/search/scopeOrder
Returns an ordered list of objects in the default global search scope of a logged-in user. Global search keeps track of which objects the user interacts with and how often and arranges the search results accordingly. Objects used most frequently appear at the top of the list.
The returned list reflects the object order in the user’s default search scope, including any pinned objects on the user’s search results page. This call is useful if you want to implement a custom search results page using the optimized global search scope. The search string must be URL-encoded.
https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/resources_search_scope_order.htm
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the content type of the request; expected value is "application/json". |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
GET Search Suggested Queries
/data/v{version}/search/suggestSearchQueries
Returns a list of suggested searches based on the user’s query string text matching searches that other users have performed in Salesforce Knowledge. Provides a way to improve search effectiveness, before the user performs a search.
https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/resources_search_suggest_queries.htm
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Provide a SOQL query string to execute, including the SELECT and FROM clauses. |
|
|
The language code to filter suggested articles by language. |
|
|
Specify the content type of the request; expected value is "application/json". |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
GET Search for Records Suggested by Autocomplete and Instant Results
/data/v{version}/search/suggestions
Returns a list of suggested records whose names match the user’s search string. The suggestions resource provides autocomplete results and instant results for users to navigate directly to likely relevant records, before performing a full search.
https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/resources_search_suggest_records.htm
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Provide a SOQL query string to execute, including the SELECT and FROM clauses. |
|
|
The object type to limit the search suggestions to, such as Account or Contact. |
|
|
Specify the content type of the request; expected value is "application/json". |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
Support and Knowledge (6)
GET Articles Details
/data/v{version}/support/knowledgeArticles/{ARTICLE_ID}
Get all online article fields, accessible to the user.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The unique identifier of the knowledge article to retrieve. |
|
|
Specify the content type of the request; expected value is "application/json". |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
GET Articles List
/data/v{version}/support/knowledgeArticles
Get a page of online articles for the given language and category through either search or query.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the content type of the request; expected value is "application/json". |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
GET Data Category Detail
/data/v{version}/support/dataCategoryGroups/{GROUP}/dataCategories/{CATEGORY}
Get data category details and the child categories by a given category.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The name of the data category group containing the category. |
|
|
The name of the data category within the group. |
|
|
Specify the content type of the request; expected value is "application/json". |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
GET Data Category Groups
/data/v{version}/support/dataCategoryGroups
Returns the list of list views for the specified sObject, including the ID and other basic information about each list view. You can also get basic information for a specific list view by ID.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The object type to filter the data category groups by, for example KnowledgeArticleVersion. |
|
|
Specify the content type of the request; expected value is "application/json". |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
GET Embedded Service Configuration Describe
/data/v{version}/support/embeddedservice/configuration/{EMBEDDED_SERVICE_CONFIG_DEVELOPERNAME}
Retrieves the values for your Embedded Service deployment configuration, including the branding colors, font, and site URL.
You must be logged in to the account that owns the EmbeddedServiceConfigDeveloperName you are querying.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The developer name of the embedded service configuration to describe. |
|
|
Specify the content type of the request; expected value is "application/json". |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |
GET Retrieve Knowledge Language Settings
/data/v{version}/knowledgeManagement/settings
Returns the existing Knowledge language settings, including the default knowledge language and a list of supported Knowledge language information.
https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/resources_knowledge_retrieve_language.htm
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the content type of the request; expected value is "application/json". |
|
|
Specify the API version number to use for the request. |
|
|
The response format expected from the API (e.g. application/json). |