An HTTP Requests connection executes these commands to perform common HyperText Transfer Protocol (HTTP) requests to a given URL to connect and automate supported solutions through their respective connectors.
Note: To enable these commands, an IT admin first creates a HTTP Request connector. While the connection doesn't have OData-specific features, you can add any necessary components of the request via the headers and query parameters.
Delete
Makes an HTTP DELETE request
Inputs
| Input |
Detail |
| Username |
If basic authentication is required, enter the username |
| Password |
If basic authentication is required, enter the password |
| Certificate |
Enter the path to the certificate to use when making the request (optional) |
| Show Response |
To show the API response body in the output, check this box |
| URL |
Enter the URL used for the request |
| Content Type |
Enter the content-type header to set. This specifies the expected format to send to the request body. |
| Body File |
Enter the file that contains the JSON object or request parameters to send in the request body. If you include this, leave the Body Text input blank. |
| Body Text |
Enter the text to send in the request body. If you include this, leave the Body File input blank. |
| Headers |
Enter any additional headers to add to the request |
Outputs
| Response Headers |
JSON |
| Response |
File |
| Response Code |
Integer |
Exit Codes
| Code |
Type |
Detail |
| 0 |
Success |
Success |
| 2 |
Error |
Request failed; non-200 response code |
| 4 |
Error |
Certificate not found |
| 5 |
Error |
Invalid request headers |
Get
Makes an HTTP GET request
Inputs
| Input |
Detail |
| Username |
If basic authentication is required, enter the username |
| Password |
If basic authentication is required, enter the password |
| Certificate |
Enter the path to the certificate to use when making the request (optional) |
| Show Response |
To show the API response body in the output, check this box |
| URL |
Enter the URL used for the request |
| Query String |
Enter the query string to append to the request, such as param1=value1¶m2=value2 |
| Headers |
Enter any additional headers to add to the request |
| Content Type |
Enter the content-type header to set. This specifies the expected format to send to the request body. |
Outputs
| Response Headers |
JSON |
| Response |
File |
| Response Code |
Integer |
Exit Codes
| Code |
Type |
Detail |
| 0 |
Success |
Success |
| 2 |
Error |
Request failed; non-200 response code |
| 4 |
Error |
Certificate not found |
| 5 |
Error |
Invalid request headers |
Post
Makes an HTTP POST request
Inputs
| Input |
Detail |
| Username |
If basic authentication is required, enter the username |
| Password |
If basic authentication is required, enter the password |
| Certificate |
Enter the path to the certificate to use when making the request (optional) |
| Show Response |
To show the API response body in the output, check this box |
| URL |
Enter the URL used for the request |
| Content Type |
Enter the content-type header to set. This specifies the expected format to send to the request body. |
| Body File |
Enter the file that contains the JSON object or request parameters to send in the request body. If you include this, leave the Body Text input blank. |
| Body Text |
Enter the text to send in the request body. If you include this, leave the Body File input blank. |
| Headers |
Enter any additional headers to add to the request |
Outputs
| Response Headers |
JSON |
| Response |
File |
| Response Code |
Integer |
Exit Codes
| Code |
Type |
Detail |
| 0 |
Success |
Success |
| 2 |
Error |
Request failed; non-200 response code |
| 4 |
Error |
Certificate not found |
| 5 |
Error |
Invalid request headers |
Put
Makes an HTTP PUT request
Inputs
| Input |
Detail |
| Username |
If basic authentication is required, enter the username |
| Password |
If basic authentication is required, enter the password |
| Certificate |
Enter the path to the certificate to use when making the request (optional) |
| Show Response |
To show the API response body in the output, check this box |
| URL |
Enter the URL used for the request |
| Content Type |
Enter the content-type header to set. This specifies the expected format to send to the request body. |
| Body File |
Enter the file that contains the JSON object or request paraemnters to send in the request body. If you include this, leave the Body Text input blank. |
| Body Text |
Enter the text to send in the request body. If you include this, leave the Body File input blank. |
| Headers |
Enter any additional headers to add to the request |
Outputs
| Response Headers |
JSON |
| Response |
File |
| Response Code |
Integer |
Exit Codes
| Code |
Type |
Detail |
| 0 |
Success |
Success |
| 2 |
Error |
Request failed; non-200 response code |
| 4 |
Error |
Certificate not found |
| 5 |
Error |
Invalid request headers |