diff --git a/codetf.schema.json b/codetf.schema.json
index ad82833..759e17e 100644
--- a/codetf.schema.json
+++ b/codetf.schema.json
@@ -87,6 +87,34 @@
           "description": "Vendor-specific properties to help storytelling",
           "additionalProperties": true
         },
+        "failureState": {
+          "type": "object",
+          "properties": {
+            "failed": {
+              "type": "boolean",
+              "description": "Whether the codemod entirely failed to run"
+            },
+            "reason": {
+              "type": "string",
+              "description": "A short description of why the codemod failed"
+            },
+            "exception": {
+              "type": "string",
+              "description": "More detailed information about the exception that caused the failure"
+            }
+          },
+          "if": {
+            "properties": {
+              "failed": { "const": true }
+            }
+          },
+          "then": {
+            "required": ["failed", "reason"]
+          },
+          "else": {
+            "required": ["failed"]
+          }
+        },
         "failedFiles": {
           "type": "array",
           "description": "A set of file paths for files that the tool failed to parse or transform",