agentmail 0.4.17 → 0.4.19

package/dist/llms-full.txt

@@ -3,7 +3,9 @@
 title: Welcome
 slug: welcome
 description: Your starting point for building with the AgentMail API.
----------------------------------------------------------------------
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 <Tip title="Welcome to AgentMail!" icon="fa-solid fa-star">
   We're thrilled to have you here! Dive in to learn how to give your AI agents their own email inboxes.
@@ -43,13 +45,14 @@ AgentMail is an API platform for giving AI agents their own inboxes to send, rec
   </Card>
 </CardGroup>
 
-
 ***
 
 title: Introduction
 subtitle: Give AI agents email inboxes
 slug: introduction
-------------------
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 ## What is AgentMail?
 
@@ -147,7 +150,13 @@ Our customers use AgentMail for agent identity, authentication, and communicatio
 ## Get Started
 
 <CardGroup>
-  <Card title="Quickstart" icon="fa-solid fa-book" href="/quickstart" />
+  <Card title="Quickstart" icon="fa-solid fa-book" href="/quickstart">
+    Create your first inbox and send an email in minutes.
+  </Card>
+
+  <Card title="Receive emails" icon="fa-solid fa-bell" href="/webhooks-overview">
+    Set up webhooks or WebSockets to receive incoming messages in real time.
+  </Card>
 
   <Card title="API Reference" icon="fa-solid fa-code" href="/api-reference" />
 </CardGroup>
@@ -160,16 +169,15 @@ Our customers use AgentMail for agent identity, authentication, and communicatio
   <Card title="Email" icon="fa-solid fa-envelope" href="mailto:support@agentmail.cc" />
 </CardGroup>
 
-
 ***
 
 title: Quickstart
 subtitle: Create your first inbox with the AgentMail API
 slug: quickstart
-description: >-
-Follow this guide to make your first AgentMail API request and create a new
-email inbox.
-------------
+description: Follow this guide to make your first AgentMail API request and create a new email inbox.
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 ## Quickest start
 
@@ -187,13 +195,39 @@ email inbox.
   ```
 </CodeBlocks>
 
-Get your API key from the [Console](https://console.agentmail.to) and replace `am_...` in the code below.
+Sign up your agent and get an API key in one call (no console needed):
 
 <CodeBlocks>
   ```python title="Python"
   from agentmail import AgentMail
 
+  client = AgentMail()
+  response = client.agent.sign_up(human_email="you@example.com", username="my-agent")
+  # response.api_key  -> store this securely
+  # response.inbox_id -> my-agent@agentmail.to
+  ```
+
+  ```typescript title="TypeScript"
+  import { AgentMailClient } from "agentmail";
+
+  const client = new AgentMailClient();
+  const response = await client.agent.signUp({ humanEmail: "you@example.com", username: "my-agent" });
+  // response.apiKey  -> store this securely
+  // response.inboxId -> my-agent@agentmail.to
+  ```
+
+  ```bash title="CLI"
+  agentmail agent sign-up --human-email you@example.com --username my-agent
+  ```
+</CodeBlocks>
+
+Verify with the OTP sent to your email, then send a message:
+
+<CodeBlocks>
+  ```python title="Python"
   client = AgentMail(api_key="am_...")
+  client.agent.verify(otp_code="123456")
+
   inbox = client.inboxes.create()
   client.inboxes.messages.send(inbox.inbox_id, to="user@example.com", subject="Hello", text="Hello from my agent!")
   ```
@@ -201,14 +235,16 @@ Get your API key from the [Console](https://console.agentmail.to) and replace `a
   ```typescript title="TypeScript"
   import { AgentMailClient } from "agentmail";
 
-  (async () => {
-    const client = new AgentMailClient({ apiKey: "am_..." });
-    const inbox = await client.inboxes.create();
-    await client.inboxes.messages.send(inbox.inboxId, { to: "user@example.com", subject: "Hello", text: "Hello from my agent!" });
-  })();
+  const client = new AgentMailClient({ apiKey: "am_..." });
+  await client.agent.verify({ otpCode: "123456" });
+
+  const inbox = await client.inboxes.create();
+  await client.inboxes.messages.send(inbox.inboxId, { to: "user@example.com", subject: "Hello", text: "Hello from my agent!" });
   ```
 
   ```bash title="CLI"
+  agentmail agent verify --otp-code 123456
+
   # create an inbox
   agentmail inboxes create
 
@@ -221,6 +257,10 @@ Get your API key from the [Console](https://console.agentmail.to) and replace `a
   ```
 </CodeBlocks>
 
+<Note>
+  Already have an account? Get your API key from the [Console](https://console.agentmail.to) and skip straight to sending emails.
+</Note>
+
 ## 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.
@@ -232,6 +272,10 @@ Copy one of the blocks below into Cursor or Claude for a complete, working Agent
 
   Setup: pip install agentmail python-dotenv. Set AGENTMAIL_API_KEY in .env.
 
+  Agent sign-up (no API key needed):
+  - agent.sign_up(human_email, username) — returns api_key, inbox_id, organization_id
+  - agent.verify(otp_code) — verify with OTP sent to human_email
+
   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?)
@@ -276,6 +320,10 @@ Copy one of the blocks below into Cursor or Claude for a complete, working Agent
    *
    * Setup: npm install agentmail dotenv. Set AGENTMAIL_API_KEY in .env.
    *
+   * Agent sign-up (no API key needed):
+   * - agent.signUp({ humanEmail, username }) — returns apiKey, inboxId, organizationId
+   * - agent.verify({ otpCode }) — verify with OTP sent to humanEmail
+   *
    * API reference:
    * - inboxes.create({ username?, domain?, displayName?, clientId? }) — clientId for idempotent retries
    * - messages.send(inboxId, { to, subject, text, html?, cc?, bcc?, replyTo?, attachments? })
@@ -327,25 +375,84 @@ Copy one of the blocks below into Cursor or Claude for a complete, working Agent
   for reply content without quoted history.
 </Tip>
 
-This guide will walk you through installing the AgentMail SDK, authenticating with your API key, and creating your first email inbox.
+This guide walks you through signing up, authenticating, and creating your first email inbox.
 
 <Steps>
-  <Step title="Access the AgentMail Console">
-    First, you'll need to access the AgentMail Console to manage your account and API keys. Click the link below to get started.
+  <Step title="Sign up and get an API key">
+    You have two options to get an API key:
+
+    **Option A: Agent sign-up (programmatic)**
+
+    Use the Agent API to create an account and get an API key without leaving your terminal. No console access needed.
+
+    <CodeBlocks>
+      ```python title="Python"
+      from agentmail import AgentMail
+
+      client = AgentMail()
+      response = client.agent.sign_up(
+          human_email="you@example.com",
+          username="my-agent"
+      )
+      print(response.api_key)   # store this securely
+      print(response.inbox_id)  # my-agent@agentmail.to
+      ```
+
+      ```typescript title="TypeScript"
+      import { AgentMailClient } from "agentmail";
+
+      const client = new AgentMailClient();
+      const response = await client.agent.signUp({
+          humanEmail: "you@example.com",
+          username: "my-agent",
+      });
+      console.log(response.apiKey);   // store this securely
+      console.log(response.inboxId);  // my-agent@agentmail.to
+      ```
+
+      ```bash title="CLI"
+      agentmail agent sign-up \
+        --human-email you@example.com \
+        --username my-agent
+      ```
+    </CodeBlocks>
 
-    <Card title="Open AgentMail Console" icon="fa-solid fa-desktop" href="https://console.agentmail.to" target="_blank" />
+    A 6-digit OTP is sent to the provided email. Verify to unlock full permissions:
 
-    If you don't have an account yet, you can sign up directly from the console. Once you're logged in, you'll be able to manage your inboxes, view analytics, and create API keys.
+    <CodeBlocks>
+      ```python title="Python"
+      client = AgentMail(api_key=response.api_key)
+      client.agent.verify(otp_code="123456")
+      ```
+
+      ```typescript title="TypeScript"
+      const authedClient = new AgentMailClient({ apiKey: response.apiKey });
+      await authedClient.agent.verify({ otpCode: "123456" });
+      ```
+
+      ```bash title="CLI"
+      agentmail agent verify --otp-code 123456
+      ```
+    </CodeBlocks>
+
+    <Info>
+      The sign-up endpoint is idempotent. Calling it again with the same email rotates the API key and resends the OTP if expired.
+    </Info>
+
+    **Option B: Console (manual)**
+
+    Go to the [AgentMail Console](https://console.agentmail.to), create an account, and generate an API key from the dashboard.
+    ![API Key Creation Screenshot](https://files.buildwithfern.com/https://agentmail-production.docs.buildwithfern.com/4e665f546efdf08d30178fcfbd996298ed7b3d1d44709fc742ed5315fed9532e/assets/api-key-creation.png)
   </Step>
 
-  <Step title="Create an API Key">
-    Now that you're in the console, you'll need to create an API key to
-    authenticate your requests. Navigate to the API Keys section in your console
-    dashboard. ![API Key Creation Screenshot](https://files.buildwithfern.com/https://agentmail-production.docs.buildwithfern.com/4e665f546efdf08d30178fcfbd996298ed7b3d1d44709fc742ed5315fed9532e/assets/api-key-creation.png) Click
-    "Create New API Key" and give it a descriptive name. Once created, copy the
-    API key and store it securely. Create a `.env` file in your project's root
-    directory and add your key to it. We recommend using environment variables to
-    keep your keys secure.
+  <Step title="Store your API key">
+    Create a `.env` file in your project root and add your key:
+
+    ```bash
+    AGENTMAIL_API_KEY=am_...
+    ```
+
+    We recommend using environment variables to keep your keys secure.
   </Step>
 
   <Step title="Install the SDK">
@@ -475,23 +582,40 @@ This guide will walk you through installing the AgentMail SDK, authenticating wi
 
 ## Next Steps
 
-Congrats, you sent your first email via AgentMail. But this isn't our strength. Explore the full power of creating agents that can autonomously reply, take action, parse attachments, semantically search your inbox, by exploring our docs and tutorials below.
+You've created an inbox and sent your first email. Now set up your agent to receive and respond to incoming messages:
+
+<CardGroup>
+  <Card title="Receive emails with WebSockets" icon="fa-solid fa-plug" href="/websockets">
+    The fastest way to receive emails. No public URL or ngrok needed.
+  </Card>
+
+  <Card title="Receive emails with webhooks" icon="fa-solid fa-bell" href="/webhooks-overview">
+    Get real-time HTTP notifications when emails arrive.
+  </Card>
+
+  <Card title="Sending & receiving guide" icon="fa-solid fa-right-left" href="/sending-receiving-email">
+    Build a complete conversational agent workflow.
+  </Card>
+
+  <Card title="API Reference" icon="fa-solid fa-code" href="/api-reference">
+    Explore the full API with interactive examples.
+  </Card>
+</CardGroup>
 
 <Note>
   Looking for a different language? Email us at
   [support@agentmail.cc](mailto:support@agentmail.cc) and we'll get you set up.
 </Note>
 
-
 ***
 
 title: Inboxes
 subtitle: The foundation of your agent's identity and communication.
 slug: inboxes
-description: >-
-Learn how AgentMail Inboxes act as scalable, API-first email accounts for your
-agents.
--------
+description: Learn how AgentMail Inboxes act as scalable, API-first email accounts for your agents.
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 ## What is an Inbox?
 
@@ -612,8 +736,8 @@ Here at AgentMail we've now made an `Inbox` an API resource, meaning you can per
     --domain domain.com \
     --display-name "Docs Tester"
 
-  # retrieve an inbox
-  agentmail inboxes retrieve --inbox-id my_name@domain.com
+  # get an inbox
+  agentmail inboxes get --inbox-id my_name@domain.com
 
   # list all inboxes
   agentmail inboxes list
@@ -727,16 +851,15 @@ Copy one of the blocks below into Cursor or Claude for complete Inboxes API know
   ```
 </CodeBlocks>
 
-
 ***
 
 title: Messages
 subtitle: The fundamental unit of communication for your agents.
 slug: messages
-description: >-
-Learn how to send, receive, and manage emails as Message objects with the
-AgentMail API.
---------------
+description: Learn how to send, receive, and manage emails as Message objects with the AgentMail API.
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 ## What is a Message?
 
@@ -938,8 +1061,8 @@ You can retrieve the details of any specific `Message` by providing its ID along
   ```
 
   ```bash title="CLI"
-  # retrieve a specific message
-  agentmail inboxes:messages retrieve \
+  # get a specific message
+  agentmail inboxes:messages get \
     --inbox-id my_inbox@agentmail.to \
     --message-id "<abc123@agentmail.to>"
   ```
@@ -1199,10 +1322,14 @@ When processing incoming messages, always treat `html` as the primary content so
 
 ## Receiving `Messages`
 
+<Warning>
+  **Inbound emails require the sender's domain to have SPF or DKIM configured.** To reduce spoofing and phishing, AgentMail drops inbound emails when the sender's domain has neither SPF nor DKIM set up. If a sender reports that their email never arrived, this is the most likely cause. Once they configure SPF/DKIM on their domain, their emails will start landing in your inbox again. See [Why are my emails not showing up?](/knowledge-base/inbound-emails-missing) for details.
+</Warning>
+
 While you can periodically list `Messages` to check for new emails, the most efficient way to handle incoming `Messages` for your agents is with `Webhooks`. By configuring a `Webhook` endpoint, AgentMail can notify your application/agent in real-time as soon as a new `Message` arrives, so you can take action on them.
 
 <CardGroup>
-  <Card title="Guide: Webhooks" icon="fa-solid fa-bolt" href="/overview">
+  <Card title="Guide: Webhooks" icon="fa-solid fa-bolt" href="/webhooks-overview">
     Learn how to set up webhooks for real-time message processing.
   </Card>
 </CardGroup>
@@ -1268,16 +1395,15 @@ AgentMail doesn't have a dedicated "mark as read" endpoint — instead, you use
 ```
 ```
 
-
 ***
 
 title: Threads
 subtitle: Organizing conversations across your Inboxes.
 slug: threads
-description: >-
-Learn how AgentMail Threads group messages into conversations and how to query
-them across your entire organization.
--------------------------------------
+description: Learn how AgentMail Threads group messages into conversations and how to query them across your entire organization.
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 ## What is a Thread?
 
@@ -1298,7 +1424,7 @@ This is the standard way to retrieve all the conversations associated with a sin
   # You'll need an inbox ID to list threads from.
   inbox_id = "inbound-agent@agentmail.to"
 
-  # This retrieves all threads within the specified Inbox
+  # This loads all threads within the specified Inbox
 
   inbox_threads = client.inboxes.threads.list(inbox_id=inbox_id)
 
@@ -1308,7 +1434,7 @@ This is the standard way to retrieve all the conversations associated with a sin
   // You'll need an inbox ID to list threads from.
   const inboxId = "inbound-agent@agentmail.to";
 
-  // This retrieves all threads within the specified Inbox
+  // This loads all threads within the specified Inbox
   const inboxThreads = await client.inboxes.threads.list("inbound-agent@agentmail.to");
 
   console.log(`Found ${inboxThreads.count} threads in Inbox ${inboxId}.`);
@@ -1365,7 +1491,7 @@ You can also retrieve a single `Thread` by its ID. This will return the `Thread`
   ```python
   thread_id = "thread_456def"
 
-  # This retrieves a single thread and its messages
+  # This loads a single thread and its messages
 
   thread = client.threads.get(
   thread_id="thread_id"
@@ -1378,7 +1504,7 @@ You can also retrieve a single `Thread` by its ID. This will return the `Thread`
   ```typescript title="TypeScript"
   const threadId = "thread_456def";
 
-  // This retrieves a single thread and its messages
+  // This loads a single thread and its messages
   const thread = await client.threads.get(
   	"thread_id"
   )
@@ -1387,8 +1513,8 @@ You can also retrieve a single `Thread` by its ID. This will return the `Thread`
   ```
 
   ```bash title="CLI"
-  # retrieve a single thread by id
-  agentmail threads retrieve \
+  # get a single thread by id
+  agentmail threads get \
     --thread-id thread_456def
   ```
 </CodeBlocks>
@@ -1476,16 +1602,15 @@ Copy one of the blocks below into Cursor or Claude for complete Threads API know
   ```
 </CodeBlocks>
 
-
 ***
 
 title: Drafts
 subtitle: Preparing and scheduling Messages for your agents.
 slug: drafts
-description: >-
-Learn how to create, manage, and send Drafts to enable advanced agent
-workflows like human-in-the-loop review and scheduled sending.
---------------------------------------------------------------
+description: Learn how to create, manage, and send Drafts to enable advanced agent workflows like human-in-the-loop review and scheduled sending.
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 ## What is a Draft?
 
@@ -1568,8 +1693,8 @@ Once a `Draft` is created, you can retrieve it by its ID
   ```
 
   ```bash title="CLI"
-  # retrieve a draft by id
-  agentmail inboxes:drafts retrieve \
+  # get a draft by id
+  agentmail inboxes:drafts get \
     --inbox-id my_inbox@domain.com \
     --draft-id draft_id_123
   ```
@@ -2033,16 +2158,15 @@ Copy one of the blocks below into Cursor or Claude for complete Drafts API knowl
   ```
 </CodeBlocks>
 
-
 ***
 
 title: Labels
 subtitle: Organizing and categorizing your agent's conversations at scale.
 slug: labels
-description: >-
-Learn how to use Labels to manage state, track campaigns, and filter messages
-for powerful agentic workflows.
--------------------------------
+description: Learn how to use Labels to manage state, track campaigns, and filter messages for powerful agentic workflows.
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 ## What are `Labels`?
 
@@ -2292,16 +2416,15 @@ Copy one of the blocks below into Cursor or Claude for complete Labels usage in
   based on their content.
 </Callout>
 
-
 ***
 
 title: Lists
 subtitle: Filter emails by allowing or blocking specific addresses and domains.
 slug: lists
-description: >-
-Learn how to use Lists to control which email addresses and domains your
-agents can send to or receive from.
------------------------------------
+description: Learn how to use Lists to control which email addresses and domains your agents can send to or receive from.
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 ## What are Lists?
 
@@ -2415,8 +2538,8 @@ Retrieve a specific entry from a list by its email address or domain.
   ```
 
   ```bash title="CLI"
-  # retrieve a specific entry
-  agentmail lists retrieve \
+  # get a specific entry
+  agentmail lists get \
     --direction receive \
     --type allow \
     --entry partner@example.com
@@ -2601,16 +2724,15 @@ Copy one of the blocks below into Cursor or Claude for complete Lists API knowle
   ```
 </CodeBlocks>
 
-
 ***
 
 title: Attachments
 subtitle: Sending and receiving files with your agents.
 slug: attachments
-description: >-
-Learn how to send files as attachments, and download incoming attachments from
-both messages and threads.
---------------------------
+description: Learn how to send files as attachments, and download incoming attachments from both messages and threads.
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 ## What are `Attachments`?
 
@@ -2835,12 +2957,13 @@ Copy one of the blocks below into Cursor or Claude for complete Attachments usag
   ```
 </CodeBlocks>
 
-
 ***
 
 title: Pods
 description: Learn how to use pods for multi-tenant email management
---------------------------------------------------------------------
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 ## What are Pods?
 
@@ -3131,16 +3254,15 @@ Pod: "Marketing-Agent"
 * Learn about [Inboxes](/inboxes) and how to create email accounts within pods
 * Explore [Domains](/custom-domains) to set up custom email domains for your pods
 
-
 ***
 
 title: Permissions
 subtitle: Control what your API keys can access with granular permissions.
 slug: permissions
-description: >-
-Learn how to configure fine-grained permissions on API keys to restrict access
-to specific resources and operations.
--------------------------------------
+description: Learn how to configure fine-grained permissions on API keys to restrict access to specific resources and operations.
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 ## What are Permissions?
 
@@ -3207,6 +3329,10 @@ A restricted API key cannot create a child key with more permissions than itself
   When a label visibility permission is denied, items with that label are automatically excluded from list results and return "not found" on direct access. For example, setting `label_spam_read` to `false` means the key will never see spam messages in any listing or lookup.
 </Info>
 
+<Callout intent="info" title="Event subscriptions">
+  Label visibility permissions also control whether an API key can subscribe to the corresponding event types on [webhooks](/events) and [WebSockets](/websockets). An API key without `label_spam_read` cannot create a webhook or WebSocket subscription for `message.received.spam` events, and an API key without `label_blocked_read` cannot subscribe to `message.received.blocked` events.
+</Callout>
+
 ### Drafts
 
 | Permission     | Description   |
@@ -3568,24 +3694,71 @@ Copy one of the blocks below into Cursor or Claude for complete Permissions API
 * **Combine with scopes for defense in depth.** Pair permissions with [pod-scoped](/multi-tenancy#pod-scoped-keys) or [inbox-scoped](/multi-tenancy#inbox-scoped-keys) keys. Scopes limit *which* resources a key can see, while permissions limit *what* it can do.
 * **Filter unwanted content from agents.** Set `label_spam_read`, `label_blocked_read`, and `label_trash_read` to `false` on agent-facing keys. This prevents agents from seeing or processing unwanted email, keeping their context clean.
 
-
 ***
 
 title: Agent Onboarding
 subtitle: Everything you need to onboard your AI agent to AgentMail
 slug: agent-onboarding
-description: >-
-Resources for AI coding assistants, MCP servers, skills, and agent-friendly
-documentation.
---------------
+description: Resources for AI coding assistants, MCP servers, skills, and agent-friendly documentation.
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 > 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
+## Get 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.
+Your agent can sign up programmatically using the Agent API. No console access needed.
+
+<CodeBlocks>
+  ```python title="Python"
+  from agentmail import AgentMail
+
+  client = AgentMail()
+  response = client.agent.sign_up(human_email="you@example.com", username="my-agent")
+  # response.api_key  -> store this securely
+  # response.inbox_id -> my-agent@agentmail.to
+  ```
+
+  ```typescript title="TypeScript"
+  import { AgentMailClient } from "agentmail";
+
+  const client = new AgentMailClient();
+  const response = await client.agent.signUp({ humanEmail: "you@example.com", username: "my-agent" });
+  // response.apiKey  -> store this securely
+  // response.inboxId -> my-agent@agentmail.to
+  ```
+
+  ```bash title="CLI"
+  agentmail agent sign-up --human-email you@example.com --username my-agent
+  ```
+</CodeBlocks>
+
+A 6-digit OTP is sent to the provided email. Verify to unlock full permissions:
+
+<CodeBlocks>
+  ```python title="Python"
+  client = AgentMail(api_key=response.api_key)
+  client.agent.verify(otp_code="123456")
+  ```
+
+  ```typescript title="TypeScript"
+  const authedClient = new AgentMailClient({ apiKey: response.apiKey });
+  await authedClient.agent.verify({ otpCode: "123456" });
+  ```
+
+  ```bash title="CLI"
+  agentmail agent verify --otp-code 123456
+  ```
+</CodeBlocks>
+
+<Info>
+  The sign-up endpoint is idempotent. Calling it again with the same email rotates the API key and resends the OTP if expired.
+</Info>
+
+Alternatively, a human can create an account at [console.agentmail.to](https://console.agentmail.to) and generate an API key from the dashboard.
 
 <Info>
   AgentMail's free tier includes 3 inboxes and 3,000 emails/month. Your agent can start building immediately.
@@ -3713,19 +3886,26 @@ export AGENTMAIL_API_KEY="your-api-key-here"
   View the skill source and full documentation.
 </Card>
 
-## Quick Start for Agents
+## Quick start for agents
 
-Create an inbox and send your first email in a few lines:
+Sign up, create an inbox, and send your first email:
 
 <CodeBlocks>
   ```python title="Python"
   from agentmail import AgentMail
 
-  client = AgentMail(api_key="am_...")
+  # sign up (no API key needed)
+  client = AgentMail()
+  response = client.agent.sign_up(human_email="you@example.com", username="my-agent")
+
+  # after verifying with the OTP sent to your email:
+  client = AgentMail(api_key=response.api_key)
+  client.agent.verify(otp_code="123456")
+
+  # create an inbox and send an email
   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",
@@ -3737,12 +3917,19 @@ Create an inbox and send your first email in a few lines:
   ```typescript title="TypeScript"
   import { AgentMailClient } from "agentmail";
 
-  const client = new AgentMailClient({ apiKey: "am_..." });
-  const inbox = await client.inboxes.create({ displayName: "My AI Agent" });
+  // sign up (no API key needed)
+  const client = new AgentMailClient();
+  const response = await client.agent.signUp({ humanEmail: "you@example.com", username: "my-agent" });
+
+  // after verifying with the OTP sent to your email:
+  const authedClient = new AgentMailClient({ apiKey: response.apiKey });
+  await authedClient.agent.verify({ otpCode: "123456" });
+
+  // create an inbox and send an email
+  const inbox = await authedClient.inboxes.create({ displayName: "My AI Agent" });
   console.log(`Agent email: ${inbox.inboxId}`);
 
-  // Send an email
-  await client.inboxes.messages.send(inbox.inboxId, {
+  await authedClient.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."
@@ -3750,6 +3937,10 @@ Create an inbox and send your first email in a few lines:
   ```
 
   ```bash title="CLI"
+  # sign up and verify
+  agentmail agent sign-up --human-email you@example.com --username my-agent
+  agentmail agent verify --otp-code 123456
+
   # create an inbox
   agentmail inboxes create --display-name "My AI Agent"
 
@@ -3762,6 +3953,10 @@ Create an inbox and send your first email in a few lines:
   ```
 </CodeBlocks>
 
+<Note>
+  Already have an API key? Skip the sign-up step and initialize the client directly with your key.
+</Note>
+
 ### Receive and reply to emails
 
 <CodeBlocks>
@@ -3787,17 +3982,17 @@ Create an inbox and send your first email in a few lines:
 
   ```typescript title="TypeScript"
   // List threads in the inbox
-  const threads = await client.inboxes.threads.list(inbox.inboxId);
+  const threads = await authedClient.inboxes.threads.list(inbox.inboxId);
 
   // Get the latest thread
-  const thread = await client.inboxes.threads.get(
+  const thread = await authedClient.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(
+  await authedClient.inboxes.messages.reply(
       inbox.inboxId,
       latestMessage.messageId,
       { to: [latestMessage.from], text: "Thanks for your email! I'll look into this." }
@@ -3862,16 +4057,15 @@ Unlike traditional email APIs that are built for one-way transactional email, Ag
   </Card>
 </CardGroup>
 
-
 ***
 
 title: Skills
 subtitle: Add AgentMail to AI coding assistants with the official skill
 slug: integrations/skills
-description: >-
-AgentMail's official skill for OpenClaw, Claude Code, Cursor, and other AI
-assistants
-----------
+description: AgentMail's official skill for OpenClaw, Claude Code, Cursor, and other AI assistants
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 ## Getting started
 
@@ -3995,14 +4189,15 @@ Once installed, you can ask your AI assistant to perform email tasks:
 * [AgentMail API Reference](/api-reference)
 * [AgentMail Console](https://console.agentmail.to)
 
-
 ***
 
 title: MCP
 subtitle: Connect AgentMail to any MCP-compatible AI client
 slug: integrations/mcp
 description: AgentMail's Model Context Protocol (MCP) integration
------------------------------------------------------------------
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 ## Getting started
 
@@ -4038,14 +4233,15 @@ The AgentMail MCP server works with any MCP-compatible client, including:
 
 For detailed setup instructions and available tools, visit [mcp.agentmail.to](https://mcp.agentmail.to).
 
-
 ***
 
 title: CLI
 subtitle: Manage AgentMail resources from the command line
 slug: integrations/cli
 description: AgentMail's official command-line interface
---------------------------------------------------------
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 ## Getting started
 
@@ -4115,7 +4311,7 @@ agentmail webhooks create \
 The CLI provides commands for:
 
 * **Inbox management:** Create, list, update, and delete inboxes
-* **Message operations:** Send, reply, forward, and retrieve emails
+* **Message operations:** Send, reply, forward, and read emails
 * **Thread management:** List and manage email threads
 * **Drafts:** Create, update, send, and delete drafts
 * **Webhooks:** Create and manage webhook endpoints
@@ -4155,14 +4351,15 @@ openclaw skills install agentmail-to/agentmail-skills/agentmail-cli
 
 This works with any compatible tool, including OpenClaw, Claude Code, Cursor, and Codex. See the [Skills](/integrations/skills) page for more details.
 
-
 ***
 
 title: Google ADK
 subtitle: Give your Google ADK agent its own email inbox
 slug: integrations/google-adk
 description: AgentMail's Google Agent Development Kit (ADK) integration
------------------------------------------------------------------------
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 ## Getting started
 
@@ -4273,14 +4470,15 @@ Once connected, your ADK agent has access to the following AgentMail tools:
 | `forward_message`  | Forward a message to another recipient        |
 | `update_message`   | Update message properties such as read status |
 
-
 ***
 
 title: OpenClaw
 subtitle: Give your OpenClaw agent its own email inbox
 slug: integrations/openclaw
 description: AgentMail's OpenClaw integration
----------------------------------------------
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 ## Getting started
 
@@ -4501,14 +4699,15 @@ Now OpenClaw will be notified whenever a new email arrives, allowing it to proac
 * [OpenClaw Documentation](https://docs.openclaw.ai)
 * [OpenClaw Skills Guide](https://docs.openclaw.ai/tools/skills)
 
-
 ***
 
 title: Replit
 subtitle: Integrate AgentMail with your Replit apps and agents
 slug: integrations/replit
 description: AgentMail's Replit integration
--------------------------------------------
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 ## Getting started
 
@@ -4717,14 +4916,15 @@ Email is critical to identity and communication on the internet. Much of the con
 
 These are just a few select verticals, but we have seen AgentMail be effective in automating any email task across every function. If a human does it with email, it can be automated with AgentMail.
 
-
 ***
 
 title: x402
 subtitle: Pay-per-use AgentMail with the x402 payment protocol
 slug: integrations/x402
 description: AgentMail's x402 integration for HTTP-native payments
-------------------------------------------------------------------
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 ## Getting started
 
@@ -4879,14 +5079,15 @@ This means your agent can use the full AgentMail API (inboxes, messages, threads
 * [AgentMail API reference](/api-reference)
 * [WebSockets overview](/websockets)
 
-
 ***
 
 title: MPP
 subtitle: Pay-per-use AgentMail with Stripe's Machine Payments Protocol
 slug: integrations/mpp
 description: AgentMail's MPP integration for machine-to-machine payments via Stripe
------------------------------------------------------------------------------------
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 ## Getting started
 
@@ -4974,14 +5175,15 @@ This means your agent can use the full AgentMail API (inboxes, messages, threads
 * [AgentMail API reference](/api-reference)
 * [WebSockets overview](/websockets)
 
-
 ***
 
 title: Integrate LiveKit Agents
 subtitle: Build a voice assistant with real time email capabilities.
 slug: integrate-livekit-agents
 description: A step-by-step guide to integrate with the LiveKit Agents SDK.
----------------------------------------------------------------------------
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 ## Overview
 
@@ -5108,16 +5310,92 @@ Run your agent inside the terminal and send it an email
 python agent.py console
 ```
 
+***
+
+title: Sim.ai
+subtitle: Connect AgentMail to your Sim.ai workflows
+slug: integrations/sim
+description: AgentMail's Sim.ai integration
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
+## Getting started
+
+[Sim.ai](https://sim.ai) is a platform for building agentic workflows. By connecting AgentMail to Sim, your workflows can create inboxes, send and receive emails, manage threads, handle drafts, and organize conversations with labels, all without writing backend code.
+
+## Use cases
+
+* **Dynamic inbox creation:** Spin up new inboxes on the fly for each agent, workflow, or customer for multi-tenant email handling.
+* **Automated email processing:** List and read incoming messages, then trigger downstream actions based on content, sender, or labels.
+* **Conversational email:** Reply to threads and forward messages to keep conversations flowing naturally within automated workflows.
+* **Draft and review workflows:** Create drafts, update them with AI-generated content, and send when approved for human-in-the-loop patterns.
+* **Email organization:** Apply labels to threads and messages to categorize, filter, and route emails through your automation pipeline.
+
+## Prerequisites
+
+1. An [AgentMail account](https://agentmail.to/) with an API key from the [AgentMail Console](https://console.agentmail.to)
+2. A [Sim.ai](https://sim.ai) account
+
+## Setup
+
+1. Open your workflow in the Sim builder.
+2. Add the **AgentMail** block from the tools panel.
+3. Paste your AgentMail API key into the configuration.
+4. Select the operation you need (for example, create inbox, send message, or list threads).
+5. Map the input fields to your workflow data and connect the block to the rest of your flow.
+
+## Available operations
+
+Once connected, Sim provides access to the following AgentMail operations:
+
+### Inbox management
+
+| Operation    | Description                                                            |
+| ------------ | ---------------------------------------------------------------------- |
+| Create inbox | Create a new inbox with an optional username, domain, and display name |
+| Get inbox    | Retrieve details for a specific inbox                                  |
+| Delete inbox | Delete an inbox                                                        |
+
+### Message operations
+
+| Operation        | Description                              |
+| ---------------- | ---------------------------------------- |
+| Send message     | Send a new email from an inbox           |
+| Get message      | Retrieve details of a specific message   |
+| Reply to message | Reply to an existing message in a thread |
+| Forward message  | Forward a message to new recipients      |
+
+### Thread management
+
+| Operation     | Description                                                                  |
+| ------------- | ---------------------------------------------------------------------------- |
+| Get thread    | Retrieve a thread and its messages                                           |
+| Delete thread | Delete a thread (moves to trash, or permanently deletes if already in trash) |
+
+### Draft management
+
+| Operation    | Description                          |
+| ------------ | ------------------------------------ |
+| Create draft | Create a new email draft in an inbox |
+| Get draft    | Retrieve details of a specific draft |
+| Delete draft | Delete a draft                       |
+
+## Resources
+
+* [Sim.ai AgentMail tool documentation](https://docs.sim.ai/tools/agentmail)
+* [AgentMail API reference](/api-reference)
+* [Webhooks overview](/webhooks/webhooks-overview)
 
 ***
 
-title: 'Guide: Sending & Receiving Email'
+title: Guide: Sending & Receiving Email
 subtitle: Building your first conversational agent workflow.
 slug: sending-receiving-email
-description: >-
-A step-by-step guide to the practical workflow of sending initial emails and
-handling replies to have a full conversation.
----------------------------------------------
+description: A step-by-step guide to the practical workflow of sending initial emails and handling replies to have a full conversation.
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 This guide walks you through the complete, practical workflow of an agent having a conversation. While the `Core Concepts` pages detail the individual API calls, this guide shows you how to stitch them together to create a functional conversational loop.
 
@@ -5264,7 +5542,7 @@ Here's the step-by-step logic for a polling-based conversational agent.
 <Callout intent="success" title="Real-Time Processing with Webhooks">
   For production applications, polling is inefficient. The best way to handle incoming replies is to use `Webhooks`. This allows AgentMail to notify your agent instantly when a new `Message` arrives, so you can reply in real-time.
 
-  [**Learn how to set up `Webhooks` →**](/overview)
+  [**Learn how to set up `Webhooks` →**](/webhooks-overview)
 </Callout>
 
 ## Scheduling Emails
@@ -5313,16 +5591,15 @@ Create a `Draft` with the `send_at` field and AgentMail handles the rest. The em
   For more details on scheduled sending—including how to cancel, reschedule, list scheduled drafts, and build conditional follow-up workflows—see the [**Drafts**](/drafts) page.
 </Callout>
 
-
 ***
 
 title: IMAP & SMTP
 subtitle: Connect to AgentMail with standard email protocols
 slug: imap-smtp
-description: >-
-Configure IMAP and SMTP to access your AgentMail inboxes using email clients
-or programmatic access.
------------------------
+description: Configure IMAP and SMTP to access your AgentMail inboxes using email clients or programmatic access.
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 <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.
@@ -5561,16 +5838,15 @@ sendEmail().catch(console.error);
 | Access to all folders       | API            |
 | Bulk operations             | API            |
 
-
 ***
 
-title: 'Guide: Multi-Tenancy'
-subtitle: 'Pods, scoped keys, and event routing for your customers.'
+title: Guide: Multi-Tenancy
+subtitle: Pods, scoped keys, and event routing for your customers.
 slug: multi-tenancy
-description: >-
-How to use pods, scoped API keys, and webhook filtering to build multi-tenant
-email on AgentMail.
--------------------
+description: How to use pods, scoped API keys, and webhook filtering to build multi-tenant email on AgentMail.
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 If you're building a platform where each of your customers needs their own email infrastructure, this is how you set it up. The basic idea: create a `Pod` per customer, give them a scoped API key, and route webhook events to the right place.
 
@@ -5856,18 +6132,15 @@ Here's what onboarding a new tenant looks like end to end:
   ```
 </CodeBlocks>
 
-
 ***
 
 title: Using Custom Domains
-subtitle: >-
-Strengthen your agent's identity and improve deliverability with your own
-domain.
+subtitle: Strengthen your agent's identity and improve deliverability with your own domain.
 slug: custom-domains
-description: >-
-A step-by-step guide to configuring your custom domain with AgentMail for
-enhanced branding and trust.
-----------------------------
+description: A step-by-step guide to configuring your custom domain with AgentMail for enhanced branding and trust.
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 ## Why Use a Custom Domain?
 
@@ -6266,18 +6539,15 @@ DNS can be tricky. Here are some common issues and how to resolve them.
 
 Check out our guide on [Email Deliverability](/email-deliverability) for tips on warming up your new domain and maintaining a healthy sender reputation.
 
-
 ***
 
 title: Managing Your Domains
-subtitle: >-
-Best practices for monitoring, scaling, and optimizing your domain strategy
-for agent fleets.
+subtitle: Best practices for monitoring, scaling, and optimizing your domain strategy for agent fleets.
 slug: managing-domains
-description: >-
-Learn how to manage your custom domains effectively using AgentMail's API for
-enhanced deliverability and reputation management.
---------------------------------------------------
+description: Learn how to manage your custom domains effectively using AgentMail's API for enhanced deliverability and reputation management.
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 ## From Setup to Strategy
 
@@ -6345,16 +6615,15 @@ By default, AgentMail configures your domain with a strict DMARC policy (`p=reje
 
 However, this is obviously up to your discretion if you want to impose a more relaxed DMARC policy, whether its `p=none` where it doesn't do anything if both SPF and DMARC fail, or its `p=quarantine`, where it puts the mail in spam/junk. Feel free to do more research at your own discretion. You can do this by changing the value in the TXT record in your DNS configuration where the name starts with `_dmarc`.
 
-
 ***
 
 title: Webhooks Overview
 subtitle: Get real-time notifications for email events.
-slug: overview
-description: >-
-Learn how to use Webhooks to build responsive, event-driven email agents with
-AgentMail.
-----------
+slug: webhooks-overview
+description: Learn how to use Webhooks to build responsive, event-driven email agents with AgentMail.
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 Webhooks are the best way to get real-time information about what's happening with your emails. Instead of constantly asking the AgentMail API if there's a new email (a process called polling), you can register a URL, and we will send you a `POST` request with the details as soon as an event happens.
 
@@ -6365,13 +6634,19 @@ This event-driven approach is more efficient and allows you to build fast, respo
 * **Real-Time Speed:** Build conversational agents that can reply to incoming emails in seconds.
 * **Efficiency:** Eliminates the need for constant polling, which saves you computational resources and simplifies your application logic.
 
+<Callout intent="info" title="Prefer a simpler setup?">
+  If you don't want to expose a public URL or set up ngrok, [WebSockets](/websockets) let you receive the same events over a persistent connection with no external tooling required.
+</Callout>
+
 ## Available Events
 
-AgentMail supports seven webhook event types. When creating a webhook, you can subscribe to specific events or receive all of them. See [Webhook Events](/events) for full payload details.
+AgentMail supports nine webhook event types. When creating a webhook, you can subscribe to specific events or receive all of them. See [Webhook Events](/events) for full payload details.
 
 **Message events:**
 
 * **`message.received`** — New email received and processed in one of your inboxes
+* **`message.received.spam`** — A message was received and classified as spam (requires `label_spam_read` permission)
+* **`message.received.blocked`** — A message was received and matched a block list entry (requires `label_blocked_read` permission)
 * **`message.sent`** — Message successfully sent from your inbox
 * **`message.delivered`** — Delivery confirmed by the recipient's mail server
 * **`message.bounced`** — Message failed to deliver and bounced back
@@ -6382,6 +6657,10 @@ AgentMail supports seven webhook event types. When creating a webhook, you can s
 
 * **`domain.verified`** — Custom domain successfully verified
 
+<Callout intent="info">
+  Spam and blocked events are excluded by default. To receive them, explicitly include `message.received.spam` or `message.received.blocked` in the `event_types` list when creating a webhook. Messages with these labels are no longer sent as `message.received`.
+</Callout>
+
 ## The Webhook Workflow
 
 The process is straightforward:
@@ -6418,7 +6697,7 @@ The process is straightforward:
       ```
     </CodeBlocks>
 
-    Specify which events to receive; omit `event_types` to subscribe to all event types.
+    Specify which events to receive; omit `event_types` to subscribe to all standard event types. Spam and blocked events must always be explicitly included.
   </Step>
 
   <Step title="3. AgentMail Sends Events">
@@ -6459,7 +6738,7 @@ Omitted content is always available through the API. After receiving a webhook,
 
   ```bash title="CLI"
   # fetch the full message after receiving a webhook
-  agentmail inboxes:messages retrieve \
+  agentmail inboxes:messages get \
     --inbox-id <inbox_id> \
     --message-id <message_id>
   ```
@@ -6539,8 +6818,9 @@ Copy one of the blocks below into Cursor or Claude for complete Webhooks API kno
   - 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
+  Events: message.received, message.received.spam, message.received.blocked, 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).
+  Note: message.received.spam and message.received.blocked are excluded by default. To receive them, explicitly include them in event_types and ensure the API key has label_spam_read / label_blocked_read permissions.
   """
   import os
   from dotenv import load_dotenv
@@ -6567,7 +6847,8 @@ Copy one of the blocks below into Cursor or Claude for complete Webhooks API kno
    * - 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
+   * Events: message.received, message.received.spam, message.received.blocked, message.sent, message.delivered, message.bounced, message.complained, message.rejected, domain.verified
+   * Note: message.received.spam and message.received.blocked are excluded by default. To receive them, explicitly include them in eventTypes and ensure the API key has label_spam_read / label_blocked_read permissions.
    * Verify with Svix using webhook.secret. Use express.raw() for body—signature needs raw payload.
    */
   import { AgentMailClient } from "agentmail";
@@ -6599,18 +6880,23 @@ Copy one of the blocks below into Cursor or Claude for complete Webhooks API kno
     Learn how to verify webhook signatures to secure your endpoints.
   </Card>
 
+  <Card title="WebSockets" href="/websockets">
+    Receive events over a persistent connection with no public URL required.
+  </Card>
+
   <Card title="Example: Event-Driven Agent" href="/github-star-agent">
     Build a fully deployable, event-driven agent that can respond to emails in
     real time.
   </Card>
 </CardGroup>
 
-
 ***
 
 title: Webhook Events
 slug: events
-------------
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 As mentioned in the overview, webhooks allow us to create event-driven applications.
 
@@ -6658,6 +6944,12 @@ The AgentMail SDKs export typed classes for each webhook event, so you can parse
     } else if (eventType === "message.rejected") {
       const event = await serialization.events.MessageRejectedEvent.parse(payload);
       console.log(event.reject.reason);
+    } else if (eventType === "message.received.spam") {
+      const event = await serialization.events.MessageReceivedSpamEvent.parse(payload);
+      console.log(event.message.subject);
+    } else if (eventType === "message.received.blocked") {
+      const event = await serialization.events.MessageReceivedBlockedEvent.parse(payload);
+      console.log(event.message.subject);
     } else if (eventType === "domain.verified") {
       const event = await serialization.events.DomainVerifiedEvent.parse(payload);
       console.log(event.domain.status);
@@ -6668,6 +6960,8 @@ The AgentMail SDKs export typed classes for each webhook event, so you can parse
   ```python title="Python"
   from agentmail import (
       MessageReceivedEvent,
+      MessageReceivedSpamEvent,
+      MessageReceivedBlockedEvent,
       MessageSentEvent,
       MessageBouncedEvent,
       MessageDeliveredEvent,
@@ -6699,6 +6993,12 @@ The AgentMail SDKs export typed classes for each webhook event, so you can parse
       elif event_type == "message.rejected":
           event = MessageRejectedEvent(**payload)
           print(event.reject.reason)
+      elif event_type == "message.received.spam":
+          event = MessageReceivedSpamEvent(**payload)
+          print(event.message.subject)
+      elif event_type == "message.received.blocked":
+          event = MessageReceivedBlockedEvent(**payload)
+          print(event.message.subject)
       elif event_type == "domain.verified":
           event = DomainVerifiedEvent(**payload)
           print(event.domain.status)
@@ -6714,12 +7014,15 @@ Copy one of the blocks below into Cursor or Claude for webhook event parsing in
   """
   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.
+  Parse typed events: MessageReceivedEvent (message.received), MessageReceivedSpamEvent (message.received.spam), MessageReceivedBlockedEvent (message.received.blocked),
+  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.
+  Note: message.received.spam and message.received.blocked require label_spam_read / label_blocked_read permissions.
   """
   from agentmail import (
-    MessageReceivedEvent, MessageSentEvent, MessageBouncedEvent,
+    MessageReceivedEvent, MessageReceivedSpamEvent, MessageReceivedBlockedEvent,
+    MessageSentEvent, MessageBouncedEvent,
     MessageDeliveredEvent, MessageComplainedEvent, MessageRejectedEvent, DomainVerifiedEvent,
   )
 
@@ -6731,6 +7034,8 @@ Copy one of the blocks below into Cursor or Claude for webhook event parsing in
     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 == "message.received.spam": e = MessageReceivedSpamEvent(**payload); print(e.message.subject)
+    elif t == "message.received.blocked": e = MessageReceivedBlockedEvent(**payload); print(e.message.subject)
     elif t == "domain.verified": e = DomainVerifiedEvent(**payload); print(e.domain.status)
   ```
 
@@ -6738,8 +7043,10 @@ Copy one of the blocks below into Cursor or Claude for webhook event parsing in
   /**
    * 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.
+   * Parse with serialization.events.<EventType>.parse(payload).
+   * message.received → MessageReceivedEvent, message.received.spam → MessageReceivedSpamEvent, message.received.blocked → MessageReceivedBlockedEvent.
+   * Only message.received* has message+thread; others have send/delivery/bounce/complaint/reject/domain.
+   * message.received.spam and message.received.blocked require label_spam_read / label_blocked_read permissions.
    */
   import { serialization } from "agentmail";
 
@@ -6763,6 +7070,12 @@ Copy one of the blocks below into Cursor or Claude for webhook event parsing in
     } else if (t === "message.rejected") {
       const e = await serialization.events.MessageRejectedEvent.parse(payload);
       console.log(e.reject);
+    } else if (t === "message.received.spam") {
+      const e = await serialization.events.MessageReceivedSpamEvent.parse(payload);
+      console.log(e.message.subject);
+    } else if (t === "message.received.blocked") {
+      const e = await serialization.events.MessageReceivedBlockedEvent.parse(payload);
+      console.log(e.message.subject);
     } else if (t === "domain.verified") {
       const e = await serialization.events.DomainVerifiedEvent.parse(payload);
       console.log(e.domain);
@@ -6833,6 +7146,106 @@ Copy one of the blocks below into Cursor or Claude for webhook event parsing in
   ```
 </CodeGroup>
 
+### `message.received.spam`
+
+* **Description:** Triggered when a new email is received and classified as spam. The payload structure is the same as `message.received`. Messages classified as spam are not delivered as `message.received` events.
+* **Example use-case:** Route spam to a review queue or log spam patterns for analysis.
+
+<Callout intent="warn">
+  This event is only delivered if the API key used to create the webhook has the `label_spam_read` permission. Without this permission, the webhook creation will be rejected with a `403 Forbidden` error.
+</Callout>
+
+<CodeGroup>
+  ```json
+  {
+    "type": "event",
+    "event_type": "message.received.spam",
+    "event_id": "evt_spam123",
+    "message": {
+      "inbox_id": "inbox_456def",
+      "thread_id": "thd_789ghi",
+      "message_id": "<spam123@example.com>",
+      "labels": ["spam"],
+      "timestamp": "2023-10-27T10:00:00Z",
+      "from": "spammer@example.com",
+      "to": ["agent@agentmail.to"],
+      "subject": "Suspicious offer",
+      "preview": "You've been selected...",
+      "text": "Full spam message body.",
+      "html": "<html>...</html>",
+      "size": 1024,
+      "updated_at": "2023-10-27T10:00:00Z",
+      "created_at": "2023-10-27T10:00:00Z"
+    },
+    "thread": {
+      "inbox_id": "inbox_456def",
+      "thread_id": "thd_789ghi",
+      "labels": ["spam"],
+      "timestamp": "2023-10-27T10:00:00Z",
+      "senders": ["spammer@example.com"],
+      "recipients": ["agent@agentmail.to"],
+      "subject": "Suspicious offer",
+      "preview": "You've been selected...",
+      "last_message_id": "<spam123@example.com>",
+      "message_count": 1,
+      "size": 1024,
+      "updated_at": "2023-10-27T10:00:00Z",
+      "created_at": "2023-10-27T10:00:00Z"
+    }
+  }
+  ```
+</CodeGroup>
+
+### `message.received.blocked`
+
+* **Description:** Triggered when a new email is received and matched a block list entry. The payload structure is the same as `message.received`. Messages that match a block list are not delivered as `message.received` events.
+* **Example use-case:** Audit blocked senders or maintain a log of blocked messages.
+
+<Callout intent="warn">
+  This event is only delivered if the API key used to create the webhook has the `label_blocked_read` permission. Without this permission, the webhook creation will be rejected with a `403 Forbidden` error.
+</Callout>
+
+<CodeGroup>
+  ```json
+  {
+    "type": "event",
+    "event_type": "message.received.blocked",
+    "event_id": "evt_blocked456",
+    "message": {
+      "inbox_id": "inbox_456def",
+      "thread_id": "thd_789ghi",
+      "message_id": "<blocked456@example.com>",
+      "labels": ["blocked"],
+      "timestamp": "2023-10-27T10:00:00Z",
+      "from": "blocked-sender@example.com",
+      "to": ["agent@agentmail.to"],
+      "subject": "Blocked message",
+      "preview": "This message was blocked...",
+      "text": "Full blocked message body.",
+      "html": "<html>...</html>",
+      "size": 512,
+      "updated_at": "2023-10-27T10:00:00Z",
+      "created_at": "2023-10-27T10:00:00Z"
+    },
+    "thread": {
+      "inbox_id": "inbox_456def",
+      "thread_id": "thd_789ghi",
+      "labels": ["blocked"],
+      "timestamp": "2023-10-27T10:00:00Z",
+      "senders": ["blocked-sender@example.com"],
+      "recipients": ["agent@agentmail.to"],
+      "subject": "Blocked message",
+      "preview": "This message was blocked...",
+      "last_message_id": "<blocked456@example.com>",
+      "message_count": 1,
+      "size": 512,
+      "updated_at": "2023-10-27T10:00:00Z",
+      "created_at": "2023-10-27T10:00:00Z"
+    }
+  }
+  ```
+</CodeGroup>
+
 ### `message.sent`
 
 * **Description:** Triggered when a message is successfully sent from one of your `Inboxes`.
@@ -7020,18 +7433,21 @@ When creating a webhook, you can specify which events to subscribe to. This allo
 
 For example, if you only need to trigger workflows on incoming messages, you can subscribe to just `message.received`. If you're building a delivery tracking system, you might subscribe to `message.sent`, `message.delivered`, and `message.bounced`.
 
-If you have any specific webhook notifications you would like, please ping us in the `#feature-requests` channel in the [Discord](https://discord.gg/hTYatWYWBc)
+<Callout intent="info">
+  By default, spam and blocked events are **not** delivered. To receive them, you must explicitly include `message.received.spam` or `message.received.blocked` in the `event_types` list when creating your webhook. The API key must also have the corresponding `label_spam_read` or `label_blocked_read` permission.
+</Callout>
 
+If you have any specific webhook notifications you would like, please ping us in the `#feature-requests` channel in the [Discord](https://discord.gg/hTYatWYWBc)
 
 ***
 
 title: Webhook Setup Guide
 subtitle: Step-by-step guide to configure webhooks.
 slug: webhook-setup
-description: >-
-A comprehensive guide to setting up webhooks with ngrok and AgentMail,
-including account creation, inbox setup, and code examples.
------------------------------------------------------------
+description: A comprehensive guide to setting up webhooks with ngrok and AgentMail, including account creation, inbox setup, and code examples.
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 This guide walks you through the complete process of setting up webhooks to receive real-time notifications from AgentMail. You'll learn how to create an ngrok account, set up an inbox, configure webhooks, and write a simple webhook receiver.
 
@@ -7044,6 +7460,10 @@ Before you start, make sure you have:
 * `pip` package manager
 * Basic familiarity with Python and terminal commands
 
+<Callout intent="info" title="Want something simpler?">
+  Webhooks require a public URL and tools like ngrok. If you'd rather skip that setup, [WebSockets](/websockets) give you real-time events over a persistent connection with no external tooling. See the [WebSockets quickstart](/websockets/quickstart).
+</Callout>
+
 ## Installation
 
 First, install the required Python packages:
@@ -7326,7 +7746,7 @@ For production deployments:
     Learn how to verify webhook signatures for secure endpoints.
   </Card>
 
-  <Card title="Webhooks Overview" href="/overview">
+  <Card title="Webhooks Overview" href="/webhooks-overview">
     Learn more about how webhooks work and their payload structure.
   </Card>
 
@@ -7335,16 +7755,15 @@ For production deployments:
   </Card>
 </CardGroup>
 
-
 ***
 
 title: Verifying Webhooks
 subtitle: Ensure webhook requests are authentically from AgentMail.
 slug: webhook-verification
-description: >-
-Learn how to verify webhook signatures to secure your webhook endpoints and
-prevent spoofed requests.
--------------------------
+description: Learn how to verify webhook signatures to secure your webhook endpoints and prevent spoofed requests.
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 When building webhook receivers, it's critical to verify that incoming requests actually originate from AgentMail and haven't been tampered with. AgentMail uses [Svix](https://www.svix.com/) to deliver webhooks, which provides cryptographic signature verification.
 
@@ -7391,7 +7810,7 @@ Each webhook endpoint has a unique signing secret that you'll use to verify requ
 
   ```bash title="CLI"
   # get webhook details including the signing secret
-  agentmail webhooks retrieve --webhook-id ep_xxx
+  agentmail webhooks get --webhook-id ep_xxx
   ```
 </CodeBlocks>
 
@@ -7787,16 +8206,15 @@ For production, you'll need to deploy your webhook server to a hosting provider
   </Card>
 </CardGroup>
 
-
 ***
 
 title: WebSockets
-subtitle: 'Real-time, low-latency email event streaming'
+subtitle: Real-time, low-latency email event streaming
 slug: websockets
-description: >-
-Learn how to use WebSockets for instant email notifications without webhooks
-or polling.
------------
+description: Learn how to use WebSockets for instant email notifications without webhooks or polling.
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 WebSockets provide a persistent, bidirectional connection to AgentMail for receiving email events in real-time. Unlike webhooks, WebSockets don't require a public URL or external tools like ngrok.
 
@@ -8024,6 +8442,12 @@ Subscribe(
     inbox_ids=["agent@agentmail.to"],
     event_types=["message.received", "message.sent"]
 )
+
+# Subscribe to spam and blocked events (requires label_spam_read / label_blocked_read permissions)
+Subscribe(
+    inbox_ids=["agent@agentmail.to"],
+    event_types=["message.received", "message.received.spam", "message.received.blocked"]
+)
 ```
 
 **TypeScript:**
@@ -8047,8 +8471,19 @@ socket.sendSubscribe({
   inboxIds: ["agent@agentmail.to"],
   eventTypes: ["message.received", "message.sent"],
 });
+
+// Subscribe to spam and blocked events (requires label_spam_read / label_blocked_read permissions)
+socket.sendSubscribe({
+  type: "subscribe",
+  inboxIds: ["agent@agentmail.to"],
+  eventTypes: ["message.received", "message.received.spam", "message.received.blocked"],
+});
 ```
 
+<Callout intent="info">
+  By default (when no `event_types` are specified), spam and blocked events are excluded from the subscription. To receive spam events, explicitly include `message.received.spam` in `event_types` and ensure the API key has the `label_spam_read` permission. The same applies to `message.received.blocked` with the `label_blocked_read` permission.
+</Callout>
+
 ***
 
 ## Event Types
@@ -8061,14 +8496,16 @@ socket.sendSubscribe({
 
 ### Message Events
 
-| Event                | Python                   | TypeScript                         | Description          |
-| -------------------- | ------------------------ | ---------------------------------- | -------------------- |
-| `message_received`   | `MessageReceivedEvent`   | `AgentMail.MessageReceivedEvent`   | New email received   |
-| `message_sent`       | `MessageSentEvent`       | `AgentMail.MessageSentEvent`       | Email was sent       |
-| `message_delivered`  | `MessageDeliveredEvent`  | `AgentMail.MessageDeliveredEvent`  | Email was delivered  |
-| `message_bounced`    | `MessageBouncedEvent`    | `AgentMail.MessageBouncedEvent`    | Email bounced        |
-| `message_complained` | `MessageComplainedEvent` | `AgentMail.MessageComplainedEvent` | Email marked as spam |
-| `message_rejected`   | `MessageRejectedEvent`   | `AgentMail.MessageRejectedEvent`   | Email was rejected   |
+| Event                      | Python                        | TypeScript                              | Description                                |
+| -------------------------- | ----------------------------- | --------------------------------------- | ------------------------------------------ |
+| `message_received`         | `MessageReceivedEvent`        | `AgentMail.MessageReceivedEvent`        | New email received                         |
+| `message_received_spam`    | `MessageReceivedSpamEvent`    | `AgentMail.MessageReceivedSpamEvent`    | Email received, classified as spam         |
+| `message_received_blocked` | `MessageReceivedBlockedEvent` | `AgentMail.MessageReceivedBlockedEvent` | Email received, matched a block list entry |
+| `message_sent`             | `MessageSentEvent`            | `AgentMail.MessageSentEvent`            | Email was sent                             |
+| `message_delivered`        | `MessageDeliveredEvent`       | `AgentMail.MessageDeliveredEvent`       | Email was delivered                        |
+| `message_bounced`          | `MessageBouncedEvent`         | `AgentMail.MessageBouncedEvent`         | Email bounced                              |
+| `message_complained`       | `MessageComplainedEvent`      | `AgentMail.MessageComplainedEvent`      | Email marked as spam                       |
+| `message_rejected`         | `MessageRejectedEvent`        | `AgentMail.MessageRejectedEvent`        | Email was rejected                         |
 
 ### Domain Events
 
@@ -8180,7 +8617,8 @@ Copy one of the blocks below into Cursor or Claude for WebSockets in one shot.
   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
+  Event types: Subscribed, MessageReceivedEvent, MessageReceivedSpamEvent, MessageReceivedBlockedEvent, MessageSentEvent, MessageDeliveredEvent, MessageBouncedEvent, MessageComplainedEvent, MessageRejectedEvent, DomainVerifiedEvent
+  Spam/blocked events require explicit opt-in via event_types and label_spam_read / label_blocked_read permissions.
   """
   from agentmail import AgentMail, Subscribe, Subscribed, MessageReceivedEvent
 
@@ -8219,13 +8657,14 @@ Copy one of the blocks below into Cursor or Claude for WebSockets in one shot.
 
 ***
 
-
 ***
 
 title: WebSockets Quickstart
 subtitle: Get started with real-time email event streaming
 slug: websockets/quickstart
----------------------------
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 ## Copy for Cursor / Claude
 
@@ -8313,16 +8752,15 @@ with client.websockets.connect() as socket:
             print(f"Received message from: {msg.from_}")
 ```
 
-
 ***
 
 title: Email Deliverability
-subtitle: 'Best practices for landing your emails in the inbox, not the spam folder.'
+subtitle: Best practices for landing your emails in the inbox, not the spam folder.
 slug: email-deliverability
-description: >-
-Learn the strategies and best practices for maximizing your email
-deliverability with AgentMail.
-------------------------------
+description: Learn the strategies and best practices for maximizing your email deliverability with AgentMail.
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 ## What is Email Deliverability?
 
@@ -8428,16 +8866,15 @@ The content of your email plays a huge role in whether it's seen as a valuable m
   </Step>
 </Steps>
 
-
 ***
 
 title: Idempotent Requests
 subtitle: Learn how to use idempotency keys to build safe and reliable API integrations.
 slug: idempotency
-description: >-
-A guide to using the client\_id parameter in AgentMail to prevent duplicate
-resources and safely retry API requests.
-----------------------------------------
+description: A guide to using the client_id parameter in AgentMail to prevent duplicate resources and safely retry API requests.
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 ## What is Idempotency?
 
@@ -8483,18 +8920,15 @@ To use idempotency effectively, the `client_id` you generate must be unique and
 
 A common and highly effective pattern is to generate a UUID (like a `UUID v4`) on your client side for a resource you are about to create, save that UUID in your own database, and then use it as the `client_id` in the API call. This gives you a reliable key to use for any retries.
 
-
 ***
 
-title: 'Example: Event-Driven Agent'
-subtitle: >-
-Build a proactive, event-driven GitHub agent that uses Webhooks to handle
-replies in real time.
+title: Example: Event-Driven Agent
+subtitle: Build a proactive, event-driven GitHub agent that uses Webhooks to handle replies in real time.
 slug: webhook-agent
-description: >-
-A step-by-step guide to building a sophisticated agent that performs proactive
-outreach and uses webhooks for inbound message processing.
-----------------------------------------------------------
+description: A step-by-step guide to building a sophisticated agent that performs proactive outreach and uses webhooks for inbound message processing.
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 This tutorial walks you through building a sophisticated, dual-mode agent. It will:
 
@@ -8902,15 +9336,14 @@ You now have a fully event-driven agent that can both initiate conversations and
 ```
 ```
 
-
 ***
 
 title: Auto-Reply Email Agent
-description: >-
-Build a simple agent that automatically responds to incoming emails with
-personalized messages
+description: Build a simple agent that automatically responds to incoming emails with personalized messages
 ---------------------
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 ## Overview
 
 Learn how to build an email auto-reply agent that automatically responds to incoming emails. This beginner-friendly example demonstrates the core concepts of building with AgentMail: receiving webhooks, processing email events, and sending automated replies.
@@ -9774,14 +10207,13 @@ Your agent now has conversation memory. When replying to follow-up emails, the A
 
 If you build something cool with AgentMail, we'd love to hear about it. Share in our [Discord community](https://discord.gg/hTYatWYWBc)!
 
-
 ***
 
 title: Smart Email Labeling Agent
-description: >-
-Build an AI-powered agent that automatically classifies and labels incoming
-emails across multiple dimensions
----------------------------------
+description: Build an AI-powered agent that automatically classifies and labels incoming emails across multiple dimensions
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 ## Overview
 
@@ -10490,15 +10922,14 @@ Use this data to identify bottlenecks, improve processes, and make data-driven d
 
 Congratulations! You've built an AI-powered email classification system. This agent showcases how AgentMail's labeling feature can power sophisticated inbox automation and analytics.
 
-
 ***
 
 title: Sales Agent with WebSocket
 slug: sales-agent-websocket
-description: >-
-A step-by-step guide to building an AI-powered sales agent that uses WebSocket
-for real-time email processing without polling or webhooks.
------------------------------------------------------------
+description: A step-by-step guide to building an AI-powered sales agent that uses WebSocket for real-time email processing without polling or webhooks.
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 ## Overview
 
@@ -11216,6 +11647,7 @@ await socket.send_subscribe(Subscribe(inbox_ids=[
 
 If you build something cool with AgentMail, we'd love to hear about it. Share in our [Discord community](https://discord.gg/hTYatWYWBc)!
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 # Live Email Agents
 
@@ -11258,15 +11690,14 @@ Ready to build your own intelligent email agent? Check out our [quickstart guide
   demo.
 </Note>
 
-
 ***
 
 title: Frequently Asked Questions (FAQ)
 slug: faq
-description: >-
-Find answers to common questions about AgentMail, from core concepts to best
-practices and security.
------------------------
+description: Find answers to common questions about AgentMail, from core concepts to best practices and security.
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 <AccordionGroup>
   <Accordion title="What is AgentMail?">
@@ -11298,7 +11729,7 @@ practices and security.
     For production applications, **Webhooks are the recommended method**. They
     provide real-time notifications and are far more efficient than constantly
     polling the API for new messages. You can learn how to set them up in our
-    [Webhooks Overview](/overview).
+    [Webhooks Overview](/webhooks-overview).
   </Accordion>
 
   <Accordion title="How do I get just the new content from a reply?">
@@ -11318,16 +11749,15 @@ practices and security.
   </Accordion>
 </AccordionGroup>
 
-
 ***
 
 title: Email Reply Extraction with Talon
 subtitle: Extract clean reply content from email threads using Talon library
 slug: talon-reply-extraction
-description: >-
-Learn how to use Talon to extract new content from email replies, removing
-quoted text with 93.8% accuracy.
---------------------------------
+description: Learn how to use Talon to extract new content from email replies, removing quoted text with 93.8% accuracy.
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 ## Why Talon?
 
@@ -11857,15 +12287,14 @@ TalonJS provides 90.6% accuracy with slightly faster performance (1.88ms), makin
   * The 3.2% accuracy difference is acceptable for most use cases
 </Tip>
 
-
 ***
 
 title: Join the AgentMail Community
 slug: community
-description: >-
-Connect with the AgentMail team and developers, share what you're building,
-and get support.
-----------------
+description: Connect with the AgentMail team and developers, share what you're building, and get support.
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 <CardGroup>
   <Card title="Join our Discord Server" href="https://discord.com/invite/hTYatWYWBc" icon="fa-brands fa-discord">
@@ -11890,13 +12319,14 @@ and get support.
   To learn more about our premium plans and dedicated support options, please visit our website [here](https://agentmail.to/pricing).
 </Callout>
 
-
 ***
 
 title: Support
 slug: support
 description: Get help with AgentMail through our support channels.
-------------------------------------------------------------------
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 ## Need Help?
 
@@ -11908,13 +12338,14 @@ description: Get help with AgentMail through our support channels.
   <Card title="Email Support" icon="fa-solid fa-envelope" href="mailto:support@agentmail.cc" />
 </Cards>
 
-
 ***
 
-title: 'Understanding Email Authentication (SPF, DKIM, DMARC)'
+title: Understanding Email Authentication (SPF, DKIM, DMARC)
 slug: email-protocols
-description: 'Learn why we ask for DNS records and what SPF, DKIM, and DMARC are.'
-----------------------------------------------------------------------------------
+description: Learn why we ask for DNS records and what SPF, DKIM, and DMARC are.
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 When you add a custom domain to AgentMail, we ask you to add several records to your DNS settings. We understand that this can seem daunting, and we want to be completely transparent about what these records are and why they are necessary.
 
@@ -11987,14 +12418,15 @@ This is some records that we might give you:
 
 We hope this provides a clear and transparent look into why these DNS records are required. By setting them up, you enable AgentMail to provide a secure and reliable email experience for your AI agents.
 
-
 ***
 
 title: SOC 2 Compliance
 description: AgentMail's SOC 2 Type I and Type II compliance.
-sidebar\_position: 40
-lastUpdated: '2026-03-17'
--------------------------
+sidebar_position: 40
+lastUpdated: 2026-03-17
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 > AgentMail has achieved **SOC 2 Type I** (July 2025) and **Type II** (Q1 2026) compliance.
 
@@ -12122,13 +12554,14 @@ Organizations evaluating AgentMail can [request SOC 2 documentation](mailto:secu
 
 ***
 
-
 ***
 
 title: Spam & Virus Detection
 slug: spam-virus-detection
 description: How AgentMail automatically scans incoming emails for spam and viruses.
-------------------------------------------------------------------------------------
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 AgentMail automatically scans every inbound message for spam and viruses before it reaches your inbox. This happens transparently — there is nothing you need to configure.
 
@@ -12179,14 +12612,15 @@ Each thread object includes a `spam` label indicating whether it was flagged as
 }
 ```
 
-
 ***
 
 title: API Welcome
 subtitle: Getting Started with AgentMail
 slug: api-reference
 description: Quick overview of the AgentMail SDK
-------------------------------------------------
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 ## Introduction
 
@@ -12224,6 +12658,7 @@ If you have any other languages you would like us to support, please [reach out
 
 All of our SDKs are open source and available under the MIT license.
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 # Sign Up
 
@@ -12511,6 +12946,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Verify
 
 POST https://api.agentmail.to/v0/agent/verify
@@ -12768,6 +13205,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # List Inboxes
 
 GET https://api.agentmail.to/v0/inboxes
@@ -13050,13 +13489,15 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Get Inbox
 
 GET https://api.agentmail.to/v0/inboxes/{inbox_id}
 
 **CLI:**
 ```bash
-agentmail inboxes retrieve --inbox-id <inbox_id>
+agentmail inboxes get --inbox-id <inbox_id>
 ```
 
 Reference: https://docs.agentmail.to/api-reference/inboxes/get
@@ -13076,7 +13517,7 @@ paths:
       description: |-
         **CLI:**
         ```bash
-        agentmail inboxes retrieve --inbox-id <inbox_id>
+        agentmail inboxes get --inbox-id <inbox_id>
         ```
       tags:
         - subpackage_inboxes
@@ -13315,6 +13756,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Create Inbox
 
 POST https://api.agentmail.to/v0/inboxes
@@ -13603,6 +14046,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Update Inbox
 
 PATCH https://api.agentmail.to/v0/inboxes/{inbox_id}
@@ -13910,6 +14355,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Delete Inbox
 
 DELETE https://api.agentmail.to/v0/inboxes/{inbox_id}
@@ -14127,6 +14574,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # List Threads
 
 GET https://api.agentmail.to/v0/inboxes/{inbox_id}/threads
@@ -14626,13 +15075,15 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Get Thread
 
 GET https://api.agentmail.to/v0/inboxes/{inbox_id}/threads/{thread_id}
 
 **CLI:**
 ```bash
-agentmail inboxes:threads retrieve --inbox-id <inbox_id> --thread-id <thread_id>
+agentmail inboxes:threads get --inbox-id <inbox_id> --thread-id <thread_id>
 ```
 
 Reference: https://docs.agentmail.to/api-reference/inboxes/threads/get
@@ -14654,7 +15105,7 @@ paths:
 
         ```bash
 
-        agentmail inboxes:threads retrieve --inbox-id <inbox_id> --thread-id
+        agentmail inboxes:threads get --inbox-id <inbox_id> --thread-id
         <thread_id>
 
         ```
@@ -15199,6 +15650,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Get Attachment
 
 GET https://api.agentmail.to/v0/inboxes/{inbox_id}/threads/{thread_id}/attachments/{attachment_id}
@@ -15495,6 +15948,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Update Thread
 
 PATCH https://api.agentmail.to/v0/inboxes/{inbox_id}/threads/{thread_id}
@@ -15804,6 +16259,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Delete Thread
 
 DELETE https://api.agentmail.to/v0/inboxes/{inbox_id}/threads/{thread_id}
@@ -16048,6 +16505,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # List Messages
 
 GET https://api.agentmail.to/v0/inboxes/{inbox_id}/messages
@@ -16566,13 +17025,15 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Get Message
 
 GET https://api.agentmail.to/v0/inboxes/{inbox_id}/messages/{message_id}
 
 **CLI:**
 ```bash
-agentmail inboxes:messages retrieve --inbox-id <inbox_id> --message-id <message_id>
+agentmail inboxes:messages get --inbox-id <inbox_id> --message-id <message_id>
 ```
 
 Reference: https://docs.agentmail.to/api-reference/inboxes/messages/get
@@ -16594,7 +17055,7 @@ paths:
 
         ```bash
 
-        agentmail inboxes:messages retrieve --inbox-id <inbox_id> --message-id
+        agentmail inboxes:messages get --inbox-id <inbox_id> --message-id
         <message_id>
 
         ```
@@ -17012,6 +17473,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Get Attachment
 
 GET https://api.agentmail.to/v0/inboxes/{inbox_id}/messages/{message_id}/attachments/{attachment_id}
@@ -17308,6 +17771,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Get Raw Message
 
 GET https://api.agentmail.to/v0/inboxes/{inbox_id}/messages/{message_id}/raw
@@ -17570,6 +18035,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Update Message
 
 PATCH https://api.agentmail.to/v0/inboxes/{inbox_id}/messages/{message_id}
@@ -17882,6 +18349,246 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
+# Delete Message
+
+DELETE https://api.agentmail.to/v0/inboxes/{inbox_id}/messages/{message_id}
+
+Permanently deletes a message.
+
+**CLI:**
+```bash
+agentmail inboxes:messages delete --inbox-id <inbox_id> --message-id <message_id>
+```
+
+Reference: https://docs.agentmail.to/api-reference/inboxes/messages/delete
+
+## OpenAPI Specification
+
+```yaml
+openapi: 3.1.0
+info:
+  title: api
+  version: 1.0.0
+paths:
+  /v0/inboxes/{inbox_id}/messages/{message_id}:
+    delete:
+      operationId: delete
+      summary: Delete Message
+      description: >-
+        Permanently deletes a message.
+
+
+        **CLI:**
+
+        ```bash
+
+        agentmail inboxes:messages delete --inbox-id <inbox_id> --message-id
+        <message_id>
+
+        ```
+      tags:
+        - subpackage_inboxes.subpackage_inboxes/messages
+      parameters:
+        - name: inbox_id
+          in: path
+          required: true
+          schema:
+            $ref: '#/components/schemas/type_inboxes:InboxId'
+        - name: message_id
+          in: path
+          required: true
+          schema:
+            $ref: '#/components/schemas/type_messages:MessageId'
+        - name: Authorization
+          in: header
+          description: Bearer authentication
+          required: true
+          schema:
+            type: string
+      responses:
+        '200':
+          description: Successful response
+        '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_inboxes:InboxId:
+      type: string
+      description: The ID of the inbox.
+      title: InboxId
+    type_messages:MessageId:
+      type: string
+      description: ID of message.
+      title: MessageId
+    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.inboxes.messages.delete("inbox_id", "message_id");
+}
+main();
+
+```
+
+```python
+from agentmail import AgentMail
+
+client = AgentMail(
+    api_key="YOUR_TOKEN_HERE",
+)
+
+client.inboxes.messages.delete(
+    inbox_id="inbox_id",
+    message_id="message_id",
+)
+
+```
+
+```go
+package main
+
+import (
+	"fmt"
+	"net/http"
+	"io"
+)
+
+func main() {
+
+	url := "https://api.agentmail.to/v0/inboxes/inbox_id/messages/message_id"
+
+	req, _ := http.NewRequest("DELETE", 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/inboxes/inbox_id/messages/message_id")
+
+http = Net::HTTP.new(url.host, url.port)
+http.use_ssl = true
+
+request = Net::HTTP::Delete.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.delete("https://api.agentmail.to/v0/inboxes/inbox_id/messages/message_id")
+  .header("Authorization", "Bearer <api_key>")
+  .asString();
+```
+
+```php
+<?php
+require_once('vendor/autoload.php');
+
+$client = new \GuzzleHttp\Client();
+
+$response = $client->request('DELETE', 'https://api.agentmail.to/v0/inboxes/inbox_id/messages/message_id', [
+  'headers' => [
+    'Authorization' => 'Bearer <api_key>',
+  ],
+]);
+
+echo $response->getBody();
+```
+
+```csharp
+using RestSharp;
+
+var client = new RestClient("https://api.agentmail.to/v0/inboxes/inbox_id/messages/message_id");
+var request = new RestRequest(Method.DELETE);
+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/inboxes/inbox_id/messages/message_id")! as URL,
+                                        cachePolicy: .useProtocolCachePolicy,
+                                    timeoutInterval: 10.0)
+request.httpMethod = "DELETE"
+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()
+```
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Send Message
 
 POST https://api.agentmail.to/v0/inboxes/{inbox_id}/messages/send
@@ -18288,6 +18995,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Reply To Message
 
 POST https://api.agentmail.to/v0/inboxes/{inbox_id}/messages/{message_id}/reply
@@ -18700,6 +19409,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Reply All Message
 
 POST https://api.agentmail.to/v0/inboxes/{inbox_id}/messages/{message_id}/reply-all
@@ -19088,6 +19799,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Forward Message
 
 POST https://api.agentmail.to/v0/inboxes/{inbox_id}/messages/{message_id}/forward
@@ -19500,6 +20213,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # List Drafts
 
 GET https://api.agentmail.to/v0/inboxes/{inbox_id}/drafts
@@ -19952,13 +20667,15 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Get Draft
 
 GET https://api.agentmail.to/v0/inboxes/{inbox_id}/drafts/{draft_id}
 
 **CLI:**
 ```bash
-agentmail inboxes:drafts retrieve --inbox-id <inbox_id> --draft-id <draft_id>
+agentmail inboxes:drafts get --inbox-id <inbox_id> --draft-id <draft_id>
 ```
 
 Reference: https://docs.agentmail.to/api-reference/inboxes/drafts/get
@@ -19975,14 +20692,10 @@ paths:
     get:
       operationId: get
       summary: Get Draft
-      description: >-
+      description: |-
         **CLI:**
-
         ```bash
-
-        agentmail inboxes:drafts retrieve --inbox-id <inbox_id> --draft-id
-        <draft_id>
-
+        agentmail inboxes:drafts get --inbox-id <inbox_id> --draft-id <draft_id>
         ```
       tags:
         - subpackage_inboxes.subpackage_inboxes/drafts
@@ -20372,6 +21085,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Get Attachment
 
 GET https://api.agentmail.to/v0/inboxes/{inbox_id}/drafts/{draft_id}/attachments/{attachment_id}
@@ -20668,6 +21383,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Create Draft
 
 POST https://api.agentmail.to/v0/inboxes/{inbox_id}/drafts
@@ -21156,6 +21873,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Update Draft
 
 PATCH https://api.agentmail.to/v0/inboxes/{inbox_id}/drafts/{draft_id}
@@ -21621,6 +22340,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Delete Draft
 
 DELETE https://api.agentmail.to/v0/inboxes/{inbox_id}/drafts/{draft_id}
@@ -21852,6 +22573,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Send Draft
 
 POST https://api.agentmail.to/v0/inboxes/{inbox_id}/drafts/{draft_id}/send
@@ -22172,6 +22895,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # List Entries
 
 GET https://api.agentmail.to/v0/inboxes/{inbox_id}/lists/{direction}/{type}
@@ -22486,13 +23211,15 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Get List Entry
 
 GET https://api.agentmail.to/v0/inboxes/{inbox_id}/lists/{direction}/{type}/{entry}
 
 **CLI:**
 ```bash
-agentmail inboxes:lists retrieve --inbox-id <inbox_id> --direction <direction> --type <type> --entry <entry>
+agentmail inboxes:lists get --inbox-id <inbox_id> --direction <direction> --type <type> --entry <entry>
 ```
 
 Reference: https://docs.agentmail.to/api-reference/inboxes/lists/get
@@ -22514,7 +23241,7 @@ paths:
 
         ```bash
 
-        agentmail inboxes:lists retrieve --inbox-id <inbox_id> --direction
+        agentmail inboxes:lists get --inbox-id <inbox_id> --direction
         <direction> --type <type> --entry <entry>
 
         ```
@@ -22792,6 +23519,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Create List Entry
 
 POST https://api.agentmail.to/v0/inboxes/{inbox_id}/lists/{direction}/{type}
@@ -23129,6 +23858,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Delete List Entry
 
 DELETE https://api.agentmail.to/v0/inboxes/{inbox_id}/lists/{direction}/{type}/{entry}
@@ -23384,6 +24115,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Query Metrics
 
 GET https://api.agentmail.to/v0/inboxes/{inbox_id}/metrics
@@ -23693,6 +24426,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # List API Keys
 
 GET https://api.agentmail.to/v0/inboxes/{inbox_id}/api-keys
@@ -24114,6 +24849,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Create API Key
 
 POST https://api.agentmail.to/v0/inboxes/{inbox_id}/api-keys
@@ -24315,8 +25052,6 @@ components:
           $ref: '#/components/schemas/type_api-keys:Name'
         permissions:
           $ref: '#/components/schemas/type_api-keys:ApiKeyPermissions'
-      required:
-        - name
       title: CreateApiKeyRequest
     type_api-keys:ApiKeyId:
       type: string
@@ -24406,9 +25141,7 @@ async function main() {
     const client = new AgentMailClient({
         apiKey: "YOUR_TOKEN_HERE",
     });
-    await client.inboxes.apiKeys.create("inbox_id", {
-        name: "name",
-    });
+    await client.inboxes.apiKeys.create("inbox_id", {});
 }
 main();
 
@@ -24423,7 +25156,6 @@ client = AgentMail(
 
 client.inboxes.api_keys.create(
     inbox_id="inbox_id",
-    name="name",
 )
 
 ```
@@ -24442,7 +25174,7 @@ func main() {
 
 	url := "https://api.agentmail.to/v0/inboxes/inbox_id/api-keys"
 
-	payload := strings.NewReader("{\n  \"name\": \"name\"\n}")
+	payload := strings.NewReader("{}")
 
 	req, _ := http.NewRequest("POST", url, payload)
 
@@ -24472,7 +25204,7 @@ http.use_ssl = true
 request = Net::HTTP::Post.new(url)
 request["Authorization"] = 'Bearer <api_key>'
 request["Content-Type"] = 'application/json'
-request.body = "{\n  \"name\": \"name\"\n}"
+request.body = "{}"
 
 response = http.request(request)
 puts response.read_body
@@ -24485,7 +25217,7 @@ import com.mashape.unirest.http.Unirest;
 HttpResponse<String> response = Unirest.post("https://api.agentmail.to/v0/inboxes/inbox_id/api-keys")
   .header("Authorization", "Bearer <api_key>")
   .header("Content-Type", "application/json")
-  .body("{\n  \"name\": \"name\"\n}")
+  .body("{}")
   .asString();
 ```
 
@@ -24496,9 +25228,7 @@ require_once('vendor/autoload.php');
 $client = new \GuzzleHttp\Client();
 
 $response = $client->request('POST', 'https://api.agentmail.to/v0/inboxes/inbox_id/api-keys', [
-  'body' => '{
-  "name": "name"
-}',
+  'body' => '{}',
   'headers' => [
     'Authorization' => 'Bearer <api_key>',
     'Content-Type' => 'application/json',
@@ -24515,7 +25245,7 @@ var client = new RestClient("https://api.agentmail.to/v0/inboxes/inbox_id/api-ke
 var request = new RestRequest(Method.POST);
 request.AddHeader("Authorization", "Bearer <api_key>");
 request.AddHeader("Content-Type", "application/json");
-request.AddParameter("application/json", "{\n  \"name\": \"name\"\n}", ParameterType.RequestBody);
+request.AddParameter("application/json", "{}", ParameterType.RequestBody);
 IRestResponse response = client.Execute(request);
 ```
 
@@ -24526,7 +25256,7 @@ let headers = [
   "Authorization": "Bearer <api_key>",
   "Content-Type": "application/json"
 ]
-let parameters = ["name": "name"] as [String : Any]
+let parameters = [] as [String : Any]
 
 let postData = JSONSerialization.data(withJSONObject: parameters, options: [])
 
@@ -24550,6 +25280,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Delete API Key
 
 DELETE https://api.agentmail.to/v0/inboxes/{inbox_id}/api-keys/{api_key_id}
@@ -24781,6 +25513,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # List Threads
 
 GET https://api.agentmail.to/v0/threads
@@ -25273,13 +26007,15 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Get Thread
 
 GET https://api.agentmail.to/v0/threads/{thread_id}
 
 **CLI:**
 ```bash
-agentmail threads retrieve --thread-id <thread_id>
+agentmail threads get --thread-id <thread_id>
 ```
 
 Reference: https://docs.agentmail.to/api-reference/threads/get
@@ -25299,7 +26035,7 @@ paths:
       description: |-
         **CLI:**
         ```bash
-        agentmail threads retrieve --thread-id <thread_id>
+        agentmail threads get --thread-id <thread_id>
         ```
       tags:
         - subpackage_threads
@@ -25836,13 +26572,15 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Get Attachment
 
 GET https://api.agentmail.to/v0/threads/{thread_id}/attachments/{attachment_id}
 
 **CLI:**
 ```bash
-agentmail threads retrieve-attachment --thread-id <thread_id> --attachment-id <attachment_id>
+agentmail threads get-attachment --thread-id <thread_id> --attachment-id <attachment_id>
 ```
 
 Reference: https://docs.agentmail.to/api-reference/threads/get-attachment
@@ -25864,8 +26602,8 @@ paths:
 
         ```bash
 
-        agentmail threads retrieve-attachment --thread-id <thread_id>
-        --attachment-id <attachment_id>
+        agentmail threads get-attachment --thread-id <thread_id> --attachment-id
+        <attachment_id>
 
         ```
       tags:
@@ -26122,6 +26860,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Update Thread
 
 PATCH https://api.agentmail.to/v0/threads/{thread_id}
@@ -26421,6 +27161,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Delete Thread
 
 DELETE https://api.agentmail.to/v0/threads/{thread_id}
@@ -26654,6 +27396,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # List Drafts
 
 GET https://api.agentmail.to/v0/drafts
@@ -27099,13 +27843,15 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Get Draft
 
 GET https://api.agentmail.to/v0/drafts/{draft_id}
 
 **CLI:**
 ```bash
-agentmail drafts retrieve --draft-id <draft_id>
+agentmail drafts get --draft-id <draft_id>
 ```
 
 Reference: https://docs.agentmail.to/api-reference/drafts/get
@@ -27125,7 +27871,7 @@ paths:
       description: |-
         **CLI:**
         ```bash
-        agentmail drafts retrieve --draft-id <draft_id>
+        agentmail drafts get --draft-id <draft_id>
         ```
       tags:
         - subpackage_drafts
@@ -27509,6 +28255,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Get Attachment
 
 GET https://api.agentmail.to/v0/drafts/{draft_id}/attachments/{attachment_id}
@@ -27795,6 +28543,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # List Webhooks
 
 GET https://api.agentmail.to/v0/webhooks
@@ -27889,6 +28639,8 @@ components:
       type: string
       enum:
         - message.received
+        - message.received.spam
+        - message.received.blocked
         - message.sent
         - message.delivered
         - message.bounced
@@ -28107,13 +28859,15 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Get Webhook
 
 GET https://api.agentmail.to/v0/webhooks/{webhook_id}
 
 **CLI:**
 ```bash
-agentmail webhooks retrieve --webhook-id <webhook_id>
+agentmail webhooks get --webhook-id <webhook_id>
 ```
 
 Reference: https://docs.agentmail.to/api-reference/webhooks/get
@@ -28133,7 +28887,7 @@ paths:
       description: |-
         **CLI:**
         ```bash
-        agentmail webhooks retrieve --webhook-id <webhook_id>
+        agentmail webhooks get --webhook-id <webhook_id>
         ```
       tags:
         - subpackage_webhooks
@@ -28181,6 +28935,8 @@ components:
       type: string
       enum:
         - message.received
+        - message.received.spam
+        - message.received.blocked
         - message.sent
         - message.delivered
         - message.bounced
@@ -28402,6 +29158,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Create Webhook
 
 POST https://api.agentmail.to/v0/webhooks
@@ -28477,6 +29235,8 @@ components:
       type: string
       enum:
         - message.received
+        - message.received.spam
+        - message.received.blocked
         - message.sent
         - message.delivered
         - message.bounced
@@ -28753,6 +29513,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Update Webhook
 
 PATCH https://api.agentmail.to/v0/webhooks/{webhook_id}
@@ -28871,6 +29633,8 @@ components:
       type: string
       enum:
         - message.received
+        - message.received.spam
+        - message.received.blocked
         - message.sent
         - message.delivered
         - message.bounced
@@ -29110,6 +29874,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Delete Webhook
 
 DELETE https://api.agentmail.to/v0/webhooks/{webhook_id}
@@ -29327,6 +30093,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Message Received
 
 POST 
@@ -29756,6 +30524,8 @@ components:
 
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Message Sent
 
 POST 
@@ -29882,6 +30652,8 @@ components:
 
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Message Delivered
 
 POST 
@@ -30008,6 +30780,8 @@ components:
 
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Message Bounced
 
 POST 
@@ -30155,6 +30929,8 @@ components:
 
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Message Complained
 
 POST 
@@ -30289,6 +31065,8 @@ components:
 
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Message Rejected
 
 POST 
@@ -30413,6 +31191,8 @@ components:
 
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Domain Verified
 
 POST 
@@ -30608,6 +31388,8 @@ components:
 
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Connect
 
 GET /v0
@@ -30640,19 +31422,23 @@ channels:
           - $ref: >-
               #/components/messages/subpackage_websockets.websockets-server-1-message_received
           - $ref: >-
-              #/components/messages/subpackage_websockets.websockets-server-2-message_sent
+              #/components/messages/subpackage_websockets.websockets-server-2-message_received_spam
+          - $ref: >-
+              #/components/messages/subpackage_websockets.websockets-server-3-message_received_blocked
           - $ref: >-
-              #/components/messages/subpackage_websockets.websockets-server-3-message_delivered
+              #/components/messages/subpackage_websockets.websockets-server-4-message_sent
           - $ref: >-
-              #/components/messages/subpackage_websockets.websockets-server-4-message_bounced
+              #/components/messages/subpackage_websockets.websockets-server-5-message_delivered
           - $ref: >-
-              #/components/messages/subpackage_websockets.websockets-server-5-message_complained
+              #/components/messages/subpackage_websockets.websockets-server-6-message_bounced
           - $ref: >-
-              #/components/messages/subpackage_websockets.websockets-server-6-message_rejected
+              #/components/messages/subpackage_websockets.websockets-server-7-message_complained
           - $ref: >-
-              #/components/messages/subpackage_websockets.websockets-server-7-domain_verified
+              #/components/messages/subpackage_websockets.websockets-server-8-message_rejected
           - $ref: >-
-              #/components/messages/subpackage_websockets.websockets-server-8-error
+              #/components/messages/subpackage_websockets.websockets-server-9-domain_verified
+          - $ref: >-
+              #/components/messages/subpackage_websockets.websockets-server-10-error
     subscribe:
       operationId: websockets-subscribe
       summary: Client message
@@ -30684,31 +31470,39 @@ components:
       name: message_received
       payload:
         $ref: '#/components/schemas/type_events:MessageReceivedEvent'
-    subpackage_websockets.websockets-server-2-message_sent:
+    subpackage_websockets.websockets-server-2-message_received_spam:
+      name: message_received_spam
+      payload:
+        $ref: '#/components/schemas/type_events:MessageReceivedSpamEvent'
+    subpackage_websockets.websockets-server-3-message_received_blocked:
+      name: message_received_blocked
+      payload:
+        $ref: '#/components/schemas/type_events:MessageReceivedBlockedEvent'
+    subpackage_websockets.websockets-server-4-message_sent:
       name: message_sent
       payload:
         $ref: '#/components/schemas/type_events:MessageSentEvent'
-    subpackage_websockets.websockets-server-3-message_delivered:
+    subpackage_websockets.websockets-server-5-message_delivered:
       name: message_delivered
       payload:
         $ref: '#/components/schemas/type_events:MessageDeliveredEvent'
-    subpackage_websockets.websockets-server-4-message_bounced:
+    subpackage_websockets.websockets-server-6-message_bounced:
       name: message_bounced
       payload:
         $ref: '#/components/schemas/type_events:MessageBouncedEvent'
-    subpackage_websockets.websockets-server-5-message_complained:
+    subpackage_websockets.websockets-server-7-message_complained:
       name: message_complained
       payload:
         $ref: '#/components/schemas/type_events:MessageComplainedEvent'
-    subpackage_websockets.websockets-server-6-message_rejected:
+    subpackage_websockets.websockets-server-8-message_rejected:
       name: message_rejected
       payload:
         $ref: '#/components/schemas/type_events:MessageRejectedEvent'
-    subpackage_websockets.websockets-server-7-domain_verified:
+    subpackage_websockets.websockets-server-9-domain_verified:
       name: domain_verified
       payload:
         $ref: '#/components/schemas/type_events:DomainVerifiedEvent'
-    subpackage_websockets.websockets-server-8-error:
+    subpackage_websockets.websockets-server-10-error:
       name: error
       payload:
         $ref: '#/components/schemas/type_websockets:Error'
@@ -30717,6 +31511,8 @@ components:
       type: string
       enum:
         - message.received
+        - message.received.spam
+        - message.received.blocked
         - message.sent
         - message.delivered
         - message.bounced
@@ -31126,6 +31922,60 @@ components:
         - message
         - thread
       title: MessageReceivedEvent
+    type_events:MessageReceivedSpamEvent:
+      type: object
+      properties:
+        type:
+          type: string
+          enum:
+            - event
+        event_type:
+          type: string
+          enum:
+            - message.received.spam
+        event_id:
+          $ref: '#/components/schemas/type_events:EventId'
+        message:
+          $ref: '#/components/schemas/type_messages:Message'
+        thread:
+          $ref: '#/components/schemas/type_threads:ThreadItem'
+      required:
+        - type
+        - event_type
+        - event_id
+        - message
+        - thread
+      description: >-
+        A message was received and classified as spam. Requires
+        `label_spam_read` permission.
+      title: MessageReceivedSpamEvent
+    type_events:MessageReceivedBlockedEvent:
+      type: object
+      properties:
+        type:
+          type: string
+          enum:
+            - event
+        event_type:
+          type: string
+          enum:
+            - message.received.blocked
+        event_id:
+          $ref: '#/components/schemas/type_events:EventId'
+        message:
+          $ref: '#/components/schemas/type_messages:Message'
+        thread:
+          $ref: '#/components/schemas/type_threads:ThreadItem'
+      required:
+        - type
+        - event_type
+        - event_id
+        - message
+        - thread
+      description: >-
+        A message was received and matched a block list entry. Requires
+        `label_blocked_read` permission.
+      title: MessageReceivedBlockedEvent
     type_events:Timestamp:
       type: string
       format: date-time
@@ -31551,6 +32401,8 @@ components:
 
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # List Domains
 
 GET https://api.agentmail.to/v0/domains
@@ -31833,13 +32685,15 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Get Domain
 
 GET https://api.agentmail.to/v0/domains/{domain_id}
 
 **CLI:**
 ```bash
-agentmail domains retrieve --domain-id <domain_id>
+agentmail domains get --domain-id <domain_id>
 ```
 
 Reference: https://docs.agentmail.to/api-reference/domains/get
@@ -31859,7 +32713,7 @@ paths:
       description: |-
         **CLI:**
         ```bash
-        agentmail domains retrieve --domain-id <domain_id>
+        agentmail domains get --domain-id <domain_id>
         ```
       tags:
         - subpackage_domains
@@ -32159,6 +33013,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Get Zone File
 
 GET https://api.agentmail.to/v0/domains/{domain_id}/zone-file
@@ -32381,6 +33237,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Create Domain
 
 POST https://api.agentmail.to/v0/domains
@@ -32744,6 +33602,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Update Domain
 
 PATCH https://api.agentmail.to/v0/domains/{domain_id}
@@ -33101,6 +33961,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Delete Domain
 
 DELETE https://api.agentmail.to/v0/domains/{domain_id}
@@ -33318,6 +34180,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Verify Domain
 
 POST https://api.agentmail.to/v0/domains/{domain_id}/verify
@@ -33535,6 +34399,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # List Entries
 
 GET https://api.agentmail.to/v0/lists/{direction}/{type}
@@ -33828,13 +34694,15 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Get List Entry
 
 GET https://api.agentmail.to/v0/lists/{direction}/{type}/{entry}
 
 **CLI:**
 ```bash
-agentmail lists retrieve --direction <direction> --type <type> --entry <entry>
+agentmail lists get --direction <direction> --type <type> --entry <entry>
 ```
 
 Reference: https://docs.agentmail.to/api-reference/lists/get
@@ -33856,7 +34724,7 @@ paths:
 
         ```bash
 
-        agentmail lists retrieve --direction <direction> --type <type> --entry
+        agentmail lists get --direction <direction> --type <type> --entry
         <entry>
 
         ```
@@ -34117,6 +34985,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Create List Entry
 
 POST https://api.agentmail.to/v0/lists/{direction}/{type}
@@ -34437,6 +35307,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Delete List Entry
 
 DELETE https://api.agentmail.to/v0/lists/{direction}/{type}/{entry}
@@ -34682,6 +35554,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Query Metrics
 
 GET https://api.agentmail.to/v0/metrics
@@ -34980,6 +35854,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # List API Keys
 
 GET https://api.agentmail.to/v0/api-keys
@@ -35374,6 +36250,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Create API Key
 
 POST https://api.agentmail.to/v0/api-keys
@@ -35560,8 +36438,6 @@ components:
           $ref: '#/components/schemas/type_api-keys:Name'
         permissions:
           $ref: '#/components/schemas/type_api-keys:ApiKeyPermissions'
-      required:
-        - name
       title: CreateApiKeyRequest
     type_api-keys:ApiKeyId:
       type: string
@@ -35636,9 +36512,7 @@ async function main() {
     const client = new AgentMailClient({
         apiKey: "YOUR_TOKEN_HERE",
     });
-    await client.apiKeys.create({
-        name: "name",
-    });
+    await client.apiKeys.create({});
 }
 main();
 
@@ -35651,9 +36525,7 @@ client = AgentMail(
     api_key="YOUR_TOKEN_HERE",
 )
 
-client.api_keys.create(
-    name="name",
-)
+client.api_keys.create()
 
 ```
 
@@ -35671,7 +36543,7 @@ func main() {
 
 	url := "https://api.agentmail.to/v0/api-keys"
 
-	payload := strings.NewReader("{\n  \"name\": \"name\"\n}")
+	payload := strings.NewReader("{}")
 
 	req, _ := http.NewRequest("POST", url, payload)
 
@@ -35701,7 +36573,7 @@ http.use_ssl = true
 request = Net::HTTP::Post.new(url)
 request["Authorization"] = 'Bearer <api_key>'
 request["Content-Type"] = 'application/json'
-request.body = "{\n  \"name\": \"name\"\n}"
+request.body = "{}"
 
 response = http.request(request)
 puts response.read_body
@@ -35714,7 +36586,7 @@ import com.mashape.unirest.http.Unirest;
 HttpResponse<String> response = Unirest.post("https://api.agentmail.to/v0/api-keys")
   .header("Authorization", "Bearer <api_key>")
   .header("Content-Type", "application/json")
-  .body("{\n  \"name\": \"name\"\n}")
+  .body("{}")
   .asString();
 ```
 
@@ -35725,9 +36597,7 @@ require_once('vendor/autoload.php');
 $client = new \GuzzleHttp\Client();
 
 $response = $client->request('POST', 'https://api.agentmail.to/v0/api-keys', [
-  'body' => '{
-  "name": "name"
-}',
+  'body' => '{}',
   'headers' => [
     'Authorization' => 'Bearer <api_key>',
     'Content-Type' => 'application/json',
@@ -35744,7 +36614,7 @@ var client = new RestClient("https://api.agentmail.to/v0/api-keys");
 var request = new RestRequest(Method.POST);
 request.AddHeader("Authorization", "Bearer <api_key>");
 request.AddHeader("Content-Type", "application/json");
-request.AddParameter("application/json", "{\n  \"name\": \"name\"\n}", ParameterType.RequestBody);
+request.AddParameter("application/json", "{}", ParameterType.RequestBody);
 IRestResponse response = client.Execute(request);
 ```
 
@@ -35755,7 +36625,7 @@ let headers = [
   "Authorization": "Bearer <api_key>",
   "Content-Type": "application/json"
 ]
-let parameters = ["name": "name"] as [String : Any]
+let parameters = [] as [String : Any]
 
 let postData = JSONSerialization.data(withJSONObject: parameters, options: [])
 
@@ -35779,6 +36649,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Delete API Key
 
 DELETE https://api.agentmail.to/v0/api-keys/{api_key_id}
@@ -35996,6 +36868,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # List Pods
 
 GET https://api.agentmail.to/v0/pods
@@ -36265,13 +37139,15 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Get Pod
 
 GET https://api.agentmail.to/v0/pods/{pod_id}
 
 **CLI:**
 ```bash
-agentmail pods retrieve --pod-id <pod_id>
+agentmail pods get --pod-id <pod_id>
 ```
 
 Reference: https://docs.agentmail.to/api-reference/pods/get
@@ -36291,7 +37167,7 @@ paths:
       description: |-
         **CLI:**
         ```bash
-        agentmail pods retrieve --pod-id <pod_id>
+        agentmail pods get --pod-id <pod_id>
         ```
       tags:
         - subpackage_pods
@@ -36517,6 +37393,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Create Pod
 
 POST https://api.agentmail.to/v0/pods
@@ -36791,6 +37669,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Delete Pod
 
 DELETE https://api.agentmail.to/v0/pods/{pod_id}
@@ -37008,6 +37888,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # List Inboxes
 
 GET https://api.agentmail.to/v0/pods/{pod_id}/inboxes
@@ -37322,13 +38204,15 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Get Inbox
 
 GET https://api.agentmail.to/v0/pods/{pod_id}/inboxes/{inbox_id}
 
 **CLI:**
 ```bash
-agentmail pods:inboxes retrieve --pod-id <pod_id> --inbox-id <inbox_id>
+agentmail pods:inboxes get --pod-id <pod_id> --inbox-id <inbox_id>
 ```
 
 Reference: https://docs.agentmail.to/api-reference/pods/inboxes/get
@@ -37348,7 +38232,7 @@ paths:
       description: |-
         **CLI:**
         ```bash
-        agentmail pods:inboxes retrieve --pod-id <pod_id> --inbox-id <inbox_id>
+        agentmail pods:inboxes get --pod-id <pod_id> --inbox-id <inbox_id>
         ```
       tags:
         - subpackage_pods.subpackage_pods/inboxes
@@ -37593,6 +38477,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Create Inbox
 
 POST https://api.agentmail.to/v0/pods/{pod_id}/inboxes
@@ -37899,6 +38785,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Update Inbox
 
 PATCH https://api.agentmail.to/v0/pods/{pod_id}/inboxes/{inbox_id}
@@ -38208,6 +39096,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Delete Inbox
 
 DELETE https://api.agentmail.to/v0/pods/{pod_id}/inboxes/{inbox_id}
@@ -38435,6 +39325,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # List Threads
 
 GET https://api.agentmail.to/v0/pods/{pod_id}/threads
@@ -38938,13 +39830,15 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Get Thread
 
 GET https://api.agentmail.to/v0/pods/{pod_id}/threads/{thread_id}
 
 **CLI:**
 ```bash
-agentmail pods:threads retrieve --pod-id <pod_id> --thread-id <thread_id>
+agentmail pods:threads get --pod-id <pod_id> --thread-id <thread_id>
 ```
 
 Reference: https://docs.agentmail.to/api-reference/pods/threads/get
@@ -38961,14 +39855,10 @@ paths:
     get:
       operationId: get
       summary: Get Thread
-      description: >-
+      description: |-
         **CLI:**
-
         ```bash
-
-        agentmail pods:threads retrieve --pod-id <pod_id> --thread-id
-        <thread_id>
-
+        agentmail pods:threads get --pod-id <pod_id> --thread-id <thread_id>
         ```
       tags:
         - subpackage_pods.subpackage_pods/threads
@@ -39515,6 +40405,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Get Attachment
 
 GET https://api.agentmail.to/v0/pods/{pod_id}/threads/{thread_id}/attachments/{attachment_id}
@@ -39811,6 +40703,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Update Thread
 
 PATCH https://api.agentmail.to/v0/pods/{pod_id}/threads/{thread_id}
@@ -40120,6 +41014,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Delete Thread
 
 DELETE https://api.agentmail.to/v0/pods/{pod_id}/threads/{thread_id}
@@ -40363,6 +41259,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # List Drafts
 
 GET https://api.agentmail.to/v0/pods/{pod_id}/drafts
@@ -40819,13 +41717,15 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Get Draft
 
 GET https://api.agentmail.to/v0/pods/{pod_id}/drafts/{draft_id}
 
 **CLI:**
 ```bash
-agentmail pods:drafts retrieve --pod-id <pod_id> --draft-id <draft_id>
+agentmail pods:drafts get --pod-id <pod_id> --draft-id <draft_id>
 ```
 
 Reference: https://docs.agentmail.to/api-reference/pods/drafts/get
@@ -40845,7 +41745,7 @@ paths:
       description: |-
         **CLI:**
         ```bash
-        agentmail pods:drafts retrieve --pod-id <pod_id> --draft-id <draft_id>
+        agentmail pods:drafts get --pod-id <pod_id> --draft-id <draft_id>
         ```
       tags:
         - subpackage_pods.subpackage_pods/drafts
@@ -41239,6 +42139,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Get Attachment
 
 GET https://api.agentmail.to/v0/pods/{pod_id}/drafts/{draft_id}/attachments/{attachment_id}
@@ -41535,6 +42437,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # List Domains
 
 GET https://api.agentmail.to/v0/pods/{pod_id}/domains
@@ -41849,13 +42753,15 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Get Domain
 
 GET https://api.agentmail.to/v0/pods/{pod_id}/domains/{domain_id}
 
 **CLI:**
 ```bash
-agentmail pods:domains retrieve --pod-id <pod_id> --domain-id <domain_id>
+agentmail pods:domains get --pod-id <pod_id> --domain-id <domain_id>
 ```
 
 Reference: https://docs.agentmail.to/api-reference/pods/domains/get
@@ -41872,14 +42778,10 @@ paths:
     get:
       operationId: get
       summary: Get Domain
-      description: >-
+      description: |-
         **CLI:**
-
         ```bash
-
-        agentmail pods:domains retrieve --pod-id <pod_id> --domain-id
-        <domain_id>
-
+        agentmail pods:domains get --pod-id <pod_id> --domain-id <domain_id>
         ```
       tags:
         - subpackage_pods.subpackage_pods/domains
@@ -42185,6 +43087,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Get Zone File
 
 GET https://api.agentmail.to/v0/pods/{pod_id}/domains/{domain_id}/zone-file
@@ -42421,6 +43325,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Create Domain
 
 POST https://api.agentmail.to/v0/pods/{pod_id}/domains
@@ -42790,6 +43696,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Update Domain
 
 PATCH https://api.agentmail.to/v0/pods/{pod_id}/domains/{domain_id}
@@ -43153,6 +44061,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Delete Domain
 
 DELETE https://api.agentmail.to/v0/pods/{pod_id}/domains/{domain_id}
@@ -43380,6 +44290,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Verify Domain
 
 POST https://api.agentmail.to/v0/pods/{pod_id}/domains/{domain_id}/verify
@@ -43607,6 +44519,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # List Entries
 
 GET https://api.agentmail.to/v0/pods/{pod_id}/lists/{direction}/{type}
@@ -43921,13 +44835,15 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Get List Entry
 
 GET https://api.agentmail.to/v0/pods/{pod_id}/lists/{direction}/{type}/{entry}
 
 **CLI:**
 ```bash
-agentmail pods:lists retrieve --pod-id <pod_id> --direction <direction> --type <type> --entry <entry>
+agentmail pods:lists get --pod-id <pod_id> --direction <direction> --type <type> --entry <entry>
 ```
 
 Reference: https://docs.agentmail.to/api-reference/pods/lists/get
@@ -43949,7 +44865,7 @@ paths:
 
         ```bash
 
-        agentmail pods:lists retrieve --pod-id <pod_id> --direction <direction>
+        agentmail pods:lists get --pod-id <pod_id> --direction <direction>
         --type <type> --entry <entry>
 
         ```
@@ -44227,6 +45143,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Create List Entry
 
 POST https://api.agentmail.to/v0/pods/{pod_id}/lists/{direction}/{type}
@@ -44564,6 +45482,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Delete List Entry
 
 DELETE https://api.agentmail.to/v0/pods/{pod_id}/lists/{direction}/{type}/{entry}
@@ -44819,6 +45739,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Query Metrics
 
 GET https://api.agentmail.to/v0/pods/{pod_id}/metrics
@@ -45128,6 +46050,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # List API Keys
 
 GET https://api.agentmail.to/v0/pods/{pod_id}/api-keys
@@ -45549,6 +46473,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Create API Key
 
 POST https://api.agentmail.to/v0/pods/{pod_id}/api-keys
@@ -45750,8 +46676,6 @@ components:
           $ref: '#/components/schemas/type_api-keys:Name'
         permissions:
           $ref: '#/components/schemas/type_api-keys:ApiKeyPermissions'
-      required:
-        - name
       title: CreateApiKeyRequest
     type_api-keys:ApiKeyId:
       type: string
@@ -45841,9 +46765,7 @@ async function main() {
     const client = new AgentMailClient({
         apiKey: "YOUR_TOKEN_HERE",
     });
-    await client.pods.apiKeys.create("pod_id", {
-        name: "name",
-    });
+    await client.pods.apiKeys.create("pod_id", {});
 }
 main();
 
@@ -45858,7 +46780,6 @@ client = AgentMail(
 
 client.pods.api_keys.create(
     pod_id="pod_id",
-    name="name",
 )
 
 ```
@@ -45877,7 +46798,7 @@ func main() {
 
 	url := "https://api.agentmail.to/v0/pods/pod_id/api-keys"
 
-	payload := strings.NewReader("{\n  \"name\": \"name\"\n}")
+	payload := strings.NewReader("{}")
 
 	req, _ := http.NewRequest("POST", url, payload)
 
@@ -45907,7 +46828,7 @@ http.use_ssl = true
 request = Net::HTTP::Post.new(url)
 request["Authorization"] = 'Bearer <api_key>'
 request["Content-Type"] = 'application/json'
-request.body = "{\n  \"name\": \"name\"\n}"
+request.body = "{}"
 
 response = http.request(request)
 puts response.read_body
@@ -45920,7 +46841,7 @@ import com.mashape.unirest.http.Unirest;
 HttpResponse<String> response = Unirest.post("https://api.agentmail.to/v0/pods/pod_id/api-keys")
   .header("Authorization", "Bearer <api_key>")
   .header("Content-Type", "application/json")
-  .body("{\n  \"name\": \"name\"\n}")
+  .body("{}")
   .asString();
 ```
 
@@ -45931,9 +46852,7 @@ require_once('vendor/autoload.php');
 $client = new \GuzzleHttp\Client();
 
 $response = $client->request('POST', 'https://api.agentmail.to/v0/pods/pod_id/api-keys', [
-  'body' => '{
-  "name": "name"
-}',
+  'body' => '{}',
   'headers' => [
     'Authorization' => 'Bearer <api_key>',
     'Content-Type' => 'application/json',
@@ -45950,7 +46869,7 @@ var client = new RestClient("https://api.agentmail.to/v0/pods/pod_id/api-keys");
 var request = new RestRequest(Method.POST);
 request.AddHeader("Authorization", "Bearer <api_key>");
 request.AddHeader("Content-Type", "application/json");
-request.AddParameter("application/json", "{\n  \"name\": \"name\"\n}", ParameterType.RequestBody);
+request.AddParameter("application/json", "{}", ParameterType.RequestBody);
 IRestResponse response = client.Execute(request);
 ```
 
@@ -45961,7 +46880,7 @@ let headers = [
   "Authorization": "Bearer <api_key>",
   "Content-Type": "application/json"
 ]
-let parameters = ["name": "name"] as [String : Any]
+let parameters = [] as [String : Any]
 
 let postData = JSONSerialization.data(withJSONObject: parameters, options: [])
 
@@ -45985,6 +46904,8 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Delete API Key
 
 DELETE https://api.agentmail.to/v0/pods/{pod_id}/api-keys/{api_key_id}
@@ -46216,11 +47137,18 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
 # Get Organization
 
 GET https://api.agentmail.to/v0/organizations
 
-Get the current organization.
+Returns the organization for the authenticated API key (usage limits, counts, and billing metadata).
+
+**CLI:**
+```bash
+agentmail organizations get
+```
 
 Reference: https://docs.agentmail.to/api-reference/organizations/get
 
@@ -46236,7 +47164,18 @@ paths:
     get:
       operationId: get
       summary: Get Organization
-      description: Get the current organization.
+      description: >-
+        Returns the organization for the authenticated API key (usage limits,
+        counts, and billing metadata).
+
+
+        **CLI:**
+
+        ```bash
+
+        agentmail organizations get
+
+        ```
       tags:
         - subpackage_organizations
       parameters:
@@ -46451,7 +47390,9 @@ dataTask.resume()
 title: Knowledge Base
 subtitle: A collection of answers to frequently asked questions.
 slug: knowledge-base
---------------------
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 ## Getting Started
 
@@ -46543,6 +47484,10 @@ slug: knowledge-base
   <Card title="Emails bouncing" icon="fa-solid fa-rotate-left" href="/knowledge-base/emails-bouncing">
     Diagnose and resolve email bounce issues.
   </Card>
+
+  <Card title="Email spoofing protection" icon="fa-solid fa-shield-halved" href="/knowledge-base/inbound-emails-missing">
+    How AgentMail protects your inboxes from unauthenticated senders.
+  </Card>
 </Cards>
 
 ## DNS Guides
@@ -46567,13 +47512,14 @@ Step-by-step instructions for verifying your domain with popular DNS providers.
   </Card>
 </Cards>
 
-
 ***
 
 title: What is AgentMail and how is it different?
 subtitle: Understand how AgentMail compares to traditional email providers.
 slug: knowledge-base/what-is-agentmail
---------------------------------------
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 AgentMail is email infrastructure built specifically for AI agents. Unlike transactional email APIs that focus on one-way sending, AgentMail is built for two-way agent communication: dedicated inboxes, native threading, and full receiving support with no shared sending domains.
 
@@ -46606,13 +47552,14 @@ AgentMail is the right choice when:
 
 Yes. AgentMail's send API works similarly. Replace your existing send call with `client.inboxes.messages.send()` and you get the same sending capability plus full receiving, threading, and agent identity features on top. See the [Quickstart](/quickstart) to get started in minutes.
 
-
 ***
 
 title: What can I do with an AgentMail inbox?
 subtitle: A complete overview of inbox capabilities for AI agents.
 slug: knowledge-base/inbox-capabilities
----------------------------------------
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 An AgentMail inbox is a full email account for your AI agent. Each inbox gets a unique email address and can send, receive, reply, forward, and manage emails entirely through the API.
 
@@ -46704,13 +47651,14 @@ if threads.threads:
     )
 ```
 
-
 ***
 
 title: How do I create my first inbox?
 subtitle: Get up and running with your first AgentMail inbox.
 slug: knowledge-base/creating-first-inbox
------------------------------------------
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 Creating an inbox gives your AI agent its own email address. You can create inboxes on the default `@agentmail.to` domain or on your own custom domain.
 
@@ -46803,13 +47751,14 @@ Now that you have an inbox, explore what you can do with it:
 * [Set up webhooks](/webhook-setup) to get notified when emails arrive
 * [Use labels](/labels) to track message state in your agent workflows
 
-
 ***
 
 title: How do I get my API key?
 subtitle: Create and manage your AgentMail API keys.
 slug: knowledge-base/getting-api-key
-------------------------------------
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 You need an API key to authenticate requests to the AgentMail API. API keys start with `am_` and are created in the AgentMail Console.
 
@@ -46873,13 +47822,14 @@ No credit card required to get started. The free tier includes:
 
 To create more inboxes or send higher volumes, see the [pricing page](https://agentmail.to/pricing).
 
-
 ***
 
 title: How do I handle inbound emails with my agent?
 subtitle: Compare Webhooks and WebSockets for processing incoming emails.
 slug: knowledge-base/handling-inbound-emails
---------------------------------------------
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 AgentMail offers two ways to process incoming emails, each suited to different use cases.
 
@@ -46983,13 +47933,14 @@ See the [WebSocket Overview](/websockets) for more details.
 
 For most production use cases, **webhooks** are recommended. They are reliable, event-driven, and integrate well with serverless platforms. If you need real-time events without exposing a public URL, **WebSockets** are the best option.
 
-
 ***
 
 title: How do I set up allowlists and blocklists?
 subtitle: Control who your AI agent can send to and receive from.
 slug: knowledge-base/allowlists-blocklists
-------------------------------------------
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 Allowlists and blocklists let you control who your AI agent can communicate with. This is a critical safety feature for autonomous agents running in production with minimal human oversight.
 
@@ -47130,13 +48081,14 @@ Without guardrails, an autonomous agent could email the wrong people, respond to
 
 For more details on the Lists API, see the [Lists core concept](/lists) documentation.
 
-
 ***
 
 title: How do I manage threaded conversations?
 subtitle: Maintain context across multi-turn email conversations with your agent.
 slug: knowledge-base/threaded-conversations
--------------------------------------------
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 Threads are how AgentMail organizes conversations. Every time your agent sends a new email, a thread is created. Replies are automatically grouped into the same thread, giving your agent full conversation context.
 
@@ -47260,13 +48212,14 @@ for thread in unreplied.threads:
 * Use labels like `unreplied`, `replied`, `escalated`, and `resolved` to track conversation state
 * Always reply to the **last message** in a thread to keep email headers correct
 
-
 ***
 
 title: How do I build a human-in-the-loop workflow?
 subtitle: Keep humans in control of your agent's email communications.
 slug: knowledge-base/human-in-the-loop
---------------------------------------
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 AgentMail provides several mechanisms for keeping humans involved when agents send emails. You can combine these approaches to match the level of oversight your workflow requires.
 
@@ -47366,13 +48319,14 @@ This acts as a hard safety boundary. Your agent can only email recipients you ha
 * **Use labels consistently** across your agents so dashboards and alerting work reliably
 * **Combine approaches:** for example, use allowlists for autonomous sending to known recipients, drafts for unknown recipients, and CC a human on everything during the first week
 
-
 ***
 
 title: How do I use Pods for multi-tenant email?
-subtitle: 'Isolate inboxes, domains, and data across tenants with Pods.'
+subtitle: Isolate inboxes, domains, and data across tenants with Pods.
 slug: knowledge-base/pods-multi-tenant
---------------------------------------
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 Pods provide tenant isolation for multi-tenant applications. Each Pod is an isolated workspace containing its own inboxes, domains, threads, and drafts, completely separated from other Pods.
 
@@ -47486,13 +48440,14 @@ client.pods.delete(pod_id=pod.pod_id)
 
 For more details, see the [Pods core concept](/pods) documentation.
 
-
 ***
 
 title: How do I use labels to track email state?
 subtitle: Use labels to manage agent workflow state on emails and threads.
 slug: knowledge-base/labels-track-state
----------------------------------------
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 Labels are string-based tags you attach to messages and threads. They are the primary way agents track state, classify emails, and filter conversations in AgentMail.
 
@@ -47620,13 +48575,14 @@ for thread_item in unreplied.threads:
 
 For more details, see the [Labels core concept](/labels) documentation.
 
-
 ***
 
 title: How do I set up a custom domain?
 subtitle: Send emails from your own domain instead of @agentmail.to.
 slug: knowledge-base/custom-domain-setup
-----------------------------------------
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 Custom domains let your agent send emails from your brand (e.g., `agent@yourcompany.com`) instead of the default `@agentmail.to`. This improves deliverability and builds trust with recipients.
 
@@ -47718,13 +48674,14 @@ console.log(`Created: ${inbox.inboxId}`);
 * **One SPF record per domain:** if you already have an SPF record, merge AgentMail's `include:` into the existing record rather than creating a second one
   For a detailed walkthrough, see the [Creating Custom Domains](/custom-domains) guide.
 
-
 ***
 
-title: 'How do I set up SPF, DKIM, and DMARC?'
+title: How do I set up SPF, DKIM, and DMARC?
 subtitle: Authenticate your domain for reliable email deliverability.
 slug: knowledge-base/spf-dkim-dmarc
------------------------------------
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 SPF, DKIM, and DMARC are three email authentication protocols that prove your emails are legitimate. They are essential for deliverability: Gmail, Outlook, and other major providers now require all three for reliable inbox placement.
 
@@ -47815,13 +48772,14 @@ For step-by-step DNS instructions, see our provider guides: [Cloudflare](/knowle
 
 For a deeper explanation of how these protocols work, see the [SPF, DKIM, DMARC](/email-protocols) documentation.
 
-
 ***
 
 title: Why are my emails going to spam?
 subtitle: Troubleshoot and fix spam folder placement issues.
 slug: knowledge-base/emails-going-to-spam
------------------------------------------
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 If your agent's emails are landing in spam instead of the inbox, work through these common causes in order. The most frequent issues are at the top.
 
@@ -47886,13 +48844,14 @@ If you have checked all of the above and emails are still going to spam, reach o
 
 For a comprehensive guide to maximizing deliverability, see the [Email Deliverability](/email-deliverability) best practices.
 
-
 ***
 
 title: Warming Up
 subtitle: Gradually build sending reputation on a new domain or inbox.
 slug: knowledge-base/domain-warming
------------------------------------
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 Warming up is the process of gradually increasing your email volume on a new domain to build sender reputation with mailbox providers like Gmail, Outlook, and Yahoo.
 You can connect AgentMail inboxes to Instantly and Smartlead for programmatic warm up using [SMTP credentials](https://docs.agentmail.to/imap-smtp#finding-your-credentials).
@@ -47967,13 +48926,14 @@ You can track bounces and complaints by using [Query Metrics](https://docs.agent
 
 For more deliverability best practices, see the [Email Deliverability](/email-deliverability) guide.
 
-
 ***
 
 title: How do I avoid MX record conflicts?
 subtitle: Add AgentMail DNS records without breaking existing email.
 slug: knowledge-base/mx-record-conflicts
-----------------------------------------
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 If you already use Gmail, Outlook, or another email provider for your domain, adding AgentMail's MX records could conflict with your existing setup. Here is how to avoid that.
 
@@ -48050,13 +49010,14 @@ 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
-----------------------------------
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 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.
 
@@ -48118,13 +49079,14 @@ If you get a `200` response, your key is valid and working. You can then copy th
 
 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?
 subtitle: Understand AgentMail's rate limits and how to work within them.
 slug: knowledge-base/rate-limits
---------------------------------
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 AgentMail is built for high-volume agent workflows. Limits vary by plan.
 
@@ -48178,13 +49140,14 @@ async function sendWithRetry(inboxId: string, params: any, maxRetries = 3) {
 
 If you need higher sending volumes or more inboxes than your current plan allows, contact [support@agentmail.cc](mailto:support@agentmail.cc) or visit the [pricing page](https://agentmail.to/pricing) for enterprise options.
 
-
 ***
 
 title: How do I prevent duplicate sends?
 subtitle: Use idempotency to avoid sending the same email twice.
 slug: knowledge-base/preventing-duplicate-sends
------------------------------------------------
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 AI agents can sometimes retry requests due to network errors, timeouts, or logic bugs. Without safeguards, this can cause the same email to be sent multiple times. Here is how to prevent that.
 
@@ -48273,13 +49236,14 @@ Since drafts support `clientId`, creating the same draft multiple times is safe.
 
 For more details, see the [Idempotent Requests](/idempotency) guide.
 
-
 ***
 
 title: Why is my domain not verifying?
 subtitle: What to do when your domain verification is stuck.
 slug: knowledge-base/domain-not-verifying
------------------------------------------
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 If your domain is stuck in a pending or failed verification state, work through these common causes.
 
@@ -48351,13 +49315,14 @@ You can check your domain's status in the [AgentMail Console](https://console.ag
 
 If you have checked all of the above and your domain is still not verifying, email [support@agentmail.cc](mailto:support@agentmail.cc) with your domain name and a screenshot of your DNS records. We can help diagnose the issue.
 
-
 ***
 
 title: Why are my emails bouncing?
 subtitle: Diagnose and resolve email bounce issues.
 slug: knowledge-base/emails-bouncing
-------------------------------------
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 A bounced email means the recipient's mail server rejected your message. Understanding the bounce type helps you take the right action.
 
@@ -48442,13 +49407,107 @@ await client.webhooks.create({
 
 For more on maintaining healthy sending metrics, see the [Email Deliverability](/email-deliverability) best practices.
 
+***
+
+title: Why are my emails not showing up?
+subtitle: The most common reason inbound emails go missing is that the sender's domain isn't authenticated.
+slug: knowledge-base/inbound-emails-missing
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
+
+<Warning>
+  **The sender's domain must have SPF or DKIM configured.** To reduce spoofing and phishing, AgentMail now drops inbound emails when the sender's domain has neither SPF nor DKIM set up. If a sender reports that their email never arrived, this is the most likely cause — once they configure SPF/DKIM on their domain, their emails will start landing in your inbox again.
+</Warning>
+
+AgentMail verifies every inbound email using SPF, DKIM, and DMARC authentication before delivering it to your inbox. Emails that fail any of these checks are dropped to prevent spoofing, phishing, and spam from reaching your agents.
+
+This is the same standard enforced by Gmail, Outlook, Yahoo, and other major email providers.
+
+## How inbound authentication works
+
+When an email arrives, AgentMail inspects the SPF, DKIM, and DMARC verdicts provided by the receiving mail server. To be delivered, an email must meet **all** of the following conditions:
+
+* Neither SPF nor DKIM returns a `FAIL` verdict
+* At least one of SPF or DKIM is configured (not both `GRAY`)
+* DMARC does not return `FAIL` (unless the sender's DMARC policy is `none`)
+* The message passes virus scanning
+
+If any check fails, the email is dropped.
+
+| Scenario                       | SPF  | DKIM | Result    |
+| ------------------------------ | ---- | ---- | --------- |
+| Both pass                      | PASS | PASS | Delivered |
+| One passes, other unconfigured | PASS | GRAY | Delivered |
+| One passes, other unconfigured | GRAY | PASS | Delivered |
+| Neither configured             | GRAY | GRAY | Dropped   |
+| Either explicitly fails        | FAIL | any  | Dropped   |
+| Either explicitly fails        | any  | FAIL | Dropped   |
+
+<Warning>
+  Emails dropped due to failed authentication are **silently rejected**. The sender's mail server may still report successful delivery because AgentMail's servers did receive the message, but it was rejected during authentication verification. The sender gets no bounce-back or error notification.
+</Warning>
+
+## Why this matters
+
+Without these checks, anyone could send emails claiming to be from any domain. SPF and DKIM authentication proves that the sending server is authorized to send on behalf of the domain in the `From` address, while DMARC ties those results to the domain's published policy. Dropping unauthenticated emails protects your agents from:
+
+* **Spoofing:** forged sender addresses impersonating trusted contacts
+* **Phishing:** malicious emails designed to trick your agent into taking harmful actions
+* **Spam:** bulk unsolicited email from unverified sources
+
+## Diagnosing missing emails
+
+If a sender reports that their email never arrived, check whether their domain has SPF and DKIM records configured:
+
+```bash
+# check for SPF record
+dig TXT example.com +short
+# look for a record starting with "v=spf1"
+```
+
+For DKIM, use [MXToolbox DKIM Lookup](https://mxtoolbox.com/dkim.aspx) or a similar tool. DKIM records are stored under a selector-specific subdomain (e.g., `google._domainkey.example.com`), and the selector name varies by email provider, so there is no single DNS query that covers all cases.
+
+You can also use [MXToolbox SPF Lookup](https://mxtoolbox.com/spf.aspx) to verify SPF records online.
+
+If the domain has neither an SPF record nor a DKIM record, that is the cause. Emails from that domain will be dropped by AgentMail and likely by other providers as well.
+
+## What to tell the sender
+
+The sender needs to configure SPF and/or DKIM on their domain's DNS. This is not something you can fix on the AgentMail side, as the records must be set up by the domain owner.
+
+* Add an SPF record to authorize their mail server (e.g., `v=spf1 include:_spf.google.com ~all` for Google Workspace)
+* Enable DKIM signing through their email provider's admin console
+* Consider adding a DMARC record for full authentication coverage
+
+Most email providers have setup guides: [Google Workspace](https://support.google.com/a/answer/33786), [Microsoft 365](https://learn.microsoft.com/en-us/microsoft-365/security/office-365-security/email-authentication-spf-configure), [Amazon SES](https://docs.aws.amazon.com/ses/latest/dg/send-email-authentication-spf.html).
+
+## Google Workspace and internal routing
+
+If the sender uses Google Workspace and the AgentMail inbox is on a subdomain of a Google Workspace domain, Google may route the email internally instead of sending it through external MX records. In this case, the email never reaches AgentMail's servers at all.
+
+For example, if the Google Workspace domain is `yourcompany.com` and the AgentMail inbox is on `agents.yourcompany.com`, Google Workspace may intercept emails to `agents.yourcompany.com` and deliver them internally.
+
+**How to fix:** In Google Admin Console, go to **Apps > Google Workspace > Gmail > Routing** and add a routing rule that sends mail for the AgentMail subdomain to the external MX records instead of handling it internally.
+
+## Still not receiving emails?
+
+If the sender's domain does have SPF/DKIM configured and emails are still not arriving:
+
+* Verify your domain's MX records are correctly pointing to AgentMail (see [MX record conflicts](/knowledge-base/mx-record-conflicts))
+* Check that your domain is fully verified in the [AgentMail Console](https://console.agentmail.to)
+* Make sure you are listening for incoming emails via [webhooks or WebSockets](/knowledge-base/handling-inbound-emails)
+
+If none of the above resolves the issue, reach out in our [Discord](https://discord.com/invite/hTYatWYWBc) support channel or email [support@agentmail.cc](mailto:support@agentmail.cc).
 
 ***
 
-title: 'DNS Guide: Cloudflare'
+title: DNS Guide: Cloudflare
 subtitle: Step-by-step instructions for adding AgentMail DNS records in Cloudflare.
 slug: knowledge-base/dns-cloudflare
------------------------------------
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 ## Steps
 
@@ -48516,13 +49575,14 @@ Cloudflare DNS typically propagates within **1 to 5 minutes**, making it one of
 
 * **Name field auto-strips domain:** Cloudflare removes the domain portion from the Name field automatically. If your DKIM selector is `agentmail._domainkey`, enter just that. Do not enter `agentmail._domainkey.yourdomain.com`, or the record will be created incorrectly.
 
-
 ***
 
-title: 'DNS Guide: GoDaddy'
+title: DNS Guide: GoDaddy
 subtitle: Step-by-step instructions for adding AgentMail DNS records in GoDaddy.
 slug: knowledge-base/dns-godaddy
---------------------------------
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 ## Steps
 
@@ -48587,13 +49647,14 @@ GoDaddy DNS typically propagates within **15 to 30 minutes**, but it can occasio
 
 * **Parked domain or forwarding:** If your domain is parked or has forwarding enabled, GoDaddy may override your MX records. Disable parking and forwarding before setting up email receiving.
 
-
 ***
 
-title: 'DNS Guide: Route 53 (AWS)'
+title: DNS Guide: Route 53 (AWS)
 subtitle: Step-by-step instructions for adding AgentMail DNS records in AWS Route 53.
 slug: knowledge-base/dns-route53
---------------------------------
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 ## Steps
 
@@ -48661,13 +49722,32 @@ Route 53 name servers typically pick up changes within **60 seconds**, but full
 
 * **Multiple values in one record:** Route 53 lets you add multiple values to a single record. If you need to add a second MX entry, add it as a new line in the same MX record rather than creating a separate record.
 
+* **DKIM TXT record too long (CharacterStringTooLong error):** If your DKIM record is provided as a TXT value (rather than a CNAME), the DKIM public key is often longer than the 255-character limit that Route 53 enforces per string segment. You will see an error like `CharacterStringTooLong (Value is too long)`. To fix this, split the value into two quoted strings within a single record. The split point should be near the middle of the `p=` value. The two quoted strings must have **no space and no line break** between the closing and opening quotes. For example:
+
+  ```
+  "v=DKIM1; k=rsa; p=MIIBIjANBgkqhki...firsthalf""secondhalf...wIDAQAB"
+  ```
+
+  In Route 53, paste the entire value (both quoted strings) into the **Value** field as a single entry. If Route 53 shows two separate copy-pastable values instead of one, there is likely a space or line break between the two strings. Remove it so the closing `"` and opening `"` are directly adjacent (`""`).
+
+  **Incorrect:** A space or line break between the two quoted strings causes Route 53 to treat them as separate values.
+
+  <img src="https://files.buildwithfern.com/https://agentmail-production.docs.buildwithfern.com/5145d22514b03251934e96ef49b78f8ca79e6b20bfa7ec5065a343ac547338e9/assets/route53-dkim-incorrect.png" alt="Incorrect Route 53 DKIM configuration with space between quoted strings" />
+
+  **Correct:** The two quoted strings are directly adjacent with no space, producing a single value in Route 53.
+
+  <img src="https://files.buildwithfern.com/https://agentmail-production.docs.buildwithfern.com/d67b72b3e23c286ef81bb101c57098bab684785fca4bf3791fd7f0fffe864740/assets/route53-dkim-correct.png" alt="Correct Route 53 DKIM configuration with no space between quoted strings" />
+
+  You can also use the AWS CLI to add the record, which handles multi-string TXT values more reliably.
 
 ***
 
-title: 'DNS Guide: Namecheap'
+title: DNS Guide: Namecheap
 subtitle: Step-by-step instructions for adding AgentMail DNS records in Namecheap.
 slug: knowledge-base/dns-namecheap
-----------------------------------
+---------------------
+
+For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. For full content including API reference and SDK examples, see https://docs.agentmail.to/llms-full.txt.
 
 ## Steps
 
@@ -48734,4 +49814,3 @@ Namecheap DNS typically propagates within **15 to 30 minutes**, but in some case
 
 * **Propagation delays:** Unlike some providers, Namecheap propagation can take 15 to 30 minutes. If verification fails, wait and retry before troubleshooting further.
 
-