agentmail 0.4.19 → 0.5.0

package/dist/llms-full.txt

@@ -1,11 +1,10 @@
-***
+# AgentMail | Documentation
+
+> AgentMail is an email API built for AI agents. Create inboxes, send and receive messages, manage threads, and handle webhooks programmatically.
 
-title: Welcome
-slug: welcome
-description: Your starting point for building with the AgentMail API.
----------------------
+# Welcome
 
-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.
+> Your starting point for building with the AgentMail API.
 
 <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.
@@ -45,14 +44,7 @@ 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.
+# Introduction
 
 ## What is AgentMail?
 
@@ -169,278 +161,106 @@ 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.
----------------------
-
-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
-
-<CodeBlocks>
-  ```bash title="Python"
-  pip install agentmail
-  ```
-
-  ```bash title="TypeScript"
-  npm install agentmail
-  ```
-
-  ```bash title="CLI"
-  npm install -g agentmail-cli
-  ```
-</CodeBlocks>
-
-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!")
-  ```
-
-  ```typescript title="TypeScript"
-  import { AgentMailClient } from "agentmail";
-
-  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
-
-  # send an email (replace <inbox_id> with the id from above)
-  agentmail inboxes:messages send \
-    --inbox-id <inbox_id> \
-    --to user@example.com \
-    --subject "Hello" \
-    --text "Hello from my agent!"
-  ```
-</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.
-
-<CodeBlocks>
-  ```python title="Python"
-  """
-  AgentMail Python Quickstart — copy into Cursor/Claude for instant setup.
-
-  Setup: pip install agentmail python-dotenv. Set AGENTMAIL_API_KEY in .env.
-
-  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
+# Quickstart
 
-  API reference:
-  - inboxes.create(username?, domain?, display_name?, client_id?) — client_id for idempotent retries
-  - messages.send(inbox_id, to, subject, text, html?, cc?, bcc?, reply_to?, attachments?)
-  - messages.list(inbox_id, limit?, page_token?, labels?) — receive emails; use extracted_text/extracted_html for reply content
-
-  Errors: SDK raises on 4xx/5xx. Inspect error.body.message or str(e).
-  Rate limit: 429 with Retry-After header. Implement exponential backoff for retries.
-  Idempotency: Pass client_id to inboxes.create() to safely retry without duplicates.
-  """
-  import os
-  from dotenv import load_dotenv
-  from agentmail import AgentMail
+> Follow this guide to make your first AgentMail API request and create a new email inbox.
 
-  load_dotenv()
-  client = AgentMail(api_key=os.getenv("AGENTMAIL_API_KEY"))
+## For Agents
 
-  # Create inbox (client_id enables safe retries)
-  inbox = client.inboxes.create(client_id="my-agent-inbox-v1")
+For agents that sign themselves up programmatically, no Console or dashboard needed. The agent registers itself using an email you provide and receives an API key in response. This flow is for first-time users only: human email addresses already signed up with AgentMail will not work here.
 
-  # Send email
-  try:
-      client.inboxes.messages.send(
-          inbox.inbox_id,
-          to="recipient@example.com",
-          subject="Hello from AgentMail",
-          text="Plain text body",
-          html="<p>HTML body</p>",
-      )
-  except Exception as e:
-      # Handle validation, not found, rate limit (429), etc.
-      print(f"Send failed: {e}")
-      raise
-
-  # Receive messages
-  for msg in client.inboxes.messages.list(inbox.inbox_id, limit=10).messages:
-      print(msg.subject, msg.extracted_text or msg.text)
-  ```
-
-  ```typescript title="TypeScript"
-  /**
-   * AgentMail TypeScript Quickstart — copy into Cursor/Claude for instant setup.
-   *
-   * Setup: npm install agentmail dotenv. Set AGENTMAIL_API_KEY in .env.
-   *
-   * 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? })
-   * - messages.list(inboxId, { limit?, pageToken?, labels? }) — receive; use extractedText/extractedHtml for reply content
-   *
-   * Errors: SDK throws on 4xx/5xx. Check error.body?.message.
-   * Rate limit: 429 with Retry-After header. Use exponential backoff for retries.
-   * Idempotency: Pass clientId to inboxes.create() to safely retry without duplicates.
-   */
-  import { AgentMailClient } from "agentmail";
-  import "dotenv/config";
-
-  const client = new AgentMailClient({
-    apiKey: process.env.AGENTMAIL_API_KEY!,
-  });
-
-  async function main() {
-    // Create inbox (clientId enables safe retries)
-    const inbox = await client.inboxes.create({
-      clientId: "my-agent-inbox-v1",
-    });
-
-    try {
-      await client.inboxes.messages.send(inbox.inboxId, {
-        to: "recipient@example.com",
-        subject: "Hello from AgentMail",
-        text: "Plain text body",
-        html: "<p>HTML body</p>",
-      });
-    } catch (error: unknown) {
-      // Handle validation, not found, rate limit (429), etc.
-      const msg = (error as { body?: { message?: string } })?.body?.message ?? String(error);
-      throw new Error(`Send failed: ${msg}`);
-    }
-
-    // Receive messages
-    const res = await client.inboxes.messages.list(inbox.inboxId, { limit: 10 });
-    for (const msg of res.messages) {
-      console.log(msg.subject, msg.extractedText ?? msg.text);
-    }
-  }
-
-  main();
-  ```
-</CodeBlocks>
+<Steps>
+  <Step title="Sign up">
+    The agent registers itself using the human email you provide and gets back an API key, inbox ID, and organization ID. An OTP is sent to that email.
 
-<Tip>
-  When receiving emails, messages include `extracted_text` and `extracted_html`
-  for reply content without quoted history.
-</Tip>
+    <CodeBlocks>
+      ```bash title="CLI"
+      npm install -g agentmail-cli
 
-This guide walks you through signing up, authenticating, and creating your first email inbox.
+      agentmail agent sign-up \
+        --human-email you@example.com \
+        --username my-agent
+      ```
 
-<Steps>
-  <Step title="Sign up and get an API key">
-    You have two options to get an API key:
+      ```bash title="cURL"
+      curl -X POST https://api.agentmail.to/agent/sign-up \
+        -H "Content-Type: application/json" \
+        -d '{
+          "human_email": "you@example.com",
+          "username": "my-agent"
+        }'
+      # returns { api_key, inbox_id, organization_id }
+      ```
+    </CodeBlocks>
 
-    **Option A: Agent sign-up (programmatic)**
+    <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>
+  </Step>
 
-    Use the Agent API to create an account and get an API key without leaving your terminal. No console access needed.
+  <Step title="Verify with the OTP">
+    Check the human's email for a 6-digit OTP code and verify to unlock full permissions.
 
     <CodeBlocks>
-      ```python title="Python"
-      from agentmail import AgentMail
+      ```bash title="CLI"
+      export AGENTMAIL_API_KEY="am_..."  # from the sign-up response
 
-      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
+      agentmail agent verify --otp-code 123456
       ```
 
-      ```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
+      ```bash title="cURL"
+      curl -X POST https://api.agentmail.to/agent/verify \
+        -H "Authorization: Bearer $AGENTMAIL_API_KEY" \
+        -H "Content-Type: application/json" \
+        -d '{ "otp_code": "123456" }'
       ```
     </CodeBlocks>
+  </Step>
 
-    A 6-digit OTP is sent to the provided email. Verify to unlock full permissions:
+  <Step title="Create an inbox and send an email">
+    With the API key from sign-up, the agent can create inboxes and send mail on its own.
 
     <CodeBlocks>
-      ```python title="Python"
-      client = AgentMail(api_key=response.api_key)
-      client.agent.verify(otp_code="123456")
-      ```
+      ```bash title="CLI"
+      # create an inbox
+      agentmail inboxes create
 
-      ```typescript title="TypeScript"
-      const authedClient = new AgentMailClient({ apiKey: response.apiKey });
-      await authedClient.agent.verify({ otpCode: "123456" });
+      # send an email (replace <inbox_id> with the id from above)
+      agentmail inboxes:messages send \
+        --inbox-id <inbox_id> \
+        --to recipient@example.com \
+        --subject "Hello" \
+        --text "Hello from my agent!"
       ```
 
-      ```bash title="CLI"
-      agentmail agent verify --otp-code 123456
+      ```bash title="cURL"
+      # create an inbox (client_id enables safe retries)
+      curl -X POST https://api.agentmail.to/inboxes \
+        -H "Authorization: Bearer $AGENTMAIL_API_KEY" \
+        -H "Content-Type: application/json" \
+        -d '{ "client_id": "my-agent-inbox-v1" }'
+      # returns { inbox_id, ... }
+
+      # send an email (replace <inbox_id> with the id from above)
+      curl -X POST https://api.agentmail.to/inboxes/<inbox_id>/messages/send \
+        -H "Authorization: Bearer $AGENTMAIL_API_KEY" \
+        -H "Content-Type: application/json" \
+        -d '{
+          "to": "recipient@example.com",
+          "subject": "Hello from AgentMail",
+          "text": "Plain text body"
+        }'
       ```
     </CodeBlocks>
+  </Step>
+</Steps>
 
-    <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>
+## For Humans
 
-    **Option B: Console (manual)**
+For developers who want to try AgentMail from the Console.
 
+<Steps>
+  <Step title="Sign up and get an API key">
     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>
@@ -475,10 +295,9 @@ This guide walks you through signing up, authenticating, and creating your first
   </Step>
 
   <Step title="Create an inbox and send an email">
-    Now you're ready to make your first API call. Create a new file (e.g.,
-    `quickstart.py` or `quickstart.ts`) and add the following code. This script
-    will initialize the AgentMail client, create a new inbox, and then send a
-    test email.
+    Create a new file (e.g., `quickstart.py` or `quickstart.ts`) and add the
+    following code. This script initializes the AgentMail client, creates a new
+    inbox, and sends a test email.
 
     <CodeBlocks>
       ```python title="Python"
@@ -486,28 +305,26 @@ This guide walks you through signing up, authenticating, and creating your first
       from dotenv import load_dotenv
       from agentmail import AgentMail
 
-      # Load the API key from the .env file
+      # load the API key from the .env file
       load_dotenv()
       api_key = os.getenv("AGENTMAIL_API_KEY")
 
-      # Initialize the client
+      # initialize the client
       client = AgentMail(api_key=api_key)
 
-      # Create an inbox
+      # create an inbox
       print("Creating inbox...")
       inbox = client.inboxes.create() # domain is optional
       print("Inbox created successfully!")
       print(inbox)
 
-      # Send Email
-
+      # send an email from the new inbox
       client.inboxes.messages.send(
         inbox.inbox_id,
         to="your-email@example.com",
         subject="Hello from AgentMail!",
         text="This is my first email sent with the AgentMail API.",
       )
-
       ```
 
       ```typescript title="TypeScript"
@@ -515,18 +332,18 @@ This guide walks you through signing up, authenticating, and creating your first
       import "dotenv/config"; // loads .env file
 
       async function main() {
-        // Initialize the client
+        // initialize the client
         const client = new AgentMailClient({
           apiKey: process.env.AGENTMAIL_API_KEY,
         });
 
-        // Create an inbox
+        // create an inbox
         console.log("Creating inbox...");
         const inbox = await client.inboxes.create(); // domain is optional
         console.log("Inbox created successfully!");
         console.log(inbox);
 
-        // Send an email from the new inbox
+        // send an email from the new inbox
         console.log("Sending email...");
         await client.inboxes.messages.send(inbox.inboxId, {
           to: "your-email@example.com",
@@ -580,6 +397,120 @@ This guide walks you through signing up, authenticating, and creating your first
   </Step>
 </Steps>
 
+## Copy for Cursor / Claude
+
+Copy one of the blocks below into Cursor or Claude for a complete, working AgentMail integration. Each block includes setup, API reference, error handling, rate limiting, and idempotency guidance.
+
+<CodeBlocks>
+  ```python title="Python"
+  """
+  AgentMail Python Quickstart — copy into Cursor/Claude for instant setup.
+
+  Setup: pip install agentmail python-dotenv. Set AGENTMAIL_API_KEY in .env.
+
+  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?)
+  - messages.list(inbox_id, limit?, page_token?, labels?) — receive emails; use extracted_text/extracted_html for reply content
+
+  Errors: SDK raises on 4xx/5xx. Inspect error.body.message or str(e).
+  Rate limit: 429 with Retry-After header. Implement exponential backoff for retries.
+  Idempotency: Pass client_id to inboxes.create() to safely retry without duplicates.
+  """
+  import os
+  from dotenv import load_dotenv
+  from agentmail import AgentMail
+
+  load_dotenv()
+  client = AgentMail(api_key=os.getenv("AGENTMAIL_API_KEY"))
+
+  # create inbox (client_id enables safe retries)
+  inbox = client.inboxes.create(client_id="my-agent-inbox-v1")
+
+  # send email
+  try:
+      client.inboxes.messages.send(
+          inbox.inbox_id,
+          to="recipient@example.com",
+          subject="Hello from AgentMail",
+          text="Plain text body",
+          html="<p>HTML body</p>",
+      )
+  except Exception as e:
+      # handle validation, not found, rate limit (429), etc.
+      print(f"Send failed: {e}")
+      raise
+
+  # receive messages
+  for msg in client.inboxes.messages.list(inbox.inbox_id, limit=10).messages:
+      print(msg.subject, msg.extracted_text or msg.text)
+  ```
+
+  ```typescript title="TypeScript"
+  /**
+   * AgentMail TypeScript Quickstart — copy into Cursor/Claude for instant setup.
+   *
+   * Setup: npm install agentmail dotenv. Set AGENTMAIL_API_KEY in .env.
+   *
+   * 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? })
+   * - messages.list(inboxId, { limit?, pageToken?, labels? }) — receive; use extractedText/extractedHtml for reply content
+   *
+   * Errors: SDK throws on 4xx/5xx. Check error.body?.message.
+   * Rate limit: 429 with Retry-After header. Use exponential backoff for retries.
+   * Idempotency: Pass clientId to inboxes.create() to safely retry without duplicates.
+   */
+  import { AgentMailClient } from "agentmail";
+  import "dotenv/config";
+
+  const client = new AgentMailClient({
+    apiKey: process.env.AGENTMAIL_API_KEY!,
+  });
+
+  async function main() {
+    // create inbox (clientId enables safe retries)
+    const inbox = await client.inboxes.create({
+      clientId: "my-agent-inbox-v1",
+    });
+
+    try {
+      await client.inboxes.messages.send(inbox.inboxId, {
+        to: "recipient@example.com",
+        subject: "Hello from AgentMail",
+        text: "Plain text body",
+        html: "<p>HTML body</p>",
+      });
+    } catch (error: unknown) {
+      // handle validation, not found, rate limit (429), etc.
+      const msg = (error as { body?: { message?: string } })?.body?.message ?? String(error);
+      throw new Error(`Send failed: ${msg}`);
+    }
+
+    // receive messages
+    const res = await client.inboxes.messages.list(inbox.inboxId, { limit: 10 });
+    for (const msg of res.messages) {
+      console.log(msg.subject, msg.extractedText ?? msg.text);
+    }
+  }
+
+  main();
+  ```
+</CodeBlocks>
+
+<Tip>
+  When receiving emails, messages include `extracted_text` and `extracted_html`
+  for reply content without quoted history.
+</Tip>
+
 ## Next Steps
 
 You've created an inbox and sent your first email. Now set up your agent to receive and respond to incoming messages:
@@ -607,15 +538,9 @@ You've created an inbox and sent your first email. Now set up your agent to rece
   [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.
----------------------
+# Inboxes
 
-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.
+> Learn how AgentMail Inboxes act as scalable, API-first email accounts for your agents.
 
 ## What is an Inbox?
 
@@ -851,15 +776,9 @@ 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.
----------------------
+# 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.
+> Learn how to send, receive, and manage emails as Message objects with the AgentMail API.
 
 ## What is a Message?
 
@@ -1395,15 +1314,9 @@ AgentMail doesn't have a dedicated "mark as read" endpoint — instead, you use
 ```
 ```
 
-***
+# Threads
 
-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.
----------------------
-
-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.
+> Learn how AgentMail Threads group messages into conversations and how to query them across your entire organization.
 
 ## What is a Thread?
 
@@ -1602,15 +1515,9 @@ Copy one of the blocks below into Cursor or Claude for complete Threads API know
   ```
 </CodeBlocks>
 
-***
+# Drafts
 
-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.
----------------------
-
-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.
+> Learn how to create, manage, and send Drafts to enable advanced agent workflows like human-in-the-loop review and scheduled sending.
 
 ## What is a Draft?
 
@@ -2158,15 +2065,9 @@ 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.
----------------------
+# Labels
 
-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.
+> Learn how to use Labels to manage state, track campaigns, and filter messages for powerful agentic workflows.
 
 ## What are `Labels`?
 
@@ -2416,15 +2317,9 @@ 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.
----------------------
+# Lists
 
-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.
+> Learn how to use Lists to control which email addresses and domains your agents can send to or receive from.
 
 ## What are Lists?
 
@@ -2724,15 +2619,9 @@ 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.
----------------------
+# Attachments
 
-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.
+> Learn how to send files as attachments, and download incoming attachments from both messages and threads.
 
 ## What are `Attachments`?
 
@@ -2957,13 +2846,9 @@ 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
----------------------
+# Pods
 
-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.
+> Learn how to use pods for multi-tenant email management
 
 ## What are Pods?
 
@@ -3254,15 +3139,9 @@ 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.
----------------------
+# Permissions
 
-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.
+> Learn how to configure fine-grained permissions on API keys to restrict access to specific resources and operations.
 
 ## What are Permissions?
 
@@ -3694,15 +3573,9 @@ 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.
----------------------
+# Agent Onboarding
 
-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.
+> Resources for AI coding assistants, MCP servers, skills, and agent-friendly documentation.
 
 > Everything you need to onboard your AI agent to AgentMail — the email platform built for AI agents.
 
@@ -3804,19 +3677,25 @@ You can selectively enable specific tools using the `--tools` argument:
 
 ### Available MCP Tools
 
-| Tool               | Description                           |
-| ------------------ | ------------------------------------- |
-| `create_inbox`     | Create a new email inbox for an agent |
-| `list_inboxes`     | List all inboxes in your account      |
-| `get_inbox`        | Get details of a specific inbox       |
-| `delete_inbox`     | Delete an inbox                       |
-| `send_message`     | Send an email from an agent inbox     |
-| `reply_to_message` | Reply to an email in a thread         |
-| `forward_message`  | Forward an email                      |
-| `update_message`   | Update message labels or status       |
-| `list_threads`     | List email threads in an inbox        |
-| `get_thread`       | Get a full email thread with messages |
-| `get_attachment`   | Download an email attachment          |
+| Tool               | Description                                                     |
+| ------------------ | --------------------------------------------------------------- |
+| `create_inbox`     | Create a new email inbox for an agent                           |
+| `list_inboxes`     | List all inboxes in your account                                |
+| `get_inbox`        | Get details of a specific inbox                                 |
+| `delete_inbox`     | Delete an inbox                                                 |
+| `send_message`     | Send an email from an agent inbox                               |
+| `reply_to_message` | Reply to an email in a thread                                   |
+| `forward_message`  | Forward an email                                                |
+| `update_message`   | Update message labels or status                                 |
+| `create_draft`     | Create a draft email (optionally scheduled via `send_at`)       |
+| `list_drafts`      | List drafts in an inbox (filter by labels like `scheduled`)     |
+| `get_draft`        | Get a draft by ID with content and scheduled send time          |
+| `update_draft`     | Update a draft; use `send_at` to reschedule                     |
+| `send_draft`       | Send a draft immediately (draft is converted to a sent message) |
+| `delete_draft`     | Delete a draft; also cancels a scheduled send                   |
+| `list_threads`     | List email threads in an inbox                                  |
+| `get_thread`       | Get a full email thread with messages                           |
+| `get_attachment`   | Download an email attachment                                    |
 
 <Card title="MCP Server on GitHub" icon="fa-brands fa-github" href="https://github.com/agentmail-to/agentmail-smithery-mcp">
   View the source code, contribute, or report issues.
@@ -4057,15 +3936,9 @@ 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
----------------------
+# Skills
 
-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's official skill for OpenClaw, Claude Code, Cursor, and other AI assistants
 
 ## Getting started
 
@@ -4189,15 +4062,9 @@ Once installed, you can ask your AI assistant to perform email tasks:
 * [AgentMail API Reference](/api-reference)
 * [AgentMail Console](https://console.agentmail.to)
 
-***
+# MCP
 
-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.
+> AgentMail's Model Context Protocol (MCP) integration
 
 ## Getting started
 
@@ -4208,10 +4075,10 @@ The Model Context Protocol (MCP) is an open standard that enables AI application
 Install with:
 
 ```bash
-npx add-mcp https://mcp.agentmail.to
+npx add-mcp https://mcp.agentmail.to/mcp
 ```
 
-Configure your API key when prompted. Get your key from the [AgentMail Console](https://console.agentmail.to). For more details, visit [mcp.agentmail.to](https://mcp.agentmail.to).
+Configure your API key when prompted. Get your key from the [AgentMail Console](https://console.agentmail.to). For more details, visit [mcp.agentmail.to/mcp](https://mcp.agentmail.to/mcp).
 
 ## Features
 
@@ -4219,6 +4086,7 @@ The AgentMail MCP server provides tools for:
 
 * **Inbox management:** Create, list, and delete inboxes
 * **Message operations:** Send, receive, and reply to emails
+* **Drafts:** Create, schedule, update, and send draft emails
 * **Thread management:** Access and manage email threads
 * **Attachments:** Handle email attachments
 
@@ -4231,17 +4099,11 @@ The AgentMail MCP server works with any MCP-compatible client, including:
 * Windsurf
 * Other MCP-enabled AI applications
 
-For detailed setup instructions and available tools, visit [mcp.agentmail.to](https://mcp.agentmail.to).
+For detailed setup instructions and available tools, visit [mcp.agentmail.to/mcp](https://mcp.agentmail.to/mcp).
 
-***
+# CLI
 
-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.
+> AgentMail's official command-line interface
 
 ## Getting started
 
@@ -4351,15 +4213,9 @@ 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
----------------------
+# Google ADK
 
-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's Google Agent Development Kit (ADK) integration
 
 ## Getting started
 
@@ -4470,15 +4326,20 @@ 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 |
 
-***
+### Draft management
+
+| Tool           | Description                                               |
+| -------------- | --------------------------------------------------------- |
+| `create_draft` | Create a draft email (optionally scheduled via `send_at`) |
+| `list_drafts`  | List drafts in an inbox                                   |
+| `get_draft`    | Get a specific draft by ID                                |
+| `update_draft` | Update a draft or reschedule a scheduled send             |
+| `send_draft`   | Send a draft immediately                                  |
+| `delete_draft` | Delete a draft or cancel a scheduled send                 |
 
-title: OpenClaw
-subtitle: Give your OpenClaw agent its own email inbox
-slug: integrations/openclaw
-description: AgentMail's OpenClaw integration
----------------------
+# OpenClaw
 
-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's OpenClaw integration
 
 ## Getting started
 
@@ -4699,15 +4560,9 @@ 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)
 
-***
+# Replit
 
-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.
+> AgentMail's Replit integration
 
 ## Getting started
 
@@ -4916,15 +4771,9 @@ 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.
 
-***
+# x402
 
-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.
+> AgentMail's x402 integration for HTTP-native payments
 
 ## Getting started
 
@@ -5079,15 +4928,9 @@ 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
----------------------
+# MPP
 
-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's MPP integration for machine-to-machine payments via Stripe
 
 ## Getting started
 
@@ -5175,15 +5018,9 @@ This means your agent can use the full AgentMail API (inboxes, messages, threads
 * [AgentMail API reference](/api-reference)
 * [WebSockets overview](/websockets)
 
-***
+# Integrate LiveKit Agents
 
-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.
+> A step-by-step guide to integrate with the LiveKit Agents SDK.
 
 ## Overview
 
@@ -5310,15 +5147,9 @@ 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
----------------------
+# Sim.ai
 
-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's Sim.ai integration
 
 ## Getting started
 
@@ -5387,15 +5218,9 @@ Once connected, Sim provides access to the following AgentMail operations:
 * [AgentMail API reference](/api-reference)
 * [Webhooks overview](/webhooks/webhooks-overview)
 
-***
-
-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.
----------------------
+# Guide: Sending & Receiving Email
 
-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 step-by-step guide to the practical workflow of sending initial emails and handling replies to have a full conversation.
 
 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.
 
@@ -5591,15 +5416,9 @@ 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.
----------------------
+# IMAP & SMTP
 
-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.
+> Configure IMAP and SMTP to access your AgentMail inboxes using email clients or programmatic access.
 
 <Callout intent="warn" title="IMAP is Under Development">
   IMAP support is currently under development and will be available in the coming weeks. The documentation below describes the planned functionality. SMTP is fully available today.
@@ -5838,15 +5657,9 @@ 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.
-slug: multi-tenancy
-description: How to use pods, scoped API keys, and webhook filtering to build multi-tenant email on AgentMail.
----------------------
+# Guide: Multi-Tenancy
 
-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.
+> How to use pods, scoped API keys, and webhook filtering to build multi-tenant email on AgentMail.
 
 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.
 
@@ -6132,15 +5945,9 @@ 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.
-slug: custom-domains
-description: A step-by-step guide to configuring your custom domain with AgentMail for enhanced branding and trust.
----------------------
+# Using Custom Domains
 
-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 step-by-step guide to configuring your custom domain with AgentMail for enhanced branding and trust.
 
 ## Why Use a Custom Domain?
 
@@ -6539,15 +6346,9 @@ 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.
 
-***
+# Managing Your Domains
 
-title: Managing Your Domains
-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.
----------------------
-
-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.
+> Learn how to manage your custom domains effectively using AgentMail's API for enhanced deliverability and reputation management.
 
 ## From Setup to Strategy
 
@@ -6615,15 +6416,9 @@ 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`.
 
-***
+# Webhooks Overview
 
-title: Webhooks Overview
-subtitle: Get real-time notifications for email events.
-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.
+> Learn how to use Webhooks to build responsive, event-driven email agents with AgentMail.
 
 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.
 
@@ -6890,13 +6685,7 @@ Copy one of the blocks below into Cursor or Claude for complete Webhooks API kno
   </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.
+# Webhook Events
 
 As mentioned in the overview, webhooks allow us to create event-driven applications.
 
@@ -7439,15 +7228,9 @@ For example, if you only need to trigger workflows on incoming messages, you can
 
 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.
----------------------
+# Webhook Setup Guide
 
-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 comprehensive guide to setting up webhooks with ngrok and AgentMail, including account creation, inbox setup, and code examples.
 
 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.
 
@@ -7755,15 +7538,9 @@ For production deployments:
   </Card>
 </CardGroup>
 
-***
+# Verifying Webhooks
 
-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.
----------------------
-
-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.
+> Learn how to verify webhook signatures to secure your webhook endpoints and prevent spoofed requests.
 
 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.
 
@@ -8206,15 +7983,9 @@ For production, you'll need to deploy your webhook server to a hosting provider
   </Card>
 </CardGroup>
 
-***
+# WebSockets
 
-title: WebSockets
-subtitle: Real-time, low-latency email event streaming
-slug: websockets
-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.
+> Learn how to use WebSockets for instant email notifications without webhooks or polling.
 
 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.
 
@@ -8657,14 +8428,7 @@ 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.
+# WebSockets Quickstart
 
 ## Copy for Cursor / Claude
 
@@ -8752,15 +8516,9 @@ 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.
-slug: email-deliverability
-description: Learn the strategies and best practices for maximizing your email deliverability with AgentMail.
----------------------
+# Email Deliverability
 
-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.
+> Learn the strategies and best practices for maximizing your email deliverability with AgentMail.
 
 ## What is Email Deliverability?
 
@@ -8866,15 +8624,9 @@ 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.
----------------------
+# Idempotent 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.
+> A guide to using the client_id parameter in AgentMail to prevent duplicate resources and safely retry API requests.
 
 ## What is Idempotency?
 
@@ -8920,15 +8672,9 @@ 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.
-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.
----------------------
+# Example: Event-Driven Agent
 
-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 step-by-step guide to building a sophisticated agent that performs proactive outreach and uses webhooks for inbound message processing.
 
 This tutorial walks you through building a sophisticated, dual-mode agent. It will:
 
@@ -9336,13 +9082,9 @@ 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
----------------------
+# Auto-Reply Email Agent
 
-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.
+> Build a simple agent that automatically responds to incoming emails with personalized messages
 
 ## Overview
 
@@ -10207,13 +9949,9 @@ 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
----------------------
+# Smart Email Labeling Agent
 
-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.
+> Build an AI-powered agent that automatically classifies and labels incoming emails across multiple dimensions
 
 ## Overview
 
@@ -10922,14 +10660,9 @@ 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.
 
-***
+# Sales Agent with WebSocket
 
-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.
----------------------
-
-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 step-by-step guide to building an AI-powered sales agent that uses WebSocket for real-time email processing without polling or webhooks.
 
 ## Overview
 
@@ -11647,8 +11380,6 @@ 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
 
 We have several deployed agents running in production that demonstrate the power of AgentMail. These agents showcase different use cases and capabilities of our platform.
@@ -11690,14 +11421,9 @@ 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.
----------------------
+# Frequently Asked Questions (FAQ)
 
-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.
+> Find answers to common questions about AgentMail, from core concepts to best practices and security.
 
 <AccordionGroup>
   <Accordion title="What is AgentMail?">
@@ -11749,15 +11475,9 @@ For clean Markdown content of this page, append .md to this URL. For the complet
   </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.
----------------------
+# Email Reply Extraction with Talon
 
-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.
+> Learn how to use Talon to extract new content from email replies, removing quoted text with 93.8% accuracy.
 
 ## Why Talon?
 
@@ -12287,14 +12007,9 @@ 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.
----------------------
+# Join the AgentMail Community
 
-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 with the AgentMail team and developers, share what you're building, and get support.
 
 <CardGroup>
   <Card title="Join our Discord Server" href="https://discord.com/invite/hTYatWYWBc" icon="fa-brands fa-discord">
@@ -12319,14 +12034,9 @@ For clean Markdown content of this page, append .md to this URL. For the complet
   To learn more about our premium plans and dedicated support options, please visit our website [here](https://agentmail.to/pricing).
 </Callout>
 
-***
+# Support
 
-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.
+> Get help with AgentMail through our support channels.
 
 ## Need Help?
 
@@ -12338,14 +12048,9 @@ For clean Markdown content of this page, append .md to this URL. For the complet
   <Card title="Email Support" icon="fa-solid fa-envelope" href="mailto:support@agentmail.cc" />
 </Cards>
 
-***
+# 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.
----------------------
-
-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.
+> Learn why we ask for DNS records and what SPF, DKIM, and DMARC are.
 
 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.
 
@@ -12418,15 +12123,9 @@ 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
----------------------
+# SOC 2 Compliance
 
-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's SOC 2 Type I and Type II compliance.
 
 > AgentMail has achieved **SOC 2 Type I** (July 2025) and **Type II** (Q1 2026) compliance.
 
@@ -12554,14 +12253,9 @@ Organizations evaluating AgentMail can [request SOC 2 documentation](mailto:secu
 
 ***
 
-***
+# Spam & Virus Detection
 
-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.
+> How AgentMail automatically scans incoming emails for spam and viruses.
 
 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.
 
@@ -12612,15 +12306,9 @@ 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
----------------------
+# API Welcome
 
-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.
+> Quick overview of the AgentMail SDK
 
 ## Introduction
 
@@ -12658,8 +12346,6 @@ 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
 
 POST https://api.agentmail.to/v0/agent/sign-up
@@ -12946,8 +12632,6 @@ 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
@@ -13205,8 +12889,6 @@ 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
@@ -13489,8 +13171,6 @@ 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}
@@ -13756,8 +13436,6 @@ 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
@@ -14046,8 +13724,6 @@ 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}
@@ -14355,8 +14031,6 @@ 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}
@@ -14574,8 +14248,6 @@ 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
@@ -15075,8 +14747,6 @@ 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}
@@ -15650,8 +15320,6 @@ 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}
@@ -15948,8 +15616,6 @@ 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}
@@ -16259,8 +15925,6 @@ 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}
@@ -16505,8 +16169,6 @@ 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
@@ -17025,8 +16687,6 @@ 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}
@@ -17473,8 +17133,6 @@ 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}
@@ -17771,8 +17429,6 @@ 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
@@ -18035,8 +17691,6 @@ 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}
@@ -18349,8 +18003,6 @@ 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}
@@ -18587,8 +18239,6 @@ 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 Message
 
 POST https://api.agentmail.to/v0/inboxes/{inbox_id}/messages/send
@@ -18995,8 +18645,6 @@ 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
@@ -19409,8 +19057,6 @@ 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
@@ -19799,8 +19445,6 @@ 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
@@ -20213,8 +19857,6 @@ 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
@@ -20667,8 +20309,6 @@ 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}
@@ -21085,8 +20725,6 @@ 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}
@@ -21383,8 +21021,6 @@ 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
@@ -21873,8 +21509,6 @@ 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}
@@ -22340,8 +21974,6 @@ 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}
@@ -22573,8 +22205,6 @@ 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
@@ -22895,8 +22525,6 @@ 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}
@@ -23211,8 +22839,6 @@ 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}
@@ -23519,8 +23145,6 @@ 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}
@@ -23858,8 +23482,6 @@ 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}
@@ -24115,8 +23737,6 @@ 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
@@ -24426,7 +24046,339 @@ 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 Inbox Events
+
+GET https://api.agentmail.to/v0/inboxes/{inbox_id}/events
+
+List label change events for an inbox. Returns events in reverse chronological order by default. Use for IMAP UID projection or audit logging.
+
+**CLI:**
+```bash
+agentmail inboxes:events list --inbox-id <inbox_id>
+```
+
+Reference: https://docs.agentmail.to/api-reference/inboxes/events/list
+
+## OpenAPI Specification
+
+```yaml
+openapi: 3.1.0
+info:
+  title: api
+  version: 1.0.0
+paths:
+  /v0/inboxes/{inbox_id}/events:
+    get:
+      operationId: list
+      summary: List Inbox Events
+      description: >-
+        List label change events for an inbox. Returns events in reverse
+        chronological order by default. Use for IMAP UID projection or audit
+        logging.
+
+
+        **CLI:**
+
+        ```bash
+
+        agentmail inboxes:events list --inbox-id <inbox_id>
+
+        ```
+      tags:
+        - subpackage_inboxes.subpackage_inboxes/events
+      parameters:
+        - name: inbox_id
+          in: path
+          required: true
+          schema:
+            $ref: '#/components/schemas/type_inboxes:InboxId'
+        - name: limit
+          in: query
+          required: false
+          schema:
+            $ref: '#/components/schemas/type_:Limit'
+        - name: page_token
+          in: query
+          required: false
+          schema:
+            $ref: '#/components/schemas/type_:PageToken'
+        - name: ascending
+          in: query
+          required: false
+          schema:
+            $ref: '#/components/schemas/type_:Ascending'
+        - name: Authorization
+          in: header
+          description: Bearer authentication
+          required: true
+          schema:
+            type: string
+      responses:
+        '200':
+          description: Response with status 200
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/type_inbox-events:ListInboxEventsResponse'
+        '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_:Limit:
+      type: integer
+      description: Limit of number of items returned.
+      title: Limit
+    type_:PageToken:
+      type: string
+      description: Page token for pagination.
+      title: PageToken
+    type_:Ascending:
+      type: boolean
+      description: Sort in ascending temporal order.
+      title: Ascending
+    type_:Count:
+      type: integer
+      description: Number of items returned.
+      title: Count
+    type_:OrganizationId:
+      type: string
+      description: ID of organization.
+      title: OrganizationId
+    type_inbox-events:InboxEventId:
+      type: string
+      description: ID of event.
+      title: InboxEventId
+    type_inbox-events:InboxEventType:
+      type: string
+      enum:
+        - label_added
+        - label_removed
+      description: Type of inbox event.
+      title: InboxEventType
+    type_inbox-events:InboxEvent:
+      type: object
+      properties:
+        organization_id:
+          $ref: '#/components/schemas/type_:OrganizationId'
+        pod_id:
+          type: string
+          description: ID of pod.
+        inbox_id:
+          $ref: '#/components/schemas/type_inboxes:InboxId'
+        event_id:
+          $ref: '#/components/schemas/type_inbox-events:InboxEventId'
+        event_type:
+          $ref: '#/components/schemas/type_inbox-events:InboxEventType'
+        message_id:
+          type: string
+          description: ID of message.
+        label:
+          type: string
+          description: Label added or removed.
+        event_at:
+          type: string
+          format: date-time
+          description: Time at which the event occurred.
+        created_at:
+          type: string
+          format: date-time
+          description: Time at which the event was recorded.
+      required:
+        - organization_id
+        - pod_id
+        - inbox_id
+        - event_id
+        - event_type
+        - message_id
+        - label
+        - event_at
+        - created_at
+      title: InboxEvent
+    type_inbox-events:ListInboxEventsResponse:
+      type: object
+      properties:
+        count:
+          $ref: '#/components/schemas/type_:Count'
+        limit:
+          $ref: '#/components/schemas/type_:Limit'
+        next_page_token:
+          $ref: '#/components/schemas/type_:PageToken'
+        events:
+          type: array
+          items:
+            $ref: '#/components/schemas/type_inbox-events:InboxEvent'
+          description: Ordered by `event_id` descending.
+      required:
+        - count
+        - events
+      title: ListInboxEventsResponse
+    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.events.list("inbox_id", {});
+}
+main();
+
+```
+
+```python
+from agentmail import AgentMail
+
+client = AgentMail(
+    api_key="YOUR_TOKEN_HERE",
+)
+
+client.inboxes.events.list(
+    inbox_id="inbox_id",
+)
+
+```
+
+```go
+package main
+
+import (
+	"fmt"
+	"net/http"
+	"io"
+)
+
+func main() {
+
+	url := "https://api.agentmail.to/v0/inboxes/inbox_id/events"
+
+	req, _ := http.NewRequest("GET", url, nil)
+
+	req.Header.Add("Authorization", "Bearer <api_key>")
+
+	res, _ := http.DefaultClient.Do(req)
+
+	defer res.Body.Close()
+	body, _ := io.ReadAll(res.Body)
+
+	fmt.Println(res)
+	fmt.Println(string(body))
+
+}
+```
+
+```ruby
+require 'uri'
+require 'net/http'
+
+url = URI("https://api.agentmail.to/v0/inboxes/inbox_id/events")
+
+http = Net::HTTP.new(url.host, url.port)
+http.use_ssl = true
+
+request = Net::HTTP::Get.new(url)
+request["Authorization"] = 'Bearer <api_key>'
+
+response = http.request(request)
+puts response.read_body
+```
+
+```java
+import com.mashape.unirest.http.HttpResponse;
+import com.mashape.unirest.http.Unirest;
+
+HttpResponse<String> response = Unirest.get("https://api.agentmail.to/v0/inboxes/inbox_id/events")
+  .header("Authorization", "Bearer <api_key>")
+  .asString();
+```
+
+```php
+<?php
+require_once('vendor/autoload.php');
+
+$client = new \GuzzleHttp\Client();
+
+$response = $client->request('GET', 'https://api.agentmail.to/v0/inboxes/inbox_id/events', [
+  'headers' => [
+    'Authorization' => 'Bearer <api_key>',
+  ],
+]);
+
+echo $response->getBody();
+```
+
+```csharp
+using RestSharp;
+
+var client = new RestClient("https://api.agentmail.to/v0/inboxes/inbox_id/events");
+var request = new RestRequest(Method.GET);
+request.AddHeader("Authorization", "Bearer <api_key>");
+IRestResponse response = client.Execute(request);
+```
+
+```swift
+import Foundation
+
+let headers = ["Authorization": "Bearer <api_key>"]
+
+let request = NSMutableURLRequest(url: NSURL(string: "https://api.agentmail.to/v0/inboxes/inbox_id/events")! as URL,
+                                        cachePolicy: .useProtocolCachePolicy,
+                                    timeoutInterval: 10.0)
+request.httpMethod = "GET"
+request.allHTTPHeaderFields = headers
+
+let session = URLSession.shared
+let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
+  if (error != nil) {
+    print(error as Any)
+  } else {
+    let httpResponse = response as? HTTPURLResponse
+    print(httpResponse)
+  }
+})
+
+dataTask.resume()
+```
 
 # List API Keys
 
@@ -24849,8 +24801,6 @@ 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
@@ -25280,8 +25230,6 @@ 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}
@@ -25513,8 +25461,6 @@ 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
@@ -26007,8 +25953,6 @@ 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}
@@ -26572,8 +26516,6 @@ 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}
@@ -26860,8 +26802,6 @@ 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}
@@ -27161,8 +27101,6 @@ 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}
@@ -27396,8 +27334,6 @@ 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
@@ -27843,8 +27779,6 @@ 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}
@@ -28255,8 +28189,6 @@ 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}
@@ -28543,8 +28475,6 @@ 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
@@ -28859,8 +28789,6 @@ 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}
@@ -29158,8 +29086,6 @@ 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
@@ -29513,8 +29439,6 @@ 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}
@@ -29874,8 +29798,6 @@ 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}
@@ -30093,8 +30015,6 @@ 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 
@@ -30524,8 +30444,6 @@ 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 
@@ -30652,8 +30570,6 @@ 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 
@@ -30780,8 +30696,6 @@ 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 
@@ -30929,8 +30843,6 @@ 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 
@@ -31065,8 +30977,6 @@ 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 
@@ -31191,8 +31101,6 @@ 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 
@@ -31388,8 +31296,6 @@ 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
@@ -32401,8 +32307,6 @@ 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
@@ -32685,8 +32589,6 @@ 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}
@@ -33013,8 +32915,6 @@ 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
@@ -33237,8 +33137,6 @@ 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
@@ -33602,8 +33500,6 @@ 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}
@@ -33961,8 +33857,6 @@ 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}
@@ -34180,8 +34074,6 @@ 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
@@ -34399,8 +34291,6 @@ 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}
@@ -34694,8 +34584,6 @@ 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}
@@ -34985,8 +34873,6 @@ 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}
@@ -35307,8 +35193,6 @@ 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}
@@ -35554,8 +35438,6 @@ 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
@@ -35854,8 +35736,6 @@ 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
@@ -36250,8 +36130,6 @@ 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
@@ -36649,8 +36527,6 @@ 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}
@@ -36868,8 +36744,6 @@ 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
@@ -37139,8 +37013,6 @@ 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}
@@ -37393,8 +37265,6 @@ 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
@@ -37669,8 +37539,6 @@ 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}
@@ -37888,8 +37756,6 @@ 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
@@ -38204,8 +38070,6 @@ 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}
@@ -38477,8 +38341,6 @@ 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
@@ -38785,8 +38647,6 @@ 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}
@@ -39096,8 +38956,6 @@ 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}
@@ -39325,8 +39183,6 @@ 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
@@ -39830,8 +39686,6 @@ 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}
@@ -40405,8 +40259,6 @@ 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}
@@ -40703,8 +40555,6 @@ 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}
@@ -41014,8 +40864,6 @@ 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}
@@ -41259,8 +41107,6 @@ 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
@@ -41717,8 +41563,6 @@ 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}
@@ -42139,8 +41983,6 @@ 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}
@@ -42437,8 +42279,6 @@ 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
@@ -42753,8 +42593,6 @@ 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}
@@ -43087,8 +42925,6 @@ 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
@@ -43325,8 +43161,6 @@ 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
@@ -43696,8 +43530,6 @@ 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}
@@ -44061,8 +43893,6 @@ 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}
@@ -44290,8 +44120,6 @@ 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
@@ -44519,8 +44347,6 @@ 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}
@@ -44835,8 +44661,6 @@ 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}
@@ -45143,8 +44967,6 @@ 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}
@@ -45482,8 +45304,6 @@ 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}
@@ -45739,8 +45559,6 @@ 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
@@ -46050,8 +45868,6 @@ 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
@@ -46473,8 +46289,6 @@ 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
@@ -46904,8 +46718,6 @@ 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}
@@ -47137,8 +46949,6 @@ 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
@@ -47385,14 +47195,7 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 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.
+# Knowledge Base
 
 ## Getting Started
 
@@ -47512,14 +47315,7 @@ 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.
+# What is AgentMail and how is it different?
 
 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.
 
@@ -47552,14 +47348,7 @@ 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.
+# What can I do with an AgentMail inbox?
 
 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.
 
@@ -47651,14 +47440,7 @@ 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.
+# How do I create my first inbox?
 
 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.
 
@@ -47751,14 +47533,7 @@ 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.
+# How do I get my API key?
 
 You need an API key to authenticate requests to the AgentMail API. API keys start with `am_` and are created in the AgentMail Console.
 
@@ -47822,14 +47597,7 @@ 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.
+# How do I handle inbound emails with my agent?
 
 AgentMail offers two ways to process incoming emails, each suited to different use cases.
 
@@ -47933,14 +47701,7 @@ 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.
+# How do I set up allowlists and blocklists?
 
 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.
 
@@ -48081,14 +47842,7 @@ 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.
+# How do I manage threaded conversations?
 
 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.
 
@@ -48212,14 +47966,7 @@ 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.
+# How do I build a human-in-the-loop workflow?
 
 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.
 
@@ -48319,14 +48066,7 @@ 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.
-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.
+# How do I use Pods for multi-tenant email?
 
 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.
 
@@ -48440,14 +48180,7 @@ 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.
+# How do I use labels to track email state?
 
 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.
 
@@ -48575,14 +48308,7 @@ 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.
+# How do I set up a custom domain?
 
 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.
 
@@ -48674,14 +48400,7 @@ 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?
-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.
+# How do I set up SPF, DKIM, and DMARC?
 
 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.
 
@@ -48772,14 +48491,7 @@ 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.
+# Why are my emails going to spam?
 
 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.
 
@@ -48844,14 +48556,7 @@ 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
 
 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).
@@ -48926,14 +48631,7 @@ 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.
+# How do I avoid MX record conflicts?
 
 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.
 
@@ -49010,14 +48708,7 @@ 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.
+# What does a 403 error mean?
 
 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.
 
@@ -49079,14 +48770,7 @@ 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.
+# What are the rate limits?
 
 AgentMail is built for high-volume agent workflows. Limits vary by plan.
 
@@ -49140,14 +48824,7 @@ 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.
+# How do I prevent duplicate sends?
 
 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.
 
@@ -49236,14 +48913,7 @@ 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.
+# Why is my domain not verifying?
 
 If your domain is stuck in a pending or failed verification state, work through these common causes.
 
@@ -49315,14 +48985,7 @@ 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.
+# Why are my emails bouncing?
 
 A bounced email means the recipient's mail server rejected your message. Understanding the bounce type helps you take the right action.
 
@@ -49407,14 +49070,7 @@ 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.
+# Why are my emails not showing up?
 
 <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.
@@ -49500,14 +49156,7 @@ If the sender's domain does have SPF/DKIM configured and emails are still not ar
 
 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
-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.
+# DNS Guide: Cloudflare
 
 ## Steps
 
@@ -49575,14 +49224,7 @@ 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
-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.
+# DNS Guide: GoDaddy
 
 ## Steps
 
@@ -49647,14 +49289,7 @@ 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)
-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.
+# DNS Guide: Route 53 (AWS)
 
 ## Steps
 
@@ -49740,14 +49375,7 @@ Route 53 name servers typically pick up changes within **60 seconds**, but full
 
   You can also use the AWS CLI to add the record, which handles multi-string TXT values more reliably.
 
-***
-
-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.
+# DNS Guide: Namecheap
 
 ## Steps