json-api · bf4 · Sep 23, 2015 · Sep 23, 2015
diff --git a/schema b/schema
@@ -114,18 +114,19 @@
         }
       ]
     },
-    "resource": {
+
+    "newResource": {
       "description": "\"Resource objects\" appear in a JSON API document to represent resources.",
       "type": "object",
       "required": [
-        "type",
-        "id"
+        "type"
       ],
       "properties": {
         "type": {
           "type": "string"
         },
         "id": {
+          "description": "A server **MAY** accept a client-generated ID along with a request to create a resource. An ID **MUST** be specified with an id key, the value of which **MUST** be a universally unique identifier. The client **SHOULD** use a properly generated and formatted UUID as described in RFC 4122.",
           "type": "string"
         },
         "attributes": {
@@ -143,6 +144,20 @@
       },
       "additionalProperties": false
     },
+    "resource": {
+      "description": "\"Resource objects\" appear in a JSON API document to represent resources.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/newResource"
+        },
+        {
+          "required": [
+            "type",
+            "id"
+          ]
+        }
+      ]
+    },
 
     "links": {
       "description": "A resource object **MAY** contain references to other resource objects (\"relationships\"). Relationships may be to-one or to-many. Relationships can be specified by including a member in a resource's links object.",

diff --git a/schema-create b/schema-create
@@ -0,0 +1,28 @@
+{
+  "$schema": "http://json-schema.org/draft-04/schema#",
+  "title": "JSON API Schema",
+  "description": "This is a schema for clients creating resources in the JSON API format. For more, see http://jsonapi.org",
+  "type": "object",
+  "required": [
+    "data"
+  ],
+  "properties": {
+    "data": {
+      "$ref": "#/definitions/newData"
+    },
+    "meta": {
+      "$ref": "http://jsonapi.org/schema#/definitions/meta"
+    },
+    "jsonapi": {
+      "$ref": "http://jsonapi.org/schema#/definitions/jsonapi"
+    }
+  },
+  "additionalProperties": false,
+
+  "definitions": {
+    "newData": {
+      "description": "A resource can be created by sending a `POST` request to a URL that represents a collection of resources. The request **MUST** include a single resource object as primary data.",
+      "$ref": "http://jsonapi.org/schema#/definitions/newResource"
+    }
+  }
+}
diff --git a/schema-update b/schema-update
@@ -0,0 +1,36 @@
+{
+  "$schema": "http://json-schema.org/draft-04/schema#",
+  "title": "JSON API Schema",
+  "description": "This is a schema for clients updating resources in the JSON API format. For more, see http://jsonapi.org",
+  "type": "object",
+  "required": [
+    "data"
+  ],
+  "properties": {
+    "data": {
+      "$ref": "#/definitions/updateData"
+    },
+    "meta": {
+      "$ref": "http://jsonapi.org/schema#/definitions/meta"
+    },
+    "jsonapi": {
+      "$ref": "http://jsonapi.org/schema#/definitions/jsonapi"
+    }
+  },
+  "additionalProperties": false,
+
+  "definitions": {
+    "updateData": {
+      "description": "The `PATCH` request **MUST** include a single resource object as primary data. A relationshp can be cleared by sending `null` data.",
+      "oneOf": [
+        {
+          "description": "Used to remove a relationship.",
+          "type": "null"
+        },
+        {
+          "$ref": "http://jsonapi.org/schema#/definitions/resource"
+        }
+      ]
+    }
+  }
+}