REST Message legacy workflow activity
-
- UpdatedAug 3, 2023
- 2 minutes to read
- Vancouver
- Workflow
The legacy REST Message activity enables an administrator to override the REST endpoint or supply the variables configured in the REST Message module.
Existing workflows using it will continue to work as designed. To edit this activity in an existing workflow, you must re-activate the activity.
The REST Message activity executes a dead link REST function (POST, PUT, GET, or DELETE) on an endpoint using values defined in the function record.
Input variables
Field | Description |
---|---|
Rest Message | |
REST Message | Name of the Create a REST message to run. This is a reference field to the REST Message [sys_rest_message] table ( ). |
REST Message Function | Function to call that is defined in a REST message function. This is a
reference field to the HTTP Method [sys_rest_message_fn] table ( Available functions are put, post, get, or delete. You can edit functions in the HTTP Methods related list in each REST Message record. |
).
REST Endpoint | REST endpoint to use instead of the Endpoint defined in the HTTP Method record. Leave this field blank to use the defined endpoint in the REST Message Function record. |
Rest Message Variables | |
Variables | Values to use for Variable substitution in outbound REST messages defined in the HTTP Method record. Use the following format
for the string: For
example, use name=${nameValue}, id=${idValue} where
name and id are function variables. If
either the variable name or value contains a comma or equal sign, escape those
characters with a backslash. |
Rest Message MID Server | |
Use MID Server | Check this box if you want to use a MID Server to send the REST message. A MID Server might be necessary to reach an endpoint within a firewall or a subnetwork that is not visible from the instance. If this check box is selected, but no MID Server is defined in the MID Server field, the workflow automatically attempts to find a MID Server based on IP range and the REST capability. |
MID Server | Name of the MID Server to use. This field is available when Use MID Server is selected. The workflow ignores this parameter if the use_midserver parameter is disabled. |
Rest Message Script | |
Sensor Script | The script to execute after the request has been made and a response has been received. You can access the full response body from the activity.output variable. |