An example of creating relationships together with resource

json-api · hhware · Mar 16, 2015 · Mar 16, 2015 · 48c3360e1e248bf9ede2a4dabcdce967312a4fe4
commit 48c3360e1e248bf9ede2a4dabcdce967312a4fe4
diff --git a/format/index.md b/format/index.md
@@ -908,6 +908,33 @@ Accept: application/vnd.api+json
 }
 ```
 
+Resources can be created together with relationships:
+
+```text
+POST /photos
+Content-Type: application/vnd.api+json
+Accept: application/vnd.api+json
+
+{
+  "data": {
+    "type": "photos",
+    "title": "Ember Hamster",
+    "src": "http://example.com/images/productivity.png",
+    "links": {
+      "author": {
+        "linkage": { "type": "people", "id": "12" }
+      },
+      "equipment": {
+        "linkage": [
+          { "type": "cameras", "id": "13" },
+          { "type": "lenses", "id": "14" }
+        ]
+      }
+    }
+  }
+}
+```
+
 #### Client-Generated IDs <a href="#crud-creating-client-ids" id="crud-creating-client-ids" class="headerlink"></a>
 
 A server **MAY** accept a client-generated ID along with a request to create