evaluateWebRequest

Click to copy

Web request evaluator

Evaluates the response from the HTTP request configured in the Send Web Request step. The evaluator can be used to ensure correct responses as well as proper step configuration before running the step in a job. Properties used will vary depending on the API. A valid jobId is required to evaluate Arcade expressions. The adminBasic or adminAdvanced privilege is required.

Web request evaluator parameters:

ParameterDescriptionData Type
requestTypeRequired. Can be set to GET, POST, PUT, DELETE, HEAD, PATCH, or OPTIONS.String
baseUrlRequired. The URL of the REST endpoint to send the request to.String
queryParamsOptional. Add a Key and Value for each query parameter.String
pathParamsOptional. Add a Key and Value for each path parameter.String
headersOptional. Add a Key and Value for each header.String
bodyOptional. Can be set to Form Data, URL Encoded, or Raw. If Form Data or URL Encoded, add a Key and Value for each entry. If Raw, add content and contentType, either JSON or String.String
authorizationOptional. Can be set to No Auth, API Key, Bearer Token, Basic Auth, or Digest Auth. If API Key, add a Key and Value for each entry and specify whether to add them to Headers or Query Parameters. If Bearer Token, add a token. If Basic Auth or Digest Auth, add a username and password.String
attachmentOptional. Requires the Workflow Manager Advanced license. Enter a custom folder name or attachment name.String
outputValuesOptional. Requires the Workflow Manager Advanced license. Add a Key and Value. The Value will be the JSON Path for the desired output value.String
jobIdOptional. A valid JobId is required if using this property. Required to evaluate Arcade expressions.String

Body parameter

Use dark colors for code blocksCopy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
{
  "webRequest": {
    "requestType": "GET",
    "baseUrl": "string",
    "queryParams": [
      {
        "key": "string",
        "value": "string",
        "isEnabled": true
      }
    ],
    "pathParams": [
      {
        "key": "string",
        "value": "string",
        "isEnabled": true
      }
    ],
    "headers": [
      {
        "key": "string",
        "value": "string",
        "isEnabled": true
      }
    ],
    "body": {
      "formData": {
        "keyValues": [
          {
            "key": "string",
            "value": "string",
            "isEnabled": true
          }
        ]
      },
      "urlEncoded": {
        "keyValues": [
          {
            "key": "string",
            "value": "string",
            "isEnabled": true
          }
        ]
      },
      "raw": {
        "content": "string",
        "contentType": "string"
      }
    },
    "authorization": {
      "apiKey": {
        "key": "string",
        "value": "string",
        "addedTo": "QueryParams"
      },
      "credentials": {
        "username": "string",
        "password": "string",
        "token": "string"
      },
      "authorizationType": "NoAuth",
      "tokenRequest": {
        "requestType": "GET",
        "baseUrl": "string",
        "queryParams": [
          {
            "key": "string",
            "value": "string",
            "isEnabled": true
          }
        ],
        "pathParams": [
          {
            "key": "string",
            "value": "string",
            "isEnabled": true
          }
        ],
        "headers": [
          {
            "key": "string",
            "value": "string",
            "isEnabled": true
          }
        ],
        "body": {
          "formData": {
            "keyValues": null
          },
          "urlEncoded": {
            "keyValues": null
          },
          "raw": {
            "content": null,
            "contentType": null
          }
        },
        "authorization": {
          "apiKey": {
            "key": null,
            "value": null,
            "addedTo": null
          },
          "credentials": {
            "username": null,
            "password": null,
            "token": null
          },
          "authorizationType": "NoAuth",
          "tokenRequest": {
            "requestType": null,
            "baseUrl": null,
            "queryParams": null,
            "pathParams": null,
            "headers": null,
            "body": null,
            "authorization": null,
            "attachment": null,
            "outputValues": null
          }
        },
        "attachment": {
          "folder": "string",
          "customName": "string"
        },
        "outputValues": [
          {
            "key": "string",
            "value": "string",
            "isEnabled": true
          }
        ]
      }
    },
    "attachment": {
      "folder": "string",
      "customName": "string"
    },
    "outputValues": [
      {
        "key": "string",
        "value": "string",
        "isEnabled": true
      }
    ]
  },
  "jobId": "string"
}

Query parameters

NameTypeRequired

token

string

Path parameters

NameTypeRequired

orgId

string

itemId

string

Examples

Request

Use dark colors for code blocksCopy
1
2
3
4
5
# You can also use wget
curl -X POST /{orgId}/{itemId}/evaluateWebRequest \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

Response

200 Response

Use dark colors for code blocksCopy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
{
  "status": 0,
  "body": "string",
  "requestUrl": "string",
  "headers": [
    {
      "key": "string",
      "value": "string",
      "isEnabled": true
    }
  ],
  "outputs": {
    "outputs": [
      {
        "value": "string",
        "name": "string",
        "dataType": "string",
        "isEncoded": true
      }
    ],
    "returnValue": "string",
    "isUserSpecifiedReturnValue": true,
    "comment": "string"
  }
}
StatusMeaningDescriptionSchema

200

OK

success

WebRequestResponse

500

Internal Server Error

error

WorkflowExceptionDTO

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.