REST Put
In this article
Overview
We recommend that you use the HTTP Client Snap instead of Snaps from the REST Snap Pack to connect to REST-based APIs and applications.
You can use the REST Put Snap to replace business object resources. If the business object does not exist, the Snap creates the object.
Prerequisites
A valid account with the required permissions.
Supported Features
Works in Ultra Tasks. We recommend you to set the batch size to 1.
Limitations and Known Issues
None.
Snap Views
Views | View Type | View Format | Examples of Upstream and Downstream Snaps | Description |
---|---|---|---|---|
Input | Document |
|
| Each input document contains details associated with the data that must be replaced or created in the target RESTful server. |
Output | Document |
|
| Each output document contains details related to the business objects impacted as a result of Snap execution. |
Error | Error handling is a generic way to handle errors without losing data or failing the Snap execution. You can handle the errors that the Snap might encounter when running the Pipeline by choosing one of the following options from the When errors occur list under the Views tab. The available options are:
Learn more about Error handling in Pipelines. |
Snap Settings
Field Name | Field Type | Description | ||||
---|---|---|---|---|---|---|
Label* Default Value: REST Put | String | Specify a name for the Snap. You can modify this to be more specific, especially if you have more than one of the same Snap in your Pipeline. | ||||
Service URL* | String/Expression | Specify the service endpoint URL of REST API. You can provide the URL in one of the following ways:
For example:
For example: For Snaps using AWS Signature V4 accounts, you can use the canonical name (CNAME) for the URI so it's not necessary for the URL to end with amazonaws.com or have the region and service provided in it. However, if you are using the CNAME you must provide it in the AWS Region and Service Name fields in the AWS Signature V4 account. The host name in the CNAME must be equal to the bucket name. For example: New URI with CNAME: Here, the bucket name is The Snap finds the value at the JSON path $.widget.id in the input data and replaces "%s" in the Service URL with the value. You can connect File Reader and JSON Parser Snaps upstream of a REST Put Snap and prepare the following JSON file for the File Reader Snap:
The Service URL for a REST snap has to be valid. If the Service URL contains any special characters, such as !, =, %21, $, and
|