changed post to put
added documentation