agentmail 0.4.4 → 0.4.5

package/dist/cjs/BaseClient.js

@@ -43,8 +43,8 @@ function normalizeClientOptions(options) {
     const headers = (0, headers_js_1.mergeHeaders)({
         "X-Fern-Language": "JavaScript",
         "X-Fern-SDK-Name": "agentmail",
-        "X-Fern-SDK-Version": "0.4.4",
-        "User-Agent": "agentmail/0.4.4",
+        "X-Fern-SDK-Version": "0.4.5",
+        "User-Agent": "agentmail/0.4.5",
         "X-Fern-Runtime": core.RUNTIME.type,
         "X-Fern-Runtime-Version": core.RUNTIME.version,
     }, options === null || options === void 0 ? void 0 : options.headers);

package/dist/cjs/api/resources/drafts/types/Draft.d.ts

@@ -1,7 +1,6 @@
 import type * as AgentMail from "../../../index.js";
 export interface Draft {
     inboxId: AgentMail.inboxes.InboxId;
-    threadId: AgentMail.ThreadId;
     draftId: AgentMail.DraftId;
     clientId?: AgentMail.DraftClientId;
     labels: AgentMail.DraftLabels;

package/dist/cjs/api/resources/drafts/types/DraftItem.d.ts

@@ -1,7 +1,6 @@
 import type * as AgentMail from "../../../index.js";
 export interface DraftItem {
     inboxId: AgentMail.inboxes.InboxId;
-    threadId: AgentMail.ThreadId;
     draftId: AgentMail.DraftId;
     labels: AgentMail.DraftLabels;
     to?: AgentMail.DraftTo;

package/dist/cjs/api/resources/messages/types/RawMessageResponse.d.ts

@@ -1,13 +1,13 @@
 import type * as AgentMail from "../../../index.js";
 /**
- * Signed URL to download the raw .eml file. Uses CloudFront signing, same as attachments.
+ * S3 presigned URL to download the raw .eml file.
  */
 export interface RawMessageResponse {
     /** ID of the message. */
     messageId: AgentMail.MessageId;
     /** Size of the raw message in bytes. */
     size: AgentMail.MessageSize;
-    /** Pre-signed CloudFront URL to download the raw message. Expires at expires_at. */
+    /** S3 presigned URL to download the raw message. Expires at expires_at. */
     downloadUrl: string;
     /** Time at which the download URL expires. */
     expiresAt: Date;

package/dist/cjs/api/resources/pods/client/Client.d.ts

@@ -16,21 +16,21 @@ export declare namespace PodsClient {
 }
 export declare class PodsClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<PodsClient.Options>;
-    protected _apiKeys: ApiKeysClient | undefined;
-    protected _domains: DomainsClient | undefined;
     protected _inboxes: InboxesClient | undefined;
     protected _threads: ThreadsClient | undefined;
     protected _drafts: DraftsClient | undefined;
+    protected _domains: DomainsClient | undefined;
     protected _lists: ListsClient | undefined;
     protected _metrics: MetricsClient | undefined;
+    protected _apiKeys: ApiKeysClient | undefined;
     constructor(options?: PodsClient.Options);
-    get apiKeys(): ApiKeysClient;
-    get domains(): DomainsClient;
     get inboxes(): InboxesClient;
     get threads(): ThreadsClient;
     get drafts(): DraftsClient;
+    get domains(): DomainsClient;
     get lists(): ListsClient;
     get metrics(): MetricsClient;
+    get apiKeys(): ApiKeysClient;
     /**
      * @param {AgentMail.pods.ListPodsRequest} request
      * @param {PodsClient.RequestOptions} requestOptions - Request-specific configuration.

package/dist/cjs/api/resources/pods/client/Client.js

@@ -63,14 +63,6 @@ class PodsClient {
     constructor(options = {}) {
         this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
     }
-    get apiKeys() {
-        var _a;
-        return ((_a = this._apiKeys) !== null && _a !== void 0 ? _a : (this._apiKeys = new Client_js_1.ApiKeysClient(this._options)));
-    }
-    get domains() {
-        var _a;
-        return ((_a = this._domains) !== null && _a !== void 0 ? _a : (this._domains = new Client_js_2.DomainsClient(this._options)));
-    }
     get inboxes() {
         var _a;
         return ((_a = this._inboxes) !== null && _a !== void 0 ? _a : (this._inboxes = new Client_js_4.InboxesClient(this._options)));
@@ -83,6 +75,10 @@ class PodsClient {
         var _a;
         return ((_a = this._drafts) !== null && _a !== void 0 ? _a : (this._drafts = new Client_js_3.DraftsClient(this._options)));
     }
+    get domains() {
+        var _a;
+        return ((_a = this._domains) !== null && _a !== void 0 ? _a : (this._domains = new Client_js_2.DomainsClient(this._options)));
+    }
     get lists() {
         var _a;
         return ((_a = this._lists) !== null && _a !== void 0 ? _a : (this._lists = new Client_js_5.ListsClient(this._options)));
@@ -91,6 +87,10 @@ class PodsClient {
         var _a;
         return ((_a = this._metrics) !== null && _a !== void 0 ? _a : (this._metrics = new Client_js_6.MetricsClient(this._options)));
     }
+    get apiKeys() {
+        var _a;
+        return ((_a = this._apiKeys) !== null && _a !== void 0 ? _a : (this._apiKeys = new Client_js_1.ApiKeysClient(this._options)));
+    }
     /**
      * @param {AgentMail.pods.ListPodsRequest} request
      * @param {PodsClient.RequestOptions} requestOptions - Request-specific configuration.

package/dist/cjs/serialization/resources/drafts/types/Draft.d.ts

@@ -2,7 +2,6 @@ import type * as AgentMail from "../../../../api/index.js";
 import * as core from "../../../../core/index.js";
 import type * as serializers from "../../../index.js";
 import { InboxId } from "../../inboxes/types/InboxId.js";
-import { ThreadId } from "../../threads/types/ThreadId.js";
 import { DraftAttachments } from "./DraftAttachments.js";
 import { DraftBcc } from "./DraftBcc.js";
 import { DraftCc } from "./DraftCc.js";
@@ -23,7 +22,6 @@ export declare const Draft: core.serialization.ObjectSchema<serializers.Draft.Ra
 export declare namespace Draft {
     interface Raw {
         inbox_id: InboxId.Raw;
-        thread_id: ThreadId.Raw;
         draft_id: DraftId.Raw;
         client_id?: DraftClientId.Raw | null;
         labels: DraftLabels.Raw;

package/dist/cjs/serialization/resources/drafts/types/Draft.js

@@ -37,7 +37,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Draft = void 0;
 const core = __importStar(require("../../../../core/index.js"));
 const InboxId_js_1 = require("../../inboxes/types/InboxId.js");
-const ThreadId_js_1 = require("../../threads/types/ThreadId.js");
 const DraftAttachments_js_1 = require("./DraftAttachments.js");
 const DraftBcc_js_1 = require("./DraftBcc.js");
 const DraftCc_js_1 = require("./DraftCc.js");
@@ -56,7 +55,6 @@ const DraftTo_js_1 = require("./DraftTo.js");
 const DraftUpdatedAt_js_1 = require("./DraftUpdatedAt.js");
 exports.Draft = core.serialization.object({
     inboxId: core.serialization.property("inbox_id", InboxId_js_1.InboxId),
-    threadId: core.serialization.property("thread_id", ThreadId_js_1.ThreadId),
     draftId: core.serialization.property("draft_id", DraftId_js_1.DraftId),
     clientId: core.serialization.property("client_id", DraftClientId_js_1.DraftClientId.optional()),
     labels: DraftLabels_js_1.DraftLabels,

package/dist/cjs/serialization/resources/drafts/types/DraftItem.d.ts

@@ -2,7 +2,6 @@ import type * as AgentMail from "../../../../api/index.js";
 import * as core from "../../../../core/index.js";
 import type * as serializers from "../../../index.js";
 import { InboxId } from "../../inboxes/types/InboxId.js";
-import { ThreadId } from "../../threads/types/ThreadId.js";
 import { DraftAttachments } from "./DraftAttachments.js";
 import { DraftBcc } from "./DraftBcc.js";
 import { DraftCc } from "./DraftCc.js";
@@ -18,7 +17,6 @@ export declare const DraftItem: core.serialization.ObjectSchema<serializers.Draf
 export declare namespace DraftItem {
     interface Raw {
         inbox_id: InboxId.Raw;
-        thread_id: ThreadId.Raw;
         draft_id: DraftId.Raw;
         labels: DraftLabels.Raw;
         to?: DraftTo.Raw | null;

package/dist/cjs/serialization/resources/drafts/types/DraftItem.js

@@ -37,7 +37,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.DraftItem = void 0;
 const core = __importStar(require("../../../../core/index.js"));
 const InboxId_js_1 = require("../../inboxes/types/InboxId.js");
-const ThreadId_js_1 = require("../../threads/types/ThreadId.js");
 const DraftAttachments_js_1 = require("./DraftAttachments.js");
 const DraftBcc_js_1 = require("./DraftBcc.js");
 const DraftCc_js_1 = require("./DraftCc.js");
@@ -51,7 +50,6 @@ const DraftTo_js_1 = require("./DraftTo.js");
 const DraftUpdatedAt_js_1 = require("./DraftUpdatedAt.js");
 exports.DraftItem = core.serialization.object({
     inboxId: core.serialization.property("inbox_id", InboxId_js_1.InboxId),
-    threadId: core.serialization.property("thread_id", ThreadId_js_1.ThreadId),
     draftId: core.serialization.property("draft_id", DraftId_js_1.DraftId),
     labels: DraftLabels_js_1.DraftLabels,
     to: DraftTo_js_1.DraftTo.optional(),

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "0.4.4";
+export declare const SDK_VERSION = "0.4.5";

package/dist/cjs/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = "0.4.4";
+exports.SDK_VERSION = "0.4.5";

package/dist/esm/BaseClient.mjs

@@ -6,8 +6,8 @@ export function normalizeClientOptions(options) {
     const headers = mergeHeaders({
         "X-Fern-Language": "JavaScript",
         "X-Fern-SDK-Name": "agentmail",
-        "X-Fern-SDK-Version": "0.4.4",
-        "User-Agent": "agentmail/0.4.4",
+        "X-Fern-SDK-Version": "0.4.5",
+        "User-Agent": "agentmail/0.4.5",
         "X-Fern-Runtime": core.RUNTIME.type,
         "X-Fern-Runtime-Version": core.RUNTIME.version,
     }, options === null || options === void 0 ? void 0 : options.headers);

package/dist/esm/api/resources/drafts/types/Draft.d.mts

@@ -1,7 +1,6 @@
 import type * as AgentMail from "../../../index.mjs";
 export interface Draft {
     inboxId: AgentMail.inboxes.InboxId;
-    threadId: AgentMail.ThreadId;
     draftId: AgentMail.DraftId;
     clientId?: AgentMail.DraftClientId;
     labels: AgentMail.DraftLabels;

package/dist/esm/api/resources/drafts/types/DraftItem.d.mts

@@ -1,7 +1,6 @@
 import type * as AgentMail from "../../../index.mjs";
 export interface DraftItem {
     inboxId: AgentMail.inboxes.InboxId;
-    threadId: AgentMail.ThreadId;
     draftId: AgentMail.DraftId;
     labels: AgentMail.DraftLabels;
     to?: AgentMail.DraftTo;

package/dist/esm/api/resources/messages/types/RawMessageResponse.d.mts

@@ -1,13 +1,13 @@
 import type * as AgentMail from "../../../index.mjs";
 /**
- * Signed URL to download the raw .eml file. Uses CloudFront signing, same as attachments.
+ * S3 presigned URL to download the raw .eml file.
  */
 export interface RawMessageResponse {
     /** ID of the message. */
     messageId: AgentMail.MessageId;
     /** Size of the raw message in bytes. */
     size: AgentMail.MessageSize;
-    /** Pre-signed CloudFront URL to download the raw message. Expires at expires_at. */
+    /** S3 presigned URL to download the raw message. Expires at expires_at. */
     downloadUrl: string;
     /** Time at which the download URL expires. */
     expiresAt: Date;

package/dist/esm/api/resources/pods/client/Client.d.mts

@@ -16,21 +16,21 @@ export declare namespace PodsClient {
 }
 export declare class PodsClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<PodsClient.Options>;
-    protected _apiKeys: ApiKeysClient | undefined;
-    protected _domains: DomainsClient | undefined;
     protected _inboxes: InboxesClient | undefined;
     protected _threads: ThreadsClient | undefined;
     protected _drafts: DraftsClient | undefined;
+    protected _domains: DomainsClient | undefined;
     protected _lists: ListsClient | undefined;
     protected _metrics: MetricsClient | undefined;
+    protected _apiKeys: ApiKeysClient | undefined;
     constructor(options?: PodsClient.Options);
-    get apiKeys(): ApiKeysClient;
-    get domains(): DomainsClient;
     get inboxes(): InboxesClient;
     get threads(): ThreadsClient;
     get drafts(): DraftsClient;
+    get domains(): DomainsClient;
     get lists(): ListsClient;
     get metrics(): MetricsClient;
+    get apiKeys(): ApiKeysClient;
     /**
      * @param {AgentMail.pods.ListPodsRequest} request
      * @param {PodsClient.RequestOptions} requestOptions - Request-specific configuration.

package/dist/esm/api/resources/pods/client/Client.mjs

@@ -27,14 +27,6 @@ export class PodsClient {
     constructor(options = {}) {
         this._options = normalizeClientOptionsWithAuth(options);
     }
-    get apiKeys() {
-        var _a;
-        return ((_a = this._apiKeys) !== null && _a !== void 0 ? _a : (this._apiKeys = new ApiKeysClient(this._options)));
-    }
-    get domains() {
-        var _a;
-        return ((_a = this._domains) !== null && _a !== void 0 ? _a : (this._domains = new DomainsClient(this._options)));
-    }
     get inboxes() {
         var _a;
         return ((_a = this._inboxes) !== null && _a !== void 0 ? _a : (this._inboxes = new InboxesClient(this._options)));
@@ -47,6 +39,10 @@ export class PodsClient {
         var _a;
         return ((_a = this._drafts) !== null && _a !== void 0 ? _a : (this._drafts = new DraftsClient(this._options)));
     }
+    get domains() {
+        var _a;
+        return ((_a = this._domains) !== null && _a !== void 0 ? _a : (this._domains = new DomainsClient(this._options)));
+    }
     get lists() {
         var _a;
         return ((_a = this._lists) !== null && _a !== void 0 ? _a : (this._lists = new ListsClient(this._options)));
@@ -55,6 +51,10 @@ export class PodsClient {
         var _a;
         return ((_a = this._metrics) !== null && _a !== void 0 ? _a : (this._metrics = new MetricsClient(this._options)));
     }
+    get apiKeys() {
+        var _a;
+        return ((_a = this._apiKeys) !== null && _a !== void 0 ? _a : (this._apiKeys = new ApiKeysClient(this._options)));
+    }
     /**
      * @param {AgentMail.pods.ListPodsRequest} request
      * @param {PodsClient.RequestOptions} requestOptions - Request-specific configuration.

package/dist/esm/serialization/resources/drafts/types/Draft.d.mts

@@ -2,7 +2,6 @@ import type * as AgentMail from "../../../../api/index.mjs";
 import * as core from "../../../../core/index.mjs";
 import type * as serializers from "../../../index.mjs";
 import { InboxId } from "../../inboxes/types/InboxId.mjs";
-import { ThreadId } from "../../threads/types/ThreadId.mjs";
 import { DraftAttachments } from "./DraftAttachments.mjs";
 import { DraftBcc } from "./DraftBcc.mjs";
 import { DraftCc } from "./DraftCc.mjs";
@@ -23,7 +22,6 @@ export declare const Draft: core.serialization.ObjectSchema<serializers.Draft.Ra
 export declare namespace Draft {
     interface Raw {
         inbox_id: InboxId.Raw;
-        thread_id: ThreadId.Raw;
         draft_id: DraftId.Raw;
         client_id?: DraftClientId.Raw | null;
         labels: DraftLabels.Raw;

package/dist/esm/serialization/resources/drafts/types/Draft.mjs

@@ -1,7 +1,6 @@
 // This file was auto-generated by Fern from our API Definition.
 import * as core from "../../../../core/index.mjs";
 import { InboxId } from "../../inboxes/types/InboxId.mjs";
-import { ThreadId } from "../../threads/types/ThreadId.mjs";
 import { DraftAttachments } from "./DraftAttachments.mjs";
 import { DraftBcc } from "./DraftBcc.mjs";
 import { DraftCc } from "./DraftCc.mjs";
@@ -20,7 +19,6 @@ import { DraftTo } from "./DraftTo.mjs";
 import { DraftUpdatedAt } from "./DraftUpdatedAt.mjs";
 export const Draft = core.serialization.object({
     inboxId: core.serialization.property("inbox_id", InboxId),
-    threadId: core.serialization.property("thread_id", ThreadId),
     draftId: core.serialization.property("draft_id", DraftId),
     clientId: core.serialization.property("client_id", DraftClientId.optional()),
     labels: DraftLabels,

package/dist/esm/serialization/resources/drafts/types/DraftItem.d.mts

@@ -2,7 +2,6 @@ import type * as AgentMail from "../../../../api/index.mjs";
 import * as core from "../../../../core/index.mjs";
 import type * as serializers from "../../../index.mjs";
 import { InboxId } from "../../inboxes/types/InboxId.mjs";
-import { ThreadId } from "../../threads/types/ThreadId.mjs";
 import { DraftAttachments } from "./DraftAttachments.mjs";
 import { DraftBcc } from "./DraftBcc.mjs";
 import { DraftCc } from "./DraftCc.mjs";
@@ -18,7 +17,6 @@ export declare const DraftItem: core.serialization.ObjectSchema<serializers.Draf
 export declare namespace DraftItem {
     interface Raw {
         inbox_id: InboxId.Raw;
-        thread_id: ThreadId.Raw;
         draft_id: DraftId.Raw;
         labels: DraftLabels.Raw;
         to?: DraftTo.Raw | null;

package/dist/esm/serialization/resources/drafts/types/DraftItem.mjs

@@ -1,7 +1,6 @@
 // This file was auto-generated by Fern from our API Definition.
 import * as core from "../../../../core/index.mjs";
 import { InboxId } from "../../inboxes/types/InboxId.mjs";
-import { ThreadId } from "../../threads/types/ThreadId.mjs";
 import { DraftAttachments } from "./DraftAttachments.mjs";
 import { DraftBcc } from "./DraftBcc.mjs";
 import { DraftCc } from "./DraftCc.mjs";
@@ -15,7 +14,6 @@ import { DraftTo } from "./DraftTo.mjs";
 import { DraftUpdatedAt } from "./DraftUpdatedAt.mjs";
 export const DraftItem = core.serialization.object({
     inboxId: core.serialization.property("inbox_id", InboxId),
-    threadId: core.serialization.property("thread_id", ThreadId),
     draftId: core.serialization.property("draft_id", DraftId),
     labels: DraftLabels,
     to: DraftTo.optional(),

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "0.4.4";
+export declare const SDK_VERSION = "0.4.5";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "0.4.4";
+export const SDK_VERSION = "0.4.5";

package/dist/llms-full.txt

@@ -890,6 +890,7 @@ Copy one of the blocks below into Cursor or Claude for complete Messages API kno
    * - messages.forward(inboxId, messageId, { to, subject?, text?, html? })
    * - messages.update(inboxId, messageId, { addLabels?, removeLabels? })
    * - messages.getAttachment(inboxId, messageId, attachmentId)
+   * - messages.getRaw(inboxId, messageId) -> { message_id, size, download_url, expires_at } (CloudFront signed URL for .eml)
    * - messages.getRaw(inboxId, messageId)
    *
    * Reply content: use extractedText/extractedHtml for new content without quoted history.
@@ -18039,10 +18040,6 @@ components:
       type: string
       description: The ID of the inbox.
       title: InboxId
-    type_threads:ThreadId:
-      type: string
-      description: ID of thread.
-      title: ThreadId
     type_drafts:DraftId:
       type: string
       description: ID of draft.
@@ -18160,8 +18157,6 @@ components:
       properties:
         inbox_id:
           $ref: '#/components/schemas/type_inboxes:InboxId'
-        thread_id:
-          $ref: '#/components/schemas/type_threads:ThreadId'
         draft_id:
           $ref: '#/components/schemas/type_drafts:DraftId'
         labels:
@@ -18186,7 +18181,6 @@ components:
           $ref: '#/components/schemas/type_drafts:DraftUpdatedAt'
       required:
         - inbox_id
-        - thread_id
         - draft_id
         - labels
         - updated_at
@@ -18433,10 +18427,6 @@ components:
       type: string
       description: The ID of the inbox.
       title: InboxId
-    type_threads:ThreadId:
-      type: string
-      description: ID of thread.
-      title: ThreadId
     type_drafts:DraftClientId:
       type: string
       description: Client ID of draft.
@@ -18574,8 +18564,6 @@ components:
       properties:
         inbox_id:
           $ref: '#/components/schemas/type_inboxes:InboxId'
-        thread_id:
-          $ref: '#/components/schemas/type_threads:ThreadId'
         draft_id:
           $ref: '#/components/schemas/type_drafts:DraftId'
         client_id:
@@ -18619,7 +18607,6 @@ components:
           description: Time at which draft was created.
       required:
         - inbox_id
-        - thread_id
         - draft_id
         - labels
         - updated_at
@@ -27238,10 +27225,9 @@ paths:
         '200':
           description: Response with status 200
           content:
-            application/octet-stream:
+            application/json:
               schema:
-                type: string
-                format: binary
+                $ref: '#/components/schemas/type_messages:RawMessageResponse'
         '404':
           description: Error response with status 404
           content:
@@ -27263,6 +27249,37 @@ components:
       type: string
       description: ID of message.
       title: MessageId
+    type_messages:MessageSize:
+      type: integer
+      description: Size of message in bytes.
+      title: MessageSize
+    type_messages:RawMessageResponse:
+      type: object
+      properties:
+        message_id:
+          $ref: '#/components/schemas/type_messages:MessageId'
+          description: ID of the message.
+        size:
+          $ref: '#/components/schemas/type_messages:MessageSize'
+          description: Size of the raw message in bytes.
+        download_url:
+          type: string
+          description: >-
+            Pre-signed CloudFront URL to download the raw message. Expires at
+            expires_at.
+        expires_at:
+          type: string
+          format: date-time
+          description: Time at which the download URL expires.
+      required:
+        - message_id
+        - size
+        - download_url
+        - expires_at
+      description: >-
+        Signed URL to download the raw .eml file. Uses CloudFront signing, same
+        as attachments.
+      title: RawMessageResponse
     type_:ErrorName:
       type: string
       description: Name of error.
@@ -27298,7 +27315,7 @@ async function main() {
     const client = new AgentMailClient({
         apiKey: "YOUR_TOKEN_HERE",
     });
-    await client.inboxes.messages.getRaw(":inbox_id", ":message_id");
+    await client.inboxes.messages.getRaw("inbox_id", "message_id");
 }
 main();
 
@@ -27312,8 +27329,8 @@ client = AgentMail(
 )
 
 client.inboxes.messages.get_raw(
-    inbox_id=":inbox_id",
-    message_id=":message_id"
+    inbox_id="inbox_id",
+    message_id="message_id"
 )
 
 ```
@@ -27329,7 +27346,7 @@ import (
 
 func main() {
 
-	url := "https://api.agentmail.to/v0/inboxes/%3Ainbox_id/messages/%3Amessage_id/raw"
+	url := "https://api.agentmail.to/v0/inboxes/inbox_id/messages/message_id/raw"
 
 	req, _ := http.NewRequest("GET", url, nil)
 
@@ -27350,7 +27367,7 @@ func main() {
 require 'uri'
 require 'net/http'
 
-url = URI("https://api.agentmail.to/v0/inboxes/%3Ainbox_id/messages/%3Amessage_id/raw")
+url = URI("https://api.agentmail.to/v0/inboxes/inbox_id/messages/message_id/raw")
 
 http = Net::HTTP.new(url.host, url.port)
 http.use_ssl = true
@@ -27366,7 +27383,7 @@ puts response.read_body
 import com.mashape.unirest.http.HttpResponse;
 import com.mashape.unirest.http.Unirest;
 
-HttpResponse<String> response = Unirest.get("https://api.agentmail.to/v0/inboxes/%3Ainbox_id/messages/%3Amessage_id/raw")
+HttpResponse<String> response = Unirest.get("https://api.agentmail.to/v0/inboxes/inbox_id/messages/message_id/raw")
   .header("Authorization", "Bearer <api_key>")
   .asString();
 ```
@@ -27377,7 +27394,7 @@ require_once('vendor/autoload.php');
 
 $client = new \GuzzleHttp\Client();
 
-$response = $client->request('GET', 'https://api.agentmail.to/v0/inboxes/%3Ainbox_id/messages/%3Amessage_id/raw', [
+$response = $client->request('GET', 'https://api.agentmail.to/v0/inboxes/inbox_id/messages/message_id/raw', [
   'headers' => [
     'Authorization' => 'Bearer <api_key>',
   ],
@@ -27389,7 +27406,7 @@ echo $response->getBody();
 ```csharp
 using RestSharp;
 
-var client = new RestClient("https://api.agentmail.to/v0/inboxes/%3Ainbox_id/messages/%3Amessage_id/raw");
+var client = new RestClient("https://api.agentmail.to/v0/inboxes/inbox_id/messages/message_id/raw");
 var request = new RestRequest(Method.GET);
 request.AddHeader("Authorization", "Bearer <api_key>");
 IRestResponse response = client.Execute(request);
@@ -27400,7 +27417,7 @@ import Foundation
 
 let headers = ["Authorization": "Bearer <api_key>"]
 
-let request = NSMutableURLRequest(url: NSURL(string: "https://api.agentmail.to/v0/inboxes/%3Ainbox_id/messages/%3Amessage_id/raw")! as URL,
+let request = NSMutableURLRequest(url: NSURL(string: "https://api.agentmail.to/v0/inboxes/inbox_id/messages/message_id/raw")! as URL,
                                         cachePolicy: .useProtocolCachePolicy,
                                     timeoutInterval: 10.0)
 request.httpMethod = "GET"
@@ -29587,10 +29604,6 @@ components:
       type: integer
       description: Number of items returned.
       title: Count
-    type_threads:ThreadId:
-      type: string
-      description: ID of thread.
-      title: ThreadId
     type_drafts:DraftId:
       type: string
       description: ID of draft.
@@ -29708,8 +29721,6 @@ components:
       properties:
         inbox_id:
           $ref: '#/components/schemas/type_inboxes:InboxId'
-        thread_id:
-          $ref: '#/components/schemas/type_threads:ThreadId'
         draft_id:
           $ref: '#/components/schemas/type_drafts:DraftId'
         labels:
@@ -29734,7 +29745,6 @@ components:
           $ref: '#/components/schemas/type_drafts:DraftUpdatedAt'
       required:
         - inbox_id
-        - thread_id
         - draft_id
         - labels
         - updated_at
@@ -29977,10 +29987,6 @@ components:
       type: string
       description: ID of draft.
       title: DraftId
-    type_threads:ThreadId:
-      type: string
-      description: ID of thread.
-      title: ThreadId
     type_drafts:DraftClientId:
       type: string
       description: Client ID of draft.
@@ -30118,8 +30124,6 @@ components:
       properties:
         inbox_id:
           $ref: '#/components/schemas/type_inboxes:InboxId'
-        thread_id:
-          $ref: '#/components/schemas/type_threads:ThreadId'
         draft_id:
           $ref: '#/components/schemas/type_drafts:DraftId'
         client_id:
@@ -30163,7 +30167,6 @@ components:
           description: Time at which draft was created.
       required:
         - inbox_id
-        - thread_id
         - draft_id
         - labels
         - updated_at
@@ -30800,10 +30803,6 @@ components:
         client_id:
           $ref: '#/components/schemas/type_drafts:DraftClientId'
       title: CreateDraftRequest
-    type_threads:ThreadId:
-      type: string
-      description: ID of thread.
-      title: ThreadId
     type_drafts:DraftId:
       type: string
       description: ID of draft.
@@ -30863,8 +30862,6 @@ components:
       properties:
         inbox_id:
           $ref: '#/components/schemas/type_inboxes:InboxId'
-        thread_id:
-          $ref: '#/components/schemas/type_threads:ThreadId'
         draft_id:
           $ref: '#/components/schemas/type_drafts:DraftId'
         client_id:
@@ -30908,7 +30905,6 @@ components:
           description: Time at which draft was created.
       required:
         - inbox_id
-        - thread_id
         - draft_id
         - labels
         - updated_at
@@ -31228,10 +31224,6 @@ components:
         send_at:
           $ref: '#/components/schemas/type_drafts:DraftSendAt'
       title: UpdateDraftRequest
-    type_threads:ThreadId:
-      type: string
-      description: ID of thread.
-      title: ThreadId
     type_drafts:DraftClientId:
       type: string
       description: Client ID of draft.
@@ -31320,8 +31312,6 @@ components:
       properties:
         inbox_id:
           $ref: '#/components/schemas/type_inboxes:InboxId'
-        thread_id:
-          $ref: '#/components/schemas/type_threads:ThreadId'
         draft_id:
           $ref: '#/components/schemas/type_drafts:DraftId'
         client_id:
@@ -31365,7 +31355,6 @@ components:
           description: Time at which draft was created.
       required:
         - inbox_id
-        - thread_id
         - draft_id
         - labels
         - updated_at
@@ -34003,10 +33992,6 @@ components:
       type: string
       description: The ID of the inbox.
       title: InboxId
-    type_threads:ThreadId:
-      type: string
-      description: ID of thread.
-      title: ThreadId
     type_drafts:DraftId:
       type: string
       description: ID of draft.
@@ -34124,8 +34109,6 @@ components:
       properties:
         inbox_id:
           $ref: '#/components/schemas/type_inboxes:InboxId'
-        thread_id:
-          $ref: '#/components/schemas/type_threads:ThreadId'
         draft_id:
           $ref: '#/components/schemas/type_drafts:DraftId'
         labels:
@@ -34150,7 +34133,6 @@ components:
           $ref: '#/components/schemas/type_drafts:DraftUpdatedAt'
       required:
         - inbox_id
-        - thread_id
         - draft_id
         - labels
         - updated_at
@@ -34386,10 +34368,6 @@ components:
       type: string
       description: The ID of the inbox.
       title: InboxId
-    type_threads:ThreadId:
-      type: string
-      description: ID of thread.
-      title: ThreadId
     type_drafts:DraftClientId:
       type: string
       description: Client ID of draft.
@@ -34527,8 +34505,6 @@ components:
       properties:
         inbox_id:
           $ref: '#/components/schemas/type_inboxes:InboxId'
-        thread_id:
-          $ref: '#/components/schemas/type_threads:ThreadId'
         draft_id:
           $ref: '#/components/schemas/type_drafts:DraftId'
         client_id:
@@ -34572,7 +34548,6 @@ components:
           description: Time at which draft was created.
       required:
         - inbox_id
-        - thread_id
         - draft_id
         - labels
         - updated_at
@@ -41604,6 +41579,74 @@ Your team's email continues to flow through Gmail. Agent emails go through Agent
 Pick whatever makes sense for your brand. The important thing is that it is a separate subdomain from your root domain's email.
 
 
+***
+
+title: What does a 403 error mean?
+subtitle: Common causes of API 403 Forbidden errors and how to fix them.
+slug: knowledge-base/api-403-error
+----------------------------------
+
+A `403 Forbidden` response from the AgentMail API means your request was rejected. This can happen for several reasons, and the fix depends on the cause.
+
+## 1. Incorrect API key
+
+The most common cause. Your API key may be missing, incomplete, or invalid.
+
+**How to fix:**
+
+* Go to the [AgentMail Console](https://console.agentmail.to) and generate a new API key
+* When you generate a new key, **copy the entire key immediately**. It is only shown once and starts with `am_`
+* Make sure you are passing the key in the `Authorization` header as `Bearer am_...`
+
+```typescript title="TypeScript"
+import { AgentMailClient } from "agentmail";
+
+// Make sure the full key is copied, no trailing spaces or missing characters
+const client = new AgentMailClient({ apiKey: "am_..." });
+```
+
+<Warning>
+  A common mistake is copying only part of the key. API keys are long strings. Double check that you copied the complete value from start to finish.
+</Warning>
+
+## 2. Accessing a resource you do not own
+
+You will get a 403 if you try to access an inbox, message, thread, or domain that belongs to a different organization. Each API key is scoped to one organization, and you can only access resources created under that organization.
+
+**How to fix:** Verify that the `inbox_id`, `message_id`, `thread_id`, or `domain_id` in your request actually belongs to your account.
+
+## 3. Missing required parameters
+
+Some endpoints return a 403 when required path parameters are missing or malformed. For example, calling `/v0/inboxes//messages` with an empty `inbox_id` may return 403 instead of 400.
+
+**How to fix:** Double check that all required path parameters are filled in correctly.
+
+## 4. Sending to a suppressed address
+
+AgentMail automatically suppresses addresses that have previously bounced, been rejected, or filed a spam complaint. If you try to send to a suppressed address, the API returns a 403.
+
+**How to fix:** Check if the recipient address has been suppressed. See [Emails bouncing](/knowledge-base/emails-bouncing) for more details on how suppression works.
+
+## We do not restrict your API key
+
+AgentMail does not place any feature restrictions on your API key. Every API key has access to all endpoints. If you are getting a 403, it is not because your key lacks permissions. It is one of the causes listed above.
+
+## Test your API key
+
+The fastest way to verify your API key is working is to use the **Try it** feature in our [API Reference](https://docs.agentmail.to/api-reference/inboxes/list).
+
+1. Go to any endpoint in the [API Reference](https://docs.agentmail.to/api-reference/inboxes/list)
+2. Click **Try it** in the top right of the code panel
+3. Enter your API key in the Authorization field
+4. Click **Send**
+
+If you get a `200` response, your key is valid and working. You can then copy the generated code snippet from the panel to use in your application.
+
+## Still getting 403?
+
+If none of the above resolves your issue, reach out in our [Discord](https://discord.com/invite/hTYatWYWBc) support channel or email [support@agentmail.cc](mailto:support@agentmail.cc) with the full error response and the endpoint you are calling.
+
+
 ***
 
 title: What are the rate limits?

package/dist/llms.txt

@@ -63,6 +63,7 @@
 - [Why are my emails going to spam?](https://docs.agentmail.to/knowledge-base/emails-going-to-spam.mdx): Troubleshoot and fix spam folder placement issues.
 - [Warming Up](https://docs.agentmail.to/knowledge-base/domain-warming.mdx): Gradually build sending reputation on a new domain or inbox.
 - [How do I avoid MX record conflicts?](https://docs.agentmail.to/knowledge-base/mx-record-conflicts.mdx): Add AgentMail DNS records without breaking existing email.
+- [What does a 403 error mean?](https://docs.agentmail.to/knowledge-base/api-403-error.mdx): Common causes of API 403 Forbidden errors and how to fix them.
 - [What are the rate limits?](https://docs.agentmail.to/knowledge-base/rate-limits.mdx): Understand AgentMail's rate limits and how to work within them.
 - [How do I prevent duplicate sends?](https://docs.agentmail.to/knowledge-base/preventing-duplicate-sends.mdx): Use idempotency to avoid sending the same email twice.
 - [Why is my domain not verifying?](https://docs.agentmail.to/knowledge-base/domain-not-verifying.mdx): What to do when your domain verification is stuck.
@@ -167,41 +168,6 @@
 - API Reference > Lists [Create List Entry](https://docs.agentmail.to/api-reference/lists/create.mdx)
 - API Reference > Lists [Delete List Entry](https://docs.agentmail.to/api-reference/lists/delete.mdx)
 - API Reference > Metrics [Query Metrics](https://docs.agentmail.to/api-reference/metrics/query.mdx)
-- API Reference > API Keys [List API Keys](https://docs.agentmail.to/api-reference/api-keys/list.mdx)
-- API Reference > API Keys [Create API Key](https://docs.agentmail.to/api-reference/api-keys/create.mdx)
-- API Reference > API Keys [Delete API Key](https://docs.agentmail.to/api-reference/api-keys/delete.mdx)
-- API Reference > Pods [List Pods](https://docs.agentmail.to/api-reference/pods/list.mdx)
-- API Reference > Pods [Get Pod](https://docs.agentmail.to/api-reference/pods/get.mdx)
-- API Reference > Pods [Create Pod](https://docs.agentmail.to/api-reference/pods/create.mdx)
-- API Reference > Pods [Delete Pod](https://docs.agentmail.to/api-reference/pods/delete.mdx)
-- API Reference > Pods > API Keys [List API Keys](https://docs.agentmail.to/api-reference/pods/api-keys/list.mdx)
-- API Reference > Pods > API Keys [Create API Key](https://docs.agentmail.to/api-reference/pods/api-keys/create.mdx)
-- API Reference > Pods > API Keys [Delete API Key](https://docs.agentmail.to/api-reference/pods/api-keys/delete.mdx)
-- API Reference > Pods > Domains [List Domains](https://docs.agentmail.to/api-reference/pods/domains/list.mdx)
-- API Reference > Pods > Domains [Get Domain](https://docs.agentmail.to/api-reference/pods/domains/get.mdx)
-- API Reference > Pods > Domains [Get Zone File](https://docs.agentmail.to/api-reference/pods/domains/get-zone-file.mdx)
-- API Reference > Pods > Domains [Create Domain](https://docs.agentmail.to/api-reference/pods/domains/create.mdx)
-- API Reference > Pods > Domains [Update Domain](https://docs.agentmail.to/api-reference/pods/domains/update.mdx)
-- API Reference > Pods > Domains [Delete Domain](https://docs.agentmail.to/api-reference/pods/domains/delete.mdx)
-- API Reference > Pods > Domains [Verify Domain](https://docs.agentmail.to/api-reference/pods/domains/verify.mdx)
-- API Reference > Pods > Inboxes [List Inboxes](https://docs.agentmail.to/api-reference/pods/inboxes/list.mdx)
-- API Reference > Pods > Inboxes [Get Inbox](https://docs.agentmail.to/api-reference/pods/inboxes/get.mdx)
-- API Reference > Pods > Inboxes [Create Inbox](https://docs.agentmail.to/api-reference/pods/inboxes/create.mdx)
-- API Reference > Pods > Inboxes [Update Inbox](https://docs.agentmail.to/api-reference/pods/inboxes/update.mdx)
-- API Reference > Pods > Inboxes [Delete Inbox](https://docs.agentmail.to/api-reference/pods/inboxes/delete.mdx)
-- API Reference > Pods > Threads [List Threads](https://docs.agentmail.to/api-reference/pods/threads/list.mdx)
-- API Reference > Pods > Threads [Get Thread](https://docs.agentmail.to/api-reference/pods/threads/get.mdx)
-- API Reference > Pods > Threads [Get Attachment](https://docs.agentmail.to/api-reference/pods/threads/get-attachment.mdx)
-- API Reference > Pods > Threads [Delete Thread](https://docs.agentmail.to/api-reference/pods/threads/delete.mdx)
-- API Reference > Pods > Drafts [List Drafts](https://docs.agentmail.to/api-reference/pods/drafts/list.mdx)
-- API Reference > Pods > Drafts [Get Draft](https://docs.agentmail.to/api-reference/pods/drafts/get.mdx)
-- API Reference > Pods > Drafts [Get Attachment](https://docs.agentmail.to/api-reference/pods/drafts/get-attachment.mdx)
-- API Reference > Pods > Lists [List Entries](https://docs.agentmail.to/api-reference/pods/lists/list.mdx)
-- API Reference > Pods > Lists [Get List Entry](https://docs.agentmail.to/api-reference/pods/lists/get.mdx)
-- API Reference > Pods > Lists [Create List Entry](https://docs.agentmail.to/api-reference/pods/lists/create.mdx)
-- API Reference > Pods > Lists [Delete List Entry](https://docs.agentmail.to/api-reference/pods/lists/delete.mdx)
-- API Reference > Pods > Metrics [Query Metrics](https://docs.agentmail.to/api-reference/pods/metrics/query.mdx)
-- API Reference > Organizations [Get Organization](https://docs.agentmail.to/api-reference/organizations/get.mdx)
 
 ## OpenAPI Specification
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "agentmail",
-    "version": "0.4.4",
+    "version": "0.4.5",
     "private": false,
     "repository": {
         "type": "git",