REST.put

REST.put() Function

 Note: This function can only be used in a Trusted Macro

• Introduced in version 1.5

Perform an HTTP put request to the specified URL to update an existing resource.

Usage

REST.put(url, payload, mediaType, getFullResponse)
REST.put(url, payload, mediaType, headers, getFullResponse)

Parameters

• url - String containing the URL to the resource or collection of resources.
• payload - JSON object containing the key:value pairs.
• mediaType - String containing a MIME type and charset. See example.
• headers - JSON object containing header key:value pairs.
• getFullResponse - Boolean (0:1) to get full response.

Returns

HTTP response as JSON (if full response) or server response, usually JSON but can be XML, HTML, or other formats.

Example

Update a user with a put request.

[h: baseURL = "https://reqres.in"]
[h: path = "/api/users/2"]
[h: mediaType = "application/json; charset=utf-8"]
[h: getFullResponse = 0]

[h: payload = '{ "name": "morpheus", "job": "zion resident" }']

[h: response = REST.put(baseURL + path, payload, mediaType, getFullResponse)]

<br>
<pre>
[r: json.indent(response, 2)]
</pre>

Returns:

{
  "name": "morpheus",
  "job": "zion resident",
  "updatedAt": "2019-03-17T22:49:52.188Z"
}

See Also

RESTful Functions Overview

Version Changes

• 1.5 - Added to main MapTool build.