http put command documentation

--- title: http put categories: | network version: 0.104.0 network: | Put a body to a URL. usage: | Put a body to a URL. editLink: false contributors: false ---  # `http put` for [network](/commands/categories/network.md) <div class='command-title'>Put a body to a URL.</div> ## Signature ```> http put {flags} (URL) (data)``` ## Flags - `--user, -u {any}`: the username when authenticating - `--password, -p {any}`: the password when authenticating - `--content-type, -t {any}`: the MIME type of content to post - `--max-time, -m {duration}`: max duration before timeout occurs - `--headers, -H {any}`: custom headers you want to add - `--raw, -r`: return values as a string instead of a table - `--insecure, -k`: allow insecure server connections when using SSL - `--full, -f`: returns the full response instead of only the body - `--allow-errors, -e`: do not fail if the server returns an error code - `--redirect-mode, -R {string}`: What to do when encountering redirects. Default: 'follow'. Valid options: 'follow' ('f'), 'manual' ('m'), 'error' ('e'). ## Parameters - `URL`: The URL to post to. - `data`: The contents of the post body. Required unless part of a pipeline. ## Input/output types: | input | output | | ----- | ------ | | any | any | ## Examples Put content to example.com ```nu > http put https://www.example.com 'body' ``` Put content to example.com, with username and password ```nu > http put --user myuser --password mypass https://www.example.com 'body' ``` Put content to example.com, with custom header ```nu > http put --headers [my-header-key my-header-value] https://www.example.com ``` Put content to example.com, with JSON body ```nu > http put --content-type application/json https://www.example.com { field: value } ``` Put JSON content from a pipeline to example.com ```nu > open --raw foo.json | http put https://www.example.com ``` ## Notes Performs HTTP PUT operation.

This document describes the `http put` command in Nushell, which sends a PUT request to a specified URL with a given body. It details the command's signature, flags (like authentication, content type, timeout, headers, and error handling), parameters (URL and data), input/output types, and provides usage examples for various scenarios, including authentication, custom headers, JSON content, and pipeline input.