REST Put

Reference documentation for using the REST API REST Put action

Written By Support Channel

Last updated Over 1 year ago

Overview of the REST Put action

The REST Put action allows you to update or replace an existing resource in an external system using an HTTP PUT request.

Purpose	To send updated data to an external system by calling a REST API endpoint with a PUT request method
Parameters	Headers 1 URL 1 Body
Output	Status, OK, Error, Client error, Server error, Accepted, No Content, Bad Request, Not Authorised, Not Acceptable, Not Found, Forbidden, Text, Body, Type, Char Set

Understanding the REST Put action

The REST Put action is used to update or completely replace an existing resource in an external system. Unlike the REST Post action, which is often used to create new resources and may produce different results if triggered multiple times, a REST Put action will run the same request multiple times and should always result in the same outcome.

Headers

A list of header names and values for the API request. For example:

Content-Type: “application/json”
Authorisation: “rest_api_key=1234”

URL

Specify the endpoint where the PUT request should be sent.

Body

Specify the content the PUT request will be sending.

Working with the REST Put action

The REST Put action is especially useful when syncing updates from one system to another such as updating a user’s profile or changing a status field in a connected platform.

Additionally, you should set the appropriate Content-Type header such as application/json for JSON or application/xml for XML. This lets the server know how to interpret the incoming data. Sending incorrectly formatted data or omitting the correct header can cause the request to fail or be rejected by the API.

Output Variables

Output	Code	Type	Description
Status	—	Text	Shows the HTTP Status Code of request.
OK	200	Boolean	The request was successful, and the response contains the expected data.
Accepted	202	Boolean	The request was accepted for processing, but the processing has not been completed.
No Content	204	Boolean	The request was successful, but there is no content in the response.
Bad Request	400	Boolean	The server could not understand the request due to invalid syntax or parameters.
Not Authorised	401	Boolean	The request was denied due to invalid or missing authentication credentials.
Forbidden	403	Boolean	The request is valid, but the server is refusing to fulfil it.
Not Found	404	Boolean	The resource requested could not be found on the server.
Not Acceptable	406	Boolean	The requested format is not supported by the server.
Client Error	4xx	Boolean	Any status in the 400–499 range indicating a client-side error.
Server Error	5xx	Boolean	Any status in the 500–599 range indicating a server-side error.
Error	—	Text	A general error occurred, such as connection failure or timeout.
Text	—	Text	Plain text of the body of the the request
Body	—	Text	Data received in response to request sent
Type	—	Text	Media type of the response body. For example `application/json`
Char Set	—	Text	The character encoding used in the response. For example `UTF-8`

Create and manage REST Put actions

Add a REST Put action

Add the action

Use the following steps to add the action to your workflow.

How to add an action to a workflow

Click the ‘plus’ symbol on the workflow path at the point you want to insert the action. This opens the action menu slide-over.
Either:
- Search for the action using the Search field above the actions in the menu.
- Locate a Recently Used action in the top section of the menu.
- Navigate to the action within menu: Core actions are listed under Actions, while Plugin actions are contained within their associated integration.
Select the desired action to insert it. This reveals the action’s configuration panel.
Use the Name field to name the action. This can help users to understand your workflow at a glance. (optional)
Use the Description field to add information describing the action. This can help users wanting to understand how your workflow functions. (optional)

Configure the action

Use the following steps to configure the action.

Click Add Header to create a new header entry. This reveals the Header popup.
Select Header and type the name of the header.
Select Value and input the value of the header
Click OK to complete setup of your new field value.
Repeat the above steps for any addition additional headers needed.
Set a value for the URL and Body.
Click back in the main view to hide the slide-over.

Edit the action

Use the following steps to make changes to the action.

Edit an existing Header entry by clicking on it. This displays the Edit Header popup and allows you to make changes.
Remove an unwanted entry by clicking the red cross toward its right-side.
Click back in the main view to hide the slide-over.

Delete a REST Put action

Use the following steps to remove the action from your workflow:

How to remove an action from a workflow

Access the workflow in draft mode to edit it.
Either:
- hover your mouse cursor over the action, and then click the red cross that appears over the top-right corner of the action to delete it. Or:
- click on the action to open the action slide-over. Click the red 'Delete Step’ button to remove the action from your workflow.
Click Publish in the top-right to commit your changes.

Take care when deleting an action to also remove any logic using its outputs: workflow steps may function incorrectly or break if they attempt to evaluate an output of a deleted action.

Was this helpful?

Still need help? Share an idea