Previous value: -"any_recipient, primitive_managed_domain, managed_zone, your_domain, address, org_member_email or opted_in_domains."New value: +"any_recipient, primitive_managed_domain, managed_zone, your_domain, address, org_member_email, org_member_emails or opted_in_domains."

Previous value: -"sendable, pending_outbound_dns, pending_ownership or inactive."New value: +"Whether it can send, or what it waits on."

Added value: +[
+  "sendable",
+  "pending_outbound_dns",
+  "pending_ownership",
+  "inactive"
+]

Previous value: -"any_recipient, primitive_managed_domain, managed_zone, your_domain, address, org_member_email, org_member_emails or opted_in_domains."New value: +"any_recipient, primitive_managed_domain, managed_zone, your_domain, address, org_member_email or opted_in_domains."

Previous value: -"Whether it can send, or what it waits on."New value: +"sendable, pending_outbound_dns, pending_ownership or inactive."

Removed value: -[
-  "sendable",
-  "pending_outbound_dns",
-  "pending_ownership",
-  "inactive"
-]

Previous value: -"any_recipient, primitive_managed_domain, managed_zone, your_domain, address, org_member_email or opted_in_domains."New value: +"any_recipient, primitive_managed_domain, managed_zone, your_domain, address, org_member_email, org_member_emails or opted_in_domains."

Previous value: -"sendable, pending_outbound_dns, pending_ownership or inactive."New value: +"Whether it can send, or what it waits on."

Added value: +[
+  "sendable",
+  "pending_outbound_dns",
+  "pending_ownership",
+  "inactive"
+]

Added value: +false

Previous value: -"Envelope; the result is in data.data."New value: +"Where you can send from, and to whom."

Added value: +{
+  "additionalProperties": false,
+  "description": "Who this account may email.",
+  "properties": {
+    "address_rules_omitted": {
+      "description": "Address rules left out of rules; set when some were.",
+      "type": "integer"
+    },
+    "address_rules_partial": {
+      "description": "True when the address rules are a sample: an unlisted address may be allowed.",
+      "type": "boolean"
+    },
+    "any_recipient": {
+      "description": "True when any recipient is allowed. Set when known.",
+      "type": "boolean"
+    },
+    "known": {
+      "description": "False when the rules could not be read; then only summary is set.",
+      "type": "boolean"
+    },
+    "rules": {
+      "description": "Who you may email, one rule per kind of recipient. Set when known.",
+      "items": {
+        "additionalProperties": false,
+        "properties": {
+          "address": {
+            "description": "address and org_member_email rules only: the address.",
+            "type": "string"
+          },
+          "description": {
+            "description": "Who the rule allows, in words.",
+            "type": "string"
+          },
+          "domain": {
+            "description": "your_domain rules only: the domain.",
+            "type": "string"
+          },
+          "last_received_at": {
+            "description": "address rules only: last mail from it.",
+            "type": "string"
+          },
+          "received_count": {
+            "description": "address rules only: emails received from it.",
+            "type": "integer"
+          },
+          "type": {
+            "description": "any_recipient, primitive_managed_domain, managed_zone, your_domain, address, org_member_email or opted_in_domains.",
+            "type": "string"
+          },
+          "zone": {
+            "description": "managed_zone rules only: the zone.",
+            "type": "string"
+          }
+        },
+        "required": [
+          "type",
+          "description"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "summary": {
+      "description": "Who this account can reach, to tell the user.",
+      "type": "string"
+    }
+  },
+  "required": [
+    "known",
+    "summary"
+  ],
+  "type": "object"
+}

Removed value: -{
-  "description": "API response: the result in data, or error.",
-  "properties": {
-    "data": {
-      "description": "Where you can send from, and to whom.",
-      "properties": {
-        "can_send_to": {
-          "description": "Who you may email.",
-          "properties": {
-            "any_recipient": {
-              "description": "Any recipient is allowed.",
-              "type": "boolean"
-            },
-            "rules": {
-              "description": "Who is allowed: each has a type and a description.",
-              "type": "array"
-            },
-            "summary": {
-              "description": "What to tell the user.",
-              "type": "string"
-            }
-          },
-          "type": "object"
-        },
-        "domains": {
-          "description": "Your domains and what each still needs.",
-          "items": {
-            "properties": {
-              "domain": {
-                "type": "string"
-              },
-              "id": {
-                "type": "string"
-              },
-              "outbound_verified": {
-                "description": "SPF, DKIM and DMARC verified.",
-                "type": "boolean"
-              },
-              "ownership_verified": {
-                "type": "boolean"
-              },
-              "status": {
-                "description": "sendable, pending_outbound_dns, pending_ownership, inactive.",
-                "type": "string"
-              }
-            },
-            "type": "object"
-          },
-          "type": "array"
-        },
-        "next_actions": {
-          "description": "Steps left: kind, message, command.",
-          "type": "array"
-        },
-        "ready": {
-          "description": "Some domain can send.",
-          "type": "boolean"
-        },
-        "sendable_domains": {
-          "description": "Domains you can send from now.",
-          "type": "array"
-        },
-        "summary": {
-          "description": "Plain-language status.",
-          "type": "string"
-        }
-      },
-      "type": [
-        "object",
-        "null"
-      ]
-    },
-    "error": {
-      "description": "Why the call was refused; absent on success.",
-      "properties": {
-        "code": {
-          "description": "Error code to branch on.",
-          "type": "string"
-        },
-        "message": {
-          "description": "What went wrong, in words.",
-          "type": "string"
-        }
-      },
-      "type": [
-        "object",
-        "null"
-      ]
-    },
-    "success": {
-      "description": "True when data holds the result.",
-      "type": "boolean"
-    }
-  },
-  "type": "object"
-}

Added value: +{
+  "description": "Your domains and what each still needs.",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "domain": {
+        "description": "Domain name.",
+        "type": "string"
+      },
+      "id": {
+        "description": "Domain id.",
+        "type": "string"
+      },
+      "outbound_verified": {
+        "description": "True when SPF, DKIM and DMARC are verified.",
+        "type": "boolean"
+      },
+      "ownership_verified": {
+        "description": "True when ownership is proven.",
+        "type": "boolean"
+      },
+      "status": {
+        "description": "sendable, pending_outbound_dns, pending_ownership or inactive.",
+        "type": "string"
+      }
+    },
+    "required": [
+      "id",
+      "domain",
+      "status",
+      "ownership_verified",
+      "outbound_verified"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "Steps left, most important first; empty when ready.",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "command": {
+        "description": "CLI command that does it; absent when there is none.",
+        "type": "string"
+      },
+      "kind": {
+        "description": "The step, such as add_domain or verify_domain.",
+        "type": "string"
+      },
+      "message": {
+        "description": "What to do, in words.",
+        "type": "string"
+      }
+    },
+    "required": [
+      "kind",
+      "message"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "True when some domain can send now.",
+  "type": "boolean"
+}

Added value: +{
+  "description": "Domains you can send from now.",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

Removed value: -{
-  "description": "HTTP status; 2xx on success.",
-  "type": "number"
-}

Added value: +{
+  "description": "Plain-language status, to tell the user.",
+  "type": "string"
+}

Removed value: -{
-  "description": "Tool that answered.",
-  "type": "string"
-}

Previous value: -[
-  "tool",
-  "status",
-  "data"
-]New value: +[
+  "ready",
+  "summary",
+  "sendable_domains",
+  "domains",
+  "next_actions",
+  "can_send_to"
+]

Previous value: -"Your API key from createEmailAddress, used in place of sign-in."New value: +"API key from createEmailAddress, used in place of sign-in."

Previous value: -"API response; result in data."New value: +"API response: the result in data, or error."

Previous value: -"Refusal: code, message."New value: +"Why the call was refused; absent on success."

Added value: +{
+  "code": {
+    "description": "Error code to branch on.",
+    "type": "string"
+  },
+  "message": {
+    "description": "What went wrong, in words.",
+    "type": "string"
+  }
+}

Added value: +[
+  "object",
+  "null"
+]

Previous value: -"Accepted."New value: +"True when data holds the result."

Previous value: -[
-  "object",
-  "string",
-  "null"
-]New value: +"object"

Previous value: -"HTTP status."New value: +"HTTP status; 2xx on success."

Added value: +"Tool that answered."

Previous value: -"Where you can send from, and to whom."New value: +"Envelope; the result is in data.data."

Previous value: -"API body."New value: +"API response; result in data."

Added value: +"Where you can send from, and to whom."

Previous value: -"Why refused."New value: +"Refusal: code, message."

Added value: +"Any recipient is allowed."

Added value: +"Who is allowed: each has a type and a description."

Previous value: -"Your domains: id, domain, status."New value: +"Your domains and what each still needs."

Added value: +{
+  "properties": {
+    "domain": {
+      "type": "string"
+    },
+    "id": {
+      "type": "string"
+    },
+    "outbound_verified": {
+      "description": "SPF, DKIM and DMARC verified.",
+      "type": "boolean"
+    },
+    "ownership_verified": {
+      "type": "boolean"
+    },
+    "status": {
+      "description": "sendable, pending_outbound_dns, pending_ownership, inactive.",
+      "type": "string"
+    }
+  },
+  "type": "object"
+}

Previous value: -"Key createEmailAddress returned. Send it when no account is signed in."New value: +"Your API key from createEmailAddress, used in place of sign-in."

Previous value: -"Who you may email: summary, any_recipient, rules."New value: +"Who you may email."

Added value: +{
+  "any_recipient": {
+    "type": "boolean"
+  },
+  "rules": {
+    "type": "array"
+  },
+  "summary": {
+    "description": "What to tell the user.",
+    "type": "string"
+  }
+}

Previous value: -"The api_key from createEmailAddress, for a connection with no signed-in account. Leave it out when signed in."New value: +"Key createEmailAddress returned. Send it when no account is signed in."

Previous value: -"Allowed recipients."New value: +"Who you may email: summary, any_recipient, rules."

Previous value: -"Domains and their state."New value: +"Your domains: id, domain, status."

Previous value: -"Steps left."New value: +"Steps left: kind, message, command."

Previous value: -"Domains you can send from."New value: +"Domains you can send from now."

Previous value: -"Only when no account is signed in: the api_key createEmailAddress returned, passed as is on every later call. Omit it when the user is signed in."New value: +"The api_key from createEmailAddress, for a connection with no signed-in account. Leave it out when signed in."

Added value: +"Where you can send from, and to whom."

Added value: +"API body."

Added value: +"Domains and their state."

Added value: +"Steps left."

Added value: +"Some domain can send."

Previous value: -"Domains you can send from now."New value: +"Domains you can send from."

Added value: +"Plain-language status."

Added value: +"Why refused."

Added value: +"Accepted."

Added value: +"HTTP status."

Previous value: -"Primitive API key (prim_...). Only needed when this connection has no signed-in account: pass the api_key returned by createEmailAddress, unchanged, on every call for the rest of the conversation. Omit it when the user is signed in."New value: +"Only when no account is signed in: the api_key createEmailAddress returned, passed as is on every later call. Omit it when the user is signed in."

Added value: +"Allowed recipients."

Added value: +"Domains you can send from now."

Removed value: -false

Added value: +{
+  "data": {
+    "properties": {
+      "can_send_to": {
+        "type": "object"
+      },
+      "domains": {
+        "type": "array"
+      },
+      "next_actions": {
+        "type": "array"
+      },
+      "ready": {
+        "type": "boolean"
+      },
+      "sendable_domains": {
+        "type": "array"
+      },
+      "summary": {
+        "type": "string"
+      }
+    },
+    "type": [
+      "object",
+      "null"
+    ]
+  },
+  "error": {},
+  "success": {
+    "type": "boolean"
+  }
+}

Added value: +[
+  "object",
+  "string",
+  "null"
+]

Removed value: -{
-  "type": "string"
-}

Added value: +{
+  "description": "Primitive API key (prim_...). Only needed when this connection has no signed-in account: pass the api_key returned by createEmailAddress, unchanged, on every call for the rest of the conversation. Omit it when the user is signed in.",
+  "maxLength": 200,
+  "minLength": 8,
+  "type": "string"
+}