HTTP PUT — метод запроса, который создаёт или полностью заменяет ресурс по известному URL. Клиент отправляет на этот адрес новое представление ресурса, а сервер сохраняет его целиком по указанному пути.
Главное свойство PUT — идемпотентность: повторение одного и того же запроса приводит к тому же результату. Отправив PUT дважды, вы не создадите две копии — ресурс просто перезапишется теми же данными. Этим PUT отличается от POST, который обычно каждый раз создаёт новый объект. Как и все методы HTTP, PUT указывается в начале запроса вместе с путём и заголовками.
Чтобы выбрать метод, полезно сравнить их поведение:
PUT удобен, когда клиент знает точный URL и хочет заменить содержимое целиком; для частичного изменения применяют метод PATCH. Передавать данные безопаснее по HTTPS.