agentmail 0.0.74 → 0.0.75

package/dist/llms-full.txt

@@ -171,7 +171,7 @@ This guide will walk you through installing the AgentMail SDK, authenticating wi
   <Step title="Create an API Key">
     Now that you're in the console, you'll need to create an API key to
     authenticate your requests. Navigate to the API Keys section in your console
-    dashboard. ![API Key Creation Screenshot](file:f61138eb-087c-462b-907b-eb87a63a124b) Click
+    dashboard. ![API Key Creation Screenshot](file:1fc73677-732a-471f-ab3d-7b2583d4a850) Click
     "Create New API Key" and give it a descriptive name. Once created, copy the
     API key and store it securely. Create a `.env` file in your project's root
     directory and add your key to it. We recommend using environment variables to
@@ -312,7 +312,7 @@ Unlike traditional email providers that are designed for human scale, AgentMail
 
 As the diagram below illustrates, your `organization` is the top-level container that holds all your resources. You can provision many `Inboxes` within your `organization`, each with its own `Threads`, `Messages`, and `Attachments`, allowing you to manage a large fleet of agents seamlessly.
 
-<img src="file:1802e71c-cb35-4e45-98db-10be02667722" alt="AgentMail Organizational Hierarchy" />
+<img src="file:fa5e559e-fca8-4272-861d-c360f7919946" alt="AgentMail Organizational Hierarchy" />
 
 <Steps>
   <Step title="Organization">
@@ -737,7 +737,7 @@ Here is an example of a well-structured and styled HTML header:
 </CodeBlocks>
 
 <Frame caption="Look how pretty this message looks!">
-  <img src="file:29e71512-beed-4991-ba0a-d9f4882f4d66" alt="rendered css" />
+  <img src="file:910e614f-d48b-401c-bb37-5c9f52fa2d3d" alt="rendered css" />
 </Frame>
 
 ## Receiving `Messages`
@@ -1274,6 +1274,244 @@ Similarly, you can retrieve an `Attachment` if you know the `Thread` it's in, wh
 </CodeBlocks>
 
 
+# Pods
+
+> Learn how to use pods for multi-tenant email management
+
+## What are Pods?
+
+Pods are an isolated abstraction that sits between your **organization** and your **inboxes**, providing a method to segment and organize email infrastructure for multi-tenant applications. If you're building a service that offers email functionality to your customers, pods are your key to ensure customer resource isolation.
+
+### The Hierarchy
+
+```
+Organization (Your Business)
+    └── Pod (Your Customer A)
+        ├── Inbox 1
+        ├── Inbox 2
+        └── Domain 1
+    └── Pod (Your Customer B)
+        ├── Inbox 3
+        ├── Inbox 4
+        └── Domain 2
+```
+
+**Organization**: Your company's AgentMail account
+
+* You have one organization that represents your business
+
+**Pod**: Each of your customers
+
+* Create one pod per customer/tenant in your system
+* Pods provide complete isolation between your customers' data
+* All resources (inboxes, domains, threads, drafts) can be scoped to a pod
+
+**Inbox**: Individual email accounts within a pod
+
+* Your customers can have multiple inboxes within their pod
+* It is on you to provision resources for each of your customers
+
+## Why Use Pods?
+
+### Multi-Tenancy
+
+Pods enable you to offer AgentMail's email infrastructure to your own customers while maintaining strict data isolation. Here's how our customers use pods:
+
+**SaaS/Agency Platforms**: Create a pod for each customer account. Each customer gets their own isolated email workspace.
+
+**White-Label Email**: Offer email services under your own brand. Each end-user gets their own pod with complete data isolation.
+
+**AI Agent Platforms**: Give each AI agent with its own purpose its own pod with dedicated inboxes and domains.
+
+## How Pods Work
+
+### Pod Lifecycle
+
+As a basis, here are a couple of logistical stuff that happens on the API side when you create resources.
+
+* When you sign up, you are automatically created a `Default Pod`, and all resources created whether its `Inboxes` or `Domains` all are associated with this `Default Pod`.
+* You cannot delete a `Pod` that has existing children resources. Make sure to delete any existing `Inboxes` or `Domains` before deleting a `Pod`.
+
+### What You Can Do With Pods
+
+#### Creating Resources
+
+You can create the following resources **within** a pod:
+
+* **Inboxes**
+* **Domains**
+
+<Callout>
+  NOTE: as of now domains can only be either scoped to one pod, or all pods. I.E
+  it is not possible to create a domain scoped to more than one but not all
+  pods.
+</Callout>
+
+<Tip>
+  TIP: specify a `client_id` when creating a `Pod` so that you can decide how to
+  uniquely identify pods. That way you don't need to create a table mapping your
+  `organization_id`'s for your customers or segment of your business to our
+  `pod_id`'s you can just set the `client_id` as your internal id so you can
+  access the resource using a unique identifier determined by you!
+</Tip>
+
+These resources are automatically associated with the pod and inherit its isolation guarantees.
+
+#### Listing Resources
+
+You can list the following resources **scoped to** a pod:
+
+* **Inboxes** (`GET /pods/{pod_id}/inboxes`) - View all inboxes in a pod
+* **Threads** (`GET /pods/{pod_id}/threads`) - View all email conversations across all inboxes in the pod
+* **Drafts** (`GET /pods/{pod_id}/drafts`) - View all draft emails across all inboxes in the pod
+* **Domains** (`GET /pods/{pod_id}/domains`) - View all custom domains in the pod
+
+This gives you a unified view of all activity within a customer's workspace, making it easy to build features like:
+
+* "Show me all unread emails for Customer X" (use labels here too!)
+* "List all threads across all of Customer Y's team inboxes"
+* "Display all pending drafts for Customer Z"
+
+## Important Considerations
+
+### Pod Deletion Constraints
+
+<Warning>
+  **Critical**: You cannot delete a pod that has resources still attached to it.
+  You must delete all inboxes and domains within the pod before you can delete
+  the pod itself.
+</Warning>
+
+This is a safety mechanism to prevent accidental data loss. Here's the correct deletion sequence:
+
+```typescript
+// This will FAIL if the pod has any resources
+await client.pods.delete(podId);
+
+// Correct approach: Clean up resources first
+async function offboardCustomer(podId: string) {
+  // 1. Delete all inboxes
+  const inboxes = await client.inboxes.list(podId);
+  for (const inbox of inboxes.items) {
+    await client.inboxes.delete(inbox.inbox_id);
+  }
+
+  // 2. Delete all domains
+  const domains = await client.domains.list({ podId });
+  for (const domain of domains.items) {
+    await client.domains.delete(domain.domain_id);
+  }
+
+  // 3. Now you can delete the pod
+  await client.pods.delete(podId);
+}
+```
+
+<Info>
+  When you delete an inbox or domain, all associated data (messages, threads,
+  drafts) is automatically cleaned up. You don't need to manually delete
+  individual threads or messages.
+</Info>
+
+**What's NOT Isolated to a Pod:**
+
+* API keys (these are organization-level and can access any resources in any pod)
+
+## Common Patterns and Use Cases
+
+### Pattern 1: Multi-Tenant SaaS
+
+Each company using your platform gets their own pod:
+
+```typescript
+// Customer A's workspace
+Pod: "Acme Corp"
+├── Inbox: support@acme.com
+├── Inbox: sales@acme.com
+└── Domain: acme.com
+
+// Customer B's workspace
+Pod: "TechStart Inc"
+├── Inbox: hello@techstart.io
+├── Inbox: team@techstart.io
+└── Domain: techstart.io
+```
+
+### Pattern 2: Agency Client Management
+
+Each client gets their own isolated pod:
+
+```typescript
+// Client 1
+Pod: "Client - Retail Co"
+├── Inbox: info@retailco.com
+└── Domain: retailco.com
+
+// Client 2
+Pod: "Client - FinTech"
+├── Inbox: support@fintech.ai
+└── Domain: fintech.ai
+```
+
+### Pattern 3: AI Agent Platform
+
+Each AI agent gets its own pod with dedicated email infrastructure:
+
+```typescript
+// Agent 1: Customer Support Agent
+Pod: "Support-Agent"
+├── Inbox: support@mycompany.com
+├── Inbox: help@mycompany.com
+└── Inbox: tickets@mycompany.com
+
+// Agent 2: Sales Outreach Agent
+Pod: "Sales-Agent"
+├── Inbox: sales@mycompany.com
+├── Inbox: outreach@mycompany.com
+└── Inbox: leads@mycompany.com
+
+// Agent 3: Marketing Agent
+Pod: "Marketing-Agent"
+├── Inbox: newsletter@mycompany.com
+├── Inbox: campaigns@mycompany.com
+└── Inbox: events@mycompany.com
+```
+
+## FAQ
+
+<Accordion title="Can inboxes communicate between pods?">
+  Yes! Inboxes in different pods can send and receive emails from each other
+  just like any other email addresses. Pods only provide organizational
+  isolation, not network isolation.
+</Accordion>
+
+<Accordion title="Can I move an inbox from one pod to another?">
+  No, inboxes cannot be moved between pods. You will need to create a new inbox
+  in the pod you want.
+</Accordion>
+
+<Accordion title="How many pods can I create?">
+  There's no hard limit on the number of pods. You can create as many as you
+  need for your customers.
+</Accordion>
+
+<Accordion title="Do I need to use pods?">
+  Pods are optional but highly recommended for multi-tenant applications. If
+  you're only managing email for your own organization, you can work directly
+  with inboxes without creating pods.
+</Accordion>
+
+<Accordion title="Can I set custom permissions per pod?">
+  Pod isolation is upon the caller (you). As of now we don't support pod-scoped
+  API keys so it will be on you to make the calls to AgentMail.
+</Accordion>
+
+## Next Steps
+
+* 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
+
+
 # Guide: Sending & Receiving Email
 
 > A step-by-step guide to the practical workflow of sending initial emails and handling replies to have a full conversation.
@@ -1526,7 +1764,7 @@ Configuring your domain is a three-step process: add the domain via API, copy th
     After creating your domain in the AgentMail Console, click the "Download BIND Zone File" button to get the complete zone file.
 
     <Frame caption="Downloading BIND zone file from AgentMail Console">
-      <img src="file:9f941a37-dfe7-4cdb-a847-360edc644bc9" alt="Download BIND Zone File from Console" />
+      <img src="file:75f060dd-3273-4cf3-a310-6fd55b3bd02b" alt="Download BIND Zone File from Console" />
     </Frame>
 
     <Tabs>
@@ -1537,13 +1775,13 @@ Configuring your domain is a three-step process: add the domain via API, copy th
         2. Click **"Import zone file"** in the top right corner
 
         <Frame caption="Importing BIND zone file in AWS Route 53">
-          <img src="file:5e7ebde4-2c2e-4385-a81b-68e39ae37362" alt="AWS Route 53 BIND Import" />
+          <img src="file:1943061e-7e23-4e64-8fda-5337c9a6c0c2" alt="AWS Route 53 BIND Import" />
         </Frame>
 
         3. Paste the CONTENTS of downloaded BIND zone file
 
         <Frame caption="Open the file with text editor and paste the contents. It should look similar to what we have in this image.">
-          <img src="file:3c3d7a5d-a069-47f3-a6f8-58fab87c73ec" alt="AWS Route 53 BIND Import" />
+          <img src="file:6fefb292-915e-4282-ad94-156693ed8fb7" alt="AWS Route 53 BIND Import" />
         </Frame>
 
         4. Review the records and click **"Import"**
@@ -1556,13 +1794,13 @@ Configuring your domain is a three-step process: add the domain via API, copy th
         2. Navigate to **DNS > Records**
 
         <Frame caption="This is what the page looks like">
-          <img src="file:1d0b27f8-314c-4d79-a62e-062a9144b280" alt="Cloudflare BIND Import" />
+          <img src="file:52d94562-142b-4883-a9ea-2455f6439c3e" alt="Cloudflare BIND Import" />
         </Frame>
 
         3. Click **"Import and Export"**
 
         <Frame caption="You should be able to just drop the file in">
-          <img src="file:0f4783c6-731a-42c5-8edb-e57c3e11f2b5" alt="Cloudflare BIND Import" />
+          <img src="file:f5f6e4ab-8dcb-4c59-afe5-bc869012e2ed" alt="Cloudflare BIND Import" />
         </Frame>
 
         4. Upload the downloaded BIND zone file as is
@@ -1575,13 +1813,13 @@ Configuring your domain is a three-step process: add the domain via API, copy th
         2. Navigate to the **DNS** subtab of the domain you want to send from
 
         <Frame caption="Click on this button!">
-          <img src="file:132fa64e-0aed-4f2b-87eb-908f0389fba6" alt="Porkbun DNS Management" />
+          <img src="file:978afc32-618c-4178-8c06-657227921a94" alt="Porkbun DNS Management" />
         </Frame>
 
         3. Scroll down to the quick upload section
 
         <Frame caption="Upload your BIND zone file here">
-          <img src="file:856c15e7-d2b4-4e45-8069-1d746a98cdd1" alt="Porkbun Zone File Import" />
+          <img src="file:f5f600d9-1dbf-4dd5-ae22-1169b5c8f7db" alt="Porkbun Zone File Import" />
         </Frame>
 
         4. Upload the downloaded BIND zone file as is
@@ -1665,7 +1903,7 @@ Configuring your domain is a three-step process: add the domain via API, copy th
               * **Value:** Can directly copy paste the `value` from the API response (e.g., `{random_letters_numbers}.dkim.amazonses.com`).
 
             <Frame caption="Example of adding a CNAME record in Route 53. Notice that AWS already appends the root domain (agentmail.cc) to the end of the name value!">
-              <img src="file:11ee535f-3f9d-4ff8-872d-5d23ac36bb98" alt="AWS Route 53 Record Configuration" />
+              <img src="file:72b2da60-69c0-4e3e-9840-916833c19dcf" alt="AWS Route 53 Record Configuration" />
             </Frame>
 
             * **TXT (DMARC/SPF):**
@@ -2224,7 +2462,7 @@ How you send your emails is just as important as what you send. If you're sendin
     more natural to email providers. AgentMail's ability to create inboxes at
     scale makes this strategy easy to implement.
 
-    <img src="file:50f3ca52-44f2-484e-8635-648bf87b45d3" alt="Diagram comparing one inbox sending 1000 emails vs. five inboxes sending 200 each." />
+    <img src="file:a59d7929-c6e0-4ba5-bfeb-523ab850700b" alt="Diagram comparing one inbox sending 1000 emails vs. five inboxes sending 200 each." />
   </Step>
 
   <Step title="Protect Your Reputation with Multiple Domains">
@@ -10860,8 +11098,6 @@ components:
   schemas:
     type_domains:DomainId:
       type: string
-    type_domains:DomainName:
-      type: string
     type_domains:VerificationStatus:
       type: string
       enum:
@@ -10906,8 +11142,6 @@ components:
       properties:
         domain_id:
           $ref: '#/components/schemas/type_domains:DomainId'
-        domain:
-          $ref: '#/components/schemas/type_domains:DomainName'
         status:
           $ref: '#/components/schemas/type_domains:VerificationStatus'
         feedback_enabled:
@@ -10926,7 +11160,6 @@ components:
           format: date-time
       required:
         - domain_id
-        - domain
         - status
         - feedback_enabled
         - records
@@ -11165,8 +11398,6 @@ components:
       properties:
         domain_id:
           $ref: '#/components/schemas/type_domains:DomainId'
-        domain:
-          $ref: '#/components/schemas/type_domains:DomainName'
         status:
           $ref: '#/components/schemas/type_domains:VerificationStatus'
         feedback_enabled:
@@ -11185,7 +11416,6 @@ components:
           format: date-time
       required:
         - domain_id
-        - domain
         - status
         - feedback_enabled
         - records
@@ -12620,114 +12850,1378 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
-# List Metrics
+# Message Received
 
-GET https://api.agentmail.to/v0/metrics
+POST 
 
-Reference: https://docs.agentmail.to/api-reference/metrics/list
+Reference: https://docs.agentmail.to/api-reference/webhooks/events/message-received
 
-## OpenAPI Specification
+## OpenAPI 3.1 Webhook Specification
 
 ```yaml
 openapi: 3.1.1
 info:
-  title: List Metrics
-  version: endpoint_metrics.list
-paths:
-  /v0/metrics:
-    get:
-      operationId: list
-      summary: List Metrics
+  title: Message Received
+  version: subpackage_webhooks/events.messageReceived
+webhooks:
+  message-received:
+    post:
+      operationId: message-received
+      summary: Message Received
       tags:
-        - - subpackage_metrics
+        - subpackage_webhooks,subpackage_webhooks/events
       parameters:
-        - name: event_types
-          in: query
-          required: false
-          schema:
-            $ref: '#/components/schemas/type_metrics:MetricEventTypes'
-        - name: start_timestamp
-          in: query
+        - name: svix-id
+          in: header
           required: true
           schema:
-            $ref: '#/components/schemas/type_metrics:MetricStartTimestamp'
-        - name: end_timestamp
-          in: query
+            $ref: '#/components/schemas/type_webhooks/events:SvixId'
+        - name: svix-signature
+          in: header
           required: true
           schema:
-            $ref: '#/components/schemas/type_metrics:MetricEndTimestamp'
-        - name: Authorization
+            $ref: '#/components/schemas/type_webhooks/events:SvixSignature'
+        - name: svix-timestamp
           in: header
-          description: >-
-            Bearer authentication of the form `Bearer <token>`, where token is
-            your auth token.
           required: true
           schema:
-            type: string
+            $ref: '#/components/schemas/type_webhooks/events:SvixTimestamp'
       responses:
         '200':
-          description: Response with status 200
-          content:
-            application/json:
-              schema:
-                $ref: '#/components/schemas/type_metrics:ListMetricsResponse'
-        '404':
-          description: Error response with status 404
-          content: {}
+          description: Webhook received successfully
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/type_events:MessageReceivedEvent'
 components:
   schemas:
-    type_metrics:MetricEventType:
+    type_webhooks/events:SvixId:
       type: string
-      enum:
-        - value: message.sent
-        - value: message.delivered
-        - value: message.bounced
-        - value: message.delayed
-        - value: message.rejected
-        - value: message.complained
-        - value: message.received
-    type_metrics:MetricEventTypes:
+    type_webhooks/events:SvixSignature:
+      type: string
+    type_webhooks/events:SvixTimestamp:
+      type: string
+      format: date-time
+    type_events:EventId:
+      type: string
+    type_inboxes:InboxId:
+      type: string
+    type_threads:ThreadId:
+      type: string
+    type_messages:MessageId:
+      type: string
+    type_messages:MessageLabels:
       type: array
       items:
-        $ref: '#/components/schemas/type_metrics:MetricEventType'
-    type_metrics:MetricStartTimestamp:
+        type: string
+    type_messages:MessageTimestamp:
       type: string
       format: date-time
-    type_metrics:MetricEndTimestamp:
+    type_messages:MessageFrom:
+      type: string
+    type_messages:MessageTo:
+      type: array
+      items:
+        type: string
+    type_messages:MessageCc:
+      type: array
+      items:
+        type: string
+    type_messages:MessageBcc:
+      type: array
+      items:
+        type: string
+    type_messages:MessageSubject:
+      type: string
+    type_messages:MessagePreview:
+      type: string
+    type_messages:MessageText:
+      type: string
+    type_messages:MessageHtml:
+      type: string
+    type_attachments:AttachmentId:
+      type: string
+    type_attachments:AttachmentFilename:
+      type: string
+    type_attachments:AttachmentContentType:
+      type: string
+    type_attachments:AttachmentSize:
+      type: integer
+    type_attachments:AttachmentInline:
+      type: boolean
+    type_attachments:Attachment:
+      type: object
+      properties:
+        attachment_id:
+          $ref: '#/components/schemas/type_attachments:AttachmentId'
+        filename:
+          $ref: '#/components/schemas/type_attachments:AttachmentFilename'
+        content_type:
+          $ref: '#/components/schemas/type_attachments:AttachmentContentType'
+        size:
+          $ref: '#/components/schemas/type_attachments:AttachmentSize'
+        inline:
+          $ref: '#/components/schemas/type_attachments:AttachmentInline'
+      required:
+        - attachment_id
+        - size
+        - inline
+    type_messages:MessageAttachments:
+      type: array
+      items:
+        $ref: '#/components/schemas/type_attachments:Attachment'
+    type_messages:MessageInReplyTo:
+      type: string
+    type_messages:MessageReferences:
+      type: array
+      items:
+        type: string
+    type_messages:MessageSize:
+      type: integer
+    type_messages:MessageUpdatedAt:
       type: string
       format: date-time
-    type_metrics:MetricTimestamp:
+    type_messages:MessageCreatedAt:
       type: string
       format: date-time
-    type_metrics:MessageMetrics:
+    type_messages:Message:
       type: object
       properties:
-        sent:
-          type: array
-          items:
-            $ref: '#/components/schemas/type_metrics:MetricTimestamp'
-        delivered:
-          type: array
-          items:
-            $ref: '#/components/schemas/type_metrics:MetricTimestamp'
-        bounced:
-          type: array
-          items:
-            $ref: '#/components/schemas/type_metrics:MetricTimestamp'
-        delayed:
-          type: array
-          items:
-            $ref: '#/components/schemas/type_metrics:MetricTimestamp'
-        rejected:
-          type: array
-          items:
-            $ref: '#/components/schemas/type_metrics:MetricTimestamp'
-        complained:
+        inbox_id:
+          $ref: '#/components/schemas/type_inboxes:InboxId'
+        thread_id:
+          $ref: '#/components/schemas/type_threads:ThreadId'
+        message_id:
+          $ref: '#/components/schemas/type_messages:MessageId'
+        labels:
+          $ref: '#/components/schemas/type_messages:MessageLabels'
+        timestamp:
+          $ref: '#/components/schemas/type_messages:MessageTimestamp'
+        from:
+          $ref: '#/components/schemas/type_messages:MessageFrom'
+        reply_to:
           type: array
           items:
-            $ref: '#/components/schemas/type_metrics:MetricTimestamp'
-        received:
-          type: array
+            type: string
+        to:
+          $ref: '#/components/schemas/type_messages:MessageTo'
+        cc:
+          $ref: '#/components/schemas/type_messages:MessageCc'
+        bcc:
+          $ref: '#/components/schemas/type_messages:MessageBcc'
+        subject:
+          $ref: '#/components/schemas/type_messages:MessageSubject'
+        preview:
+          $ref: '#/components/schemas/type_messages:MessagePreview'
+        text:
+          $ref: '#/components/schemas/type_messages:MessageText'
+        html:
+          $ref: '#/components/schemas/type_messages:MessageHtml'
+        attachments:
+          $ref: '#/components/schemas/type_messages:MessageAttachments'
+        in_reply_to:
+          $ref: '#/components/schemas/type_messages:MessageInReplyTo'
+        references:
+          $ref: '#/components/schemas/type_messages:MessageReferences'
+        size:
+          $ref: '#/components/schemas/type_messages:MessageSize'
+        updated_at:
+          $ref: '#/components/schemas/type_messages:MessageUpdatedAt'
+        created_at:
+          $ref: '#/components/schemas/type_messages:MessageCreatedAt'
+      required:
+        - inbox_id
+        - thread_id
+        - message_id
+        - labels
+        - timestamp
+        - from
+        - to
+        - size
+        - updated_at
+        - created_at
+    type_events:MessageReceivedEvent:
+      type: object
+      properties:
+        type:
+          type: string
+          enum:
+            - type: stringLiteral
+              value: event
+        event_type:
+          type: string
+          enum:
+            - type: stringLiteral
+              value: message.received
+        event_id:
+          $ref: '#/components/schemas/type_events:EventId'
+        message:
+          $ref: '#/components/schemas/type_messages:Message'
+      required:
+        - type
+        - event_type
+        - event_id
+        - message
+
+```
+
+# Message Sent
+
+POST 
+
+Reference: https://docs.agentmail.to/api-reference/webhooks/events/message-sent
+
+## OpenAPI 3.1 Webhook Specification
+
+```yaml
+openapi: 3.1.1
+info:
+  title: Message Sent
+  version: subpackage_webhooks/events.messageSent
+webhooks:
+  message-sent:
+    post:
+      operationId: message-sent
+      summary: Message Sent
+      tags:
+        - subpackage_webhooks,subpackage_webhooks/events
+      parameters:
+        - name: svix-id
+          in: header
+          required: true
+          schema:
+            $ref: '#/components/schemas/type_webhooks/events:SvixId'
+        - name: svix-signature
+          in: header
+          required: true
+          schema:
+            $ref: '#/components/schemas/type_webhooks/events:SvixSignature'
+        - name: svix-timestamp
+          in: header
+          required: true
+          schema:
+            $ref: '#/components/schemas/type_webhooks/events:SvixTimestamp'
+      responses:
+        '200':
+          description: Webhook received successfully
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/type_events:MessageSentEvent'
+components:
+  schemas:
+    type_webhooks/events:SvixId:
+      type: string
+    type_webhooks/events:SvixSignature:
+      type: string
+    type_webhooks/events:SvixTimestamp:
+      type: string
+      format: date-time
+    type_events:EventId:
+      type: string
+    type_inboxes:InboxId:
+      type: string
+    type_messages:MessageId:
+      type: string
+    type_events:Timestamp:
+      type: string
+      format: date-time
+    type_events:Send:
+      type: object
+      properties:
+        inbox_id:
+          $ref: '#/components/schemas/type_inboxes:InboxId'
+        message_id:
+          $ref: '#/components/schemas/type_messages:MessageId'
+        timestamp:
+          $ref: '#/components/schemas/type_events:Timestamp'
+        recipients:
+          type: array
+          items:
+            type: string
+      required:
+        - inbox_id
+        - message_id
+        - timestamp
+        - recipients
+    type_events:MessageSentEvent:
+      type: object
+      properties:
+        type:
+          type: string
+          enum:
+            - type: stringLiteral
+              value: event
+        event_type:
+          type: string
+          enum:
+            - type: stringLiteral
+              value: message.sent
+        event_id:
+          $ref: '#/components/schemas/type_events:EventId'
+        send:
+          $ref: '#/components/schemas/type_events:Send'
+      required:
+        - type
+        - event_type
+        - event_id
+        - send
+
+```
+
+# Message Delivered
+
+POST 
+
+Reference: https://docs.agentmail.to/api-reference/webhooks/events/message-delivered
+
+## OpenAPI 3.1 Webhook Specification
+
+```yaml
+openapi: 3.1.1
+info:
+  title: Message Delivered
+  version: subpackage_webhooks/events.messageDelivered
+webhooks:
+  message-delivered:
+    post:
+      operationId: message-delivered
+      summary: Message Delivered
+      tags:
+        - subpackage_webhooks,subpackage_webhooks/events
+      parameters:
+        - name: svix-id
+          in: header
+          required: true
+          schema:
+            $ref: '#/components/schemas/type_webhooks/events:SvixId'
+        - name: svix-signature
+          in: header
+          required: true
+          schema:
+            $ref: '#/components/schemas/type_webhooks/events:SvixSignature'
+        - name: svix-timestamp
+          in: header
+          required: true
+          schema:
+            $ref: '#/components/schemas/type_webhooks/events:SvixTimestamp'
+      responses:
+        '200':
+          description: Webhook received successfully
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/type_events:MessageDeliveredEvent'
+components:
+  schemas:
+    type_webhooks/events:SvixId:
+      type: string
+    type_webhooks/events:SvixSignature:
+      type: string
+    type_webhooks/events:SvixTimestamp:
+      type: string
+      format: date-time
+    type_events:EventId:
+      type: string
+    type_inboxes:InboxId:
+      type: string
+    type_messages:MessageId:
+      type: string
+    type_events:Timestamp:
+      type: string
+      format: date-time
+    type_events:Delivery:
+      type: object
+      properties:
+        inbox_id:
+          $ref: '#/components/schemas/type_inboxes:InboxId'
+        message_id:
+          $ref: '#/components/schemas/type_messages:MessageId'
+        timestamp:
+          $ref: '#/components/schemas/type_events:Timestamp'
+        recipients:
+          type: array
+          items:
+            type: string
+      required:
+        - inbox_id
+        - message_id
+        - timestamp
+        - recipients
+    type_events:MessageDeliveredEvent:
+      type: object
+      properties:
+        type:
+          type: string
+          enum:
+            - type: stringLiteral
+              value: event
+        event_type:
+          type: string
+          enum:
+            - type: stringLiteral
+              value: message.delivered
+        event_id:
+          $ref: '#/components/schemas/type_events:EventId'
+        delivery:
+          $ref: '#/components/schemas/type_events:Delivery'
+      required:
+        - type
+        - event_type
+        - event_id
+        - delivery
+
+```
+
+# Message Bounced
+
+POST 
+
+Reference: https://docs.agentmail.to/api-reference/webhooks/events/message-bounced
+
+## OpenAPI 3.1 Webhook Specification
+
+```yaml
+openapi: 3.1.1
+info:
+  title: Message Bounced
+  version: subpackage_webhooks/events.messageBounced
+webhooks:
+  message-bounced:
+    post:
+      operationId: message-bounced
+      summary: Message Bounced
+      tags:
+        - subpackage_webhooks,subpackage_webhooks/events
+      parameters:
+        - name: svix-id
+          in: header
+          required: true
+          schema:
+            $ref: '#/components/schemas/type_webhooks/events:SvixId'
+        - name: svix-signature
+          in: header
+          required: true
+          schema:
+            $ref: '#/components/schemas/type_webhooks/events:SvixSignature'
+        - name: svix-timestamp
+          in: header
+          required: true
+          schema:
+            $ref: '#/components/schemas/type_webhooks/events:SvixTimestamp'
+      responses:
+        '200':
+          description: Webhook received successfully
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/type_events:MessageBouncedEvent'
+components:
+  schemas:
+    type_webhooks/events:SvixId:
+      type: string
+    type_webhooks/events:SvixSignature:
+      type: string
+    type_webhooks/events:SvixTimestamp:
+      type: string
+      format: date-time
+    type_events:EventId:
+      type: string
+    type_inboxes:InboxId:
+      type: string
+    type_messages:MessageId:
+      type: string
+    type_events:Timestamp:
+      type: string
+      format: date-time
+    type_events:Recipient:
+      type: object
+      properties:
+        address:
+          type: string
+        status:
+          type: string
+      required:
+        - address
+        - status
+    type_events:Bounce:
+      type: object
+      properties:
+        inbox_id:
+          $ref: '#/components/schemas/type_inboxes:InboxId'
+        message_id:
+          $ref: '#/components/schemas/type_messages:MessageId'
+        timestamp:
+          $ref: '#/components/schemas/type_events:Timestamp'
+        type:
+          type: string
+        sub_type:
+          type: string
+        recipients:
+          type: array
+          items:
+            $ref: '#/components/schemas/type_events:Recipient'
+      required:
+        - inbox_id
+        - message_id
+        - timestamp
+        - type
+        - sub_type
+        - recipients
+    type_events:MessageBouncedEvent:
+      type: object
+      properties:
+        type:
+          type: string
+          enum:
+            - type: stringLiteral
+              value: event
+        event_type:
+          type: string
+          enum:
+            - type: stringLiteral
+              value: message.bounced
+        event_id:
+          $ref: '#/components/schemas/type_events:EventId'
+        bounce:
+          $ref: '#/components/schemas/type_events:Bounce'
+      required:
+        - type
+        - event_type
+        - event_id
+        - bounce
+
+```
+
+# Message Complained
+
+POST 
+
+Reference: https://docs.agentmail.to/api-reference/webhooks/events/message-complained
+
+## OpenAPI 3.1 Webhook Specification
+
+```yaml
+openapi: 3.1.1
+info:
+  title: Message Complained
+  version: subpackage_webhooks/events.messageComplained
+webhooks:
+  message-complained:
+    post:
+      operationId: message-complained
+      summary: Message Complained
+      tags:
+        - subpackage_webhooks,subpackage_webhooks/events
+      parameters:
+        - name: svix-id
+          in: header
+          required: true
+          schema:
+            $ref: '#/components/schemas/type_webhooks/events:SvixId'
+        - name: svix-signature
+          in: header
+          required: true
+          schema:
+            $ref: '#/components/schemas/type_webhooks/events:SvixSignature'
+        - name: svix-timestamp
+          in: header
+          required: true
+          schema:
+            $ref: '#/components/schemas/type_webhooks/events:SvixTimestamp'
+      responses:
+        '200':
+          description: Webhook received successfully
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/type_events:MessageComplainedEvent'
+components:
+  schemas:
+    type_webhooks/events:SvixId:
+      type: string
+    type_webhooks/events:SvixSignature:
+      type: string
+    type_webhooks/events:SvixTimestamp:
+      type: string
+      format: date-time
+    type_events:EventId:
+      type: string
+    type_inboxes:InboxId:
+      type: string
+    type_messages:MessageId:
+      type: string
+    type_events:Timestamp:
+      type: string
+      format: date-time
+    type_events:Complaint:
+      type: object
+      properties:
+        inbox_id:
+          $ref: '#/components/schemas/type_inboxes:InboxId'
+        message_id:
+          $ref: '#/components/schemas/type_messages:MessageId'
+        timestamp:
+          $ref: '#/components/schemas/type_events:Timestamp'
+        type:
+          type: string
+        sub_type:
+          type: string
+        recipients:
+          type: array
+          items:
+            type: string
+      required:
+        - inbox_id
+        - message_id
+        - timestamp
+        - type
+        - sub_type
+        - recipients
+    type_events:MessageComplainedEvent:
+      type: object
+      properties:
+        type:
+          type: string
+          enum:
+            - type: stringLiteral
+              value: event
+        event_type:
+          type: string
+          enum:
+            - type: stringLiteral
+              value: message.complained
+        event_id:
+          $ref: '#/components/schemas/type_events:EventId'
+        complaint:
+          $ref: '#/components/schemas/type_events:Complaint'
+      required:
+        - type
+        - event_type
+        - event_id
+        - complaint
+
+```
+
+# Message Rejected
+
+POST 
+
+Reference: https://docs.agentmail.to/api-reference/webhooks/events/message-rejected
+
+## OpenAPI 3.1 Webhook Specification
+
+```yaml
+openapi: 3.1.1
+info:
+  title: Message Rejected
+  version: subpackage_webhooks/events.messageRejected
+webhooks:
+  message-rejected:
+    post:
+      operationId: message-rejected
+      summary: Message Rejected
+      tags:
+        - subpackage_webhooks,subpackage_webhooks/events
+      parameters:
+        - name: svix-id
+          in: header
+          required: true
+          schema:
+            $ref: '#/components/schemas/type_webhooks/events:SvixId'
+        - name: svix-signature
+          in: header
+          required: true
+          schema:
+            $ref: '#/components/schemas/type_webhooks/events:SvixSignature'
+        - name: svix-timestamp
+          in: header
+          required: true
+          schema:
+            $ref: '#/components/schemas/type_webhooks/events:SvixTimestamp'
+      responses:
+        '200':
+          description: Webhook received successfully
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/type_events:MessageRejectedEvent'
+components:
+  schemas:
+    type_webhooks/events:SvixId:
+      type: string
+    type_webhooks/events:SvixSignature:
+      type: string
+    type_webhooks/events:SvixTimestamp:
+      type: string
+      format: date-time
+    type_events:EventId:
+      type: string
+    type_inboxes:InboxId:
+      type: string
+    type_messages:MessageId:
+      type: string
+    type_events:Timestamp:
+      type: string
+      format: date-time
+    type_events:Reject:
+      type: object
+      properties:
+        inbox_id:
+          $ref: '#/components/schemas/type_inboxes:InboxId'
+        message_id:
+          $ref: '#/components/schemas/type_messages:MessageId'
+        timestamp:
+          $ref: '#/components/schemas/type_events:Timestamp'
+        reason:
+          type: string
+      required:
+        - inbox_id
+        - message_id
+        - timestamp
+        - reason
+    type_events:MessageRejectedEvent:
+      type: object
+      properties:
+        type:
+          type: string
+          enum:
+            - type: stringLiteral
+              value: event
+        event_type:
+          type: string
+          enum:
+            - type: stringLiteral
+              value: message.rejected
+        event_id:
+          $ref: '#/components/schemas/type_events:EventId'
+        reject:
+          $ref: '#/components/schemas/type_events:Reject'
+      required:
+        - type
+        - event_type
+        - event_id
+        - reject
+
+```
+
+# Connect
+
+GET /v0
+
+Reference: https://docs.agentmail.to/api-reference/websockets/websockets
+
+## AsyncAPI Specification
+
+```yaml
+asyncapi: 2.6.0
+info:
+  title: Connect
+  version: subpackage_websockets.websockets
+channels:
+  /v0:
+    bindings:
+      ws:
+        query:
+          type: object
+          properties:
+            auth_token:
+              type: string
+    publish:
+      operationId: websockets-publish
+      summary: Server messages
+      message:
+        oneOf:
+          - $ref: >-
+              #/components/messages/subpackage_websockets.websockets-server-0-subscribed
+          - $ref: >-
+              #/components/messages/subpackage_websockets.websockets-server-1-message_received
+          - $ref: >-
+              #/components/messages/subpackage_websockets.websockets-server-2-message_sent
+          - $ref: >-
+              #/components/messages/subpackage_websockets.websockets-server-3-message_delivered
+          - $ref: >-
+              #/components/messages/subpackage_websockets.websockets-server-4-message_bounced
+          - $ref: >-
+              #/components/messages/subpackage_websockets.websockets-server-5-message_complained
+          - $ref: >-
+              #/components/messages/subpackage_websockets.websockets-server-6-message_rejected
+    subscribe:
+      operationId: websockets-subscribe
+      summary: Client message
+      message:
+        name: subscribe
+        payload:
+          $ref: '#/components/schemas/type_websockets:Subscribe'
+servers:
+  Production:
+    url: wss://ws.agentmail.to/
+    protocol: wss
+    x-default: true
+  Development:
+    url: wss://ws.agentmail.dev/
+    protocol: wss
+components:
+  messages:
+    subpackage_websockets.websockets-server-0-subscribed:
+      name: subscribed
+      payload:
+        $ref: '#/components/schemas/type_websockets:Subscribed'
+    subpackage_websockets.websockets-server-1-message_received:
+      name: message_received
+      payload:
+        $ref: '#/components/schemas/type_events:MessageReceivedEvent'
+    subpackage_websockets.websockets-server-2-message_sent:
+      name: message_sent
+      payload:
+        $ref: '#/components/schemas/type_events:MessageSentEvent'
+    subpackage_websockets.websockets-server-3-message_delivered:
+      name: message_delivered
+      payload:
+        $ref: '#/components/schemas/type_events:MessageDeliveredEvent'
+    subpackage_websockets.websockets-server-4-message_bounced:
+      name: message_bounced
+      payload:
+        $ref: '#/components/schemas/type_events:MessageBouncedEvent'
+    subpackage_websockets.websockets-server-5-message_complained:
+      name: message_complained
+      payload:
+        $ref: '#/components/schemas/type_events:MessageComplainedEvent'
+    subpackage_websockets.websockets-server-6-message_rejected:
+      name: message_rejected
+      payload:
+        $ref: '#/components/schemas/type_events:MessageRejectedEvent'
+  schemas:
+    type_websockets:Subscribed:
+      type: object
+      properties:
+        type:
+          type: string
+          enum:
+            - type: stringLiteral
+              value: subscribed
+        inbox_ids:
+          type: array
+          items:
+            type: string
+      required:
+        - type
+        - inbox_ids
+    type_events:EventId:
+      type: string
+    type_inboxes:InboxId:
+      type: string
+    type_threads:ThreadId:
+      type: string
+    type_messages:MessageId:
+      type: string
+    type_messages:MessageLabels:
+      type: array
+      items:
+        type: string
+    type_messages:MessageTimestamp:
+      type: string
+      format: date-time
+    type_messages:MessageFrom:
+      type: string
+    type_messages:MessageTo:
+      type: array
+      items:
+        type: string
+    type_messages:MessageCc:
+      type: array
+      items:
+        type: string
+    type_messages:MessageBcc:
+      type: array
+      items:
+        type: string
+    type_messages:MessageSubject:
+      type: string
+    type_messages:MessagePreview:
+      type: string
+    type_messages:MessageText:
+      type: string
+    type_messages:MessageHtml:
+      type: string
+    type_attachments:AttachmentId:
+      type: string
+    type_attachments:AttachmentFilename:
+      type: string
+    type_attachments:AttachmentContentType:
+      type: string
+    type_attachments:AttachmentSize:
+      type: integer
+    type_attachments:AttachmentInline:
+      type: boolean
+    type_attachments:Attachment:
+      type: object
+      properties:
+        attachment_id:
+          $ref: '#/components/schemas/type_attachments:AttachmentId'
+        filename:
+          $ref: '#/components/schemas/type_attachments:AttachmentFilename'
+        content_type:
+          $ref: '#/components/schemas/type_attachments:AttachmentContentType'
+        size:
+          $ref: '#/components/schemas/type_attachments:AttachmentSize'
+        inline:
+          $ref: '#/components/schemas/type_attachments:AttachmentInline'
+      required:
+        - attachment_id
+        - size
+        - inline
+    type_messages:MessageAttachments:
+      type: array
+      items:
+        $ref: '#/components/schemas/type_attachments:Attachment'
+    type_messages:MessageInReplyTo:
+      type: string
+    type_messages:MessageReferences:
+      type: array
+      items:
+        type: string
+    type_messages:MessageSize:
+      type: integer
+    type_messages:MessageUpdatedAt:
+      type: string
+      format: date-time
+    type_messages:MessageCreatedAt:
+      type: string
+      format: date-time
+    type_messages:Message:
+      type: object
+      properties:
+        inbox_id:
+          $ref: '#/components/schemas/type_inboxes:InboxId'
+        thread_id:
+          $ref: '#/components/schemas/type_threads:ThreadId'
+        message_id:
+          $ref: '#/components/schemas/type_messages:MessageId'
+        labels:
+          $ref: '#/components/schemas/type_messages:MessageLabels'
+        timestamp:
+          $ref: '#/components/schemas/type_messages:MessageTimestamp'
+        from:
+          $ref: '#/components/schemas/type_messages:MessageFrom'
+        reply_to:
+          type: array
+          items:
+            type: string
+        to:
+          $ref: '#/components/schemas/type_messages:MessageTo'
+        cc:
+          $ref: '#/components/schemas/type_messages:MessageCc'
+        bcc:
+          $ref: '#/components/schemas/type_messages:MessageBcc'
+        subject:
+          $ref: '#/components/schemas/type_messages:MessageSubject'
+        preview:
+          $ref: '#/components/schemas/type_messages:MessagePreview'
+        text:
+          $ref: '#/components/schemas/type_messages:MessageText'
+        html:
+          $ref: '#/components/schemas/type_messages:MessageHtml'
+        attachments:
+          $ref: '#/components/schemas/type_messages:MessageAttachments'
+        in_reply_to:
+          $ref: '#/components/schemas/type_messages:MessageInReplyTo'
+        references:
+          $ref: '#/components/schemas/type_messages:MessageReferences'
+        size:
+          $ref: '#/components/schemas/type_messages:MessageSize'
+        updated_at:
+          $ref: '#/components/schemas/type_messages:MessageUpdatedAt'
+        created_at:
+          $ref: '#/components/schemas/type_messages:MessageCreatedAt'
+      required:
+        - inbox_id
+        - thread_id
+        - message_id
+        - labels
+        - timestamp
+        - from
+        - to
+        - size
+        - updated_at
+        - created_at
+    type_events:MessageReceivedEvent:
+      type: object
+      properties:
+        type:
+          type: string
+          enum:
+            - type: stringLiteral
+              value: event
+        event_type:
+          type: string
+          enum:
+            - type: stringLiteral
+              value: message.received
+        event_id:
+          $ref: '#/components/schemas/type_events:EventId'
+        message:
+          $ref: '#/components/schemas/type_messages:Message'
+      required:
+        - type
+        - event_type
+        - event_id
+        - message
+    type_events:Timestamp:
+      type: string
+      format: date-time
+    type_events:Send:
+      type: object
+      properties:
+        inbox_id:
+          $ref: '#/components/schemas/type_inboxes:InboxId'
+        message_id:
+          $ref: '#/components/schemas/type_messages:MessageId'
+        timestamp:
+          $ref: '#/components/schemas/type_events:Timestamp'
+        recipients:
+          type: array
+          items:
+            type: string
+      required:
+        - inbox_id
+        - message_id
+        - timestamp
+        - recipients
+    type_events:MessageSentEvent:
+      type: object
+      properties:
+        type:
+          type: string
+          enum:
+            - type: stringLiteral
+              value: event
+        event_type:
+          type: string
+          enum:
+            - type: stringLiteral
+              value: message.sent
+        event_id:
+          $ref: '#/components/schemas/type_events:EventId'
+        send:
+          $ref: '#/components/schemas/type_events:Send'
+      required:
+        - type
+        - event_type
+        - event_id
+        - send
+    type_events:Delivery:
+      type: object
+      properties:
+        inbox_id:
+          $ref: '#/components/schemas/type_inboxes:InboxId'
+        message_id:
+          $ref: '#/components/schemas/type_messages:MessageId'
+        timestamp:
+          $ref: '#/components/schemas/type_events:Timestamp'
+        recipients:
+          type: array
+          items:
+            type: string
+      required:
+        - inbox_id
+        - message_id
+        - timestamp
+        - recipients
+    type_events:MessageDeliveredEvent:
+      type: object
+      properties:
+        type:
+          type: string
+          enum:
+            - type: stringLiteral
+              value: event
+        event_type:
+          type: string
+          enum:
+            - type: stringLiteral
+              value: message.delivered
+        event_id:
+          $ref: '#/components/schemas/type_events:EventId'
+        delivery:
+          $ref: '#/components/schemas/type_events:Delivery'
+      required:
+        - type
+        - event_type
+        - event_id
+        - delivery
+    type_events:Recipient:
+      type: object
+      properties:
+        address:
+          type: string
+        status:
+          type: string
+      required:
+        - address
+        - status
+    type_events:Bounce:
+      type: object
+      properties:
+        inbox_id:
+          $ref: '#/components/schemas/type_inboxes:InboxId'
+        message_id:
+          $ref: '#/components/schemas/type_messages:MessageId'
+        timestamp:
+          $ref: '#/components/schemas/type_events:Timestamp'
+        type:
+          type: string
+        sub_type:
+          type: string
+        recipients:
+          type: array
+          items:
+            $ref: '#/components/schemas/type_events:Recipient'
+      required:
+        - inbox_id
+        - message_id
+        - timestamp
+        - type
+        - sub_type
+        - recipients
+    type_events:MessageBouncedEvent:
+      type: object
+      properties:
+        type:
+          type: string
+          enum:
+            - type: stringLiteral
+              value: event
+        event_type:
+          type: string
+          enum:
+            - type: stringLiteral
+              value: message.bounced
+        event_id:
+          $ref: '#/components/schemas/type_events:EventId'
+        bounce:
+          $ref: '#/components/schemas/type_events:Bounce'
+      required:
+        - type
+        - event_type
+        - event_id
+        - bounce
+    type_events:Complaint:
+      type: object
+      properties:
+        inbox_id:
+          $ref: '#/components/schemas/type_inboxes:InboxId'
+        message_id:
+          $ref: '#/components/schemas/type_messages:MessageId'
+        timestamp:
+          $ref: '#/components/schemas/type_events:Timestamp'
+        type:
+          type: string
+        sub_type:
+          type: string
+        recipients:
+          type: array
+          items:
+            type: string
+      required:
+        - inbox_id
+        - message_id
+        - timestamp
+        - type
+        - sub_type
+        - recipients
+    type_events:MessageComplainedEvent:
+      type: object
+      properties:
+        type:
+          type: string
+          enum:
+            - type: stringLiteral
+              value: event
+        event_type:
+          type: string
+          enum:
+            - type: stringLiteral
+              value: message.complained
+        event_id:
+          $ref: '#/components/schemas/type_events:EventId'
+        complaint:
+          $ref: '#/components/schemas/type_events:Complaint'
+      required:
+        - type
+        - event_type
+        - event_id
+        - complaint
+    type_events:Reject:
+      type: object
+      properties:
+        inbox_id:
+          $ref: '#/components/schemas/type_inboxes:InboxId'
+        message_id:
+          $ref: '#/components/schemas/type_messages:MessageId'
+        timestamp:
+          $ref: '#/components/schemas/type_events:Timestamp'
+        reason:
+          type: string
+      required:
+        - inbox_id
+        - message_id
+        - timestamp
+        - reason
+    type_events:MessageRejectedEvent:
+      type: object
+      properties:
+        type:
+          type: string
+          enum:
+            - type: stringLiteral
+              value: event
+        event_type:
+          type: string
+          enum:
+            - type: stringLiteral
+              value: message.rejected
+        event_id:
+          $ref: '#/components/schemas/type_events:EventId'
+        reject:
+          $ref: '#/components/schemas/type_events:Reject'
+      required:
+        - type
+        - event_type
+        - event_id
+        - reject
+    type_websockets:Subscribe:
+      type: object
+      properties:
+        type:
+          type: string
+          enum:
+            - type: stringLiteral
+              value: subscribe
+        inbox_ids:
+          type: array
+          items:
+            type: string
+      required:
+        - type
+        - inbox_ids
+
+```
+
+# List Metrics
+
+GET https://api.agentmail.to/v0/metrics
+
+Reference: https://docs.agentmail.to/api-reference/metrics/list
+
+## OpenAPI Specification
+
+```yaml
+openapi: 3.1.1
+info:
+  title: List Metrics
+  version: endpoint_metrics.list
+paths:
+  /v0/metrics:
+    get:
+      operationId: list
+      summary: List Metrics
+      tags:
+        - - subpackage_metrics
+      parameters:
+        - name: event_types
+          in: query
+          required: false
+          schema:
+            $ref: '#/components/schemas/type_metrics:MetricEventTypes'
+        - name: start_timestamp
+          in: query
+          required: true
+          schema:
+            $ref: '#/components/schemas/type_metrics:MetricStartTimestamp'
+        - name: end_timestamp
+          in: query
+          required: true
+          schema:
+            $ref: '#/components/schemas/type_metrics:MetricEndTimestamp'
+        - name: Authorization
+          in: header
+          description: >-
+            Bearer authentication of the form `Bearer <token>`, where token is
+            your auth token.
+          required: true
+          schema:
+            type: string
+      responses:
+        '200':
+          description: Response with status 200
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/type_metrics:ListMetricsResponse'
+        '404':
+          description: Error response with status 404
+          content: {}
+components:
+  schemas:
+    type_metrics:MetricEventType:
+      type: string
+      enum:
+        - value: message.sent
+        - value: message.delivered
+        - value: message.bounced
+        - value: message.delayed
+        - value: message.rejected
+        - value: message.complained
+        - value: message.received
+    type_metrics:MetricEventTypes:
+      type: array
+      items:
+        $ref: '#/components/schemas/type_metrics:MetricEventType'
+    type_metrics:MetricStartTimestamp:
+      type: string
+      format: date-time
+    type_metrics:MetricEndTimestamp:
+      type: string
+      format: date-time
+    type_metrics:MetricTimestamp:
+      type: string
+      format: date-time
+    type_metrics:MessageMetrics:
+      type: object
+      properties:
+        sent:
+          type: array
+          items:
+            $ref: '#/components/schemas/type_metrics:MetricTimestamp'
+        delivered:
+          type: array
+          items:
+            $ref: '#/components/schemas/type_metrics:MetricTimestamp'
+        bounced:
+          type: array
+          items:
+            $ref: '#/components/schemas/type_metrics:MetricTimestamp'
+        delayed:
+          type: array
+          items:
+            $ref: '#/components/schemas/type_metrics:MetricTimestamp'
+        rejected:
+          type: array
+          items:
+            $ref: '#/components/schemas/type_metrics:MetricTimestamp'
+        complained:
+          type: array
+          items:
+            $ref: '#/components/schemas/type_metrics:MetricTimestamp'
+        received:
+          type: array
           items:
             $ref: '#/components/schemas/type_metrics:MetricTimestamp'
     type_metrics:ListMetricsResponse:
@@ -17217,8 +18711,6 @@ components:
       properties:
         domain_id:
           $ref: '#/components/schemas/type_domains:DomainId'
-        domain:
-          $ref: '#/components/schemas/type_domains:DomainName'
         status:
           $ref: '#/components/schemas/type_domains:VerificationStatus'
         feedback_enabled:
@@ -17237,7 +18729,6 @@ components:
           format: date-time
       required:
         - domain_id
-        - domain
         - status
         - feedback_enabled
         - records