RFC 6902, "JavaScript Object Notation (JSON) Patch", April 2013

Errata ID: 4596
Status: Rejected
Type: Technical
Publication Format(s) : TEXT
Reported By: Missing 'Append' operation
Date Reported: 2016-01-21
Rejected by: Barry Leiba
Date Rejected: 2016-01-21

Throughout the document, when it says:

Its value MUST be one of "add", "remove", "replace", 
"move", "copy", or "test"; other values are errors. 

It should say:

Its value MUST be one of "add", "append", "remove", 
"replace", "move", "copy", or "test"; other values are errors. 

... and more text to add the 'append' op description.

Notes:

There is a key missing piece to this RFC. You can do { "op": "add", "path": "/attr", "value": "val"}, which will add or modify the 'attr' attribute, if it exists or not. However, you cannot add an item to a potentially non-existing array. Updating an array that may or may not exists, forces the client to always call GET on the resource. See this API spec: https://orchestrate.io/docs/apiref#keyvalue-patch which implements the op 'append', which would solve this problem.
--VERIFIER NOTES--
This is an enhancement suggestion, not an errata report; the errata system is not for that.

Report New Errata