Add example.

json-api · beauby · Jul 26, 2017 · Jul 26, 2017 · Jul 26, 2017 · Jul 26, 2017
commit 2ddd0eab8ec44da784120d71d3c5167403c1b964
diff --git a/_format/1.1/index.md b/_format/1.1/index.md
@@ -1244,6 +1244,45 @@ otherwise (that is an object with a single `pointer` member the value of which i
 JSON pointer to a resource object). The document **MUST** still respect the full
 linkage requirement.
 
+For instance, a new article might be created along with two tags with the following 
+request:
+
+```http
+POST /articles HTTP/1.1
+Content-Type: application/vnd.api+json
+Accept: application/vnd.api+json
+
+{
+  "data": {
+    "type": "articles",
+    "attributes": {
+      "title": "Sideposting with json:api"
+    },
+    "relationships": {
+      "tags": {
+        "data": [{ "type": "tags", "id": "9" },
+                 { "pointer": "/included/0" },
+                 { "pointer": "/included/1" }]
+      }
+    }
+  },
+  "included": [
+    {
+      "type": "tags",
+      "attributes": {
+        "label": "JSON"
+      }
+    },
+    {
+      "type": "tags",
+      "attributes": {
+        "label": "REST"
+      }
+    }
+  ]
+}
+```
+
 A server **MUST** handle sideposting requests transactionally, and either create all
 requested resources or none.