Skip to main content


Laurence MorganLess than 1 minute


HTTP POST request with a JSON-parsable return


Fetches a page from a URL via HTTP/S POST request.


post url -> <stdout>

<stdin> -> post url content-type -> <stdout>


» post -> [ Status ] 
    "Code": 405,
    "Message": "Method Not Allowed"


JSON return

POST returns a JSON object with the following fields:

    "Status": {
        "Code": integer,
        "Message": string,
    "Headers": {
        string [
    "Body": string

The concept behind this is it provides and easier path for scripting eg pulling specific fields via the index, [, function.

post as a method

Running post as a method will transmit the contents of STDIN as part of the body of the HTTP POST request. When run as a method you have to include a second parameter specifying the Content-Type MIME.

Configurable options

post has a number of behavioral options which can be configured via Murex's standard config tool:

config -> [ http ]

To change a default, for example the user agent string:

config set http user-agent "bob"

This enables sane, repeatable and readable defaults. Read the documents on config for more details about it's usage and the rational behind the command.

See Also

  • [ Index ]: Outputs an element from an array, map or table
  • [[ Element ]]: Outputs an element from a nested structure
  • config: Query or define Murex runtime settings
  • get: Makes a standard HTTP request and returns the result as a JSON object
  • getfile: Makes a standard HTTP request and return the contents as Murex-aware data type for passing along Murex pipelines.

This document was generated from builtins/core/httpclient/post_doc.yamlopen in new window.

Last update:
Contributors: Laurence Morgan,Laurence Morgan,Laurence