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 |