Merge pull request #1036 from beauby/404-create-missing-related

ethanresnick · web-flow · commit d0db57a1aadc · 2016-09-28T19:48:13.000-04:00
Add response status for POST with inexistent related resource.
diff --git a/_format/1.0/index.md b/_format/1.0/index.md
@@ -1271,6 +1271,11 @@ had returned it back in a `201` response.
 A server **MAY** return `403 Forbidden` in response to an unsupported request
 to create a resource.
 
+##### <a href="#crud-creating-responses-404" id="crud-creating-responses-404" class="headerlink"></a> 404 Not Found
+
+A server **MUST** return `404 Not Found` when processing a request that
+references a related resource that does not exist.
+
 ##### <a href="#crud-creating-responses-409" id="crud-creating-responses-409" class="headerlink"></a> 409 Conflict
 
 A server **MUST** return `409 Conflict` when processing a `POST` request to
diff --git a/_format/1.0/normative-statements.json b/_format/1.0/normative-statements.json
@@ -181,6 +181,7 @@ layout: null
             { "id": "create-responses-202", "type": "normative-statements" },
             { "id": "create-responses-204", "type": "normative-statements" },
             { "id": "create-responses-403", "type": "normative-statements" },
+            { "id": "create-responses-404-related", "type": "normative-statements" },
             { "id": "create-responses-409-exists", "type": "normative-statements" },
             { "id": "create-responses-409-bad-type", "type": "normative-statements" },
             { "id": "create-responses-409-error-details", "type": "normative-statements" },
@@ -1770,6 +1771,19 @@ layout: null
         }
       }
     },
+    {
+      "id": "create-responses-404-related",
+      "type": "normative-statements",
+      "attributes": {
+        "level": "MAY",
+        "description": "A server **MUST** return `404 Not Found` when processing a request that references a related resource that does not exist."
+      },
+      "relationships": {
+        "section": {
+          "data": { "id": "creating-updating-deleting", "type": "sections" }
+        }
+      }
+    },
     {
       "id": "create-responses-409-exists",
       "type": "normative-statements",
diff --git a/_format/1.1/index.md b/_format/1.1/index.md
@@ -1292,6 +1292,11 @@ had returned it back in a `201` response.
 A server **MAY** return `403 Forbidden` in response to an unsupported request
 to create a resource.
 
+##### <a href="#crud-creating-responses-404" id="crud-creating-responses-404" class="headerlink"></a> 404 Not Found
+
+A server **MUST** return `404 Not Found` when processing a request that
+references a related resource that does not exist.
+
 ##### <a href="#crud-creating-responses-409" id="crud-creating-responses-409" class="headerlink"></a> 409 Conflict
 
 A server **MUST** return `409 Conflict` when processing a `POST` request to
diff --git a/_format/1.1/normative-statements.json b/_format/1.1/normative-statements.json
@@ -185,6 +185,7 @@ layout: null
             { "id": "create-responses-202", "type": "normative-statements" },
             { "id": "create-responses-204", "type": "normative-statements" },
             { "id": "create-responses-403", "type": "normative-statements" },
+            { "id": "create-responses-404-related", "type": "normative-statements" },
             { "id": "create-responses-409-exists", "type": "normative-statements" },
             { "id": "create-responses-409-bad-type", "type": "normative-statements" },
             { "id": "create-responses-409-error-details", "type": "normative-statements" },
@@ -1826,6 +1827,19 @@ layout: null
         }
       }
     },
+    {
+      "id": "create-responses-404-related",
+      "type": "normative-statements",
+      "attributes": {
+        "level": "MAY",
+        "description": "A server **MUST** return `404 Not Found` when processing a request that references a related resource that does not exist."
+      },
+      "relationships": {
+        "section": {
+          "data": { "id": "creating-updating-deleting", "type": "sections" }
+        }
+      }
+    },
     {
       "id": "create-responses-409-exists",
       "type": "normative-statements",
