agentmail 0.4.16 → 0.4.18

package/dist/llms-full.txt

@@ -3207,6 +3207,10 @@ A restricted API key cannot create a child key with more permissions than itself
   When a label visibility permission is denied, items with that label are automatically excluded from list results and return "not found" on direct access. For example, setting `label_spam_read` to `false` means the key will never see spam messages in any listing or lookup.
 </Info>
 
+<Callout intent="info" title="Event subscriptions">
+  Label visibility permissions also control whether an API key can subscribe to the corresponding event types on [webhooks](/events) and [WebSockets](/websockets). An API key without `label_spam_read` cannot create a webhook or WebSocket subscription for `message.received.spam` events, and an API key without `label_blocked_read` cannot subscribe to `message.received.blocked` events.
+</Callout>
+
 ### Drafts
 
 | Permission     | Description   |
@@ -5109,6 +5113,82 @@ python agent.py console
 ```
 
 
+***
+
+title: Sim.ai
+subtitle: Connect AgentMail to your Sim.ai workflows
+slug: integrations/sim
+description: AgentMail's Sim.ai integration
+-------------------------------------------
+
+## Getting started
+
+[Sim.ai](https://sim.ai) is a platform for building agentic workflows. By connecting AgentMail to Sim, your workflows can create inboxes, send and receive emails, manage threads, handle drafts, and organize conversations with labels, all without writing backend code.
+
+## Use cases
+
+* **Dynamic inbox creation:** Spin up new inboxes on the fly for each agent, workflow, or customer for multi-tenant email handling.
+* **Automated email processing:** List and read incoming messages, then trigger downstream actions based on content, sender, or labels.
+* **Conversational email:** Reply to threads and forward messages to keep conversations flowing naturally within automated workflows.
+* **Draft and review workflows:** Create drafts, update them with AI-generated content, and send when approved for human-in-the-loop patterns.
+* **Email organization:** Apply labels to threads and messages to categorize, filter, and route emails through your automation pipeline.
+
+## Prerequisites
+
+1. An [AgentMail account](https://agentmail.to/) with an API key from the [AgentMail Console](https://console.agentmail.to)
+2. A [Sim.ai](https://sim.ai) account
+
+## Setup
+
+1. Open your workflow in the Sim builder.
+2. Add the **AgentMail** block from the tools panel.
+3. Paste your AgentMail API key into the configuration.
+4. Select the operation you need (for example, create inbox, send message, or list threads).
+5. Map the input fields to your workflow data and connect the block to the rest of your flow.
+
+## Available operations
+
+Once connected, Sim provides access to the following AgentMail operations:
+
+### Inbox management
+
+| Operation    | Description                                                            |
+| ------------ | ---------------------------------------------------------------------- |
+| Create inbox | Create a new inbox with an optional username, domain, and display name |
+| Get inbox    | Retrieve details for a specific inbox                                  |
+| Delete inbox | Delete an inbox                                                        |
+
+### Message operations
+
+| Operation        | Description                              |
+| ---------------- | ---------------------------------------- |
+| Send message     | Send a new email from an inbox           |
+| Get message      | Retrieve details of a specific message   |
+| Reply to message | Reply to an existing message in a thread |
+| Forward message  | Forward a message to new recipients      |
+
+### Thread management
+
+| Operation     | Description                                                                  |
+| ------------- | ---------------------------------------------------------------------------- |
+| Get thread    | Retrieve a thread and its messages                                           |
+| Delete thread | Delete a thread (moves to trash, or permanently deletes if already in trash) |
+
+### Draft management
+
+| Operation    | Description                          |
+| ------------ | ------------------------------------ |
+| Create draft | Create a new email draft in an inbox |
+| Get draft    | Retrieve details of a specific draft |
+| Delete draft | Delete a draft                       |
+
+## Resources
+
+* [Sim.ai AgentMail tool documentation](https://docs.sim.ai/tools/agentmail)
+* [AgentMail API reference](/api-reference)
+* [Webhooks overview](/webhooks/webhooks-overview)
+
+
 ***
 
 title: 'Guide: Sending & Receiving Email'
@@ -6367,11 +6447,13 @@ This event-driven approach is more efficient and allows you to build fast, respo
 
 ## Available Events
 
-AgentMail supports seven webhook event types. When creating a webhook, you can subscribe to specific events or receive all of them. See [Webhook Events](/events) for full payload details.
+AgentMail supports nine webhook event types. When creating a webhook, you can subscribe to specific events or receive all of them. See [Webhook Events](/events) for full payload details.
 
 **Message events:**
 
 * **`message.received`** — New email received and processed in one of your inboxes
+* **`message.received.spam`** — A message was received and classified as spam (requires `label_spam_read` permission)
+* **`message.received.blocked`** — A message was received and matched a block list entry (requires `label_blocked_read` permission)
 * **`message.sent`** — Message successfully sent from your inbox
 * **`message.delivered`** — Delivery confirmed by the recipient's mail server
 * **`message.bounced`** — Message failed to deliver and bounced back
@@ -6382,6 +6464,10 @@ AgentMail supports seven webhook event types. When creating a webhook, you can s
 
 * **`domain.verified`** — Custom domain successfully verified
 
+<Callout intent="info">
+  Spam and blocked events are excluded by default. To receive them, explicitly include `message.received.spam` or `message.received.blocked` in the `event_types` list when creating a webhook. Messages with these labels are no longer sent as `message.received`.
+</Callout>
+
 ## The Webhook Workflow
 
 The process is straightforward:
@@ -6418,7 +6504,7 @@ The process is straightforward:
       ```
     </CodeBlocks>
 
-    Specify which events to receive; omit `event_types` to subscribe to all event types.
+    Specify which events to receive; omit `event_types` to subscribe to all standard event types. Spam and blocked events must always be explicitly included.
   </Step>
 
   <Step title="3. AgentMail Sends Events">
@@ -6539,8 +6625,9 @@ Copy one of the blocks below into Cursor or Claude for complete Webhooks API kno
   - webhooks.update(webhook_id, add_inbox_ids?, remove_inbox_ids?, add_pod_ids?, remove_pod_ids?)
   - webhooks.delete(webhook_id)
 
-  Events: message.received, message.sent, message.delivered, message.bounced, message.complained, message.rejected, domain.verified
+  Events: message.received, message.received.spam, message.received.blocked, message.sent, message.delivered, message.bounced, message.complained, message.rejected, domain.verified
   Payload: event_type, event_id, plus message/send/delivery/bounce/complaint/reject/domain. Verify with Svix (webhook.secret).
+  Note: message.received.spam and message.received.blocked are excluded by default. To receive them, explicitly include them in event_types and ensure the API key has label_spam_read / label_blocked_read permissions.
   """
   import os
   from dotenv import load_dotenv
@@ -6567,7 +6654,8 @@ Copy one of the blocks below into Cursor or Claude for complete Webhooks API kno
    * - webhooks.update(webhookId, { addInboxIds?, removeInboxIds?, addPodIds?, removePodIds? })
    * - webhooks.delete(webhookId)
    *
-   * Events: message.received, message.sent, message.delivered, message.bounced, message.complained, message.rejected, domain.verified
+   * Events: message.received, message.received.spam, message.received.blocked, message.sent, message.delivered, message.bounced, message.complained, message.rejected, domain.verified
+   * Note: message.received.spam and message.received.blocked are excluded by default. To receive them, explicitly include them in eventTypes and ensure the API key has label_spam_read / label_blocked_read permissions.
    * Verify with Svix using webhook.secret. Use express.raw() for body—signature needs raw payload.
    */
   import { AgentMailClient } from "agentmail";
@@ -6658,6 +6746,12 @@ The AgentMail SDKs export typed classes for each webhook event, so you can parse
     } else if (eventType === "message.rejected") {
       const event = await serialization.events.MessageRejectedEvent.parse(payload);
       console.log(event.reject.reason);
+    } else if (eventType === "message.received.spam") {
+      const event = await serialization.events.MessageReceivedSpamEvent.parse(payload);
+      console.log(event.message.subject);
+    } else if (eventType === "message.received.blocked") {
+      const event = await serialization.events.MessageReceivedBlockedEvent.parse(payload);
+      console.log(event.message.subject);
     } else if (eventType === "domain.verified") {
       const event = await serialization.events.DomainVerifiedEvent.parse(payload);
       console.log(event.domain.status);
@@ -6668,6 +6762,8 @@ The AgentMail SDKs export typed classes for each webhook event, so you can parse
   ```python title="Python"
   from agentmail import (
       MessageReceivedEvent,
+      MessageReceivedSpamEvent,
+      MessageReceivedBlockedEvent,
       MessageSentEvent,
       MessageBouncedEvent,
       MessageDeliveredEvent,
@@ -6699,6 +6795,12 @@ The AgentMail SDKs export typed classes for each webhook event, so you can parse
       elif event_type == "message.rejected":
           event = MessageRejectedEvent(**payload)
           print(event.reject.reason)
+      elif event_type == "message.received.spam":
+          event = MessageReceivedSpamEvent(**payload)
+          print(event.message.subject)
+      elif event_type == "message.received.blocked":
+          event = MessageReceivedBlockedEvent(**payload)
+          print(event.message.subject)
       elif event_type == "domain.verified":
           event = DomainVerifiedEvent(**payload)
           print(event.domain.status)
@@ -6714,12 +6816,15 @@ Copy one of the blocks below into Cursor or Claude for webhook event parsing in
   """
   AgentMail Webhook Events — copy into Cursor/Claude.
 
-  Parse typed events: MessageReceivedEvent (has message+thread), MessageSentEvent (send), MessageBouncedEvent (bounce),
-  MessageDeliveredEvent (delivery), MessageComplainedEvent (complaint), MessageRejectedEvent (reject), DomainVerifiedEvent (domain).
-  Only message.received includes full message+thread; others have send/delivery/bounce/complaint/reject/domain.
+  Parse typed events: MessageReceivedEvent (message.received), MessageReceivedSpamEvent (message.received.spam), MessageReceivedBlockedEvent (message.received.blocked),
+  MessageSentEvent (send), MessageBouncedEvent (bounce), MessageDeliveredEvent (delivery), MessageComplainedEvent (complaint),
+  MessageRejectedEvent (reject), DomainVerifiedEvent (domain).
+  Only message.received* includes full message+thread; others have send/delivery/bounce/complaint/reject/domain.
+  Note: message.received.spam and message.received.blocked require label_spam_read / label_blocked_read permissions.
   """
   from agentmail import (
-    MessageReceivedEvent, MessageSentEvent, MessageBouncedEvent,
+    MessageReceivedEvent, MessageReceivedSpamEvent, MessageReceivedBlockedEvent,
+    MessageSentEvent, MessageBouncedEvent,
     MessageDeliveredEvent, MessageComplainedEvent, MessageRejectedEvent, DomainVerifiedEvent,
   )
 
@@ -6731,6 +6836,8 @@ Copy one of the blocks below into Cursor or Claude for webhook event parsing in
     elif t == "message.delivered": e = MessageDeliveredEvent(**payload)
     elif t == "message.complained": e = MessageComplainedEvent(**payload)
     elif t == "message.rejected": e = MessageRejectedEvent(**payload); print(e.reject.reason)
+    elif t == "message.received.spam": e = MessageReceivedSpamEvent(**payload); print(e.message.subject)
+    elif t == "message.received.blocked": e = MessageReceivedBlockedEvent(**payload); print(e.message.subject)
     elif t == "domain.verified": e = DomainVerifiedEvent(**payload); print(e.domain.status)
   ```
 
@@ -6738,8 +6845,10 @@ Copy one of the blocks below into Cursor or Claude for webhook event parsing in
   /**
    * AgentMail Webhook Events — copy into Cursor/Claude.
    *
-   * Parse with serialization.events.MessageReceivedEvent.parse(payload), etc.
-   * Only message.received has message+thread; others have send/delivery/bounce/complaint/reject/domain.
+   * Parse with serialization.events.<EventType>.parse(payload).
+   * message.received → MessageReceivedEvent, message.received.spam → MessageReceivedSpamEvent, message.received.blocked → MessageReceivedBlockedEvent.
+   * Only message.received* has message+thread; others have send/delivery/bounce/complaint/reject/domain.
+   * message.received.spam and message.received.blocked require label_spam_read / label_blocked_read permissions.
    */
   import { serialization } from "agentmail";
 
@@ -6763,6 +6872,12 @@ Copy one of the blocks below into Cursor or Claude for webhook event parsing in
     } else if (t === "message.rejected") {
       const e = await serialization.events.MessageRejectedEvent.parse(payload);
       console.log(e.reject);
+    } else if (t === "message.received.spam") {
+      const e = await serialization.events.MessageReceivedSpamEvent.parse(payload);
+      console.log(e.message.subject);
+    } else if (t === "message.received.blocked") {
+      const e = await serialization.events.MessageReceivedBlockedEvent.parse(payload);
+      console.log(e.message.subject);
     } else if (t === "domain.verified") {
       const e = await serialization.events.DomainVerifiedEvent.parse(payload);
       console.log(e.domain);
@@ -6833,6 +6948,106 @@ Copy one of the blocks below into Cursor or Claude for webhook event parsing in
   ```
 </CodeGroup>
 
+### `message.received.spam`
+
+* **Description:** Triggered when a new email is received and classified as spam. The payload structure is the same as `message.received`. Messages classified as spam are not delivered as `message.received` events.
+* **Example use-case:** Route spam to a review queue or log spam patterns for analysis.
+
+<Callout intent="warn">
+  This event is only delivered if the API key used to create the webhook has the `label_spam_read` permission. Without this permission, the webhook creation will be rejected with a `403 Forbidden` error.
+</Callout>
+
+<CodeGroup>
+  ```json
+  {
+    "type": "event",
+    "event_type": "message.received.spam",
+    "event_id": "evt_spam123",
+    "message": {
+      "inbox_id": "inbox_456def",
+      "thread_id": "thd_789ghi",
+      "message_id": "<spam123@example.com>",
+      "labels": ["spam"],
+      "timestamp": "2023-10-27T10:00:00Z",
+      "from": "spammer@example.com",
+      "to": ["agent@agentmail.to"],
+      "subject": "Suspicious offer",
+      "preview": "You've been selected...",
+      "text": "Full spam message body.",
+      "html": "<html>...</html>",
+      "size": 1024,
+      "updated_at": "2023-10-27T10:00:00Z",
+      "created_at": "2023-10-27T10:00:00Z"
+    },
+    "thread": {
+      "inbox_id": "inbox_456def",
+      "thread_id": "thd_789ghi",
+      "labels": ["spam"],
+      "timestamp": "2023-10-27T10:00:00Z",
+      "senders": ["spammer@example.com"],
+      "recipients": ["agent@agentmail.to"],
+      "subject": "Suspicious offer",
+      "preview": "You've been selected...",
+      "last_message_id": "<spam123@example.com>",
+      "message_count": 1,
+      "size": 1024,
+      "updated_at": "2023-10-27T10:00:00Z",
+      "created_at": "2023-10-27T10:00:00Z"
+    }
+  }
+  ```
+</CodeGroup>
+
+### `message.received.blocked`
+
+* **Description:** Triggered when a new email is received and matched a block list entry. The payload structure is the same as `message.received`. Messages that match a block list are not delivered as `message.received` events.
+* **Example use-case:** Audit blocked senders or maintain a log of blocked messages.
+
+<Callout intent="warn">
+  This event is only delivered if the API key used to create the webhook has the `label_blocked_read` permission. Without this permission, the webhook creation will be rejected with a `403 Forbidden` error.
+</Callout>
+
+<CodeGroup>
+  ```json
+  {
+    "type": "event",
+    "event_type": "message.received.blocked",
+    "event_id": "evt_blocked456",
+    "message": {
+      "inbox_id": "inbox_456def",
+      "thread_id": "thd_789ghi",
+      "message_id": "<blocked456@example.com>",
+      "labels": ["blocked"],
+      "timestamp": "2023-10-27T10:00:00Z",
+      "from": "blocked-sender@example.com",
+      "to": ["agent@agentmail.to"],
+      "subject": "Blocked message",
+      "preview": "This message was blocked...",
+      "text": "Full blocked message body.",
+      "html": "<html>...</html>",
+      "size": 512,
+      "updated_at": "2023-10-27T10:00:00Z",
+      "created_at": "2023-10-27T10:00:00Z"
+    },
+    "thread": {
+      "inbox_id": "inbox_456def",
+      "thread_id": "thd_789ghi",
+      "labels": ["blocked"],
+      "timestamp": "2023-10-27T10:00:00Z",
+      "senders": ["blocked-sender@example.com"],
+      "recipients": ["agent@agentmail.to"],
+      "subject": "Blocked message",
+      "preview": "This message was blocked...",
+      "last_message_id": "<blocked456@example.com>",
+      "message_count": 1,
+      "size": 512,
+      "updated_at": "2023-10-27T10:00:00Z",
+      "created_at": "2023-10-27T10:00:00Z"
+    }
+  }
+  ```
+</CodeGroup>
+
 ### `message.sent`
 
 * **Description:** Triggered when a message is successfully sent from one of your `Inboxes`.
@@ -7020,6 +7235,10 @@ When creating a webhook, you can specify which events to subscribe to. This allo
 
 For example, if you only need to trigger workflows on incoming messages, you can subscribe to just `message.received`. If you're building a delivery tracking system, you might subscribe to `message.sent`, `message.delivered`, and `message.bounced`.
 
+<Callout intent="info">
+  By default, spam and blocked events are **not** delivered. To receive them, you must explicitly include `message.received.spam` or `message.received.blocked` in the `event_types` list when creating your webhook. The API key must also have the corresponding `label_spam_read` or `label_blocked_read` permission.
+</Callout>
+
 If you have any specific webhook notifications you would like, please ping us in the `#feature-requests` channel in the [Discord](https://discord.gg/hTYatWYWBc)
 
 
@@ -8024,6 +8243,12 @@ Subscribe(
     inbox_ids=["agent@agentmail.to"],
     event_types=["message.received", "message.sent"]
 )
+
+# Subscribe to spam and blocked events (requires label_spam_read / label_blocked_read permissions)
+Subscribe(
+    inbox_ids=["agent@agentmail.to"],
+    event_types=["message.received", "message.received.spam", "message.received.blocked"]
+)
 ```
 
 **TypeScript:**
@@ -8047,8 +8272,19 @@ socket.sendSubscribe({
   inboxIds: ["agent@agentmail.to"],
   eventTypes: ["message.received", "message.sent"],
 });
+
+// Subscribe to spam and blocked events (requires label_spam_read / label_blocked_read permissions)
+socket.sendSubscribe({
+  type: "subscribe",
+  inboxIds: ["agent@agentmail.to"],
+  eventTypes: ["message.received", "message.received.spam", "message.received.blocked"],
+});
 ```
 
+<Callout intent="info">
+  By default (when no `event_types` are specified), spam and blocked events are excluded from the subscription. To receive spam events, explicitly include `message.received.spam` in `event_types` and ensure the API key has the `label_spam_read` permission. The same applies to `message.received.blocked` with the `label_blocked_read` permission.
+</Callout>
+
 ***
 
 ## Event Types
@@ -8061,14 +8297,16 @@ socket.sendSubscribe({
 
 ### Message Events
 
-| Event                | Python                   | TypeScript                         | Description          |
-| -------------------- | ------------------------ | ---------------------------------- | -------------------- |
-| `message_received`   | `MessageReceivedEvent`   | `AgentMail.MessageReceivedEvent`   | New email received   |
-| `message_sent`       | `MessageSentEvent`       | `AgentMail.MessageSentEvent`       | Email was sent       |
-| `message_delivered`  | `MessageDeliveredEvent`  | `AgentMail.MessageDeliveredEvent`  | Email was delivered  |
-| `message_bounced`    | `MessageBouncedEvent`    | `AgentMail.MessageBouncedEvent`    | Email bounced        |
-| `message_complained` | `MessageComplainedEvent` | `AgentMail.MessageComplainedEvent` | Email marked as spam |
-| `message_rejected`   | `MessageRejectedEvent`   | `AgentMail.MessageRejectedEvent`   | Email was rejected   |
+| Event                      | Python                        | TypeScript                              | Description                                |
+| -------------------------- | ----------------------------- | --------------------------------------- | ------------------------------------------ |
+| `message_received`         | `MessageReceivedEvent`        | `AgentMail.MessageReceivedEvent`        | New email received                         |
+| `message_received_spam`    | `MessageReceivedSpamEvent`    | `AgentMail.MessageReceivedSpamEvent`    | Email received, classified as spam         |
+| `message_received_blocked` | `MessageReceivedBlockedEvent` | `AgentMail.MessageReceivedBlockedEvent` | Email received, matched a block list entry |
+| `message_sent`             | `MessageSentEvent`            | `AgentMail.MessageSentEvent`            | Email was sent                             |
+| `message_delivered`        | `MessageDeliveredEvent`       | `AgentMail.MessageDeliveredEvent`       | Email was delivered                        |
+| `message_bounced`          | `MessageBouncedEvent`         | `AgentMail.MessageBouncedEvent`         | Email bounced                              |
+| `message_complained`       | `MessageComplainedEvent`      | `AgentMail.MessageComplainedEvent`      | Email marked as spam                       |
+| `message_rejected`         | `MessageRejectedEvent`        | `AgentMail.MessageRejectedEvent`        | Email was rejected                         |
 
 ### Domain Events
 
@@ -8180,7 +8418,8 @@ Copy one of the blocks below into Cursor or Claude for WebSockets in one shot.
   Sync: with client.websockets.connect() as socket: socket.send_subscribe(Subscribe(inbox_ids=[...])); for event in socket: ...
   Async: async with client.websockets.connect() as socket: await socket.send_subscribe(...); async for event in socket: ...
   Subscribe(inbox_ids=[...], pod_ids=[...], event_types=[...])
-  Event types: Subscribed, MessageReceivedEvent, MessageSentEvent, MessageDeliveredEvent, MessageBouncedEvent, MessageComplainedEvent, MessageRejectedEvent, DomainVerifiedEvent
+  Event types: Subscribed, MessageReceivedEvent, MessageReceivedSpamEvent, MessageReceivedBlockedEvent, MessageSentEvent, MessageDeliveredEvent, MessageBouncedEvent, MessageComplainedEvent, MessageRejectedEvent, DomainVerifiedEvent
+  Spam/blocked events require explicit opt-in via event_types and label_spam_read / label_blocked_read permissions.
   """
   from agentmail import AgentMail, Subscribe, Subscribed, MessageReceivedEvent
 
@@ -17882,6 +18121,242 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+# Delete Message
+
+DELETE https://api.agentmail.to/v0/inboxes/{inbox_id}/messages/{message_id}
+
+Permanently deletes a message.
+
+**CLI:**
+```bash
+agentmail inboxes:messages delete --inbox-id <inbox_id> --message-id <message_id>
+```
+
+Reference: https://docs.agentmail.to/api-reference/inboxes/messages/delete
+
+## OpenAPI Specification
+
+```yaml
+openapi: 3.1.0
+info:
+  title: api
+  version: 1.0.0
+paths:
+  /v0/inboxes/{inbox_id}/messages/{message_id}:
+    delete:
+      operationId: delete
+      summary: Delete Message
+      description: >-
+        Permanently deletes a message.
+
+
+        **CLI:**
+
+        ```bash
+
+        agentmail inboxes:messages delete --inbox-id <inbox_id> --message-id
+        <message_id>
+
+        ```
+      tags:
+        - subpackage_inboxes.subpackage_inboxes/messages
+      parameters:
+        - name: inbox_id
+          in: path
+          required: true
+          schema:
+            $ref: '#/components/schemas/type_inboxes:InboxId'
+        - name: message_id
+          in: path
+          required: true
+          schema:
+            $ref: '#/components/schemas/type_messages:MessageId'
+        - name: Authorization
+          in: header
+          description: Bearer authentication
+          required: true
+          schema:
+            type: string
+      responses:
+        '200':
+          description: Successful response
+        '404':
+          description: Error response with status 404
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/type_:ErrorResponse'
+servers:
+  - url: https://api.agentmail.to
+  - url: https://x402.api.agentmail.to
+  - url: https://mpp.api.agentmail.to
+  - url: https://api.agentmail.eu
+components:
+  schemas:
+    type_inboxes:InboxId:
+      type: string
+      description: The ID of the inbox.
+      title: InboxId
+    type_messages:MessageId:
+      type: string
+      description: ID of message.
+      title: MessageId
+    type_:ErrorName:
+      type: string
+      description: Name of error.
+      title: ErrorName
+    type_:ErrorMessage:
+      type: string
+      description: Error message.
+      title: ErrorMessage
+    type_:ErrorResponse:
+      type: object
+      properties:
+        name:
+          $ref: '#/components/schemas/type_:ErrorName'
+        message:
+          $ref: '#/components/schemas/type_:ErrorMessage'
+      required:
+        - name
+        - message
+      title: ErrorResponse
+  securitySchemes:
+    Bearer:
+      type: http
+      scheme: bearer
+
+```
+
+## SDK Code Examples
+
+```typescript
+import { AgentMailClient } from "agentmail";
+
+async function main() {
+    const client = new AgentMailClient({
+        apiKey: "YOUR_TOKEN_HERE",
+    });
+    await client.inboxes.messages.delete("inbox_id", "message_id");
+}
+main();
+
+```
+
+```python
+from agentmail import AgentMail
+
+client = AgentMail(
+    api_key="YOUR_TOKEN_HERE",
+)
+
+client.inboxes.messages.delete(
+    inbox_id="inbox_id",
+    message_id="message_id",
+)
+
+```
+
+```go
+package main
+
+import (
+	"fmt"
+	"net/http"
+	"io"
+)
+
+func main() {
+
+	url := "https://api.agentmail.to/v0/inboxes/inbox_id/messages/message_id"
+
+	req, _ := http.NewRequest("DELETE", url, nil)
+
+	req.Header.Add("Authorization", "Bearer <api_key>")
+
+	res, _ := http.DefaultClient.Do(req)
+
+	defer res.Body.Close()
+	body, _ := io.ReadAll(res.Body)
+
+	fmt.Println(res)
+	fmt.Println(string(body))
+
+}
+```
+
+```ruby
+require 'uri'
+require 'net/http'
+
+url = URI("https://api.agentmail.to/v0/inboxes/inbox_id/messages/message_id")
+
+http = Net::HTTP.new(url.host, url.port)
+http.use_ssl = true
+
+request = Net::HTTP::Delete.new(url)
+request["Authorization"] = 'Bearer <api_key>'
+
+response = http.request(request)
+puts response.read_body
+```
+
+```java
+import com.mashape.unirest.http.HttpResponse;
+import com.mashape.unirest.http.Unirest;
+
+HttpResponse<String> response = Unirest.delete("https://api.agentmail.to/v0/inboxes/inbox_id/messages/message_id")
+  .header("Authorization", "Bearer <api_key>")
+  .asString();
+```
+
+```php
+<?php
+require_once('vendor/autoload.php');
+
+$client = new \GuzzleHttp\Client();
+
+$response = $client->request('DELETE', 'https://api.agentmail.to/v0/inboxes/inbox_id/messages/message_id', [
+  'headers' => [
+    'Authorization' => 'Bearer <api_key>',
+  ],
+]);
+
+echo $response->getBody();
+```
+
+```csharp
+using RestSharp;
+
+var client = new RestClient("https://api.agentmail.to/v0/inboxes/inbox_id/messages/message_id");
+var request = new RestRequest(Method.DELETE);
+request.AddHeader("Authorization", "Bearer <api_key>");
+IRestResponse response = client.Execute(request);
+```
+
+```swift
+import Foundation
+
+let headers = ["Authorization": "Bearer <api_key>"]
+
+let request = NSMutableURLRequest(url: NSURL(string: "https://api.agentmail.to/v0/inboxes/inbox_id/messages/message_id")! as URL,
+                                        cachePolicy: .useProtocolCachePolicy,
+                                    timeoutInterval: 10.0)
+request.httpMethod = "DELETE"
+request.allHTTPHeaderFields = headers
+
+let session = URLSession.shared
+let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
+  if (error != nil) {
+    print(error as Any)
+  } else {
+    let httpResponse = response as? HTTPURLResponse
+    print(httpResponse)
+  }
+})
+
+dataTask.resume()
+```
+
 # Send Message
 
 POST https://api.agentmail.to/v0/inboxes/{inbox_id}/messages/send
@@ -24315,8 +24790,6 @@ components:
           $ref: '#/components/schemas/type_api-keys:Name'
         permissions:
           $ref: '#/components/schemas/type_api-keys:ApiKeyPermissions'
-      required:
-        - name
       title: CreateApiKeyRequest
     type_api-keys:ApiKeyId:
       type: string
@@ -24406,9 +24879,7 @@ async function main() {
     const client = new AgentMailClient({
         apiKey: "YOUR_TOKEN_HERE",
     });
-    await client.inboxes.apiKeys.create("inbox_id", {
-        name: "name",
-    });
+    await client.inboxes.apiKeys.create("inbox_id", {});
 }
 main();
 
@@ -24423,7 +24894,6 @@ client = AgentMail(
 
 client.inboxes.api_keys.create(
     inbox_id="inbox_id",
-    name="name",
 )
 
 ```
@@ -24442,7 +24912,7 @@ func main() {
 
 	url := "https://api.agentmail.to/v0/inboxes/inbox_id/api-keys"
 
-	payload := strings.NewReader("{\n  \"name\": \"name\"\n}")
+	payload := strings.NewReader("{}")
 
 	req, _ := http.NewRequest("POST", url, payload)
 
@@ -24472,7 +24942,7 @@ http.use_ssl = true
 request = Net::HTTP::Post.new(url)
 request["Authorization"] = 'Bearer <api_key>'
 request["Content-Type"] = 'application/json'
-request.body = "{\n  \"name\": \"name\"\n}"
+request.body = "{}"
 
 response = http.request(request)
 puts response.read_body
@@ -24485,7 +24955,7 @@ import com.mashape.unirest.http.Unirest;
 HttpResponse<String> response = Unirest.post("https://api.agentmail.to/v0/inboxes/inbox_id/api-keys")
   .header("Authorization", "Bearer <api_key>")
   .header("Content-Type", "application/json")
-  .body("{\n  \"name\": \"name\"\n}")
+  .body("{}")
   .asString();
 ```
 
@@ -24496,9 +24966,7 @@ require_once('vendor/autoload.php');
 $client = new \GuzzleHttp\Client();
 
 $response = $client->request('POST', 'https://api.agentmail.to/v0/inboxes/inbox_id/api-keys', [
-  'body' => '{
-  "name": "name"
-}',
+  'body' => '{}',
   'headers' => [
     'Authorization' => 'Bearer <api_key>',
     'Content-Type' => 'application/json',
@@ -24515,7 +24983,7 @@ var client = new RestClient("https://api.agentmail.to/v0/inboxes/inbox_id/api-ke
 var request = new RestRequest(Method.POST);
 request.AddHeader("Authorization", "Bearer <api_key>");
 request.AddHeader("Content-Type", "application/json");
-request.AddParameter("application/json", "{\n  \"name\": \"name\"\n}", ParameterType.RequestBody);
+request.AddParameter("application/json", "{}", ParameterType.RequestBody);
 IRestResponse response = client.Execute(request);
 ```
 
@@ -24526,7 +24994,7 @@ let headers = [
   "Authorization": "Bearer <api_key>",
   "Content-Type": "application/json"
 ]
-let parameters = ["name": "name"] as [String : Any]
+let parameters = [] as [String : Any]
 
 let postData = JSONSerialization.data(withJSONObject: parameters, options: [])
 
@@ -27889,6 +28357,8 @@ components:
       type: string
       enum:
         - message.received
+        - message.received.spam
+        - message.received.blocked
         - message.sent
         - message.delivered
         - message.bounced
@@ -28181,6 +28651,8 @@ components:
       type: string
       enum:
         - message.received
+        - message.received.spam
+        - message.received.blocked
         - message.sent
         - message.delivered
         - message.bounced
@@ -28477,6 +28949,8 @@ components:
       type: string
       enum:
         - message.received
+        - message.received.spam
+        - message.received.blocked
         - message.sent
         - message.delivered
         - message.bounced
@@ -28871,6 +29345,8 @@ components:
       type: string
       enum:
         - message.received
+        - message.received.spam
+        - message.received.blocked
         - message.sent
         - message.delivered
         - message.bounced
@@ -30640,19 +31116,23 @@ channels:
           - $ref: >-
               #/components/messages/subpackage_websockets.websockets-server-1-message_received
           - $ref: >-
-              #/components/messages/subpackage_websockets.websockets-server-2-message_sent
+              #/components/messages/subpackage_websockets.websockets-server-2-message_received_spam
           - $ref: >-
-              #/components/messages/subpackage_websockets.websockets-server-3-message_delivered
+              #/components/messages/subpackage_websockets.websockets-server-3-message_received_blocked
           - $ref: >-
-              #/components/messages/subpackage_websockets.websockets-server-4-message_bounced
+              #/components/messages/subpackage_websockets.websockets-server-4-message_sent
           - $ref: >-
-              #/components/messages/subpackage_websockets.websockets-server-5-message_complained
+              #/components/messages/subpackage_websockets.websockets-server-5-message_delivered
           - $ref: >-
-              #/components/messages/subpackage_websockets.websockets-server-6-message_rejected
+              #/components/messages/subpackage_websockets.websockets-server-6-message_bounced
           - $ref: >-
-              #/components/messages/subpackage_websockets.websockets-server-7-domain_verified
+              #/components/messages/subpackage_websockets.websockets-server-7-message_complained
           - $ref: >-
-              #/components/messages/subpackage_websockets.websockets-server-8-error
+              #/components/messages/subpackage_websockets.websockets-server-8-message_rejected
+          - $ref: >-
+              #/components/messages/subpackage_websockets.websockets-server-9-domain_verified
+          - $ref: >-
+              #/components/messages/subpackage_websockets.websockets-server-10-error
     subscribe:
       operationId: websockets-subscribe
       summary: Client message
@@ -30684,31 +31164,39 @@ components:
       name: message_received
       payload:
         $ref: '#/components/schemas/type_events:MessageReceivedEvent'
-    subpackage_websockets.websockets-server-2-message_sent:
+    subpackage_websockets.websockets-server-2-message_received_spam:
+      name: message_received_spam
+      payload:
+        $ref: '#/components/schemas/type_events:MessageReceivedSpamEvent'
+    subpackage_websockets.websockets-server-3-message_received_blocked:
+      name: message_received_blocked
+      payload:
+        $ref: '#/components/schemas/type_events:MessageReceivedBlockedEvent'
+    subpackage_websockets.websockets-server-4-message_sent:
       name: message_sent
       payload:
         $ref: '#/components/schemas/type_events:MessageSentEvent'
-    subpackage_websockets.websockets-server-3-message_delivered:
+    subpackage_websockets.websockets-server-5-message_delivered:
       name: message_delivered
       payload:
         $ref: '#/components/schemas/type_events:MessageDeliveredEvent'
-    subpackage_websockets.websockets-server-4-message_bounced:
+    subpackage_websockets.websockets-server-6-message_bounced:
       name: message_bounced
       payload:
         $ref: '#/components/schemas/type_events:MessageBouncedEvent'
-    subpackage_websockets.websockets-server-5-message_complained:
+    subpackage_websockets.websockets-server-7-message_complained:
       name: message_complained
       payload:
         $ref: '#/components/schemas/type_events:MessageComplainedEvent'
-    subpackage_websockets.websockets-server-6-message_rejected:
+    subpackage_websockets.websockets-server-8-message_rejected:
       name: message_rejected
       payload:
         $ref: '#/components/schemas/type_events:MessageRejectedEvent'
-    subpackage_websockets.websockets-server-7-domain_verified:
+    subpackage_websockets.websockets-server-9-domain_verified:
       name: domain_verified
       payload:
         $ref: '#/components/schemas/type_events:DomainVerifiedEvent'
-    subpackage_websockets.websockets-server-8-error:
+    subpackage_websockets.websockets-server-10-error:
       name: error
       payload:
         $ref: '#/components/schemas/type_websockets:Error'
@@ -30717,6 +31205,8 @@ components:
       type: string
       enum:
         - message.received
+        - message.received.spam
+        - message.received.blocked
         - message.sent
         - message.delivered
         - message.bounced
@@ -31126,6 +31616,60 @@ components:
         - message
         - thread
       title: MessageReceivedEvent
+    type_events:MessageReceivedSpamEvent:
+      type: object
+      properties:
+        type:
+          type: string
+          enum:
+            - event
+        event_type:
+          type: string
+          enum:
+            - message.received.spam
+        event_id:
+          $ref: '#/components/schemas/type_events:EventId'
+        message:
+          $ref: '#/components/schemas/type_messages:Message'
+        thread:
+          $ref: '#/components/schemas/type_threads:ThreadItem'
+      required:
+        - type
+        - event_type
+        - event_id
+        - message
+        - thread
+      description: >-
+        A message was received and classified as spam. Requires
+        `label_spam_read` permission.
+      title: MessageReceivedSpamEvent
+    type_events:MessageReceivedBlockedEvent:
+      type: object
+      properties:
+        type:
+          type: string
+          enum:
+            - event
+        event_type:
+          type: string
+          enum:
+            - message.received.blocked
+        event_id:
+          $ref: '#/components/schemas/type_events:EventId'
+        message:
+          $ref: '#/components/schemas/type_messages:Message'
+        thread:
+          $ref: '#/components/schemas/type_threads:ThreadItem'
+      required:
+        - type
+        - event_type
+        - event_id
+        - message
+        - thread
+      description: >-
+        A message was received and matched a block list entry. Requires
+        `label_blocked_read` permission.
+      title: MessageReceivedBlockedEvent
     type_events:Timestamp:
       type: string
       format: date-time
@@ -35560,8 +36104,6 @@ components:
           $ref: '#/components/schemas/type_api-keys:Name'
         permissions:
           $ref: '#/components/schemas/type_api-keys:ApiKeyPermissions'
-      required:
-        - name
       title: CreateApiKeyRequest
     type_api-keys:ApiKeyId:
       type: string
@@ -35636,9 +36178,7 @@ async function main() {
     const client = new AgentMailClient({
         apiKey: "YOUR_TOKEN_HERE",
     });
-    await client.apiKeys.create({
-        name: "name",
-    });
+    await client.apiKeys.create({});
 }
 main();
 
@@ -35651,9 +36191,7 @@ client = AgentMail(
     api_key="YOUR_TOKEN_HERE",
 )
 
-client.api_keys.create(
-    name="name",
-)
+client.api_keys.create()
 
 ```
 
@@ -35671,7 +36209,7 @@ func main() {
 
 	url := "https://api.agentmail.to/v0/api-keys"
 
-	payload := strings.NewReader("{\n  \"name\": \"name\"\n}")
+	payload := strings.NewReader("{}")
 
 	req, _ := http.NewRequest("POST", url, payload)
 
@@ -35701,7 +36239,7 @@ http.use_ssl = true
 request = Net::HTTP::Post.new(url)
 request["Authorization"] = 'Bearer <api_key>'
 request["Content-Type"] = 'application/json'
-request.body = "{\n  \"name\": \"name\"\n}"
+request.body = "{}"
 
 response = http.request(request)
 puts response.read_body
@@ -35714,7 +36252,7 @@ import com.mashape.unirest.http.Unirest;
 HttpResponse<String> response = Unirest.post("https://api.agentmail.to/v0/api-keys")
   .header("Authorization", "Bearer <api_key>")
   .header("Content-Type", "application/json")
-  .body("{\n  \"name\": \"name\"\n}")
+  .body("{}")
   .asString();
 ```
 
@@ -35725,9 +36263,7 @@ require_once('vendor/autoload.php');
 $client = new \GuzzleHttp\Client();
 
 $response = $client->request('POST', 'https://api.agentmail.to/v0/api-keys', [
-  'body' => '{
-  "name": "name"
-}',
+  'body' => '{}',
   'headers' => [
     'Authorization' => 'Bearer <api_key>',
     'Content-Type' => 'application/json',
@@ -35744,7 +36280,7 @@ var client = new RestClient("https://api.agentmail.to/v0/api-keys");
 var request = new RestRequest(Method.POST);
 request.AddHeader("Authorization", "Bearer <api_key>");
 request.AddHeader("Content-Type", "application/json");
-request.AddParameter("application/json", "{\n  \"name\": \"name\"\n}", ParameterType.RequestBody);
+request.AddParameter("application/json", "{}", ParameterType.RequestBody);
 IRestResponse response = client.Execute(request);
 ```
 
@@ -35755,7 +36291,7 @@ let headers = [
   "Authorization": "Bearer <api_key>",
   "Content-Type": "application/json"
 ]
-let parameters = ["name": "name"] as [String : Any]
+let parameters = [] as [String : Any]
 
 let postData = JSONSerialization.data(withJSONObject: parameters, options: [])
 
@@ -45750,8 +46286,6 @@ components:
           $ref: '#/components/schemas/type_api-keys:Name'
         permissions:
           $ref: '#/components/schemas/type_api-keys:ApiKeyPermissions'
-      required:
-        - name
       title: CreateApiKeyRequest
     type_api-keys:ApiKeyId:
       type: string
@@ -45841,9 +46375,7 @@ async function main() {
     const client = new AgentMailClient({
         apiKey: "YOUR_TOKEN_HERE",
     });
-    await client.pods.apiKeys.create("pod_id", {
-        name: "name",
-    });
+    await client.pods.apiKeys.create("pod_id", {});
 }
 main();
 
@@ -45858,7 +46390,6 @@ client = AgentMail(
 
 client.pods.api_keys.create(
     pod_id="pod_id",
-    name="name",
 )
 
 ```
@@ -45877,7 +46408,7 @@ func main() {
 
 	url := "https://api.agentmail.to/v0/pods/pod_id/api-keys"
 
-	payload := strings.NewReader("{\n  \"name\": \"name\"\n}")
+	payload := strings.NewReader("{}")
 
 	req, _ := http.NewRequest("POST", url, payload)
 
@@ -45907,7 +46438,7 @@ http.use_ssl = true
 request = Net::HTTP::Post.new(url)
 request["Authorization"] = 'Bearer <api_key>'
 request["Content-Type"] = 'application/json'
-request.body = "{\n  \"name\": \"name\"\n}"
+request.body = "{}"
 
 response = http.request(request)
 puts response.read_body
@@ -45920,7 +46451,7 @@ import com.mashape.unirest.http.Unirest;
 HttpResponse<String> response = Unirest.post("https://api.agentmail.to/v0/pods/pod_id/api-keys")
   .header("Authorization", "Bearer <api_key>")
   .header("Content-Type", "application/json")
-  .body("{\n  \"name\": \"name\"\n}")
+  .body("{}")
   .asString();
 ```
 
@@ -45931,9 +46462,7 @@ require_once('vendor/autoload.php');
 $client = new \GuzzleHttp\Client();
 
 $response = $client->request('POST', 'https://api.agentmail.to/v0/pods/pod_id/api-keys', [
-  'body' => '{
-  "name": "name"
-}',
+  'body' => '{}',
   'headers' => [
     'Authorization' => 'Bearer <api_key>',
     'Content-Type' => 'application/json',
@@ -45950,7 +46479,7 @@ var client = new RestClient("https://api.agentmail.to/v0/pods/pod_id/api-keys");
 var request = new RestRequest(Method.POST);
 request.AddHeader("Authorization", "Bearer <api_key>");
 request.AddHeader("Content-Type", "application/json");
-request.AddParameter("application/json", "{\n  \"name\": \"name\"\n}", ParameterType.RequestBody);
+request.AddParameter("application/json", "{}", ParameterType.RequestBody);
 IRestResponse response = client.Execute(request);
 ```
 
@@ -45961,7 +46490,7 @@ let headers = [
   "Authorization": "Bearer <api_key>",
   "Content-Type": "application/json"
 ]
-let parameters = ["name": "name"] as [String : Any]
+let parameters = [] as [String : Any]
 
 let postData = JSONSerialization.data(withJSONObject: parameters, options: [])