Function API only Updated 15 Oct 2026

`httpPut(url, data, [headers])`

Calls specified web service with method PUT. Expects JSON. Parses JSON to object.

Parameters

urlstringrequired

URL to call with HTTP PUT.

dataobjectrequired

Data to PUT

headersobjectoptional

Name / value object that will be converted to HTTP headers.

Returns

Returns the JSON answer parsed to an object.

Errors do not throw: if the call fails, or the answer is not JSON, the result is { DoclyError: "<message>" }. The HTTP status code is not returned — use httpFetch when you need it.

Security: requests to Docly's own platform domains (and their subdomains) and to cloud metadata / link-local addresses are always blocked — also after a redirect — and the call returns { DoclyError }. The Host header cannot be set. Private networks are only blocked by httpFetch with blockPrivateNetworks: true.

Example

Normal JavaScript, running in the browser or on the Docly™ server.

export default () => {
    let config = docly.getJson("#/Config") || {};   // keep credentials in #/Config, never in code
    let headers = {
        "Authorization": "Basic " + docly.base64(config.ApiUser + ":" + config.ApiPassword)
    };
    let data = { "Field1": "123" };

    // Call some API — data is sent as JSON with method PUT
    let result = docly.httpPut("https://api.example.com/v1/items/1", data, headers);

    if (result && result.DoclyError) throw new Error("The external API did not answer");
    return result;
}