npm - @pidgeon-ai/sdk - Versions diffs - 1.1.0 → 1.2.0 - Mend

@pidgeon-ai/sdk 1.1.0 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (6) hide show

package/dist/index.d.ts CHANGED Viewed

@@ -468,7 +468,7 @@ type Message = {
         downloadable: boolean;
     }>;
     /**
-     * The calendar part this message carried, or null. See `prd/calendar.md`.
+     * The calendar part this message carried, or null — the invitation, who was asked, and what they answered.
      */
     invitation: {
         method: string | null;
@@ -1176,7 +1176,13 @@ type Error = {
 };
 type AgentSignUpData = {
     body: {
+        /**
+         * The local part you want on the shared domain.
+         */
         username: string;
+        /**
+         * A person who can be reached. They receive the code that finishes the signup.
+         */
         human_email: string;
         source?: string | null;
     };
@@ -1190,7 +1196,7 @@ type AgentSignUpErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -1210,7 +1216,13 @@ type AgentSignUpResponses = {
 type AgentSignUpResponse = AgentSignUpResponses[keyof AgentSignUpResponses];
 type AgentAttachHumanData = {
     body: {
+        /**
+         * From the signup this is finishing.
+         */
         signup_id: string;
+        /**
+         * A person who can be reached. They receive the code that finishes the signup.
+         */
         human_email: string;
     };
     path?: never;
@@ -1223,7 +1235,7 @@ type AgentAttachHumanErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -1243,6 +1255,9 @@ type AgentAttachHumanResponses = {
 type AgentAttachHumanResponse = AgentAttachHumanResponses[keyof AgentAttachHumanResponses];
 type AgentVerifyData = {
     body: {
+        /**
+         * From the signup this is finishing.
+         */
         signup_id: string;
         code: string;
     };
@@ -1256,7 +1271,7 @@ type AgentVerifyErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -1293,7 +1308,7 @@ type IdentitiesListErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -1318,15 +1333,49 @@ type IdentitiesListResponses = {
 type IdentitiesListResponse = IdentitiesListResponses[keyof IdentitiesListResponses];
 type IdentitiesCreateData = {
     body: {
+        /**
+         * From `GET /domains`, or the `domain_id` on any address you already have.
+         */
         domain_id?: string;
+        /**
+         * A domain name you own, or the shared one. An alternative to `domain_id`.
+         */
         domain?: string;
+        /**
+         * A whole address — the local part and the domain in one. An alternative to the other two.
+         */
         address?: string;
+        /**
+         * Everything before the `@`.
+         */
         local_part?: string;
+        /**
+         * The name a recipient sees beside the address.
+         */
         display_name?: string | null;
+        /**
+         * Whether it keeps mail. With an inbox what arrives is stored and a person can open it; without one it becomes an event and your webhook fires. Defaults from `type`.
+         */
+        inbox?: boolean;
+        /**
+         * A label for what this address is for. It does not change what the address can do — that is `inbox`.
+         */
         type?: 'human' | 'team' | 'application' | 'workflow' | 'agent';
+        /**
+         * Who answers: a person, software, or both.
+         */
         mode?: 'human' | 'automated' | 'hybrid';
+        /**
+         * When it stops accepting mail. Expiry suspends; it never deletes, so the correspondence survives.
+         */
         expires_at?: string | null;
+        /**
+         * Who it may write to. `reply_only` makes an address structurally unable to start a conversation with a stranger.
+         */
         send_policy?: 'open' | 'reply_only' | 'list';
+        /**
+         * Your own opaque grouping — a customer id, whatever your side calls it. Never parsed here.
+         */
         tenant_id?: string | null;
     };
     path?: never;
@@ -1339,7 +1388,7 @@ type IdentitiesCreateErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -1371,7 +1420,7 @@ type IdentitiesDeleteErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -1403,7 +1452,7 @@ type IdentitiesGetErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -1423,14 +1472,29 @@ type IdentitiesGetResponses = {
 type IdentitiesGetResponse = IdentitiesGetResponses[keyof IdentitiesGetResponses];
 type IdentitiesUpdateData = {
     body: {
+        /**
+         * The name a recipient sees beside the address.
+         */
         display_name?: string | null;
+        /**
+         * Who answers: a person, software, or both.
+         */
         mode?: 'human' | 'automated' | 'hybrid';
         capabilities?: {
             [key: string]: boolean;
         };
         status?: 'active' | 'suspended' | 'archived';
+        /**
+         * When it stops accepting mail. Expiry suspends; it never deletes, so the correspondence survives.
+         */
         expires_at?: string | null;
+        /**
+         * Who it may write to. `reply_only` makes an address structurally unable to start a conversation with a stranger.
+         */
         send_policy?: 'open' | 'reply_only' | 'list';
+        /**
+         * Your own opaque grouping — a customer id, whatever your side calls it. Never parsed here.
+         */
         tenant_id?: string | null;
     };
     path: {
@@ -1445,7 +1509,7 @@ type IdentitiesUpdateErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -1479,7 +1543,7 @@ type IdentitiesAccessDeleteErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -1511,7 +1575,7 @@ type IdentitiesAccessGetErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -1534,6 +1598,9 @@ type IdentitiesAccessCreateData = {
         user_id?: string;
         api_key_id?: string;
         everyone?: true;
+        /**
+         * What a key may do. Give an agent the narrowest one that works.
+         */
         access: 'read' | 'send' | 'admin';
     };
     path: {
@@ -1548,7 +1615,7 @@ type IdentitiesAccessCreateErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -1582,7 +1649,7 @@ type IdentitiesSendRulesDeleteErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -1614,7 +1681,7 @@ type IdentitiesSendRulesGetErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -1649,7 +1716,7 @@ type IdentitiesSendRulesCreateErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -1683,7 +1750,7 @@ type IdentitiesReceiveRulesDeleteErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -1715,7 +1782,7 @@ type IdentitiesReceiveRulesGetErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -1750,7 +1817,7 @@ type IdentitiesReceiveRulesCreateErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -1785,7 +1852,7 @@ type IdentitiesSuspendTenantErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -1817,7 +1884,7 @@ type LabelsListErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -1842,6 +1909,9 @@ type LabelsListResponses = {
 type LabelsListResponse = LabelsListResponses[keyof LabelsListResponses];
 type LabelsCreateData = {
     body: {
+        /**
+         * The address this belongs to.
+         */
         identity_id: string;
         name: string;
         colour?: string;
@@ -1856,7 +1926,7 @@ type LabelsCreateErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -1888,7 +1958,7 @@ type LabelsDeleteErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -1923,7 +1993,7 @@ type LabelsUpdateErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -1957,7 +2027,7 @@ type ThreadsLabelsDeleteErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -1989,7 +2059,7 @@ type ThreadsLabelsGetErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -2028,7 +2098,7 @@ type ThreadsLabelsCreateErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -2070,7 +2140,7 @@ type MessagesListInThreadErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -2095,14 +2165,41 @@ type MessagesListInThreadResponses = {
 type MessagesListInThreadResponse = MessagesListInThreadResponses[keyof MessagesListInThreadResponses];
 type MessagesSendData = {
     body: {
+        /**
+         * An address on a domain you own, and one this key may send from.
+         */
         from: string;
+        /**
+         * One address or several. A string is accepted for the single case.
+         */
         to: string | Array<string>;
+        /**
+         * Copied, and visible to everybody who receives the message.
+         */
         cc?: string | Array<string>;
+        /**
+         * Copied, and visible to nobody else.
+         */
         bcc?: string | Array<string>;
+        /**
+         * Left off a reply, where the thread already has one.
+         */
         subject?: string;
+        /**
+         * The plain-text body. Send this even when you send `html` — some clients only read it.
+         */
         text?: string;
+        /**
+         * The rich body. Sanitised on the way in; scripts and remote content are removed.
+         */
         html?: string;
+        /**
+         * Ids from `POST /attachments`, uploaded before the message that carries them. Up to 20.
+         */
         attachment_ids?: Array<string>;
+        /**
+         * The message being answered. Keeps the conversation together in the recipient’s client too.
+         */
         in_reply_to?: string | null;
     };
     path?: never;
@@ -2115,7 +2212,7 @@ type MessagesSendErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -2126,10 +2223,10 @@ type MessagesSendErrors = {
 type MessagesSendError = MessagesSendErrors[keyof MessagesSendErrors];
 type MessagesSendResponses = {
     /**
-     * The sent message.
+     * Accepted.
      */
-    201: {
-        data: Message;
+    202: {
+        data: Sent;
     };
 };
 type MessagesSendResponse = MessagesSendResponses[keyof MessagesSendResponses];
@@ -2156,7 +2253,7 @@ type MessagesSearchErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -2194,7 +2291,7 @@ type MessagesActErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -2226,7 +2323,7 @@ type MessagesUndoErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -2258,7 +2355,7 @@ type MessagesGetErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -2294,7 +2391,7 @@ type MessagesUpdateErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -2314,11 +2411,29 @@ type MessagesUpdateResponses = {
 type MessagesUpdateResponse = MessagesUpdateResponses[keyof MessagesUpdateResponses];
 type MessagesReplyData = {
     body: {
+        /**
+         * The plain-text body. Send this even when you send `html` — some clients only read it.
+         */
         text?: string;
+        /**
+         * The rich body. Sanitised on the way in; scripts and remote content are removed.
+         */
         html?: string;
+        /**
+         * One address or several. A string is accepted for the single case.
+         */
         to?: Array<string>;
+        /**
+         * Copied, and visible to everybody who receives the message.
+         */
         cc?: Array<string>;
+        /**
+         * Copied, and visible to nobody else.
+         */
         bcc?: Array<string>;
+        /**
+         * Ids from `POST /attachments`, uploaded before the message that carries them. Up to 20.
+         */
         attachment_ids?: Array<string>;
     };
     path: {
@@ -2333,7 +2448,7 @@ type MessagesReplyErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -2353,11 +2468,29 @@ type MessagesReplyResponses = {
 type MessagesReplyResponse = MessagesReplyResponses[keyof MessagesReplyResponses];
 type MessagesReplyAllData = {
     body: {
+        /**
+         * The plain-text body. Send this even when you send `html` — some clients only read it.
+         */
         text?: string;
+        /**
+         * The rich body. Sanitised on the way in; scripts and remote content are removed.
+         */
         html?: string;
+        /**
+         * One address or several. A string is accepted for the single case.
+         */
         to?: Array<string>;
+        /**
+         * Copied, and visible to everybody who receives the message.
+         */
         cc?: Array<string>;
+        /**
+         * Copied, and visible to nobody else.
+         */
         bcc?: Array<string>;
+        /**
+         * Ids from `POST /attachments`, uploaded before the message that carries them. Up to 20.
+         */
         attachment_ids?: Array<string>;
     };
     path: {
@@ -2372,7 +2505,7 @@ type MessagesReplyAllErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -2392,11 +2525,29 @@ type MessagesReplyAllResponses = {
 type MessagesReplyAllResponse = MessagesReplyAllResponses[keyof MessagesReplyAllResponses];
 type MessagesForwardData = {
     body: {
+        /**
+         * The plain-text body. Send this even when you send `html` — some clients only read it.
+         */
         text?: string;
+        /**
+         * The rich body. Sanitised on the way in; scripts and remote content are removed.
+         */
         html?: string;
+        /**
+         * One address or several. A string is accepted for the single case.
+         */
         to?: Array<string>;
+        /**
+         * Copied, and visible to everybody who receives the message.
+         */
         cc?: Array<string>;
+        /**
+         * Copied, and visible to nobody else.
+         */
         bcc?: Array<string>;
+        /**
+         * Ids from `POST /attachments`, uploaded before the message that carries them. Up to 20.
+         */
         attachment_ids?: Array<string>;
     };
     path: {
@@ -2411,7 +2562,7 @@ type MessagesForwardErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -2443,7 +2594,7 @@ type MessagesRawErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -2484,7 +2635,7 @@ type ThreadsListErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -2521,7 +2672,7 @@ type ThreadsGetErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -2557,7 +2708,7 @@ type ThreadsUpdateErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -2593,7 +2744,7 @@ type DomainsListErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -2618,6 +2769,9 @@ type DomainsListResponses = {
 type DomainsListResponse = DomainsListResponses[keyof DomainsListResponses];
 type DomainsCreateData = {
     body: {
+        /**
+         * A domain name you own, or the shared one. An alternative to `domain_id`.
+         */
         domain: string;
     };
     path?: never;
@@ -2630,7 +2784,7 @@ type DomainsCreateErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -2662,7 +2816,7 @@ type DomainsZoneFileErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -2697,7 +2851,7 @@ type DomainsGetSetupLinkErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -2729,7 +2883,7 @@ type DomainsVerifyErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -2761,7 +2915,7 @@ type DomainsDeleteErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -2793,7 +2947,7 @@ type DomainsGetErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -2827,7 +2981,7 @@ type DomainsUpdateErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -2859,7 +3013,7 @@ type RoutingListErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -2911,7 +3065,7 @@ type RoutingCreateErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -2943,7 +3097,7 @@ type RoutingDeleteErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -2977,7 +3131,7 @@ type RoutingUpdateErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -3009,7 +3163,7 @@ type MailboxesListErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -3048,7 +3202,7 @@ type MailboxesChangesErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -3087,7 +3241,7 @@ type MailboxesEmptyTrashErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -3127,7 +3281,7 @@ type MailboxesListFolderErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -3162,7 +3316,7 @@ type KeysListErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -3189,7 +3343,13 @@ type KeysCreateData = {
     body: {
         name: string;
         identity_ids: Array<string>;
+        /**
+         * What a key may do. Give an agent the narrowest one that works.
+         */
         access?: 'read' | 'send' | 'admin';
+        /**
+         * When it stops accepting mail. Expiry suspends; it never deletes, so the correspondence survives.
+         */
         expires_at?: string | null;
     };
     path?: never;
@@ -3202,7 +3362,7 @@ type KeysCreateErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -3234,7 +3394,7 @@ type KeysRevokeErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -3266,7 +3426,7 @@ type KeysGetErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -3300,7 +3460,7 @@ type KeysUpdateErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -3332,7 +3492,7 @@ type AppPasswordsListErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -3357,6 +3517,9 @@ type AppPasswordsListResponses = {
 type AppPasswordsListResponse = AppPasswordsListResponses[keyof AppPasswordsListResponses];
 type AppPasswordsCreateData = {
     body: {
+        /**
+         * The address this belongs to.
+         */
         identity_id: string;
         name: string;
     };
@@ -3370,7 +3533,7 @@ type AppPasswordsCreateErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -3402,7 +3565,7 @@ type AppPasswordsRevokeErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -3432,7 +3595,7 @@ type WorkspaceGetErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -3462,7 +3625,7 @@ type WorkspaceMembersErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -3506,7 +3669,7 @@ type EventsListErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -3543,7 +3706,7 @@ type EventsGetErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -3579,7 +3742,7 @@ type WebhooksListErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -3604,7 +3767,13 @@ type WebhooksListResponses = {
 type WebhooksListResponse = WebhooksListResponses[keyof WebhooksListResponses];
 type WebhooksCreateData = {
     body: {
+        /**
+         * Where we POST. HTTPS, and it has to answer within a few seconds.
+         */
         url: string;
+        /**
+         * The address this belongs to.
+         */
         identity_id?: string | null;
         event_types?: Array<'message.received' | 'message.sent' | 'message.delivered' | 'message.bounced' | 'message.rejected' | 'message.complained' | 'message.spam' | 'message.invitation' | 'message.archived' | 'message.deleted' | 'calendar.event.created' | 'calendar.event.updated' | 'calendar.event.deleted' | 'calendar.event.starting' | 'calendar.event.ending' | 'calendar.event.responded' | 'thread.created' | 'thread.updated' | 'thread.assigned' | 'thread.unassigned' | 'identity.created' | 'identity.updated' | 'identity.suspended' | 'identity.transferred' | 'domain.verified'>;
     };
@@ -3618,7 +3787,7 @@ type WebhooksCreateErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -3650,7 +3819,7 @@ type WebhooksDeleteErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -3682,7 +3851,7 @@ type WebhooksGetErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -3716,7 +3885,7 @@ type WebhooksUpdateErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -3748,7 +3917,7 @@ type WebhooksGetHeadersErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -3784,7 +3953,7 @@ type WebhooksUpdateHeadersErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -3817,7 +3986,7 @@ type WebhooksDeliveriesErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -3854,7 +4023,7 @@ type WebhooksReplayErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -3889,7 +4058,7 @@ type MessagesRespondToInvitationErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -3927,7 +4096,7 @@ type CalendarGetErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -3947,6 +4116,9 @@ type CalendarGetResponses = {
 type CalendarGetResponse = CalendarGetResponses[keyof CalendarGetResponses];
 type CalendarUpdateData = {
     body: {
+        /**
+         * An IANA name, like `Europe/Lisbon`. The times above are read in it.
+         */
         timezone: string;
     };
     headers?: {
@@ -3967,7 +4139,7 @@ type CalendarUpdateErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -4005,7 +4177,7 @@ type CalendarListEventsErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -4033,6 +4205,9 @@ type CalendarCreateEventData = {
         title: string;
         start: string;
         end: string;
+        /**
+         * An IANA name, like `Europe/Lisbon`. The times above are read in it.
+         */
         timezone?: string | null;
         all_day?: boolean;
         description?: string | null;
@@ -4064,7 +4239,7 @@ type CalendarCreateEventErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -4107,7 +4282,7 @@ type CalendarRespondToEventErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -4144,7 +4319,7 @@ type CalendarListEventInstancesErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -4186,7 +4361,7 @@ type CalendarGetAgendaErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -4235,7 +4410,7 @@ type CalendarDeleteEventErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -4268,7 +4443,7 @@ type CalendarGetEventErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -4291,6 +4466,9 @@ type CalendarUpdateEventData = {
         title?: string;
         start?: string;
         end?: string;
+        /**
+         * An IANA name, like `Europe/Lisbon`. The times above are read in it.
+         */
         timezone?: string;
         all_day?: boolean;
         description?: string | null;
@@ -4334,7 +4512,7 @@ type CalendarUpdateEventErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -4367,7 +4545,7 @@ type DraftsListErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -4392,14 +4570,38 @@ type DraftsListResponses = {
 type DraftsListResponse = DraftsListResponses[keyof DraftsListResponses];
 type DraftsCreateData = {
     body: {
+        /**
+         * The address this belongs to.
+         */
         identity_id: string;
+        /**
+         * An address on a domain you own, and one this key may send from.
+         */
         from?: string;
+        /**
+         * One address or several. A string is accepted for the single case.
+         */
         to?: Array<string>;
+        /**
+         * Copied, and visible to everybody who receives the message.
+         */
         cc?: Array<string>;
+        /**
+         * Copied, and visible to nobody else.
+         */
         bcc?: Array<string>;
+        /**
+         * Left off a reply, where the thread already has one.
+         */
         subject?: string | null;
+        /**
+         * The plain-text body. Send this even when you send `html` — some clients only read it.
+         */
         text?: string | null;
         in_reply_to_message_id?: string | null;
+        /**
+         * Ids from `POST /attachments`, uploaded before the message that carries them. Up to 20.
+         */
         attachment_ids?: Array<string>;
     };
     path?: never;
@@ -4412,7 +4614,7 @@ type DraftsCreateErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -4444,7 +4646,7 @@ type DraftsDeleteErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -4476,7 +4678,7 @@ type DraftsGetErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -4496,12 +4698,33 @@ type DraftsGetResponses = {
 type DraftsGetResponse = DraftsGetResponses[keyof DraftsGetResponses];
 type DraftsUpdateData = {
     body: {
+        /**
+         * An address on a domain you own, and one this key may send from.
+         */
         from?: string;
+        /**
+         * One address or several. A string is accepted for the single case.
+         */
         to?: Array<string>;
+        /**
+         * Copied, and visible to everybody who receives the message.
+         */
         cc?: Array<string>;
+        /**
+         * Copied, and visible to nobody else.
+         */
         bcc?: Array<string>;
+        /**
+         * Left off a reply, where the thread already has one.
+         */
         subject?: string | null;
+        /**
+         * The plain-text body. Send this even when you send `html` — some clients only read it.
+         */
         text?: string | null;
+        /**
+         * Ids from `POST /attachments`, uploaded before the message that carries them. Up to 20.
+         */
         attachment_ids?: Array<string>;
     };
     path: {
@@ -4516,7 +4739,7 @@ type DraftsUpdateErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -4548,7 +4771,7 @@ type DraftsSendErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -4580,7 +4803,7 @@ type DraftsCancelScheduleErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -4614,7 +4837,7 @@ type DraftsScheduleErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -4647,7 +4870,7 @@ type DraftsRemoveAttachmentErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -4680,7 +4903,7 @@ type MetricsQueryErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -4713,7 +4936,7 @@ type AttachmentsUploadErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -4745,7 +4968,7 @@ type AttachmentsDownloadUrlErrors = {
      */
     401: Error;
     /**
-     * No such resource, **or** one belonging to another account. The two are deliberately indistinguishable: a different answer would enumerate what exists.
+     * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
     /**
@@ -4930,7 +5153,7 @@ declare const messagesListInThread: <ThrowOnError extends boolean = false>(optio
 /**
  * Send a message
  *
- * Idempotent with an `Idempotency-Key` header.
+ * Idempotent with an `Idempotency-Key` header. Answers `202` with the id, the thread and anything **rejected** — a recipient the address is not allowed to write to is refused here rather than failing later, so read `rejected` before assuming it went.
  */
 declare const messagesSend: <ThrowOnError extends boolean = false>(options: Options<MessagesSendData, ThrowOnError>) => RequestResult<MessagesSendResponses, MessagesSendErrors, ThrowOnError>;
 /**