Using Siren to demonstrate a PUT with different read/write models.

siren-put.json

{
  "properties": {
    "title": "Error on page load",
    "description": "Steps to reproduce: ...",
    "severity": 1,
    "views": 6,
    "version": 3
  },
  "entities": [
    {
      "rel": "http://rels.x.io/comments",
      "href": "http://x.io/bugs/1/comments"
    }
  ],
  "actions": [
    {
      "name": "bug-update",
      "method": "PUT",
      "href": "http://x.io/bugs/1",
      "type": "application/x-www-form-urlencoded",
      "fields": [
        { "name": "title", "type": "text" },
        { "name": "description", "type": "text" },
        { "name": "severity", "type": "number" },
        { "name": "version", "type": "hidden", "value": "3" }
      ]
    }
  ],
  "links": [
    { "rel": "self", "href": "http://x.io/bugs/1" },
    { "rel": "next", "href": "http://x.io/bugs/2" }
  ]
}

Siren spec, for reference: https://github.com/kevinswiber/siren