agentmail 0.4.1 → 0.4.2

package/dist/llms-full.txt

@@ -763,7 +763,7 @@ Replying to an existing `Message` adds your new `Message` to the same `Thread`,
   # Python example
   reply = client.inboxes.messages.reply(
       inbox_id='my_inbox@domain.com'
-      message_id='msg_id',
+      message_id='<abc123@agentmail.to>',
       text="Thanks for the referral!",
       attachments=[
           SendAttachment(
@@ -781,7 +781,7 @@ Replying to an existing `Message` adds your new `Message` to the same `Thread`,
 
   const reply = await client.inboxes.messages.reply(
   	"my_inbox@domain.com",
-  	"msg_id",
+  	"<abc123@agentmail.to>",
   	{
   		text: "Thanks for the referral!",
   		attachments: [
@@ -810,7 +810,7 @@ You can retrieve the details of any specific `Message` by providing its ID along
 <CodeBlocks>
   ```python title="Python"
 
-  message = client.inboxes.messages.get(inbox_id = 'my_inbox@agentmail.to', message_id = 'msg_id')
+  message = client.inboxes.messages.get(inbox_id = 'my_inbox@agentmail.to', message_id = '<abc123@agentmail.to>')
 
   print(f"Retrieved message with subject: {message.subject}")
 
@@ -820,7 +820,7 @@ You can retrieve the details of any specific `Message` by providing its ID along
 
   await client.inboxes.messages.get(
   	"my_inbox@domain.com",
-  	"msg_id"
+  	"<abc123@agentmail.to>"
   )
 
   console.log(`Retrieved message with subject: ${message.subject}`);
@@ -1568,7 +1568,7 @@ You can modify the `Labels` on a `Message` that has already been sent using the
 
   client.messages.update(
   inbox_id='outbound@domain.com',
-  message_id='msg_id_123',
+  message_id='<abc123@agentmail.to>',
   add_labels=["resolved"],
   remove_labels=['unresolved']
   )
@@ -1581,7 +1581,7 @@ You can modify the `Labels` on a `Message` that has already been sent using the
 
   await client.inboxes.messages.update(
     "my_inbox@domain.com",
-    "msg_id_123",
+    "<abc123@agentmail.to>",
     {
       addLabels: [
           "resolved"
@@ -1656,7 +1656,7 @@ Copy one of the blocks below into Cursor or Claude for complete Labels usage in
   client.inboxes.messages.send("out@agentmail.to", to="user@example.com", subject="Hi", text="Body", labels=["q4-campaign"])
 
   # Update labels
-  client.inboxes.messages.update("out@agentmail.to", "msg_123", add_labels=["resolved"], remove_labels=["pending"])
+  client.inboxes.messages.update("out@agentmail.to", "<abc123@agentmail.to>", add_labels=["resolved"], remove_labels=["pending"])
 
   # Filter by labels
   threads = client.inboxes.threads.list("out@agentmail.to", labels=["q4-campaign", "follow-up"])
@@ -1685,7 +1685,7 @@ Copy one of the blocks below into Cursor or Claude for complete Labels usage in
       text: "Body",
       labels: ["q4-campaign"],
     });
-    await client.inboxes.messages.update("out@agentmail.to", "msg_123", {
+    await client.inboxes.messages.update("out@agentmail.to", "<abc123@agentmail.to>", {
       addLabels: ["resolved"],
       removeLabels: ["pending"],
     });
@@ -1941,7 +1941,7 @@ If you know the `Message` an `Attachment` belongs to, you can retrieve it direct
 <CodeBlocks>
   ```python
   inbox_id = "inbox_123"
-  message_id = "msg_456"
+  message_id = "<def456@agentmail.to>"
   attachment_id = "attach_789" # From the message object
 
   file_data = client.inboxes.messages.get_attachment(
@@ -1959,7 +1959,7 @@ If you know the `Message` an `Attachment` belongs to, you can retrieve it direct
 
   ```typescript title="TypeScript"
   const inboxId = "inbox_123";
-  const messageId = "msg_456";
+  const messageId = "<def456@agentmail.to>";
   const attachmentId = "attach_789"; // From the message object
 
   const fileData = await client.inboxes.messages.get_attachment(
@@ -2035,7 +2035,7 @@ Copy one of the blocks below into Cursor or Claude for complete Attachments usag
     attachments=[{"content": encoded, "filename": "report.txt", "content_type": "text/plain"}],
   )
 
-  data = client.inboxes.messages.get_attachment("inbox@am.to", "msg_123", "att_456")
+  data = client.inboxes.messages.get_attachment("inbox@am.to", "<abc123@agentmail.to>", "att_456")
   with open("downloaded.pdf", "wb") as f:
     f.write(data)
   ```
@@ -2062,7 +2062,7 @@ Copy one of the blocks below into Cursor or Claude for complete Attachments usag
     attachments: [{ content: encoded, filename: "report.txt", contentType: "text/plain" }],
   });
 
-  const data = await client.inboxes.messages.get_attachment("inbox@am.to", "msg_123", "att_456");
+  const data = await client.inboxes.messages.get_attachment("inbox@am.to", "<abc123@agentmail.to>", "att_456");
   ```
 </CodeBlocks>
 
@@ -3049,7 +3049,7 @@ curl -X POST -H "Authorization: Bearer $AGENTMAIL_API_KEY" \
   -H "Content-Type: application/json" \
   -d '{
     "url": "https://your-openclaw-webhook-url",
-    "events": ["message.received"]
+    "event_types": ["message.received"]
   }' \
   https://api.agentmail.to/v0/webhooks
 ```
@@ -4502,19 +4502,19 @@ The process is straightforward:
       ```python
       client.webhooks.create(
           url="https://<your-ngrok-url>.ngrok-free.app/webhooks",
-          events=["message.received", "message.sent"],
+          event_types=["message.received", "message.sent"],
       )
       ```
 
       ```typescript
       await client.webhooks.create({
           url: "https://<your-ngrok-url>.ngrok-free.app/webhooks",
-          events: ["message.received", "message.sent"],
+          eventTypes: ["message.received", "message.sent"],
       });
       ```
     </CodeBlocks>
 
-    Specify which events to receive; omit `events` to subscribe to all event types.
+    Specify which events to receive; omit `event_types` to subscribe to all event types.
   </Step>
 
   <Step title="3. AgentMail Sends Events">
@@ -4535,7 +4535,7 @@ When AgentMail sends a webhook, the payload includes `event_type` and `event_id`
     "organization_id": "org_abc123...",
     "inbox_id": "inbox_def456...",
     "thread_id": "thd_ghi789...",
-    "message_id": "msg_jkl012...",
+    "message_id": "<jkl012@agentmail.to>",
     "labels": ["received"],
     "timestamp": "2023-10-27T10:00:00Z",
     "reply_to": ["reply-to@example.com"],
@@ -4555,8 +4555,8 @@ When AgentMail sends a webhook, the payload includes `event_type` and `event_id`
         "inline": false
       }
     ],
-    "in_reply_to": "msg_parent456...",
-    "references": ["msg_ref1...", "msg_ref2..."],
+    "in_reply_to": "<parent456@agentmail.to>",
+    "references": ["<ref001@agentmail.to>", "<ref002@agentmail.to>"],
     "sort_key": "some-sort-key",
     "updated_at": "2023-10-27T10:00:05Z",
     "created_at": "2023-10-27T10:00:00Z"
@@ -4595,7 +4595,7 @@ Copy one of the blocks below into Cursor or Claude for complete Webhooks API kno
   Return 200 immediately; process payload in background.
 
   API reference:
-  - webhooks.create(url, events?, inbox_ids?, pod_ids?, client_id?)
+  - webhooks.create(url, event_types?, inbox_ids?, pod_ids?, client_id?)
   - webhooks.get(webhook_id), webhooks.list(limit?, page_token?)
   - webhooks.update(webhook_id, add_inbox_ids?, remove_inbox_ids?, add_pod_ids?, remove_pod_ids?)
   - webhooks.delete(webhook_id)
@@ -4610,7 +4610,7 @@ Copy one of the blocks below into Cursor or Claude for complete Webhooks API kno
   load_dotenv()
   client = AgentMail(api_key=os.getenv("AGENTMAIL_API_KEY"))
 
-  wh = client.webhooks.create(url="https://your-server.com/webhooks", events=["message.received"], client_id="my-webhook-v1")
+  wh = client.webhooks.create(url="https://your-server.com/webhooks", event_types=["message.received"], client_id="my-webhook-v1")
   all_wh = client.webhooks.list()
   secret = client.webhooks.get(wh.webhook_id).secret
   ```
@@ -4855,7 +4855,7 @@ Copy one of the blocks below into Cursor or Claude for webhook event parsing in
     "message": {
       "inbox_id": "inbox_456def",
       "thread_id": "thd_789ghi",
-      "message_id": "msg_123abc",
+      "message_id": "<abc123@agentmail.to>",
       "labels": ["received"],
       "timestamp": "2023-10-27T10:00:00Z",
       "from": "Jane Doe <jane@example.com>",
@@ -4877,7 +4877,7 @@ Copy one of the blocks below into Cursor or Claude for webhook event parsing in
       "recipients": ["Support Agent <support@agentmail.to>"],
       "subject": "Question about my account",
       "preview": "A short preview of the email text...",
-      "last_message_id": "msg_123abc",
+      "last_message_id": "<abc123@agentmail.to>",
       "message_count": 1,
       "size": 2048,
       "updated_at": "2023-10-27T10:00:00Z",
@@ -4901,7 +4901,7 @@ Copy one of the blocks below into Cursor or Claude for webhook event parsing in
     "send": {
       "inbox_id": "inbox_456def",
       "thread_id": "thd_789ghi",
-      "message_id": "msg_123abc",
+      "message_id": "<abc123@agentmail.to>",
       "timestamp": "2023-10-27T10:05:00Z",
       "recipients": [
         "recipient@example.com"
@@ -4925,7 +4925,7 @@ Copy one of the blocks below into Cursor or Claude for webhook event parsing in
     "delivery": {
       "inbox_id": "inbox_456def",
       "thread_id": "thd_789ghi",
-      "message_id": "msg_123abc",
+      "message_id": "<abc123@agentmail.to>",
       "timestamp": "2023-10-27T10:06:00Z",
       "recipients": [
         "recipient@example.com"
@@ -4968,7 +4968,7 @@ Copy one of the blocks below into Cursor or Claude for webhook event parsing in
     "bounce": {
       "inbox_id": "inbox_456def",
       "thread_id": "thd_789ghi",
-      "message_id": "msg_123abc",
+      "message_id": "<abc123@agentmail.to>",
       "timestamp": "2023-10-27T10:07:00Z",
       "type": "Permanent",
       "sub_type": "General",
@@ -4997,7 +4997,7 @@ Copy one of the blocks below into Cursor or Claude for webhook event parsing in
     "complaint": {
       "inbox_id": "inbox_456def",
       "thread_id": "thd_789ghi",
-      "message_id": "msg_123abc",
+      "message_id": "<abc123@agentmail.to>",
       "timestamp": "2023-10-27T10:08:00Z",
       "type": "abuse",
       "sub_type": "spam",
@@ -5023,7 +5023,7 @@ Copy one of the blocks below into Cursor or Claude for webhook event parsing in
     "reject": {
       "inbox_id": "inbox_456def",
       "thread_id": "thd_789ghi",
-      "message_id": "msg_123abc",
+      "message_id": "<abc123@agentmail.to>",
       "timestamp": "2023-10-27T10:09:00Z",
       "reason": "Invalid recipient address"
     }
@@ -5186,7 +5186,7 @@ webhook_url = "https://your-subdomain.ngrok-free.app/webhooks"
 
 webhook = client.webhooks.create(
     url=webhook_url,
-    events=["message.received"],  # add others (e.g. message.sent) as needed
+    event_types=["message.received"],  # add others (e.g. message.sent) as needed
     client_id="webhook-demo-webhook"  # Ensures idempotency
 )
 
@@ -5316,7 +5316,7 @@ Copy one of the blocks below into Cursor or Claude for webhook setup in one shot
   """
   AgentMail Webhook Setup — copy into Cursor/Claude.
 
-  Flow: 1) ngrok http 3000 → copy URL. 2) inboxes.create(client_id=...) 3) webhooks.create(url=ngrok+/webhooks, events=[...], client_id=...)
+  Flow: 1) ngrok http 3000 → copy URL. 2) inboxes.create(client_id=...) 3) webhooks.create(url=ngrok+/webhooks, event_types=[...], client_id=...)
   4) Flask POST /webhooks: return 200 immediately, process request.json in background.
   Local: use http://127.0.0.1:3000 in browser, not ngrok URL.
   """
@@ -5327,7 +5327,7 @@ Copy one of the blocks below into Cursor or Claude for webhook setup in one shot
   client = AgentMail()
 
   inbox = client.inboxes.create(username="webhook-demo", client_id="webhook-demo-inbox")
-  wh = client.webhooks.create(url="https://YOUR_NGROK.ngrok-free.app/webhooks", events=["message.received"], client_id="webhook-demo-webhook")
+  wh = client.webhooks.create(url="https://YOUR_NGROK.ngrok-free.app/webhooks", event_types=["message.received"], client_id="webhook-demo-webhook")
 
   @app.route("/webhooks", methods=["POST"])
   def receive():
@@ -7360,7 +7360,7 @@ def receive_webhook():
 {
   "type": "message.received",
   "message": {
-    "message_id": "abc123...",
+    "message_id": "<abc123@agentmail.to>",
     "inbox_id": "auto-reply@agentmail.to",
     "from_": "John Doe <john@example.com>",
     "subject": "Hello",
@@ -28633,6 +28633,11 @@ components:
           $ref: '#/components/schemas/type_api-keys:Prefix'
         name:
           $ref: '#/components/schemas/type_api-keys:Name'
+        pod_id:
+          type: string
+          description: >-
+            Pod ID the api key is scoped to. If set, the key can only access
+            resources within this pod.
         used_at:
           type: string
           format: date-time
@@ -28885,6 +28890,9 @@ components:
           $ref: '#/components/schemas/type_api-keys:Prefix'
         name:
           $ref: '#/components/schemas/type_api-keys:Name'
+        pod_id:
+          type: string
+          description: Pod ID the api key is scoped to.
         created_at:
           $ref: '#/components/schemas/type_api-keys:CreatedAt'
       required:
@@ -36115,6 +36123,822 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+# Create API Key
+
+POST https://api.agentmail.to/v0/pods/{pod_id}/api-keys
+Content-Type: application/json
+
+Reference: https://docs.agentmail.to/api-reference/pods/api-keys/create
+
+## OpenAPI Specification
+
+```yaml
+openapi: 3.1.0
+info:
+  title: api
+  version: 1.0.0
+paths:
+  /v0/pods/{pod_id}/api-keys:
+    post:
+      operationId: create
+      summary: Create API Key
+      tags:
+        - subpackage_pods.subpackage_pods/api-keys
+      parameters:
+        - name: pod_id
+          in: path
+          required: true
+          schema:
+            $ref: '#/components/schemas/type_pods:PodId'
+        - name: Authorization
+          in: header
+          description: Bearer authentication
+          required: true
+          schema:
+            type: string
+      responses:
+        '200':
+          description: Response with status 200
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/type_api-keys:CreateApiKeyResponse'
+        '400':
+          description: Error response with status 400
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/type_:ValidationErrorResponse'
+        '404':
+          description: Error response with status 404
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/type_:ErrorResponse'
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/type_api-keys:CreateApiKeyRequest'
+servers:
+  - url: https://api.agentmail.to
+  - url: https://x402.api.agentmail.to
+  - url: https://mpp.api.agentmail.to
+  - url: https://api.agentmail.eu
+components:
+  schemas:
+    type_pods:PodId:
+      type: string
+      description: ID of pod.
+      title: PodId
+    type_api-keys:Name:
+      type: string
+      description: Name of api key.
+      title: Name
+    type_api-keys:CreateApiKeyRequest:
+      type: object
+      properties:
+        name:
+          $ref: '#/components/schemas/type_api-keys:Name'
+      required:
+        - name
+      title: CreateApiKeyRequest
+    type_api-keys:ApiKeyId:
+      type: string
+      description: ID of api key.
+      title: ApiKeyId
+    type_api-keys:Prefix:
+      type: string
+      description: Prefix of api key.
+      title: Prefix
+    type_api-keys:CreatedAt:
+      type: string
+      format: date-time
+      description: Time at which api key was created.
+      title: CreatedAt
+    type_api-keys:CreateApiKeyResponse:
+      type: object
+      properties:
+        api_key_id:
+          $ref: '#/components/schemas/type_api-keys:ApiKeyId'
+        api_key:
+          type: string
+          description: API key.
+        prefix:
+          $ref: '#/components/schemas/type_api-keys:Prefix'
+        name:
+          $ref: '#/components/schemas/type_api-keys:Name'
+        pod_id:
+          type: string
+          description: Pod ID the api key is scoped to.
+        created_at:
+          $ref: '#/components/schemas/type_api-keys:CreatedAt'
+      required:
+        - api_key_id
+        - api_key
+        - prefix
+        - name
+        - created_at
+      title: CreateApiKeyResponse
+    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
+    type_:ValidationErrorResponse:
+      type: object
+      properties:
+        name:
+          $ref: '#/components/schemas/type_:ErrorName'
+        errors:
+          description: Validation errors.
+      required:
+        - name
+        - errors
+      title: ValidationErrorResponse
+  securitySchemes:
+    Bearer:
+      type: http
+      scheme: bearer
+
+```
+
+## SDK Code Examples
+
+```typescript
+import { AgentMailClient } from "agentmail";
+
+async function main() {
+    const client = new AgentMailClient({
+        apiKey: "YOUR_TOKEN_HERE",
+    });
+    await client.pods.apiKeys.create("pod_id", {
+        name: "name",
+    });
+}
+main();
+
+```
+
+```python
+from agentmail import AgentMail
+
+client = AgentMail(
+    api_key="YOUR_TOKEN_HERE"
+)
+
+client.pods.api_keys.create(
+    pod_id="pod_id",
+    name="name"
+)
+
+```
+
+```go
+package main
+
+import (
+	"fmt"
+	"strings"
+	"net/http"
+	"io"
+)
+
+func main() {
+
+	url := "https://api.agentmail.to/v0/pods/pod_id/api-keys"
+
+	payload := strings.NewReader("{\n  \"name\": \"name\"\n}")
+
+	req, _ := http.NewRequest("POST", url, payload)
+
+	req.Header.Add("Authorization", "Bearer <api_key>")
+	req.Header.Add("Content-Type", "application/json")
+
+	res, _ := http.DefaultClient.Do(req)
+
+	defer res.Body.Close()
+	body, _ := io.ReadAll(res.Body)
+
+	fmt.Println(res)
+	fmt.Println(string(body))
+
+}
+```
+
+```ruby
+require 'uri'
+require 'net/http'
+
+url = URI("https://api.agentmail.to/v0/pods/pod_id/api-keys")
+
+http = Net::HTTP.new(url.host, url.port)
+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}"
+
+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.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}")
+  .asString();
+```
+
+```php
+<?php
+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"
+}',
+  'headers' => [
+    'Authorization' => 'Bearer <api_key>',
+    'Content-Type' => 'application/json',
+  ],
+]);
+
+echo $response->getBody();
+```
+
+```csharp
+using RestSharp;
+
+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);
+IRestResponse response = client.Execute(request);
+```
+
+```swift
+import Foundation
+
+let headers = [
+  "Authorization": "Bearer <api_key>",
+  "Content-Type": "application/json"
+]
+let parameters = ["name": "name"] as [String : Any]
+
+let postData = JSONSerialization.data(withJSONObject: parameters, options: [])
+
+let request = NSMutableURLRequest(url: NSURL(string: "https://api.agentmail.to/v0/pods/pod_id/api-keys")! as URL,
+                                        cachePolicy: .useProtocolCachePolicy,
+                                    timeoutInterval: 10.0)
+request.httpMethod = "POST"
+request.allHTTPHeaderFields = headers
+request.httpBody = postData as Data
+
+let session = URLSession.shared
+let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
+  if (error != nil) {
+    print(error as Any)
+  } else {
+    let httpResponse = response as? HTTPURLResponse
+    print(httpResponse)
+  }
+})
+
+dataTask.resume()
+```
+
+# List API Keys
+
+GET https://api.agentmail.to/v0/pods/{pod_id}/api-keys
+
+Reference: https://docs.agentmail.to/api-reference/pods/api-keys/list
+
+## OpenAPI Specification
+
+```yaml
+openapi: 3.1.0
+info:
+  title: api
+  version: 1.0.0
+paths:
+  /v0/pods/{pod_id}/api-keys:
+    get:
+      operationId: list
+      summary: List API Keys
+      tags:
+        - subpackage_pods.subpackage_pods/api-keys
+      parameters:
+        - name: pod_id
+          in: path
+          required: true
+          schema:
+            $ref: '#/components/schemas/type_pods:PodId'
+        - name: limit
+          in: query
+          required: false
+          schema:
+            $ref: '#/components/schemas/type_:Limit'
+        - name: page_token
+          in: query
+          required: false
+          schema:
+            $ref: '#/components/schemas/type_:PageToken'
+        - name: Authorization
+          in: header
+          description: Bearer authentication
+          required: true
+          schema:
+            type: string
+      responses:
+        '200':
+          description: Response with status 200
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/type_api-keys:ListApiKeysResponse'
+        '404':
+          description: Error response with status 404
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/type_:ErrorResponse'
+servers:
+  - url: https://api.agentmail.to
+  - url: https://x402.api.agentmail.to
+  - url: https://mpp.api.agentmail.to
+  - url: https://api.agentmail.eu
+components:
+  schemas:
+    type_pods:PodId:
+      type: string
+      description: ID of pod.
+      title: PodId
+    type_:Limit:
+      type: integer
+      description: Limit of number of items returned.
+      title: Limit
+    type_:PageToken:
+      type: string
+      description: Page token for pagination.
+      title: PageToken
+    type_:Count:
+      type: integer
+      description: Number of items returned.
+      title: Count
+    type_api-keys:ApiKeyId:
+      type: string
+      description: ID of api key.
+      title: ApiKeyId
+    type_api-keys:Prefix:
+      type: string
+      description: Prefix of api key.
+      title: Prefix
+    type_api-keys:Name:
+      type: string
+      description: Name of api key.
+      title: Name
+    type_api-keys:CreatedAt:
+      type: string
+      format: date-time
+      description: Time at which api key was created.
+      title: CreatedAt
+    type_api-keys:ApiKey:
+      type: object
+      properties:
+        api_key_id:
+          $ref: '#/components/schemas/type_api-keys:ApiKeyId'
+        prefix:
+          $ref: '#/components/schemas/type_api-keys:Prefix'
+        name:
+          $ref: '#/components/schemas/type_api-keys:Name'
+        pod_id:
+          type: string
+          description: >-
+            Pod ID the api key is scoped to. If set, the key can only access
+            resources within this pod.
+        used_at:
+          type: string
+          format: date-time
+          description: Time at which api key was last used.
+        created_at:
+          $ref: '#/components/schemas/type_api-keys:CreatedAt'
+      required:
+        - api_key_id
+        - prefix
+        - name
+        - created_at
+      title: ApiKey
+    type_api-keys:ListApiKeysResponse:
+      type: object
+      properties:
+        count:
+          $ref: '#/components/schemas/type_:Count'
+        next_page_token:
+          $ref: '#/components/schemas/type_:PageToken'
+        api_keys:
+          type: array
+          items:
+            $ref: '#/components/schemas/type_api-keys:ApiKey'
+          description: Ordered by `created_at` descending.
+      required:
+        - count
+        - api_keys
+      title: ListApiKeysResponse
+    type_:ErrorName:
+      type: string
+      description: Name of error.
+      title: ErrorName
+    type_:ErrorMessage:
+      type: string
+      description: Error message.
+      title: ErrorMessage
+    type_:ErrorResponse:
+      type: object
+      properties:
+        name:
+          $ref: '#/components/schemas/type_:ErrorName'
+        message:
+          $ref: '#/components/schemas/type_:ErrorMessage'
+      required:
+        - name
+        - message
+      title: ErrorResponse
+  securitySchemes:
+    Bearer:
+      type: http
+      scheme: bearer
+
+```
+
+## SDK Code Examples
+
+```typescript
+import { AgentMailClient } from "agentmail";
+
+async function main() {
+    const client = new AgentMailClient({
+        apiKey: "YOUR_TOKEN_HERE",
+    });
+    await client.pods.apiKeys.list("pod_id", {});
+}
+main();
+
+```
+
+```python
+from agentmail import AgentMail
+
+client = AgentMail(
+    api_key="YOUR_TOKEN_HERE"
+)
+
+client.pods.api_keys.list(
+    pod_id="pod_id"
+)
+
+```
+
+```go
+package main
+
+import (
+	"fmt"
+	"net/http"
+	"io"
+)
+
+func main() {
+
+	url := "https://api.agentmail.to/v0/pods/pod_id/api-keys"
+
+	req, _ := http.NewRequest("GET", url, nil)
+
+	req.Header.Add("Authorization", "Bearer <api_key>")
+
+	res, _ := http.DefaultClient.Do(req)
+
+	defer res.Body.Close()
+	body, _ := io.ReadAll(res.Body)
+
+	fmt.Println(res)
+	fmt.Println(string(body))
+
+}
+```
+
+```ruby
+require 'uri'
+require 'net/http'
+
+url = URI("https://api.agentmail.to/v0/pods/pod_id/api-keys")
+
+http = Net::HTTP.new(url.host, url.port)
+http.use_ssl = true
+
+request = Net::HTTP::Get.new(url)
+request["Authorization"] = 'Bearer <api_key>'
+
+response = http.request(request)
+puts response.read_body
+```
+
+```java
+import com.mashape.unirest.http.HttpResponse;
+import com.mashape.unirest.http.Unirest;
+
+HttpResponse<String> response = Unirest.get("https://api.agentmail.to/v0/pods/pod_id/api-keys")
+  .header("Authorization", "Bearer <api_key>")
+  .asString();
+```
+
+```php
+<?php
+require_once('vendor/autoload.php');
+
+$client = new \GuzzleHttp\Client();
+
+$response = $client->request('GET', 'https://api.agentmail.to/v0/pods/pod_id/api-keys', [
+  'headers' => [
+    'Authorization' => 'Bearer <api_key>',
+  ],
+]);
+
+echo $response->getBody();
+```
+
+```csharp
+using RestSharp;
+
+var client = new RestClient("https://api.agentmail.to/v0/pods/pod_id/api-keys");
+var request = new RestRequest(Method.GET);
+request.AddHeader("Authorization", "Bearer <api_key>");
+IRestResponse response = client.Execute(request);
+```
+
+```swift
+import Foundation
+
+let headers = ["Authorization": "Bearer <api_key>"]
+
+let request = NSMutableURLRequest(url: NSURL(string: "https://api.agentmail.to/v0/pods/pod_id/api-keys")! as URL,
+                                        cachePolicy: .useProtocolCachePolicy,
+                                    timeoutInterval: 10.0)
+request.httpMethod = "GET"
+request.allHTTPHeaderFields = headers
+
+let session = URLSession.shared
+let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
+  if (error != nil) {
+    print(error as Any)
+  } else {
+    let httpResponse = response as? HTTPURLResponse
+    print(httpResponse)
+  }
+})
+
+dataTask.resume()
+```
+
+# Delete API Key
+
+DELETE https://api.agentmail.to/v0/pods/{pod_id}/api-keys/{api_key}
+
+Reference: https://docs.agentmail.to/api-reference/pods/api-keys/delete
+
+## OpenAPI Specification
+
+```yaml
+openapi: 3.1.0
+info:
+  title: api
+  version: 1.0.0
+paths:
+  /v0/pods/{pod_id}/api-keys/{api_key}:
+    delete:
+      operationId: delete
+      summary: Delete API Key
+      tags:
+        - subpackage_pods.subpackage_pods/api-keys
+      parameters:
+        - name: pod_id
+          in: path
+          required: true
+          schema:
+            $ref: '#/components/schemas/type_pods:PodId'
+        - name: api_key
+          in: path
+          required: true
+          schema:
+            $ref: '#/components/schemas/type_api-keys:ApiKeyId'
+        - 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_pods:PodId:
+      type: string
+      description: ID of pod.
+      title: PodId
+    type_api-keys:ApiKeyId:
+      type: string
+      description: ID of api key.
+      title: ApiKeyId
+    type_:ErrorName:
+      type: string
+      description: Name of error.
+      title: ErrorName
+    type_:ErrorMessage:
+      type: string
+      description: Error message.
+      title: ErrorMessage
+    type_:ErrorResponse:
+      type: object
+      properties:
+        name:
+          $ref: '#/components/schemas/type_:ErrorName'
+        message:
+          $ref: '#/components/schemas/type_:ErrorMessage'
+      required:
+        - name
+        - message
+      title: ErrorResponse
+  securitySchemes:
+    Bearer:
+      type: http
+      scheme: bearer
+
+```
+
+## SDK Code Examples
+
+```typescript
+import { AgentMailClient } from "agentmail";
+
+async function main() {
+    const client = new AgentMailClient({
+        apiKey: "YOUR_TOKEN_HERE",
+    });
+    await client.pods.apiKeys.delete("pod_id", "api_key");
+}
+main();
+
+```
+
+```python
+from agentmail import AgentMail
+
+client = AgentMail(
+    api_key="YOUR_TOKEN_HERE"
+)
+
+client.pods.api_keys.delete(
+    pod_id="pod_id",
+    api_key="api_key"
+)
+
+```
+
+```go
+package main
+
+import (
+	"fmt"
+	"net/http"
+	"io"
+)
+
+func main() {
+
+	url := "https://api.agentmail.to/v0/pods/pod_id/api-keys/api_key"
+
+	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/pods/pod_id/api-keys/api_key")
+
+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/pods/pod_id/api-keys/api_key")
+  .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/pods/pod_id/api-keys/api_key', [
+  'headers' => [
+    'Authorization' => 'Bearer <api_key>',
+  ],
+]);
+
+echo $response->getBody();
+```
+
+```csharp
+using RestSharp;
+
+var client = new RestClient("https://api.agentmail.to/v0/pods/pod_id/api-keys/api_key");
+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/pods/pod_id/api-keys/api_key")! 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()
+```
+
 # Get Organization
 
 GET https://api.agentmail.to/v0/organizations