Previous value: -"html, text or none: what body_text was made from. Not with full."New value: +"What body_text was made from. Not with full."

Added value: +[
+  "html",
+  "text",
+  "none"
+]

Previous value: -"The body as text. Quoted history is left out and links are [n] markers, unless full. Null when there is none."New value: +"The body as text. Quoted history is left out and links are [n] markers, unless full. Null when there is none or withheld."

Added value: +[
+  "pending",
+  "processing",
+  "complete",
+  "failed",
+  null
+]

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

Previous value: -"What body_text was made from. Not with full."New value: +"html, text or none: what body_text was made from. Not with full."

Removed value: -[
-  "html",
-  "text",
-  "none"
-]

Previous value: -"The body as text. Quoted history is left out and links are [n] markers, unless full. Null when there is none or withheld."New value: +"The body as text. Quoted history is left out and links are [n] markers, unless full. Null when there is none."

Removed value: -[
-  "pending",
-  "processing",
-  "complete",
-  "failed",
-  null
-]

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

Previous value: -"html, text or none: what body_text was made from. Not with full."New value: +"What body_text was made from. Not with full."

Added value: +[
+  "html",
+  "text",
+  "none"
+]

Previous value: -"The body as text. Quoted history is left out and links are [n] markers, unless full. Null when there is none."New value: +"The body as text. Quoted history is left out and links are [n] markers, unless full. Null when there is none or withheld."

Added value: +[
+  "pending",
+  "processing",
+  "complete",
+  "failed",
+  null
+]

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

Added value: +false

Previous value: -"Envelope; the result is in data.data."New value: +"One inbound email."

Added value: +{
+  "description": "Files on the email; read one with getEmailAttachment.",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "content_type": {
+        "description": "Media type, such as application/pdf.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "filename": {
+        "description": "File name; null when the email gave none.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "part_index": {
+        "description": "Pass to getEmailAttachment to read it.",
+        "type": [
+          "integer",
+          "null"
+        ]
+      },
+      "size_bytes": {
+        "description": "Size in bytes.",
+        "type": [
+          "integer",
+          "null"
+        ]
+      }
+    },
+    "required": [
+      "filename",
+      "content_type",
+      "size_bytes",
+      "part_index"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "full only: SPF, DKIM and DMARC results; their keys vary by message.",
+  "type": "object"
+}

Added value: +{
+  "description": "Length of the whole body, in characters. Not with full.",
+  "type": "integer"
+}

Added value: +{
+  "description": "full only: the HTML body.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Added value: +{
+  "description": "True when the HTML was too deep to read in full. Not with full.",
+  "type": "boolean"
+}

Added value: +{
+  "description": "Pass as offset to read on; null at the end. Not with full.",
+  "type": [
+    "integer",
+    "null"
+  ]
+}

Added value: +{
+  "description": "Where this part of the body starts. Not with full.",
+  "type": "integer"
+}

Added value: +{
+  "description": "html, text or none: what body_text was made from. Not with full.",
+  "type": "string"
+}

Added value: +{
+  "description": "The body as text. Quoted history is left out and links are [n] markers, unless full. Null when there is none.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Removed value: -{
-  "description": "API response: the result in data, or error.",
-  "properties": {
-    "data": {
-      "description": "One inbound email.",
-      "properties": {
-        "attachments": {
-          "description": "Read one with getEmailAttachment.",
-          "items": {
-            "properties": {
-              "content_type": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "filename": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "part_index": {
-                "description": "Pass to getEmailAttachment.",
-                "type": [
-                  "number",
-                  "string",
-                  "null"
-                ]
-              },
-              "size_bytes": {
-                "type": [
-                  "number",
-                  "string",
-                  "null"
-                ]
-              }
-            },
-            "type": "object"
-          },
-          "type": "array"
-        },
-        "auth": {
-          "description": "Full only: SPF, DKIM, DMARC results.",
-          "type": "object"
-        },
-        "body_chars": {
-          "description": "Whole body length.",
-          "type": [
-            "number",
-            "string"
-          ]
-        },
-        "body_html": {
-          "description": "HTML body, full only.",
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "body_incomplete": {
-          "description": "HTML too deep to read in full.",
-          "type": "boolean"
-        },
-        "body_next_offset": {
-          "description": "Next offset; null at the end.",
-          "type": [
-            "number",
-            "string",
-            "null"
-          ]
-        },
-        "body_offset": {
-          "description": "Where this page starts.",
-          "type": [
-            "number",
-            "string"
-          ]
-        },
-        "body_source": {
-          "description": "html, text or none: what body_text came from.",
-          "type": "string"
-        },
-        "body_text": {
-          "description": "No quoted history unless full.",
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "from": {
-          "description": "From header.",
-          "type": "string"
-        },
-        "from_email": {
-          "description": "Sender address.",
-          "type": "string"
-        },
-        "id": {
-          "description": "Email id.",
-          "type": "string"
-        },
-        "image_count": {
-          "description": "Images in the body.",
-          "type": [
-            "number",
-            "string"
-          ]
-        },
-        "link_count": {
-          "description": "Links in the body.",
-          "type": [
-            "number",
-            "string"
-          ]
-        },
-        "links": {
-          "description": "Targets the links argument asked for.",
-          "items": {
-            "properties": {
-              "n": {
-                "description": "The [n] marker in body_text.",
-                "type": [
-                  "number",
-                  "string"
-                ]
-              },
-              "url": {
-                "type": "string"
-              }
-            },
-            "type": "object"
-          },
-          "type": "array"
-        },
-        "parse_status": {
-          "description": "pending or processing: read again shortly.",
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "parsed": {
-          "description": "Full only: the parsed message.",
-          "type": "object"
-        },
-        "preheader": {
-          "description": "Preview text; not with full.",
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "quoted_chars_removed": {
-          "description": "Quoted text left out.",
-          "type": [
-            "number",
-            "string"
-          ]
-        },
-        "received_at": {
-          "description": "Arrival time.",
-          "type": "string"
-        },
-        "replies": {
-          "description": "Full only: your replies.",
-          "items": {
-            "properties": {
-              "created_at": {
-                "type": "string"
-              },
-              "id": {
-                "type": "string"
-              },
-              "status": {
-                "type": "string"
-              },
-              "subject": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              }
-            },
-            "type": "object"
-          },
-          "type": "array"
-        },
-        "status": {
-          "description": "Processing stage.",
-          "type": "string"
-        },
-        "subject": {
-          "description": "Subject line.",
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "thread_id": {
-          "description": "Conversation it belongs to.",
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "to": {
-          "description": "Recipient.",
-          "type": "string"
-        },
-        "to_email": {
-          "description": "Recipient address.",
-          "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": "Sender, as the From header shows it.",
+  "type": "string"
+}

Added value: +{
+  "description": "full only: sender address.",
+  "type": "string"
+}

Added value: +{
+  "description": "Email id.",
+  "type": "string"
+}

Added value: +{
+  "description": "Images in the body. Not with full.",
+  "type": "integer"
+}

Added value: +{
+  "description": "Links in the body. Not with full.",
+  "type": "integer"
+}

Added value: +{
+  "description": "With the links argument: the link targets asked for.",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "n": {
+        "description": "The [n] marker in body_text.",
+        "type": "integer"
+      },
+      "url": {
+        "description": "Where the link goes.",
+        "type": "string"
+      }
+    },
+    "required": [
+      "n",
+      "url"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "Parse stage, when known. pending or processing: read again shortly; failed: the body may be incomplete.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Added value: +{
+  "description": "full only: the parsed message as stored; its keys vary by message.",
+  "type": "object"
+}

Added value: +{
+  "description": "Inbox preview text. Not with full.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Added value: +{
+  "description": "Characters of quoted history left out. Not with full.",
+  "type": "integer"
+}

Added value: +{
+  "description": "Arrival time.",
+  "type": "string"
+}

Added value: +{
+  "description": "full only: replies you sent to it.",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "created_at": {
+        "description": "When it was sent.",
+        "type": "string"
+      },
+      "id": {
+        "description": "Sent email id, for getSentEmail.",
+        "type": "string"
+      },
+      "status": {
+        "description": "Delivery state.",
+        "type": "string"
+      },
+      "subject": {
+        "description": "Subject line.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "to_address": {
+        "description": "Recipient address.",
+        "type": "string"
+      }
+    },
+    "required": [
+      "id",
+      "status",
+      "to_address",
+      "subject",
+      "created_at"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

Previous value: -"HTTP status; 2xx on success."New value: +"full only: processing stage."

Previous value: -"number"New value: +"string"

Added value: +{
+  "description": "Subject line.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Added value: +{
+  "description": "Conversation id, for getConversation; null when it is in none.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Added value: +{
+  "description": "Recipient address.",
+  "type": "string"
+}

Added value: +{
+  "description": "full only: recipient address.",
+  "type": "string"
+}

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

Previous value: -[
-  "tool",
-  "status",
-  "data"
-]New value: +[
+  "id",
+  "thread_id",
+  "received_at",
+  "from",
+  "to",
+  "subject",
+  "body_text",
+  "attachments"
+]

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: -"Preview text."New value: +"Preview text; not with full."

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: -"One inbound email."New value: +"Envelope; the result is in data.data."

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

Added value: +"One inbound email."

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

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: -"Each has a part_index."New value: +"Read one with getEmailAttachment."

Added value: +{
+  "properties": {
+    "content_type": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "filename": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "part_index": {
+      "description": "Pass to getEmailAttachment.",
+      "type": [
+        "number",
+        "string",
+        "null"
+      ]
+    },
+    "size_bytes": {
+      "type": [
+        "number",
+        "string",
+        "null"
+      ]
+    }
+  },
+  "type": "object"
+}

Previous value: -"SPF, DKIM, DMARC results."New value: +"Full only: SPF, DKIM, DMARC results."

Added value: +{
+  "description": "HTML too deep to read in full.",
+  "type": "boolean"
+}

Added value: +{
+  "description": "Where this page starts.",
+  "type": [
+    "number",
+    "string"
+  ]
+}

Added value: +{
+  "description": "html, text or none: what body_text came from.",
+  "type": "string"
+}

Added value: +"Sender address."

Added value: +"Email id."

Added value: +{
+  "description": "Images in the body.",
+  "type": [
+    "number",
+    "string"
+  ]
+}

Previous value: -"Requested link targets."New value: +"Targets the links argument asked for."

Added value: +{
+  "properties": {
+    "n": {
+      "description": "The [n] marker in body_text.",
+      "type": [
+        "number",
+        "string"
+      ]
+    },
+    "url": {
+      "type": "string"
+    }
+  },
+  "type": "object"
+}

Added value: +{
+  "description": "Full only: the parsed message.",
+  "type": "object"
+}

Previous value: -"Replies sent to it."New value: +"Full only: your replies."

Added value: +{
+  "properties": {
+    "created_at": {
+      "type": "string"
+    },
+    "id": {
+      "type": "string"
+    },
+    "status": {
+      "type": "string"
+    },
+    "subject": {
+      "type": [
+        "string",
+        "null"
+      ]
+    }
+  },
+  "type": "object"
+}

Added value: +"Subject line."

Added value: +"Conversation it belongs to."

Added value: +"Recipient address."

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: -"Set true for the stored record, with the HTML body, links, quoted history and authentication results; the default is a compact view for reading."New value: +"Return the stored record, with the HTML body, links, quoted history and authentication results, instead of the compact view for reading."

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."

Previous value: -"Set true for the record as stored. By default the result is a compact view for reading, which leaves out the HTML body, link targets, quoted history, authentication results, routing and webhook delivery state."New value: +"Set true for the stored record, with the HTML body, links, quoted history and authentication results; the default is a compact view for reading."

Previous value: -"Which link targets to return, as a links array of { n, url }: \"all\", or a comma-separated list of [n] numbers such as \"3,7\" (at most 50). Omit for none. Not used with full."New value: +"Link targets to include in `links`: all of them, or the [n] numbers you want. Leave it out for none. Not used with full."

Added value: +"^(all|\\s*[1-9]\\d{0,14}\\s*(,\\s*[1-9]\\d{0,14}\\s*){0,49})(?![\\s\\S])"

Added value: +"One inbound email."

Added value: +"API body."

Added value: +"SPF, DKIM, DMARC results."

Added value: +"HTML body, full only."

Added value: +"From header."

Added value: +"Links in the body."

Added value: +"Requested link targets."

Added value: +"Preview text."

Added value: +"Quoted text left out."

Added value: +"Arrival time."

Added value: +"Replies sent to it."

Added value: +"Processing stage."

Added value: +"Recipient."

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."

Previous value: -"Most characters of body_text to return in this call; read the rest with offset. Not used with full."New value: +"How much of body_text to return per call; read the rest with offset. Not used with full."

Added value: +"Each has a part_index."

Added value: +"Whole body length."

Added value: +"Next offset; null at the end."

Added value: +"No quoted history unless full."

Added value: +"pending or processing: read again shortly."

Previous value: -"Most characters of body_text to return, 500 to 100000. Read the rest with offset. Not used with full."New value: +"Most characters of body_text to return in this call; read the rest with offset. Not used with full."

Removed value: -false

Added value: +{
+  "data": {
+    "properties": {
+      "attachments": {
+        "type": "array"
+      },
+      "auth": {
+        "type": "object"
+      },
+      "body_chars": {
+        "type": [
+          "number",
+          "string"
+        ]
+      },
+      "body_html": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "body_next_offset": {
+        "type": [
+          "number",
+          "string",
+          "null"
+        ]
+      },
+      "body_text": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "from": {
+        "type": "string"
+      },
+      "from_email": {
+        "type": "string"
+      },
+      "id": {
+        "type": "string"
+      },
+      "link_count": {
+        "type": [
+          "number",
+          "string"
+        ]
+      },
+      "links": {
+        "type": "array"
+      },
+      "parse_status": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "preheader": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "quoted_chars_removed": {
+        "type": [
+          "number",
+          "string"
+        ]
+      },
+      "received_at": {
+        "type": "string"
+      },
+      "replies": {
+        "type": "array"
+      },
+      "status": {
+        "type": "string"
+      },
+      "subject": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "thread_id": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "to": {
+        "type": "string"
+      },
+      "to_email": {
+        "type": "string"
+      }
+    },
+    "type": [
+      "object",
+      "null"
+    ]
+  },
+  "error": {},
+  "success": {
+    "type": "boolean"
+  }
+}

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

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

Added value: +{
+  "default": false,
+  "description": "Set true for the record as stored. By default the result is a compact view for reading, which leaves out the HTML body, link targets, quoted history, authentication results, routing and webhook delivery state.",
+  "type": "boolean"
+}

Added value: +{
+  "description": "Which link targets to return, as a links array of { n, url }: \"all\", or a comma-separated list of [n] numbers such as \"3,7\" (at most 50). Omit for none. Not used with full.",
+  "type": "string"
+}

Added value: +{
+  "default": 16000,
+  "description": "Most characters of body_text to return, 500 to 100000. Read the rest with offset. Not used with full.",
+  "maximum": 100000,
+  "minimum": 500,
+  "type": "integer"
+}

Added value: +{
+  "default": 0,
+  "description": "Character position in the body to start from: the body_next_offset of the previous result. Not used with full.",
+  "minimum": 0,
+  "type": "integer"
+}

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"
+}

Added value: +"Inbound email ID from listEmails or searchEmails."