agentmail 0.3.9 → 0.4.1

package/dist/llms-full.txt

@@ -205,6 +205,107 @@ Get your API key from the [Console](https://console.agentmail.to) and replace `a
   ```
 </CodeBlocks>
 
+## Copy for Cursor / Claude
+
+Copy one of the blocks below into Cursor or Claude for a complete, working AgentMail integration. Each block includes setup, API reference, error handling, rate limiting, and idempotency guidance.
+
+<CodeBlocks>
+  ```python title="Python"
+  """
+  AgentMail Python Quickstart — copy into Cursor/Claude for instant setup.
+
+  Setup: pip install agentmail python-dotenv. Set AGENTMAIL_API_KEY in .env.
+
+  API reference:
+  - inboxes.create(username?, domain?, display_name?, client_id?) — client_id for idempotent retries
+  - messages.send(inbox_id, to, subject, text, html?, cc?, bcc?, reply_to?, attachments?)
+  - messages.list(inbox_id, limit?, page_token?, labels?) — receive emails; use extracted_text/extracted_html for reply content
+
+  Errors: SDK raises on 4xx/5xx. Inspect error.body.message or str(e).
+  Rate limit: 429 with Retry-After header. Implement exponential backoff for retries.
+  Idempotency: Pass client_id to inboxes.create() to safely retry without duplicates.
+  """
+  import os
+  from dotenv import load_dotenv
+  from agentmail import AgentMail
+
+  load_dotenv()
+  client = AgentMail(api_key=os.getenv("AGENTMAIL_API_KEY"))
+
+  # Create inbox (client_id enables safe retries)
+  inbox = client.inboxes.create(client_id="my-agent-inbox-v1")
+
+  # Send email
+  try:
+      client.inboxes.messages.send(
+          inbox.inbox_id,
+          to="recipient@example.com",
+          subject="Hello from AgentMail",
+          text="Plain text body",
+          html="<p>HTML body</p>",
+      )
+  except Exception as e:
+      # Handle validation, not found, rate limit (429), etc.
+      print(f"Send failed: {e}")
+      raise
+
+  # Receive messages
+  for msg in client.inboxes.messages.list(inbox.inbox_id, limit=10).messages:
+      print(msg.subject, msg.extracted_text or msg.text)
+  ```
+
+  ```typescript title="TypeScript"
+  /**
+   * AgentMail TypeScript Quickstart — copy into Cursor/Claude for instant setup.
+   *
+   * Setup: npm install agentmail dotenv. Set AGENTMAIL_API_KEY in .env.
+   *
+   * API reference:
+   * - inboxes.create({ username?, domain?, displayName?, clientId? }) — clientId for idempotent retries
+   * - messages.send(inboxId, { to, subject, text, html?, cc?, bcc?, replyTo?, attachments? })
+   * - messages.list(inboxId, { limit?, pageToken?, labels? }) — receive; use extractedText/extractedHtml for reply content
+   *
+   * Errors: SDK throws on 4xx/5xx. Check error.body?.message.
+   * Rate limit: 429 with Retry-After header. Use exponential backoff for retries.
+   * Idempotency: Pass clientId to inboxes.create() to safely retry without duplicates.
+   */
+  import { AgentMailClient } from "agentmail";
+  import "dotenv/config";
+
+  const client = new AgentMailClient({
+    apiKey: process.env.AGENTMAIL_API_KEY!,
+  });
+
+  async function main() {
+    // Create inbox (clientId enables safe retries)
+    const inbox = await client.inboxes.create({
+      clientId: "my-agent-inbox-v1",
+    });
+
+    try {
+      await client.inboxes.messages.send(inbox.inboxId, {
+        to: "recipient@example.com",
+        subject: "Hello from AgentMail",
+        text: "Plain text body",
+        html: "<p>HTML body</p>",
+      });
+    } catch (error: unknown) {
+      // Handle validation, not found, rate limit (429), etc.
+      const msg = (error as { body?: { message?: string } })?.body?.message ?? String(error);
+      throw new Error(`Send failed: ${msg}`);
+    }
+
+    // Receive messages
+    const res = await client.inboxes.messages.list(inbox.inboxId, { limit: 10 });
+    for (const msg of res.messages) {
+      console.log(msg.subject, msg.extractedText ?? msg.text);
+    }
+  }
+
+  main();
+  ```
+</CodeBlocks>
+
 <Tip>
   When receiving emails, messages include `extracted_text` and `extracted_html`
   for reply content without quoted history.
@@ -308,7 +409,10 @@ This guide will walk you through installing the AgentMail SDK, authenticating wi
         console.log("Email sent successfully!");
       }
 
-      main();
+      main().catch((error) => {
+        console.error(error);
+        process.exit(1);
+      });
       ```
     </CodeBlocks>
 
@@ -477,6 +581,72 @@ Here at AgentMail we've now made an `Inbox` an API resource, meaning you can per
   domains](/guides/domains/managing-domains) to learn more.
 </Tip>
 
+## Copy for Cursor / Claude
+
+Copy one of the blocks below into Cursor or Claude for complete Inboxes API knowledge in one shot.
+
+<CodeBlocks>
+  ```python title="Python"
+  """
+  AgentMail Inboxes — copy into Cursor/Claude.
+
+  Setup: pip install agentmail python-dotenv. Set AGENTMAIL_API_KEY in .env.
+
+  API reference:
+  - inboxes.create(username?, domain?, display_name?, client_id?) — client_id for idempotent retries
+  - inboxes.get(inbox_id)
+  - inboxes.list(limit?, page_token?)
+  - inboxes.update(inbox_id, display_name)
+  - inboxes.delete(inbox_id)
+
+  Errors: SDK raises on 4xx/5xx. Rate limit: 429 with Retry-After.
+  """
+  import os
+  from dotenv import load_dotenv
+  from agentmail import AgentMail
+
+  load_dotenv()
+  client = AgentMail(api_key=os.getenv("AGENTMAIL_API_KEY"))
+
+  # Create (client_id for idempotent retries)
+  inbox = client.inboxes.create(client_id="my-inbox-v1")
+
+  # Get, list
+  retrieved = client.inboxes.get(inbox.inbox_id)
+  all_inboxes = client.inboxes.list(limit=20)
+  print(f"Total: {all_inboxes.count}")
+  ```
+
+  ```typescript title="TypeScript"
+  /**
+   * AgentMail Inboxes — copy into Cursor/Claude.
+   *
+   * Setup: npm install agentmail dotenv. Set AGENTMAIL_API_KEY in .env.
+   *
+   * API reference:
+   * - inboxes.create({ username?, domain?, displayName?, clientId? })
+   * - inboxes.get(inboxId)
+   * - inboxes.list({ limit?, pageToken? })
+   * - inboxes.update(inboxId, { displayName })
+   * - inboxes.delete(inboxId)
+   *
+   * Errors: SDK throws on 4xx/5xx. Rate limit: 429 with Retry-After.
+   */
+  import { AgentMailClient } from "agentmail";
+  import "dotenv/config";
+
+  const client = new AgentMailClient({ apiKey: process.env.AGENTMAIL_API_KEY! });
+
+  async function main() {
+    const inbox = await client.inboxes.create({ clientId: "my-inbox-v1" });
+    const retrieved = await client.inboxes.get(inbox.inboxId);
+    const allInboxes = await client.inboxes.list({ limit: 20 });
+    console.log("Total:", allInboxes.count);
+  }
+  main();
+  ```
+</CodeBlocks>
+
 
 ***
 
@@ -659,6 +829,100 @@ You can retrieve the details of any specific `Message` by providing its ID along
 
 When receiving replies or forwards, use `extracted_text` or `extracted_html` for just the new content—quoted history is stripped automatically.
 
+## Copy for Cursor / Claude
+
+Copy one of the blocks below into Cursor or Claude for complete Messages API knowledge in one shot.
+
+<CodeBlocks>
+  ```python title="Python"
+  """
+  AgentMail Messages — copy into Cursor/Claude.
+
+  Setup: pip install agentmail python-dotenv. Set AGENTMAIL_API_KEY in .env.
+
+  API reference:
+  - messages.send(inbox_id, to, subject, text, html?, cc?, bcc?, reply_to?, labels?, attachments?)
+  - messages.list(inbox_id, limit?, page_token?, labels?)
+  - messages.get(inbox_id, message_id)
+  - messages.reply(inbox_id, message_id, text, html?, attachments?, reply_all?)
+  - messages.forward(inbox_id, message_id, to, subject?, text?, html?)
+  - messages.update(inbox_id, message_id, add_labels?, remove_labels?)
+  - messages.get_attachment(inbox_id, message_id, attachment_id)
+  - messages.get_raw(inbox_id, message_id)
+
+  Reply content: use extracted_text/extracted_html for new content without quoted history.
+  Errors: SDK raises on 4xx/5xx. Rate limit: 429 with Retry-After.
+  """
+  import os
+  from dotenv import load_dotenv
+  from agentmail import AgentMail
+
+  load_dotenv()
+  client = AgentMail(api_key=os.getenv("AGENTMAIL_API_KEY"))
+
+  inbox_id = "agent@agentmail.to"
+
+  # Send
+  sent = client.inboxes.messages.send(inbox_id, to="user@example.com", subject="Hi", text="Body", labels=["outreach"])
+  print(sent.message_id, sent.thread_id)
+
+  # List, get
+  res = client.inboxes.messages.list(inbox_id, limit=10)
+  for msg in res.messages:
+      content = msg.extracted_text or msg.text
+  msg = client.inboxes.messages.get(inbox_id, res.messages[0].message_id)
+
+  # Reply
+  reply = client.inboxes.messages.reply(inbox_id, msg.message_id, text="Thanks!")
+  ```
+
+  ```typescript title="TypeScript"
+  /**
+   * AgentMail Messages — copy into Cursor/Claude.
+   *
+   * Setup: npm install agentmail dotenv. Set AGENTMAIL_API_KEY in .env.
+   *
+   * API reference:
+   * - messages.send(inboxId, { to, subject, text, html?, cc?, bcc?, replyTo?, labels?, attachments? })
+   * - messages.list(inboxId, { limit?, pageToken?, labels? })
+   * - messages.get(inboxId, messageId)
+   * - messages.reply(inboxId, messageId, { text, html?, attachments?, replyAll? })
+   * - messages.forward(inboxId, messageId, { to, subject?, text?, html? })
+   * - messages.update(inboxId, messageId, { addLabels?, removeLabels? })
+   * - messages.getAttachment(inboxId, messageId, attachmentId)
+   * - messages.getRaw(inboxId, messageId)
+   *
+   * Reply content: use extractedText/extractedHtml for new content without quoted history.
+   * Errors: SDK throws on 4xx/5xx. Rate limit: 429 with Retry-After.
+   */
+  import { AgentMailClient } from "agentmail";
+  import "dotenv/config";
+
+  const client = new AgentMailClient({ apiKey: process.env.AGENTMAIL_API_KEY! });
+
+  async function main() {
+    const inboxId = "agent@agentmail.to";
+
+    const sent = await client.inboxes.messages.send(inboxId, {
+      to: "user@example.com",
+      subject: "Hi",
+      text: "Body",
+      labels: ["outreach"],
+    });
+    console.log(sent.messageId, sent.threadId);
+
+    const res = await client.inboxes.messages.list(inboxId, { limit: 10 });
+    for (const msg of res.messages) {
+      const content = msg.extractedText ?? msg.text;
+    }
+    const msg = await client.inboxes.messages.get(inboxId, res.messages[0].messageId);
+
+    await client.inboxes.messages.reply(inboxId, msg.messageId, { text: "Thanks!" });
+  }
+  main();
+  ```
+</CodeBlocks>
+
 ### Crafting Your Message: HTML, Text, and CSS
 
 When sending a `Message`, you can provide the body in two formats: `text` for a plain-text version and `html` for a rich, styled version.
@@ -929,6 +1193,89 @@ You can also retrieve a single `Thread` by its ID. This will return the `Thread`
   ```
 </CodeBlocks>
 
+## Copy for Cursor / Claude
+
+Copy one of the blocks below into Cursor or Claude for complete Threads API knowledge in one shot.
+
+<CodeBlocks>
+  ```python title="Python"
+  """
+  AgentMail Threads — copy into Cursor/Claude.
+
+  Setup: pip install agentmail python-dotenv. Set AGENTMAIL_API_KEY in .env.
+
+  API reference:
+  - inboxes.threads.list(inbox_id, limit?, page_token?, labels?, before?, after?, ascending?)
+  - inboxes.threads.get(inbox_id, thread_id)
+  - inboxes.threads.get_attachment(inbox_id, thread_id, attachment_id)
+  - inboxes.threads.delete(inbox_id, thread_id)
+  - threads.list(limit?, page_token?, labels?) — org-wide, all inboxes
+  - threads.get(thread_id) — org-wide
+  - threads.get_attachment(thread_id, attachment_id)
+
+  Errors: SDK raises on 4xx/5xx. Rate limit: 429 with Retry-After.
+  """
+  import os
+  from dotenv import load_dotenv
+  from agentmail import AgentMail
+
+  load_dotenv()
+  client = AgentMail(api_key=os.getenv("AGENTMAIL_API_KEY"))
+
+  inbox_id = "agent@agentmail.to"
+
+  # Per-inbox threads
+  inbox_threads = client.inboxes.threads.list(inbox_id=inbox_id, limit=20)
+  if inbox_threads.threads:
+      thread = client.inboxes.threads.get(inbox_id, inbox_threads.threads[0].thread_id)
+
+  # Org-wide threads
+  all_threads = client.threads.list(limit=50)
+  if all_threads.threads:
+      single = client.threads.get(all_threads.threads[0].thread_id)
+      print(f"Thread has {len(single.messages)} messages")
+  ```
+
+  ```typescript title="TypeScript"
+  /**
+   * AgentMail Threads — copy into Cursor/Claude.
+   *
+   * Setup: npm install agentmail dotenv. Set AGENTMAIL_API_KEY in .env.
+   *
+   * API reference:
+   * - inboxes.threads.list(inboxId, { limit?, pageToken?, labels?, before?, after?, ascending? })
+   * - inboxes.threads.get(inboxId, threadId)
+   * - inboxes.threads.getAttachment(inboxId, threadId, attachmentId)
+   * - inboxes.threads.delete(inboxId, threadId)
+   * - threads.list({ limit?, pageToken?, labels? }) — org-wide
+   * - threads.get(threadId) — org-wide
+   * - threads.getAttachment(threadId, attachmentId)
+   *
+   * Errors: SDK throws on 4xx/5xx. Rate limit: 429 with Retry-After.
+   */
+  import { AgentMailClient } from "agentmail";
+  import "dotenv/config";
+
+  const client = new AgentMailClient({ apiKey: process.env.AGENTMAIL_API_KEY! });
+
+  async function main() {
+    const inboxId = "agent@agentmail.to";
+
+    const inboxThreads = await client.inboxes.threads.list(inboxId, { limit: 20 });
+    if (inboxThreads.threads.length > 0) {
+      const thread = await client.inboxes.threads.get(inboxId, inboxThreads.threads[0].threadId);
+    }
+
+    const allThreads = await client.threads.list({ limit: 50 });
+    if (allThreads.threads.length > 0) {
+      const single = await client.threads.get(allThreads.threads[0].threadId);
+      console.log("Thread has", single.messages.length, "messages");
+    }
+  }
+  main();
+  ```
+</CodeBlocks>
+
 
 ***
 
@@ -1059,6 +1406,84 @@ Similar to `Threads`, you can list all `Drafts` across your entire `Organization
   ```
 </CodeBlocks>
 
+## Copy for Cursor / Claude
+
+Copy one of the blocks below into Cursor or Claude for complete Drafts API knowledge in one shot.
+
+<CodeBlocks>
+  ```python title="Python"
+  """
+  AgentMail Drafts — copy into Cursor/Claude.
+
+  Setup: pip install agentmail python-dotenv. Set AGENTMAIL_API_KEY in .env.
+
+  API reference:
+  - inboxes.drafts.create(inbox_id, to, subject?, text?, html?, cc?, bcc?, reply_to?, attachments?)
+  - inboxes.drafts.get(inbox_id, draft_id)
+  - inboxes.drafts.update(inbox_id, draft_id, to?, subject?, text?, html?, ...)
+  - inboxes.drafts.send(inbox_id, draft_id) — converts to Message, deletes draft
+  - inboxes.drafts.delete(inbox_id, draft_id)
+  - inboxes.drafts.list(inbox_id, limit?, page_token?, labels?)
+  - drafts.list(limit?, page_token?) — org-wide
+
+  Errors: SDK raises on 4xx/5xx. Rate limit: 429 with Retry-After.
+  """
+  import os
+  from dotenv import load_dotenv
+  from agentmail import AgentMail
+
+  load_dotenv()
+  client = AgentMail(api_key=os.getenv("AGENTMAIL_API_KEY"))
+
+  inbox_id = "agent@agentmail.to"
+
+  draft = client.inboxes.drafts.create(inbox_id, to=["review@example.com"], subject="[REVIEW] Proposed reply")
+  retrieved = client.inboxes.drafts.get(inbox_id, draft.draft_id)
+  sent = client.inboxes.drafts.send(inbox_id, draft.draft_id)
+  print(sent.message_id)
+
+  all_drafts = client.drafts.list()
+  ```
+
+  ```typescript title="TypeScript"
+  /**
+   * AgentMail Drafts — copy into Cursor/Claude.
+   *
+   * Setup: npm install agentmail dotenv. Set AGENTMAIL_API_KEY in .env.
+   *
+   * API reference:
+   * - inboxes.drafts.create(inboxId, { to, subject?, text?, html?, cc?, bcc?, replyTo?, attachments? })
+   * - inboxes.drafts.get(inboxId, draftId)
+   * - inboxes.drafts.update(inboxId, draftId, { to?, subject?, text?, html?, ... })
+   * - inboxes.drafts.send(inboxId, draftId) — converts to Message, deletes draft
+   * - inboxes.drafts.delete(inboxId, draftId)
+   * - inboxes.drafts.list(inboxId, { limit?, pageToken?, labels? })
+   * - drafts.list({ limit?, pageToken? }) — org-wide
+   *
+   * Errors: SDK throws on 4xx/5xx. Rate limit: 429 with Retry-After.
+   */
+  import { AgentMailClient } from "agentmail";
+  import "dotenv/config";
+
+  const client = new AgentMailClient({ apiKey: process.env.AGENTMAIL_API_KEY! });
+
+  async function main() {
+    const inboxId = "agent@agentmail.to";
+
+    const draft = await client.inboxes.drafts.create(inboxId, {
+      to: ["review@example.com"],
+      subject: "[REVIEW] Proposed reply",
+    });
+    const retrieved = await client.inboxes.drafts.get(inboxId, draft.draftId);
+    const sent = await client.inboxes.drafts.send(inboxId, draft.draftId);
+    console.log(sent.messageId);
+
+    const allDrafts = await client.drafts.list();
+  }
+  main();
+  ```
+</CodeBlocks>
+
 
 ***
 
@@ -1206,6 +1631,70 @@ This is where `Labels` become truly powerful. You can list `Threads`, `Messages`
   ```
 </CodeBlocks>
 
+## Copy for Cursor / Claude
+
+Copy one of the blocks below into Cursor or Claude for complete Labels usage in one shot.
+
+<CodeBlocks>
+  ```python title="Python"
+  """
+  AgentMail Labels — copy into Cursor/Claude.
+
+  Labels are string tags on Messages and Threads for state, campaigns, triage.
+
+  - Send: messages.send(..., labels=["campaign", "follow-up"])
+  - Update: inboxes.messages.update(inbox_id, message_id, add_labels=[...], remove_labels=[...])
+  - Filter: messages.list(inbox_id, labels=[...]), threads.list(inbox_id, labels=[...]), drafts.list(inbox_id, labels=[...])
+
+  Use kebab-case or snake_case consistently.
+  """
+  from agentmail import AgentMail
+
+  client = AgentMail(api_key="YOUR_API_KEY")
+
+  # Send with labels
+  client.inboxes.messages.send("out@agentmail.to", to="user@example.com", subject="Hi", text="Body", labels=["q4-campaign"])
+
+  # Update labels
+  client.inboxes.messages.update("out@agentmail.to", "msg_123", add_labels=["resolved"], remove_labels=["pending"])
+
+  # Filter by labels
+  threads = client.inboxes.threads.list("out@agentmail.to", labels=["q4-campaign", "follow-up"])
+  ```
+
+  ```typescript title="TypeScript"
+  /**
+   * AgentMail Labels — copy into Cursor/Claude.
+   *
+   * Labels are string tags on Messages and Threads for state, campaigns, triage.
+   *
+   * - Send: messages.send(inboxId, { ..., labels: ["campaign", "follow-up"] })
+   * - Update: messages.update(inboxId, messageId, { addLabels: [...], removeLabels: [...] })
+   * - Filter: messages.list(inboxId, { labels: [...] }), threads.list(inboxId, { labels: [...] }), drafts.list(inboxId, { labels: [...] })
+   *
+   * Use kebab-case or camelCase consistently.
+   */
+  import { AgentMailClient } from "agentmail";
+
+  const client = new AgentMailClient({ apiKey: "YOUR_API_KEY" });
+
+  async function main() {
+    await client.inboxes.messages.send("out@agentmail.to", {
+      to: "user@example.com",
+      subject: "Hi",
+      text: "Body",
+      labels: ["q4-campaign"],
+    });
+    await client.inboxes.messages.update("out@agentmail.to", "msg_123", {
+      addLabels: ["resolved"],
+      removeLabels: ["pending"],
+    });
+    const threads = await client.inboxes.threads.list("out@agentmail.to", { labels: ["q4-campaign", "follow-up"] });
+  }
+  main();
+  ```
+</CodeBlocks>
+
 ## Best Practices
 
 * **Be Consistent:** Establish a clear and consistent naming convention for your labels (e.g., `kebab-case`, `snake_case`).
@@ -1312,6 +1801,65 @@ Remove an entry from a list.
   ```
 </CodeBlocks>
 
+## Copy for Cursor / Claude
+
+Copy one of the blocks below into Cursor or Claude for complete Lists API knowledge in one shot.
+
+<CodeBlocks>
+  ```python title="Python"
+  """
+  AgentMail Lists — copy into Cursor/Claude.
+
+  Filter emails by allow/block for send/receive. Types: receive|send × allow|block.
+
+  API reference:
+  - lists.list(direction, type, limit?, page_token?)
+  - lists.create(direction, type, entry, reason?) — reason only for block lists
+  - lists.get(direction, type, entry)
+  - lists.delete(direction, type, entry)
+
+  Entry: full email (user@domain.com) or domain (example.com).
+  """
+  from agentmail import AgentMail
+
+  client = AgentMail(api_key="YOUR_API_KEY")
+
+  entries = client.lists.list("receive", "allow", limit=10)
+  client.lists.create("receive", "allow", entry="partner@example.com")
+  client.lists.create("receive", "block", entry="spam@example.com", reason="spam")
+  e = client.lists.get("receive", "allow", entry="partner@example.com")
+  client.lists.delete("receive", "allow", entry="partner@example.com")
+  ```
+
+  ```typescript title="TypeScript"
+  /**
+   * AgentMail Lists — copy into Cursor/Claude.
+   *
+   * Filter emails by allow/block for send/receive. Types: receive|send × allow|block.
+   *
+   * API reference:
+   * - lists.list(direction, type, { limit?, pageToken? })
+   * - lists.create(direction, type, { entry, reason? }) — reason only for block
+   * - lists.get(direction, type, entry)
+   * - lists.delete(direction, type, entry)
+   *
+   * Entry: full email or domain.
+   */
+  import { AgentMailClient } from "agentmail";
+
+  const client = new AgentMailClient({ apiKey: "YOUR_API_KEY" });
+
+  async function main() {
+    const entries = await client.lists.list("receive", "allow", { limit: 10 });
+    await client.lists.create("receive", "allow", { entry: "partner@example.com" });
+    await client.lists.create("receive", "block", { entry: "spam@example.com", reason: "spam" });
+    const e = await client.lists.get("receive", "allow", "partner@example.com");
+    await client.lists.delete("receive", "allow", "partner@example.com");
+  }
+  main();
+  ```
+</CodeBlocks>
+
 
 ***
 
@@ -1458,6 +2006,66 @@ Similarly, you can retrieve an `Attachment` if you know the `Thread` it's in, wh
   ```
 </CodeBlocks>
 
+## Copy for Cursor / Claude
+
+Copy one of the blocks below into Cursor or Claude for complete Attachments usage in one shot.
+
+<CodeBlocks>
+  ```python title="Python"
+  """
+  AgentMail Attachments — copy into Cursor/Claude.
+
+  Send: attachments=[{ content: base64_string, filename?, content_type? }] in messages.send/reply.
+  Get attachment_id from message.attachments or thread.attachments.
+
+  - messages.get_attachment(inbox_id, message_id, attachment_id) → bytes
+  - threads.get_attachment(inbox_id, thread_id, attachment_id) → bytes
+  """
+  import base64
+  from agentmail import AgentMail
+
+  client = AgentMail(api_key="YOUR_API_KEY")
+
+  encoded = base64.b64encode(b"file content").decode()
+  client.inboxes.messages.send(
+    "agent@agentmail.to",
+    to="user@example.com",
+    subject="Report",
+    text="See attachment",
+    attachments=[{"content": encoded, "filename": "report.txt", "content_type": "text/plain"}],
+  )
+
+  data = client.inboxes.messages.get_attachment("inbox@am.to", "msg_123", "att_456")
+  with open("downloaded.pdf", "wb") as f:
+    f.write(data)
+  ```
+
+  ```typescript title="TypeScript"
+  /**
+   * AgentMail Attachments — copy into Cursor/Claude.
+   *
+   * Send: attachments: [{ content: base64String, filename?, contentType? }] in messages.send/reply.
+   * Get attachmentId from message.attachments or thread.attachments.
+   *
+   * - messages.get_attachment(inboxId, messageId, attachmentId) → Buffer/Blob
+   * - threads.get_attachment(inboxId, threadId, attachmentId) → Buffer/Blob
+   */
+  import { AgentMailClient } from "agentmail";
+
+  const client = new AgentMailClient({ apiKey: "YOUR_API_KEY" });
+
+  const encoded = Buffer.from("file content").toString("base64");
+  await client.inboxes.messages.send("agent@agentmail.to", {
+    to: "user@example.com",
+    subject: "Report",
+    text: "See attachment",
+    attachments: [{ content: encoded, filename: "report.txt", contentType: "text/plain" }],
+  });
+
+  const data = await client.inboxes.messages.get_attachment("inbox@am.to", "msg_123", "att_456");
+  ```
+</CodeBlocks>
+
 
 ***
 
@@ -1559,6 +2167,61 @@ This gives you a unified view of all activity within a customer's workspace, mak
 * "List all threads across all of Customer Y's team inboxes"
 * "Display all pending drafts for Customer Z"
 
+## Copy for Cursor / Claude
+
+Copy one of the blocks below into Cursor or Claude for complete Pods API knowledge in one shot.
+
+<CodeBlocks>
+  ```python title="Python"
+  """
+  AgentMail Pods — copy into Cursor/Claude. Multi-tenant isolation.
+
+  API reference:
+  - pods.create(client_id?) — client_id for idempotent mapping to your tenant IDs
+  - pods.get(pod_id), pods.list(limit?, page_token?), pods.delete(pod_id)
+  - pods.inboxes.list(pod_id, ...), pods.inboxes.create(pod_id, ...), pods.inboxes.delete(pod_id, inbox_id)
+  - pods.domains.list(pod_id, ...), pods.domains.create(pod_id, ...), pods.domains.delete(pod_id, domain_id)
+  - pods.threads.list(pod_id, ...), pods.drafts.list(pod_id, ...)
+
+  Delete order: inboxes + domains first, then pod. Deleting inbox/domain cascades to messages/threads.
+  """
+  from agentmail import AgentMail
+
+  client = AgentMail(api_key="YOUR_API_KEY")
+
+  pod = client.pods.create(client_id="tenant-acme-1")
+  inboxes = client.pods.inboxes.list(pod.pod_id)
+  inbox = client.pods.inboxes.create(pod.pod_id, username="support", display_name="Support")
+  threads = client.pods.threads.list(pod.pod_id, limit=20)
+  ```
+
+  ```typescript title="TypeScript"
+  /**
+   * AgentMail Pods — copy into Cursor/Claude. Multi-tenant isolation.
+   *
+   * API reference:
+   * - pods.create({ clientId? })
+   * - pods.get(podId), pods.list({ limit?, pageToken? }), pods.delete(podId)
+   * - pods.inboxes.list(podId, ...), pods.inboxes.create(podId, ...), pods.inboxes.delete(podId, inboxId)
+   * - pods.domains.list(podId, ...), pods.domains.create(podId, ...), pods.domains.delete(podId, domainId)
+   * - pods.threads.list(podId, ...), pods.drafts.list(podId, ...)
+   *
+   * Delete order: inboxes + domains first, then pod.
+   */
+  import { AgentMailClient } from "agentmail";
+
+  const client = new AgentMailClient({ apiKey: "YOUR_API_KEY" });
+
+  async function main() {
+    const pod = await client.pods.create({ clientId: "tenant-acme-1" });
+    const inboxes = await client.pods.inboxes.list(pod.podId);
+    const inbox = await client.pods.inboxes.create(pod.podId, { username: "support", displayName: "Support" });
+    const threads = await client.pods.threads.list(pod.podId, { limit: 20 });
+  }
+  main();
+  ```
+</CodeBlocks>
+
 ## Important Considerations
 
 ### Pod Deletion Constraints
@@ -1699,36 +2362,318 @@ Pod: "Marketing-Agent"
 * Explore [Domains](/custom-domains) to set up custom email domains for your pods
 
 
+***
+
+title: AI Onboarding
+subtitle: Everything you need to onboard your AI agent to AgentMail
+slug: ai-onboarding
+description: >-
+Resources for AI coding assistants, MCP servers, skills, and agent-friendly
+documentation.
+--------------
+
+> Everything you need to onboard your AI agent to AgentMail — the email platform built for AI agents.
+
+If you're developing with AI, AgentMail offers several resources to improve your experience.
+
+## Prerequisite: Create an API Key
+
+You'll need a human to create an AgentMail account at [console.agentmail.to](https://console.agentmail.to). Once you have an account, create an API key from the dashboard. With an API key, your agent can create inboxes, send and receive emails, manage threads, and more.
+
+<Info>
+  AgentMail's free tier includes 3 inboxes and 3,000 emails/month. Your agent can start building immediately.
+</Info>
+
+## AgentMail MCP Server
+
+MCP (Model Context Protocol) is an open protocol that standardizes how applications provide context to LLMs. The AgentMail MCP server gives your AI agent tools to create inboxes, send emails, manage threads, and more.
+
+### Setup
+
+Add this to your MCP client configuration (Claude Code, Cursor, Codex, etc.):
+
+```json
+{
+  "mcpServers": {
+    "AgentMail": {
+      "command": "npx",
+      "args": ["-y", "agentmail-mcp"],
+      "env": {
+        "AGENTMAIL_API_KEY": "YOUR_API_KEY"
+      }
+    }
+  }
+}
+```
+
+You can selectively enable specific tools using the `--tools` argument:
+
+```json
+{
+  "mcpServers": {
+    "AgentMail": {
+      "command": "npx",
+      "args": ["-y", "agentmail-mcp", "--tools", "get_message,send_message,reply_to_message"],
+      "env": {
+        "AGENTMAIL_API_KEY": "YOUR_API_KEY"
+      }
+    }
+  }
+}
+```
+
+### Available MCP Tools
+
+| Tool               | Description                           |
+| ------------------ | ------------------------------------- |
+| `create_inbox`     | Create a new email inbox for an agent |
+| `list_inboxes`     | List all inboxes in your account      |
+| `get_inbox`        | Get details of a specific inbox       |
+| `delete_inbox`     | Delete an inbox                       |
+| `send_message`     | Send an email from an agent inbox     |
+| `reply_to_message` | Reply to an email in a thread         |
+| `forward_message`  | Forward an email                      |
+| `update_message`   | Update message labels or status       |
+| `list_threads`     | List email threads in an inbox        |
+| `get_thread`       | Get a full email thread with messages |
+| `get_attachment`   | Download an email attachment          |
+
+<Card title="MCP Server on GitHub" icon="fa-brands fa-github" href="https://github.com/agentmail-to/agentmail-smithery-mcp">
+  View the source code, contribute, or report issues.
+</Card>
+
+## AgentMail Docs for Agents
+
+You can give your agent current docs in three ways:
+
+1. **Full documentation index**
+
+   A structured index of every doc page with descriptions:
+
+   ```
+   https://docs.agentmail.to/llms.txt
+   ```
+2. **Complete docs in one file**
+
+   Every doc page concatenated into a single file for full context:
+
+   ```
+   https://docs.agentmail.to/llms-full.txt
+   ```
+3. **Markdown versions of any page**
+
+   Every doc page is available as Markdown. Append `.md` to any page URL:
+
+   ```
+   https://docs.agentmail.to/quickstart.md
+   ```
+
+## AgentMail Skills
+
+Skills give AI agents specialized knowledge for specific tasks. Install the AgentMail skill to give your coding assistant full email capabilities:
+
+### Claude Code
+
+```bash
+claude-code skills install agentmail-to/agentmail-skills/agentmail
+```
+
+### Cursor
+
+```bash
+cursor skills install agentmail-to/agentmail-skills/agentmail
+```
+
+### Codex
+
+```bash
+codex skills install agentmail-to/agentmail-skills/agentmail
+```
+
+### Manual Installation
+
+```bash
+git clone https://github.com/agentmail-to/agentmail-skills.git ~/.skills/agentmail
+```
+
+Then set your API key:
+
+```bash
+export AGENTMAIL_API_KEY="your-api-key-here"
+```
+
+<Card title="Skills on GitHub" icon="fa-brands fa-github" href="https://github.com/agentmail-to/agentmail-skills">
+  View the skill source and full documentation.
+</Card>
+
+## Quick Start for Agents
+
+Create an inbox and send your first email in a few lines:
+
+<CodeBlocks>
+  ```python title="Python"
+  from agentmail import AgentMail
+
+  client = AgentMail(api_key="am_...")
+  inbox = client.inboxes.create(display_name="My AI Agent")
+  print(f"Agent email: {inbox.inbox_id}")
+
+  # Send an email
+  client.inboxes.messages.send(
+      inbox.inbox_id,
+      to="user@example.com",
+      subject="Hello from my AI agent",
+      text="Hi! I'm an AI agent with my own email address."
+  )
+  ```
+
+  ```typescript title="TypeScript"
+  import { AgentMailClient } from "agentmail";
+
+  const client = new AgentMailClient({ apiKey: "am_..." });
+  const inbox = await client.inboxes.create({ displayName: "My AI Agent" });
+  console.log(`Agent email: ${inbox.inboxId}`);
+
+  // Send an email
+  await client.inboxes.messages.send(inbox.inboxId, {
+      to: "user@example.com",
+      subject: "Hello from my AI agent",
+      text: "Hi! I'm an AI agent with my own email address."
+  });
+  ```
+</CodeBlocks>
+
+### Receive and reply to emails
+
+<CodeBlocks>
+  ```python title="Python"
+  # List threads in the inbox
+  threads = client.inboxes.threads.list(inbox_id=inbox.inbox_id)
+
+  # Get the latest thread
+  thread = client.inboxes.threads.get(
+      inbox_id=inbox.inbox_id,
+      thread_id=threads.threads[0].thread_id
+  )
+
+  # Reply to the latest message
+  latest_message = thread.messages[-1]
+  client.inboxes.messages.reply(
+      inbox_id=inbox.inbox_id,
+      message_id=latest_message.message_id,
+      to=[latest_message.from_],
+      text="Thanks for your email! I'll look into this."
+  )
+  ```
+
+  ```typescript title="TypeScript"
+  // List threads in the inbox
+  const threads = await client.inboxes.threads.list(inbox.inboxId);
+
+  // Get the latest thread
+  const thread = await client.inboxes.threads.get(
+      inbox.inboxId,
+      threads.threads[0].threadId
+  );
+
+  // Reply to the latest message
+  const latestMessage = thread.messages[thread.messages.length - 1];
+  await client.inboxes.messages.reply(
+      inbox.inboxId,
+      latestMessage.messageId,
+      { to: [latestMessage.from], text: "Thanks for your email! I'll look into this." }
+  );
+  ```
+</CodeBlocks>
+
+## AI Builder Integrations
+
+AgentMail integrates with popular AI development platforms:
+
+<CardGroup cols={2}>
+  <Card title="Replit" icon="fa-solid fa-code" href="/integrations/replit">
+    Build email agents on Replit with our template.
+  </Card>
+
+  <Card title="LiveKit" icon="fa-solid fa-microphone" href="/integrate-livekit-agents">
+    Add email to LiveKit voice agents.
+  </Card>
+
+  <Card title="OpenClaw" icon="fa-solid fa-robot" href="/integrations/openclaw">
+    Use AgentMail with OpenClaw agents.
+  </Card>
+
+  <Card title="WebSockets" icon="fa-solid fa-bolt" href="/websockets">
+    Real-time email events without webhooks.
+  </Card>
+</CardGroup>
+
+## What Makes AgentMail Different?
+
+Unlike traditional email APIs (SendGrid, Resend, Mailgun) that are built for one-way transactional email, AgentMail is built for **two-way agent communication**:
+
+| Feature                | AgentMail                  | Traditional Email APIs    |
+| ---------------------- | -------------------------- | ------------------------- |
+| Per-agent inboxes      | ✅ Create thousands via API | ❌ Shared sending domains  |
+| Receive & parse emails | ✅ Native with threads      | ⚠️ Limited or add-on      |
+| Threaded conversations | ✅ First-class API support  | ❌ Not supported           |
+| Allowlists/blocklists  | ✅ Per-inbox controls       | ❌ Not available           |
+| Multi-tenant (Pods)    | ✅ Built-in isolation       | ❌ Build it yourself       |
+| WebSocket events       | ✅ Real-time streaming      | ❌ Webhooks only           |
+| IMAP/SMTP access       | ✅ Full protocol support    | ❌ API-only                |
+| Usage-based pricing    | ✅ Pay per email            | ❌ Per-inbox subscriptions |
+
+## Next Steps
+
+<CardGroup>
+  <Card title="Full Quickstart Guide" icon="fa-solid fa-rocket" href="/quickstart">
+    Step-by-step setup with environment variables and best practices.
+  </Card>
+
+  <Card title="API Reference" icon="fa-solid fa-code" href="/api-reference">
+    Full interactive API documentation.
+  </Card>
+
+  <Card title="Example: Auto-Reply Agent" icon="fa-solid fa-bolt" href="/examples/auto-reply-agent">
+    Build an agent that responds to emails in real-time.
+  </Card>
+
+  <Card title="FAQ" icon="fa-solid fa-book" href="/resources/faq">
+    Answers to common questions about email, deliverability, and agent patterns.
+  </Card>
+</CardGroup>
+
+
 ***
 
 title: Skills
 subtitle: Add AgentMail to AI coding assistants with the official skill
 slug: integrations/skills
 description: >-
-AgentMail's official skill for Moltbot, Claude Code, Cursor, and other AI
+AgentMail's official skill for OpenClaw, Claude Code, Cursor, and other AI
 assistants
 ----------
 
 ## Getting started
 
-AgentMail provides an official skill that can be installed on AI coding assistants and agents that support the [AgentSkills](https://skills.sh) format. This includes Moltbot, Claude Code, Cursor, Codex, and other compatible tools.
+AgentMail provides an official skill that can be installed on AI coding assistants and agents that support the [AgentSkills](https://skills.sh) format. This includes OpenClaw, Claude Code, Cursor, Codex, and other compatible tools.
 
 The skill is available at [skills.sh/agentmail-to/agentmail-skills/agentmail](https://skills.sh/agentmail-to/agentmail-skills/agentmail).
 
 ## Installation
 
-### Moltbot
+### OpenClaw
 
-Install the skill using the Moltbot CLI:
+Install the skill using the OpenClaw CLI:
 
 ```bash
-moltbot skills install agentmail-to/agentmail-skills/agentmail
+openclaw skills install agentmail-to/agentmail-skills/agentmail
 ```
 
-Or install via ClawdHub:
+Or install via ClawHub:
 
 ```bash
-clawdhub install agentmail
+npx clawhub@latest install agentmail
 ```
 
 ### Claude Code
@@ -1767,9 +2712,9 @@ Set the `AGENTMAIL_API_KEY` environment variable:
 export AGENTMAIL_API_KEY="your-api-key-here"
 ```
 
-### Moltbot configuration
+### OpenClaw configuration
 
-Add the API key to `~/.clawdbot/moltbot.json`:
+Add the API key to `~/.openclaw/openclaw.json`:
 
 ```json
 {
@@ -1856,7 +2801,13 @@ The Model Context Protocol (MCP) is an open standard that enables AI application
 
 ### Setup
 
-To get started with the AgentMail MCP server, visit [mcp.agentmail.to](https://mcp.agentmail.to) for installation instructions and configuration details.
+Install with:
+
+```bash
+npx @smithery/cli@latest mcp add agentmail
+```
+
+Configure your API key when prompted. Get your key from the [AgentMail Console](https://console.agentmail.to). For more details, visit [mcp.agentmail.to](https://mcp.agentmail.to).
 
 ## Features
 
@@ -1881,25 +2832,25 @@ For detailed setup instructions and available tools, visit [mcp.agentmail.to](ht
 
 ***
 
-title: Openclaw
-subtitle: Give your Openclaw agent its own email inbox
+title: OpenClaw
+subtitle: Give your OpenClaw agent its own email inbox
 slug: integrations/openclaw
-description: AgentMail's Openclaw integration
+description: AgentMail's OpenClaw integration
 ---------------------------------------------
 
 ## Getting started
 
-Openclaw (formerly Moltbot) is an open-source AI personal assistant that runs on your own devices and integrates with messaging platforms like WhatsApp, Telegram, Discord, and Slack. By adding AgentMail to Openclaw, your agent gains the ability to send and receive emails, enabling two-way email conversations alongside your existing chat channels.
+OpenClaw (formerly Moltbot) is an open-source AI personal assistant that runs on your own devices and integrates with messaging platforms like WhatsApp, Telegram, Discord, and Slack. By adding AgentMail to OpenClaw, your agent gains the ability to send and receive emails, enabling two-way email conversations alongside your existing chat channels.
 
-There are two ways to integrate AgentMail with Openclaw: using the official AgentMail skill or creating a custom skill.
+There are two ways to integrate AgentMail with OpenClaw: using the official AgentMail skill or creating a custom skill.
 
 ## Option 1: Official AgentMail Skill (Recommended)
 
-The easiest way to add email capabilities to Openclaw is by installing the official AgentMail skill from [skills.sh](https://skills.sh/agentmail-to/agentmail-skills/agentmail). This skill is maintained by the AgentMail team and provides comprehensive email functionality.
+The easiest way to add email capabilities to OpenClaw is by installing the official AgentMail skill from [skills.sh](https://skills.sh/agentmail-to/agentmail-skills/agentmail). This skill is maintained by the AgentMail team and provides comprehensive email functionality.
 
 ### Installation
 
-Install the skill using the Openclaw CLI:
+Install the skill using the OpenClaw CLI:
 
 ```bash
 openclaw skills install agentmail-to/agentmail-skills/agentmail
@@ -1957,11 +2908,11 @@ You should see `agentmail` in the list of available skills.
 
 ## Option 2: Custom Skill
 
-For more control over the integration, you can create a custom AgentMail skill. Skills are directories containing a `SKILL.md` file with instructions for Openclaw.
+For more control over the integration, you can create a custom AgentMail skill. Skills are directories containing a `SKILL.md` file with instructions for OpenClaw.
 
 ### Create the skill directory
 
-Create a new skill in your Openclaw workspace:
+Create a new skill in your OpenClaw workspace:
 
 ```bash
 mkdir -p ~/.openclaw/skills/agentmail
@@ -2023,10 +2974,10 @@ curl -s -X POST -H "Authorization: Bearer $AGENTMAIL_API_KEY" \
   -H "Content-Type: application/json" \
   -d '{
     "to": ["recipient@example.com"],
-    "subject": "Hello from Openclaw",
+    "subject": "Hello from OpenClaw",
     "text": "This email was sent by my AI assistant."
   }' \
-  https://api.agentmail.to/v0/inboxes/{inbox_id}/messages
+  https://api.agentmail.to/v0/inboxes/{inbox_id}/messages/send
 ```
 
 ### List messages in an inbox
@@ -2077,7 +3028,7 @@ You should see `agentmail` in the list of available skills.
 
 ## Example use cases
 
-Once AgentMail is integrated with Openclaw, you can ask your agent to:
+Once AgentMail is integrated with OpenClaw, you can ask your agent to:
 
 * "Create a new email inbox for my project"
 * "Check my inbox for new emails"
@@ -2087,9 +3038,9 @@ Once AgentMail is integrated with Openclaw, you can ask your agent to:
 
 ## Real-time email notifications
 
-For proactive email handling, you can combine AgentMail webhooks with Openclaw's webhook support. This allows Openclaw to notify you immediately when new emails arrive.
+For proactive email handling, you can combine AgentMail webhooks with OpenClaw's webhook support. This allows OpenClaw to notify you immediately when new emails arrive.
 
-1. Set up a webhook endpoint in Openclaw (see [Openclaw webhook documentation](https://docs.openclaw.ai/automation/webhook))
+1. Set up a webhook endpoint in OpenClaw (see [OpenClaw webhook documentation](https://docs.openclaw.ai/automation/webhook))
 
 2. Register the webhook with AgentMail:
 
@@ -2103,14 +3054,14 @@ curl -X POST -H "Authorization: Bearer $AGENTMAIL_API_KEY" \
   https://api.agentmail.to/v0/webhooks
 ```
 
-Now Openclaw will be notified whenever a new email arrives, allowing it to proactively inform you or take action.
+Now OpenClaw will be notified whenever a new email arrives, allowing it to proactively inform you or take action.
 
 ## Resources
 
 * [Official AgentMail Skill](https://skills.sh/agentmail-to/agentmail-skills/agentmail)
 * [AgentMail API Reference](/api-reference)
-* [Openclaw Documentation](https://docs.openclaw.ai)
-* [Openclaw Skills Guide](https://docs.openclaw.ai/tools/skills)
+* [OpenClaw Documentation](https://docs.openclaw.ai)
+* [OpenClaw Skills Guide](https://docs.openclaw.ai/tools/skills)
 
 
 ***
@@ -2641,6 +3592,10 @@ Configure IMAP and SMTP to access your AgentMail inboxes using email clients
 or programmatic access.
 -----------------------
 
+<Callout intent="warn" title="IMAP is Under Development">
+  IMAP support is currently under development and will be available in the coming weeks. The documentation below describes the planned functionality. SMTP is fully available today.
+</Callout>
+
 AgentMail supports standard IMAP and SMTP protocols, allowing you to connect using traditional email clients or integrate with existing systems that rely on these protocols.
 
 ## What are IMAP and SMTP?
@@ -3627,6 +4582,73 @@ When AgentMail sends a webhook, the payload includes `event_type` and `event_id`
   * **`attachments`** (`array<object>`): A list of attachments, each with its own `attachment_id`, `filename`, `content_type`, `size`, and `inline` status.
   * **`in_reply_to`** (`string`): The `message_id` of the email this message is a reply to, if applicable.
 
+## Copy for Cursor / Claude
+
+Copy one of the blocks below into Cursor or Claude for complete Webhooks API knowledge in one shot.
+
+<CodeBlocks>
+  ```python title="Python"
+  """
+  AgentMail Webhooks — copy into Cursor/Claude.
+
+  Setup: pip install agentmail python-dotenv. Set AGENTMAIL_API_KEY in .env.
+  Return 200 immediately; process payload in background.
+
+  API reference:
+  - webhooks.create(url, events?, inbox_ids?, pod_ids?, client_id?)
+  - webhooks.get(webhook_id), webhooks.list(limit?, page_token?)
+  - webhooks.update(webhook_id, add_inbox_ids?, remove_inbox_ids?, add_pod_ids?, remove_pod_ids?)
+  - webhooks.delete(webhook_id)
+
+  Events: message.received, message.sent, message.delivered, message.bounced, message.complained, message.rejected, domain.verified
+  Payload: event_type, event_id, plus message/send/delivery/bounce/complaint/reject/domain. Verify with Svix (webhook.secret).
+  """
+  import os
+  from dotenv import load_dotenv
+  from agentmail import AgentMail
+
+  load_dotenv()
+  client = AgentMail(api_key=os.getenv("AGENTMAIL_API_KEY"))
+
+  wh = client.webhooks.create(url="https://your-server.com/webhooks", events=["message.received"], client_id="my-webhook-v1")
+  all_wh = client.webhooks.list()
+  secret = client.webhooks.get(wh.webhook_id).secret
+  ```
+
+  ```typescript title="TypeScript"
+  /**
+   * AgentMail Webhooks — copy into Cursor/Claude.
+   *
+   * Setup: npm install agentmail dotenv. Set AGENTMAIL_API_KEY in .env.
+   * Return 200 immediately; process payload in background.
+   *
+   * API reference:
+   * - webhooks.create({ url, eventTypes?, inboxIds?, podIds?, clientId? })
+   * - webhooks.get(webhookId), webhooks.list({ limit?, pageToken? })
+   * - webhooks.update(webhookId, { addInboxIds?, removeInboxIds?, addPodIds?, removePodIds? })
+   * - webhooks.delete(webhookId)
+   *
+   * Events: message.received, message.sent, message.delivered, message.bounced, message.complained, message.rejected, domain.verified
+   * Verify with Svix using webhook.secret. Use express.raw() for body—signature needs raw payload.
+   */
+  import { AgentMailClient } from "agentmail";
+  import "dotenv/config";
+
+  const client = new AgentMailClient({ apiKey: process.env.AGENTMAIL_API_KEY! });
+
+  async function main() {
+    const wh = await client.webhooks.create({
+      url: "https://your-server.com/webhooks",
+      eventTypes: ["message.received"],
+      clientId: "my-webhook-v1",
+    });
+    const allWh = await client.webhooks.list();
+    const secret = (await client.webhooks.get(wh.webhookId)).secret;
+  }
+  main();
+  ```
+</CodeBlocks>
+
 ## Next Steps
 
 <CardGroup>
@@ -3744,6 +4766,72 @@ The AgentMail SDKs export typed classes for each webhook event, so you can parse
   ```
 </CodeBlocks>
 
+## Copy for Cursor / Claude
+
+Copy one of the blocks below into Cursor or Claude for webhook event parsing in one shot.
+
+<CodeBlocks>
+  ```python title="Python"
+  """
+  AgentMail Webhook Events — copy into Cursor/Claude.
+
+  Parse typed events: MessageReceivedEvent (has message+thread), MessageSentEvent (send), MessageBouncedEvent (bounce),
+  MessageDeliveredEvent (delivery), MessageComplainedEvent (complaint), MessageRejectedEvent (reject), DomainVerifiedEvent (domain).
+  Only message.received includes full message+thread; others have send/delivery/bounce/complaint/reject/domain.
+  """
+  from agentmail import (
+    MessageReceivedEvent, MessageSentEvent, MessageBouncedEvent,
+    MessageDeliveredEvent, MessageComplainedEvent, MessageRejectedEvent, DomainVerifiedEvent,
+  )
+
+  def handle(payload: dict):
+    t = payload.get("event_type")
+    if t == "message.received": e = MessageReceivedEvent(**payload); print(e.message.subject, e.thread.message_count)
+    elif t == "message.sent": e = MessageSentEvent(**payload); print(e.send.recipients)
+    elif t == "message.bounced": e = MessageBouncedEvent(**payload); print(e.bounce.type)
+    elif t == "message.delivered": e = MessageDeliveredEvent(**payload)
+    elif t == "message.complained": e = MessageComplainedEvent(**payload)
+    elif t == "message.rejected": e = MessageRejectedEvent(**payload); print(e.reject.reason)
+    elif t == "domain.verified": e = DomainVerifiedEvent(**payload); print(e.domain.status)
+  ```
+
+  ```typescript title="TypeScript"
+  /**
+   * AgentMail Webhook Events — copy into Cursor/Claude.
+   *
+   * Parse with serialization.events.MessageReceivedEvent.parse(payload), etc.
+   * Only message.received has message+thread; others have send/delivery/bounce/complaint/reject/domain.
+   */
+  import { serialization } from "agentmail";
+
+  async function handle(payload: Record<string, unknown>) {
+    const t = payload.event_type;
+    if (t === "message.received") {
+      const e = await serialization.events.MessageReceivedEvent.parse(payload);
+      console.log(e.message.subject, e.thread.messageCount);
+    } else if (t === "message.sent") {
+      const e = await serialization.events.MessageSentEvent.parse(payload);
+      console.log(e.send.recipients);
+    } else if (t === "message.bounced") {
+      const e = await serialization.events.MessageBouncedEvent.parse(payload);
+      console.log(e.bounce.type);
+    } else if (t === "message.delivered") {
+      const e = await serialization.events.MessageDeliveredEvent.parse(payload);
+      console.log(e.delivery);
+    } else if (t === "message.complained") {
+      const e = await serialization.events.MessageComplainedEvent.parse(payload);
+      console.log(e.complaint);
+    } else if (t === "message.rejected") {
+      const e = await serialization.events.MessageRejectedEvent.parse(payload);
+      console.log(e.reject);
+    } else if (t === "domain.verified") {
+      const e = await serialization.events.DomainVerifiedEvent.parse(payload);
+      console.log(e.domain);
+    }
+  }
+  ```
+</CodeBlocks>
+
 ## Message Events
 
 ### `message.received`
@@ -4219,6 +5307,63 @@ To test your webhook setup:
   </Accordion>
 </AccordionGroup>
 
+## Copy for Cursor / Claude
+
+Copy one of the blocks below into Cursor or Claude for webhook setup in one shot.
+
+<CodeBlocks>
+  ```python title="Python"
+  """
+  AgentMail Webhook Setup — copy into Cursor/Claude.
+
+  Flow: 1) ngrok http 3000 → copy URL. 2) inboxes.create(client_id=...) 3) webhooks.create(url=ngrok+/webhooks, events=[...], client_id=...)
+  4) Flask POST /webhooks: return 200 immediately, process request.json in background.
+  Local: use http://127.0.0.1:3000 in browser, not ngrok URL.
+  """
+  from flask import Flask, request, Response
+  from agentmail import AgentMail
+
+  app = Flask(__name__)
+  client = AgentMail()
+
+  inbox = client.inboxes.create(username="webhook-demo", client_id="webhook-demo-inbox")
+  wh = client.webhooks.create(url="https://YOUR_NGROK.ngrok-free.app/webhooks", events=["message.received"], client_id="webhook-demo-webhook")
+
+  @app.route("/webhooks", methods=["POST"])
+  def receive():
+    payload = request.json
+    print(payload.get("event_type"), payload.get("message", {}).get("subject"))
+    return Response(status=200)
+  ```
+
+  ```typescript title="TypeScript"
+  /**
+   * AgentMail Webhook Setup — copy into Cursor/Claude.
+   *
+   * Flow: 1) ngrok http 3000. 2) inboxes.create({ clientId }). 3) webhooks.create({ url, eventTypes, clientId })
+   * 4) Express POST /webhooks: res.status(200).send(), process req.body async.
+   * Use express.raw() if you add Svix verification later.
+   */
+  import express from "express";
+  import { AgentMailClient } from "agentmail";
+
+  const client = new AgentMailClient({ apiKey: process.env.AGENTMAIL_API_KEY! });
+  const inbox = await client.inboxes.create({ username: "webhook-demo", clientId: "webhook-demo-inbox" });
+  await client.webhooks.create({
+    url: "https://YOUR_NGROK.ngrok-free.app/webhooks",
+    eventTypes: ["message.received"],
+    clientId: "webhook-demo-webhook",
+  });
+
+  const app = express();
+  app.post("/webhooks", express.json(), (req, res) => {
+    console.log(req.body.event_type, req.body.message?.subject);
+    res.status(200).send();
+  });
+  app.listen(3000);
+  ```
+</CodeBlocks>
+
 ## Production Considerations
 
 For production deployments:
@@ -4406,6 +5551,65 @@ The easiest way to verify webhooks is using the official Svix library, which han
   Signature verification requires the exact request body. If you're using body-parsing middleware (like `express.json()`), make sure to capture the raw body before parsing, or use `express.raw()` for your webhook endpoint.
 </Callout>
 
+## Copy for Cursor / Claude
+
+Copy one of the blocks below into Cursor or Claude for webhook verification in one shot.
+
+<CodeBlocks>
+  ```python title="Python"
+  """
+  AgentMail Webhook Verification — copy into Cursor/Claude.
+
+  Use Svix: pip install svix. Get secret from webhooks.get(webhook_id).secret (starts whsec_).
+  Headers: svix-id, svix-timestamp, svix-signature. Use request.get_data() (raw body), not request.json.
+  """
+  from flask import Flask, request
+  from svix.webhooks import Webhook, WebhookVerificationError
+
+  app = Flask(__name__)
+  secret = "whsec_..."  # from client.webhooks.get(id).secret
+
+  @app.route("/webhooks", methods=["POST"])
+  def handler():
+    try:
+      wh = Webhook(secret)
+      msg = wh.verify(request.get_data(), request.headers)
+      if msg.get("event_type") == "message.received":
+        pass  # process
+      return "", 204
+    except WebhookVerificationError:
+      return "", 400
+  ```
+
+  ```typescript title="TypeScript"
+  /**
+   * AgentMail Webhook Verification — copy into Cursor/Claude.
+   *
+   * Use Svix: npm install svix. Secret from webhooks.get(id).secret.
+   * Use express.raw({ type: "application/json" }) — NOT express.json(). Verify before parsing.
+   */
+  import express from "express";
+  import { Webhook } from "svix";
+
+  const app = express();
+  const secret = process.env.AGENTMAIL_WEBHOOK_SECRET;
+  if (!secret) {
+    throw new Error("AGENTMAIL_WEBHOOK_SECRET environment variable is required");
+  }
+
+  app.post("/webhooks", express.raw({ type: "application/json" }), (req, res) => {
+    try {
+      const wh = new Webhook(secret);
+      const msg = wh.verify(req.body, req.headers as Record<string, string>);
+      if (msg.event_type === "message.received") { /* process */ }
+      res.status(204).send();
+    } catch {
+      res.status(400).send();
+    }
+  });
+  ```
+</CodeBlocks>
+
 ## Testing Locally with ngrok
 
 During development, you'll need a way for AgentMail to reach your local server. [ngrok](https://ngrok.com/) creates a public URL that tunnels to your local machine.
@@ -5012,6 +6216,57 @@ main();
 
 ***
 
+## Copy for Cursor / Claude
+
+Copy one of the blocks below into Cursor or Claude for WebSockets in one shot.
+
+<CodeBlocks>
+  ```python title="Python"
+  """
+  AgentMail WebSockets — copy into Cursor/Claude. Real-time events, no public URL needed.
+
+  Sync: with client.websockets.connect() as socket: socket.send_subscribe(Subscribe(inbox_ids=[...])); for event in socket: ...
+  Async: async with client.websockets.connect() as socket: await socket.send_subscribe(...); async for event in socket: ...
+  Subscribe(inbox_ids=[...], pod_ids=[...], event_types=[...])
+  Event types: Subscribed, MessageReceivedEvent, MessageSentEvent, MessageDeliveredEvent, MessageBouncedEvent, MessageComplainedEvent, MessageRejectedEvent, DomainVerifiedEvent
+  """
+  from agentmail import AgentMail, Subscribe, Subscribed, MessageReceivedEvent
+
+  client = AgentMail(api_key="YOUR_API_KEY")
+  with client.websockets.connect() as socket:
+    socket.send_subscribe(Subscribe(inbox_ids=["agent@agentmail.to"]))
+    for event in socket:
+      if isinstance(event, Subscribed): print(event.inbox_ids)
+      elif isinstance(event, MessageReceivedEvent): print(event.message.subject)
+  ```
+
+  ```typescript title="TypeScript"
+  /**
+   * AgentMail WebSockets — copy into Cursor/Claude. Real-time events, no public URL.
+   *
+   * const socket = await client.websockets.connect();
+   * socket.on("open", () => socket.sendSubscribe({ type: "subscribe", inboxIds: [...] }));
+   * socket.on("message", (e) => { if (e.type === "subscribed") ...; if (e.type === "message_received") ... });
+   * socket.on("close" | "error", ...);
+   */
+  import { AgentMailClient } from "agentmail";
+
+  const client = new AgentMailClient({ apiKey: process.env.AGENTMAIL_API_KEY });
+
+  async function main() {
+    const socket = await client.websockets.connect();
+    socket.on("open", () => socket.sendSubscribe({ type: "subscribe", inboxIds: ["agent@agentmail.to"] }));
+    socket.on("message", (e) => {
+      if (e.type === "subscribed") console.log(e.inboxIds);
+      if (e.type === "message_received") console.log(e.message.subject);
+    });
+  }
+  main().catch(console.error);
+  ```
+</CodeBlocks>
+
+***
+
 
 ***
 
@@ -5020,6 +6275,46 @@ subtitle: Get started with real-time email event streaming
 slug: websockets/quickstart
 ---------------------------
 
+## Copy for Cursor / Claude
+
+Copy one of the blocks below into Cursor or Claude for instant WebSocket setup.
+
+<CodeBlocks>
+  ```python title="Python"
+  """
+  AgentMail WebSockets Quickstart — copy into Cursor/Claude.
+  client.websockets.connect() → socket.send_subscribe(Subscribe(inbox_ids=[...])) → iterate socket for events.
+  """
+  from agentmail import AgentMail, Subscribe, Subscribed, MessageReceivedEvent
+
+  client = AgentMail()
+  with client.websockets.connect() as socket:
+    socket.send_subscribe(Subscribe(inbox_ids=["my-agent@agentmail.to"]))
+    for event in socket:
+      if isinstance(event, Subscribed): print(f"Subscribed to {event.inbox_ids}")
+      elif isinstance(event, MessageReceivedEvent): print(f"Received from: {event.message.from_}")
+  ```
+
+  ```typescript title="TypeScript"
+  /**
+   * AgentMail WebSockets Quickstart — copy into Cursor/Claude.
+   * client.websockets.connect() → sendSubscribe({ type: "subscribe", inboxIds }) → on("message", ...)
+   */
+  import { AgentMailClient } from "agentmail";
+
+  const client = new AgentMailClient();
+  const socket = await client.websockets.connect();
+  socket.on("message", async (e) => {
+    if (e.type === "subscribed") console.log("Subscribed to", e.inboxIds);
+    else if (e.type === "event" && e.eventType === "message.received") console.log("Received from:", e.message?.from);
+  });
+  await socket.waitForOpen();
+  socket.sendSubscribe({ type: "subscribe", inboxIds: ["my-agent@agentmail.to"] });
+  ```
+</CodeBlocks>
+
+## SDK Examples
+
 ```typescript title="TypeScript"
 import { AgentMailClient } from "agentmail";
 
@@ -9006,6 +10301,11 @@ paths:
           required: false
           schema:
             $ref: '#/components/schemas/type_:PageToken'
+        - name: ascending
+          in: query
+          required: false
+          schema:
+            $ref: '#/components/schemas/type_:Ascending'
         - name: Authorization
           in: header
           description: Bearer authentication
@@ -9034,6 +10334,10 @@ components:
       type: string
       description: Page token for pagination.
       title: PageToken
+    type_:Ascending:
+      type: boolean
+      description: Sort in ascending temporal order.
+      title: Ascending
     type_:Count:
       type: integer
       description: Number of items returned.
@@ -9044,7 +10348,7 @@ components:
       title: PodId
     type_inboxes:InboxId:
       type: string
-      description: ID of inbox.
+      description: The ID of the inbox.
       title: InboxId
     type_inboxes:DisplayName:
       type: string
@@ -9285,7 +10589,7 @@ components:
   schemas:
     type_inboxes:InboxId:
       type: string
-      description: ID of inbox.
+      description: The ID of the inbox.
       title: InboxId
     type_pods:PodId:
       type: string
@@ -9562,7 +10866,7 @@ components:
       title: PodId
     type_inboxes:InboxId:
       type: string
-      description: ID of inbox.
+      description: The ID of the inbox.
       title: InboxId
     type_inboxes:Inbox:
       type: object
@@ -9806,7 +11110,7 @@ components:
   schemas:
     type_inboxes:InboxId:
       type: string
-      description: ID of inbox.
+      description: The ID of the inbox.
       title: InboxId
     type_inboxes:DisplayName:
       type: string
@@ -10082,7 +11386,7 @@ components:
   schemas:
     type_inboxes:InboxId:
       type: string
-      description: ID of inbox.
+      description: The ID of the inbox.
       title: InboxId
     type_:ErrorName:
       type: string
@@ -10305,6 +11609,11 @@ paths:
           required: false
           schema:
             $ref: '#/components/schemas/type_:IncludeBlocked'
+        - name: include_trash
+          in: query
+          required: false
+          schema:
+            $ref: '#/components/schemas/type_:IncludeTrash'
         - name: Authorization
           in: header
           description: Bearer authentication
@@ -10333,7 +11642,7 @@ components:
   schemas:
     type_inboxes:InboxId:
       type: string
-      description: ID of inbox.
+      description: The ID of the inbox.
       title: InboxId
     type_:Limit:
       type: integer
@@ -10371,6 +11680,10 @@ components:
       type: boolean
       description: Include blocked in results.
       title: IncludeBlocked
+    type_:IncludeTrash:
+      type: boolean
+      description: Include trash in results.
+      title: IncludeTrash
     type_:Count:
       type: integer
       description: Number of items returned.
@@ -10778,7 +12091,7 @@ components:
   schemas:
     type_inboxes:InboxId:
       type: string
-      description: ID of inbox.
+      description: The ID of the inbox.
       title: InboxId
     type_threads:ThreadId:
       type: string
@@ -11342,7 +12655,7 @@ components:
   schemas:
     type_inboxes:InboxId:
       type: string
-      description: ID of inbox.
+      description: The ID of the inbox.
       title: InboxId
     type_threads:ThreadId:
       type: string
@@ -11615,7 +12928,7 @@ components:
   schemas:
     type_inboxes:InboxId:
       type: string
-      description: ID of inbox.
+      description: The ID of the inbox.
       title: InboxId
     type_threads:ThreadId:
       type: string
@@ -11843,6 +13156,11 @@ paths:
           required: false
           schema:
             $ref: '#/components/schemas/type_:IncludeBlocked'
+        - name: include_trash
+          in: query
+          required: false
+          schema:
+            $ref: '#/components/schemas/type_:IncludeTrash'
         - name: Authorization
           in: header
           description: Bearer authentication
@@ -11871,7 +13189,7 @@ components:
   schemas:
     type_inboxes:InboxId:
       type: string
-      description: ID of inbox.
+      description: The ID of the inbox.
       title: InboxId
     type_:Limit:
       type: integer
@@ -11909,6 +13227,10 @@ components:
       type: boolean
       description: Include blocked in results.
       title: IncludeBlocked
+    type_:IncludeTrash:
+      type: boolean
+      description: Include trash in results.
+      title: IncludeTrash
     type_:Count:
       type: integer
       description: Number of items returned.
@@ -12335,7 +13657,7 @@ components:
   schemas:
     type_inboxes:InboxId:
       type: string
-      description: ID of inbox.
+      description: The ID of the inbox.
       title: InboxId
     type_messages:MessageId:
       type: string
@@ -12772,7 +14094,7 @@ components:
   schemas:
     type_inboxes:InboxId:
       type: string
-      description: ID of inbox.
+      description: The ID of the inbox.
       title: InboxId
     type_messages:MessageId:
       type: string
@@ -13050,7 +14372,7 @@ components:
   schemas:
     type_inboxes:InboxId:
       type: string
-      description: ID of inbox.
+      description: The ID of the inbox.
       title: InboxId
     type_messages:MessageId:
       type: string
@@ -13284,7 +14606,7 @@ components:
   schemas:
     type_inboxes:InboxId:
       type: string
-      description: ID of inbox.
+      description: The ID of the inbox.
       title: InboxId
     type_messages:MessageLabels:
       type: array
@@ -13681,7 +15003,7 @@ components:
   schemas:
     type_inboxes:InboxId:
       type: string
-      description: ID of inbox.
+      description: The ID of the inbox.
       title: InboxId
     type_messages:MessageId:
       type: string
@@ -14079,7 +15401,7 @@ components:
   schemas:
     type_inboxes:InboxId:
       type: string
-      description: ID of inbox.
+      description: The ID of the inbox.
       title: InboxId
     type_messages:MessageId:
       type: string
@@ -14453,7 +15775,7 @@ components:
   schemas:
     type_inboxes:InboxId:
       type: string
-      description: ID of inbox.
+      description: The ID of the inbox.
       title: InboxId
     type_messages:MessageId:
       type: string
@@ -14845,7 +16167,7 @@ components:
   schemas:
     type_inboxes:InboxId:
       type: string
-      description: ID of inbox.
+      description: The ID of the inbox.
       title: InboxId
     type_messages:MessageId:
       type: string
@@ -15346,7 +16668,7 @@ components:
   schemas:
     type_inboxes:InboxId:
       type: string
-      description: ID of inbox.
+      description: The ID of the inbox.
       title: InboxId
     type_:Limit:
       type: integer
@@ -15764,7 +17086,7 @@ components:
   schemas:
     type_inboxes:InboxId:
       type: string
-      description: ID of inbox.
+      description: The ID of the inbox.
       title: InboxId
     type_drafts:DraftId:
       type: string
@@ -16182,7 +17504,7 @@ components:
   schemas:
     type_inboxes:InboxId:
       type: string
-      description: ID of inbox.
+      description: The ID of the inbox.
       title: InboxId
     type_drafts:DraftId:
       type: string
@@ -16460,7 +17782,7 @@ components:
   schemas:
     type_inboxes:InboxId:
       type: string
-      description: ID of inbox.
+      description: The ID of the inbox.
       title: InboxId
     type_drafts:DraftLabels:
       type: array
@@ -16946,7 +18268,7 @@ components:
   schemas:
     type_inboxes:InboxId:
       type: string
-      description: ID of inbox.
+      description: The ID of the inbox.
       title: InboxId
     type_drafts:DraftId:
       type: string
@@ -17416,7 +18738,7 @@ components:
   schemas:
     type_inboxes:InboxId:
       type: string
-      description: ID of inbox.
+      description: The ID of the inbox.
       title: InboxId
     type_drafts:DraftId:
       type: string
@@ -17696,7 +19018,7 @@ components:
   schemas:
     type_inboxes:InboxId:
       type: string
-      description: ID of inbox.
+      description: The ID of the inbox.
       title: InboxId
     type_drafts:DraftId:
       type: string
@@ -17933,7 +19255,7 @@ components:
   schemas:
     type_inboxes:InboxId:
       type: string
-      description: ID of inbox.
+      description: The ID of the inbox.
       title: InboxId
     type_metrics:MetricEventType:
       type: string
@@ -18315,7 +19637,7 @@ components:
       title: Count
     type_inboxes:InboxId:
       type: string
-      description: ID of inbox.
+      description: The ID of the inbox.
       title: InboxId
     type_threads:ThreadId:
       type: string
@@ -18717,7 +20039,7 @@ components:
       title: ThreadId
     type_inboxes:InboxId:
       type: string
-      description: ID of inbox.
+      description: The ID of the inbox.
       title: InboxId
     type_threads:ThreadLabels:
       type: array
@@ -19595,7 +20917,7 @@ components:
       title: Count
     type_inboxes:InboxId:
       type: string
-      description: ID of inbox.
+      description: The ID of the inbox.
       title: InboxId
     type_threads:ThreadId:
       type: string
@@ -19978,7 +21300,7 @@ components:
       title: DraftId
     type_inboxes:InboxId:
       type: string
-      description: ID of inbox.
+      description: The ID of the inbox.
       title: InboxId
     type_threads:ThreadId:
       type: string
@@ -20630,6 +21952,11 @@ paths:
           required: false
           schema:
             $ref: '#/components/schemas/type_:PageToken'
+        - name: ascending
+          in: query
+          required: false
+          schema:
+            $ref: '#/components/schemas/type_:Ascending'
         - name: Authorization
           in: header
           description: Bearer authentication
@@ -20658,6 +21985,10 @@ components:
       type: string
       description: Page token for pagination.
       title: PageToken
+    type_:Ascending:
+      type: boolean
+      description: Sort in ascending temporal order.
+      title: Ascending
     type_:Count:
       type: integer
       description: Number of items returned.
@@ -23256,6 +24587,11 @@ paths:
           required: false
           schema:
             $ref: '#/components/schemas/type_:PageToken'
+        - name: ascending
+          in: query
+          required: false
+          schema:
+            $ref: '#/components/schemas/type_:Ascending'
         - name: Authorization
           in: header
           description: Bearer authentication
@@ -23284,6 +24620,10 @@ components:
       type: string
       description: Page token for pagination.
       title: PageToken
+    type_:Ascending:
+      type: boolean
+      description: Sort in ascending temporal order.
+      title: Ascending
     type_:Count:
       type: integer
       description: Number of items returned.
@@ -24754,7 +26094,7 @@ components:
       title: EventId
     type_inboxes:InboxId:
       type: string
-      description: ID of inbox.
+      description: The ID of the inbox.
       title: InboxId
     type_threads:ThreadId:
       type: string
@@ -25183,7 +26523,7 @@ components:
       title: EventId
     type_inboxes:InboxId:
       type: string
-      description: ID of inbox.
+      description: The ID of the inbox.
       title: InboxId
     type_threads:ThreadId:
       type: string
@@ -25309,7 +26649,7 @@ components:
       title: EventId
     type_inboxes:InboxId:
       type: string
-      description: ID of inbox.
+      description: The ID of the inbox.
       title: InboxId
     type_threads:ThreadId:
       type: string
@@ -25435,7 +26775,7 @@ components:
       title: EventId
     type_inboxes:InboxId:
       type: string
-      description: ID of inbox.
+      description: The ID of the inbox.
       title: InboxId
     type_threads:ThreadId:
       type: string
@@ -25582,7 +26922,7 @@ components:
       title: EventId
     type_inboxes:InboxId:
       type: string
-      description: ID of inbox.
+      description: The ID of the inbox.
       title: InboxId
     type_threads:ThreadId:
       type: string
@@ -25716,7 +27056,7 @@ components:
       title: EventId
     type_inboxes:InboxId:
       type: string
-      description: ID of inbox.
+      description: The ID of the inbox.
       title: InboxId
     type_threads:ThreadId:
       type: string
@@ -26117,7 +27457,7 @@ components:
       title: EventId
     type_inboxes:InboxId:
       type: string
-      description: ID of inbox.
+      description: The ID of the inbox.
       title: InboxId
     type_threads:ThreadId:
       type: string
@@ -27226,6 +28566,11 @@ paths:
           required: false
           schema:
             $ref: '#/components/schemas/type_:PageToken'
+        - name: ascending
+          in: query
+          required: false
+          schema:
+            $ref: '#/components/schemas/type_:Ascending'
         - name: Authorization
           in: header
           description: Bearer authentication
@@ -27254,6 +28599,10 @@ components:
       type: string
       description: Page token for pagination.
       title: PageToken
+    type_:Ascending:
+      type: boolean
+      description: Sort in ascending temporal order.
+      title: Ascending
     type_:Count:
       type: integer
       description: Number of items returned.
@@ -27957,6 +29306,11 @@ paths:
           required: false
           schema:
             $ref: '#/components/schemas/type_:PageToken'
+        - name: ascending
+          in: query
+          required: false
+          schema:
+            $ref: '#/components/schemas/type_:Ascending'
         - name: Authorization
           in: header
           description: Bearer authentication
@@ -27985,6 +29339,10 @@ components:
       type: string
       description: Page token for pagination.
       title: PageToken
+    type_:Ascending:
+      type: boolean
+      description: Sort in ascending temporal order.
+      title: Ascending
     type_:Count:
       type: integer
       description: Number of items returned.
@@ -28925,6 +30283,11 @@ paths:
           required: false
           schema:
             $ref: '#/components/schemas/type_:PageToken'
+        - name: ascending
+          in: query
+          required: false
+          schema:
+            $ref: '#/components/schemas/type_:Ascending'
         - name: Authorization
           in: header
           description: Bearer authentication
@@ -28963,13 +30326,17 @@ components:
       type: string
       description: Page token for pagination.
       title: PageToken
+    type_:Ascending:
+      type: boolean
+      description: Sort in ascending temporal order.
+      title: Ascending
     type_:Count:
       type: integer
       description: Number of items returned.
       title: Count
     type_inboxes:InboxId:
       type: string
-      description: ID of inbox.
+      description: The ID of the inbox.
       title: InboxId
     type_inboxes:DisplayName:
       type: string
@@ -29240,7 +30607,7 @@ components:
       title: PodId
     type_inboxes:InboxId:
       type: string
-      description: ID of inbox.
+      description: The ID of the inbox.
       title: InboxId
     type_inboxes:DisplayName:
       type: string
@@ -29519,7 +30886,7 @@ components:
       title: CreateInboxRequest
     type_inboxes:InboxId:
       type: string
-      description: ID of inbox.
+      description: The ID of the inbox.
       title: InboxId
     type_inboxes:Inbox:
       type: object
@@ -29775,7 +31142,7 @@ components:
       title: PodId
     type_inboxes:InboxId:
       type: string
-      description: ID of inbox.
+      description: The ID of the inbox.
       title: InboxId
     type_:ErrorName:
       type: string
@@ -29999,6 +31366,11 @@ paths:
           required: false
           schema:
             $ref: '#/components/schemas/type_:IncludeBlocked'
+        - name: include_trash
+          in: query
+          required: false
+          schema:
+            $ref: '#/components/schemas/type_:IncludeTrash'
         - name: Authorization
           in: header
           description: Bearer authentication
@@ -30065,13 +31437,17 @@ components:
       type: boolean
       description: Include blocked in results.
       title: IncludeBlocked
+    type_:IncludeTrash:
+      type: boolean
+      description: Include trash in results.
+      title: IncludeTrash
     type_:Count:
       type: integer
       description: Number of items returned.
       title: Count
     type_inboxes:InboxId:
       type: string
-      description: ID of inbox.
+      description: The ID of the inbox.
       title: InboxId
     type_threads:ThreadId:
       type: string
@@ -30484,7 +31860,7 @@ components:
       title: ThreadId
     type_inboxes:InboxId:
       type: string
-      description: ID of inbox.
+      description: The ID of the inbox.
       title: InboxId
     type_threads:ThreadLabels:
       type: array
@@ -31382,7 +32758,7 @@ components:
       title: Count
     type_inboxes:InboxId:
       type: string
-      description: ID of inbox.
+      description: The ID of the inbox.
       title: InboxId
     type_threads:ThreadId:
       type: string
@@ -31776,7 +33152,7 @@ components:
       title: DraftId
     type_inboxes:InboxId:
       type: string
-      description: ID of inbox.
+      description: The ID of the inbox.
       title: InboxId
     type_threads:ThreadId:
       type: string
@@ -32444,6 +33820,11 @@ paths:
           required: false
           schema:
             $ref: '#/components/schemas/type_:PageToken'
+        - name: ascending
+          in: query
+          required: false
+          schema:
+            $ref: '#/components/schemas/type_:Ascending'
         - name: Authorization
           in: header
           description: Bearer authentication
@@ -32482,6 +33863,10 @@ components:
       type: string
       description: Page token for pagination.
       title: PageToken
+    type_:Ascending:
+      type: boolean
+      description: Sort in ascending temporal order.
+      title: Ascending
     type_:Count:
       type: integer
       description: Number of items returned.
@@ -33049,6 +34434,318 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+# Get Domain
+
+GET https://api.agentmail.to/v0/pods/{pod_id}/domains/{domain_id}
+
+Reference: https://docs.agentmail.to/api-reference/pods/domains/get
+
+## OpenAPI Specification
+
+```yaml
+openapi: 3.1.0
+info:
+  title: api
+  version: 1.0.0
+paths:
+  /v0/pods/{pod_id}/domains/{domain_id}:
+    get:
+      operationId: get
+      summary: Get Domain
+      tags:
+        - subpackage_pods.subpackage_pods/domains
+      parameters:
+        - name: pod_id
+          in: path
+          required: true
+          schema:
+            $ref: '#/components/schemas/type_pods:PodId'
+        - name: domain_id
+          in: path
+          required: true
+          schema:
+            $ref: '#/components/schemas/type_domains:DomainId'
+        - name: Authorization
+          in: header
+          description: Bearer authentication
+          required: true
+          schema:
+            type: string
+      responses:
+        '200':
+          description: Response with status 200
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/type_domains:Domain'
+        '404':
+          description: Error response with status 404
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/type_:ErrorResponse'
+servers:
+  - url: https://api.agentmail.to
+  - url: https://x402.api.agentmail.to
+  - url: https://mpp.api.agentmail.to
+  - url: https://api.agentmail.eu
+components:
+  schemas:
+    type_pods:PodId:
+      type: string
+      description: ID of pod.
+      title: PodId
+    type_domains:DomainId:
+      type: string
+      description: The name of the domain. (e.g., " your-domain.com")
+      title: DomainId
+    type_domains:VerificationStatus:
+      type: string
+      enum:
+        - NOT_STARTED
+        - PENDING
+        - INVALID
+        - FAILED
+        - VERIFYING
+        - VERIFIED
+      title: VerificationStatus
+    type_domains:FeedbackEnabled:
+      type: boolean
+      description: Bounce and complaint notifications are sent to your inboxes.
+      title: FeedbackEnabled
+    type_domains:RecordType:
+      type: string
+      enum:
+        - TXT
+        - CNAME
+        - MX
+      title: RecordType
+    type_domains:RecordStatus:
+      type: string
+      enum:
+        - MISSING
+        - INVALID
+        - VALID
+      title: RecordStatus
+    type_domains:VerificationRecord:
+      type: object
+      properties:
+        type:
+          $ref: '#/components/schemas/type_domains:RecordType'
+          description: The type of the DNS record.
+        name:
+          type: string
+          description: The name or host of the record.
+        value:
+          type: string
+          description: The value of the record.
+        status:
+          $ref: '#/components/schemas/type_domains:RecordStatus'
+          description: The verification status of this specific record.
+        priority:
+          type: integer
+          description: The priority of the MX record.
+      required:
+        - type
+        - name
+        - value
+        - status
+      title: VerificationRecord
+    type_domains:ClientId:
+      type: string
+      description: Client ID of domain.
+      title: ClientId
+    type_domains:Domain:
+      type: object
+      properties:
+        pod_id:
+          $ref: '#/components/schemas/type_pods:PodId'
+        domain_id:
+          $ref: '#/components/schemas/type_domains:DomainId'
+        status:
+          $ref: '#/components/schemas/type_domains:VerificationStatus'
+          description: The verification status of the domain.
+        feedback_enabled:
+          $ref: '#/components/schemas/type_domains:FeedbackEnabled'
+        records:
+          type: array
+          items:
+            $ref: '#/components/schemas/type_domains:VerificationRecord'
+          description: A list of DNS records required to verify the domain.
+        client_id:
+          $ref: '#/components/schemas/type_domains:ClientId'
+        updated_at:
+          type: string
+          format: date-time
+          description: Time at which the domain was last updated.
+        created_at:
+          type: string
+          format: date-time
+          description: Time at which the domain was created.
+      required:
+        - domain_id
+        - status
+        - feedback_enabled
+        - records
+        - updated_at
+        - created_at
+      title: Domain
+    type_:ErrorName:
+      type: string
+      description: Name of error.
+      title: ErrorName
+    type_:ErrorMessage:
+      type: string
+      description: Error message.
+      title: ErrorMessage
+    type_:ErrorResponse:
+      type: object
+      properties:
+        name:
+          $ref: '#/components/schemas/type_:ErrorName'
+        message:
+          $ref: '#/components/schemas/type_:ErrorMessage'
+      required:
+        - name
+        - message
+      title: ErrorResponse
+  securitySchemes:
+    Bearer:
+      type: http
+      scheme: bearer
+
+```
+
+## SDK Code Examples
+
+```typescript
+import { AgentMailClient } from "agentmail";
+
+async function main() {
+    const client = new AgentMailClient({
+        apiKey: "YOUR_TOKEN_HERE",
+    });
+    await client.pods.domains.get("pod_id", "domain_id");
+}
+main();
+
+```
+
+```python
+from agentmail import AgentMail
+
+client = AgentMail(
+    api_key="YOUR_TOKEN_HERE"
+)
+
+client.pods.domains.get(
+    pod_id="pod_id",
+    domain_id="domain_id"
+)
+
+```
+
+```go
+package main
+
+import (
+	"fmt"
+	"net/http"
+	"io"
+)
+
+func main() {
+
+	url := "https://api.agentmail.to/v0/pods/pod_id/domains/domain_id"
+
+	req, _ := http.NewRequest("GET", url, nil)
+
+	req.Header.Add("Authorization", "Bearer <api_key>")
+
+	res, _ := http.DefaultClient.Do(req)
+
+	defer res.Body.Close()
+	body, _ := io.ReadAll(res.Body)
+
+	fmt.Println(res)
+	fmt.Println(string(body))
+
+}
+```
+
+```ruby
+require 'uri'
+require 'net/http'
+
+url = URI("https://api.agentmail.to/v0/pods/pod_id/domains/domain_id")
+
+http = Net::HTTP.new(url.host, url.port)
+http.use_ssl = true
+
+request = Net::HTTP::Get.new(url)
+request["Authorization"] = 'Bearer <api_key>'
+
+response = http.request(request)
+puts response.read_body
+```
+
+```java
+import com.mashape.unirest.http.HttpResponse;
+import com.mashape.unirest.http.Unirest;
+
+HttpResponse<String> response = Unirest.get("https://api.agentmail.to/v0/pods/pod_id/domains/domain_id")
+  .header("Authorization", "Bearer <api_key>")
+  .asString();
+```
+
+```php
+<?php
+require_once('vendor/autoload.php');
+
+$client = new \GuzzleHttp\Client();
+
+$response = $client->request('GET', 'https://api.agentmail.to/v0/pods/pod_id/domains/domain_id', [
+  'headers' => [
+    'Authorization' => 'Bearer <api_key>',
+  ],
+]);
+
+echo $response->getBody();
+```
+
+```csharp
+using RestSharp;
+
+var client = new RestClient("https://api.agentmail.to/v0/pods/pod_id/domains/domain_id");
+var request = new RestRequest(Method.GET);
+request.AddHeader("Authorization", "Bearer <api_key>");
+IRestResponse response = client.Execute(request);
+```
+
+```swift
+import Foundation
+
+let headers = ["Authorization": "Bearer <api_key>"]
+
+let request = NSMutableURLRequest(url: NSURL(string: "https://api.agentmail.to/v0/pods/pod_id/domains/domain_id")! as URL,
+                                        cachePolicy: .useProtocolCachePolicy,
+                                    timeoutInterval: 10.0)
+request.httpMethod = "GET"
+request.allHTTPHeaderFields = headers
+
+let session = URLSession.shared
+let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
+  if (error != nil) {
+    print(error as Any)
+  } else {
+    let httpResponse = response as? HTTPURLResponse
+    print(httpResponse)
+  }
+})
+
+dataTask.resume()
+```
+
 # Delete Domain
 
 DELETE https://api.agentmail.to/v0/pods/{pod_id}/domains/{domain_id}