agentmail 0.1.17 → 0.1.19

package/dist/llms-full.txt

@@ -5,7 +5,7 @@
 <Tip title="Welcome to AgentMail!" icon="fa-solid fa-star" />
 
 <Frame caption="We're excited to have you onboard!">
-  <img src="file:2bbde1f0-3ffb-42e2-983f-dbde7883b260" alt="We're excited to have you onboard!" />
+  <img src="https://files.buildwithfern.com/https://agentmail-production.docs.buildwithfern.com/9594f1f7c411d8f6e6a3d1e6de0661b1c8b82a57d29de765f0f90dc9da66149b/assets/doc-intro.png" alt="We're excited to have you onboard!" />
 </Frame>
 
 AgentMail is an API platform for giving AI agents their own inboxes to send, receive, and act upon emails. This allows agents to assume their own identity and communicate via the universal protocol of email with services, people, and other agents.
@@ -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:533b527b-b89e-4535-bc11-b04eda210805) Click
+    dashboard. ![API Key Creation Screenshot](https://files.buildwithfern.com/https://agentmail-production.docs.buildwithfern.com/4e665f546efdf08d30178fcfbd996298ed7b3d1d44709fc742ed5315fed9532e/assets/api-key-creation.png) Click
     "Create New API Key" and give it a descriptive name. Once created, copy the
     API key and store it securely. Create a `.env` file in your project's root
     directory and add your key to it. We recommend using environment variables to
@@ -322,7 +322,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:2f70a86c-fb83-4804-90dd-4f3b666cccf5" alt="AgentMail Organizational Hierarchy" />
+<img src="https://files.buildwithfern.com/https://agentmail-production.docs.buildwithfern.com/800085ec8545f404e194c8c6e463be1677715204ac5705be777fa95ace0e6d26/assets/hierarchy-diagram.png" alt="AgentMail Organizational Hierarchy" />
 
 <Steps>
   <Step title="Organization">
@@ -742,7 +742,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:d664e355-f144-4b64-85d2-0e39cbba8ac7" alt="rendered css" />
+  <img src="https://files.buildwithfern.com/https://agentmail-production.docs.buildwithfern.com/a598fc722b5882421ffb977dc567bd75b4f4541b1e4ff7ab18657c7435b300dc/assets/css-rendered.png" alt="rendered css" />
 </Frame>
 
 ## Receiving `Messages`
@@ -1981,7 +1981,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:b15a4c8d-594a-4014-a5fe-03b02c2921d4" alt="Download BIND Zone File from Console" />
+      <img src="https://files.buildwithfern.com/https://agentmail-production.docs.buildwithfern.com/faac7775a4d3462c040390f8427b67a3d0ab59a811489e773739e6c973418123/assets/download-zone-file.png" alt="Download BIND Zone File from Console" />
     </Frame>
 
     <Tabs>
@@ -1992,13 +1992,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:b833b8bb-2437-44a2-85d8-e269f59dd24b" alt="Cloudflare BIND Import" />
+          <img src="https://files.buildwithfern.com/https://agentmail-production.docs.buildwithfern.com/96c7605681eb665155d04a7df0a8cd58830fe147270cabdec3b05797cb993899/assets/cloudflare-dns.png" 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:8d2d26bc-c4f3-48c1-aabc-16cf3ee90047" alt="Cloudflare BIND Import" />
+          <img src="https://files.buildwithfern.com/https://agentmail-production.docs.buildwithfern.com/05cc3ce3579576efb2e81419b9a3f66d79c1cd5b0ec684d070b55762ffade22a/assets/cloudflare-import-export.png" alt="Cloudflare BIND Import" />
         </Frame>
 
         4. Upload the downloaded BIND zone file as is
@@ -2011,13 +2011,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:d7b1afc1-0bad-4d53-a011-5c4091a4380f" alt="AWS Route 53 BIND Import" />
+          <img src="https://files.buildwithfern.com/https://agentmail-production.docs.buildwithfern.com/036c4079abf5da1f8f4bb3aaa5b444b59f0be8077b4f2c3e718746aff5c06751/assets/aws-bind-import.png" 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:bbc90a2f-9733-4e39-890d-8068bc184c73" alt="AWS Route 53 BIND Import" />
+          <img src="https://files.buildwithfern.com/https://agentmail-production.docs.buildwithfern.com/0ddc3eaa3744f03f776a832f09d236312b33a0c8f40d1804a84e70c75a3b5896/assets/aws-paste.png" alt="AWS Route 53 BIND Import" />
         </Frame>
 
         4. Review the records and click **"Import"**
@@ -2046,13 +2046,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:4785688a-45d5-4f45-bd33-b92d0ef11fab" alt="Porkbun DNS Management" />
+          <img src="https://files.buildwithfern.com/https://agentmail-production.docs.buildwithfern.com/e4ed50d2d850209bc7eaba74f70e49de1e236816cf9a8b0ee1a244c76dee2714/assets/porkbun-dns.png" alt="Porkbun DNS Management" />
         </Frame>
 
         3. Scroll down to the quick upload section
 
         <Frame caption="Upload your BIND zone file here">
-          <img src="file:b8882eda-ea51-462c-a0fc-da905d4821d7" alt="Porkbun Zone File Import" />
+          <img src="https://files.buildwithfern.com/https://agentmail-production.docs.buildwithfern.com/139296cc33927d5d3c4e6e493ed61545914dec905b620a0d6a5408f3010f8e95/assets/porkbun-import.png" alt="Porkbun Zone File Import" />
         </Frame>
 
         4. Upload the downloaded BIND zone file as is
@@ -2870,13 +2870,13 @@ Ngrok creates a secure tunnel from a public URL to your local development server
 
 Visit [ngrok.com](https://ngrok.com/) and click "Sign up" to create a free account.
 
-<img src="file:257e9c77-745e-4f57-898d-6ad64c30184f" alt="Ngrok homepage" />
+<img src="https://files.buildwithfern.com/https://agentmail-production.docs.buildwithfern.com/2d257d7065229b8ebd74abd4f96802eb8eb4f5b04041bbf28a5015a9d171a4ab/assets/webhook-ngrok.png" alt="Ngrok homepage" />
 
 ### 1.2 Choose your platform and install
 
 After logging in, ngrok will guide you through the setup process. Select your operating system and follow the installation instructions.
 
-<img src="file:62640b7b-609b-4c81-b4c5-93673f5a0a1b" alt="Ngrok setup instructions" />
+<img src="https://files.buildwithfern.com/https://agentmail-production.docs.buildwithfern.com/f1ecdd69a4ef981c9e2f04c4118cad618f81b7dde98cb6de3c6f4f9a69311c79/assets/webhook-system.png" alt="Ngrok setup instructions" />
 
 For macOS, you can install ngrok via Homebrew:
 
@@ -2922,7 +2922,7 @@ ngrok http 3000
 
 You should see output similar to this:
 
-<img src="file:0fe5c03c-37be-413a-8ae6-ffb22f356221" alt="Ngrok terminal output" />
+<img src="https://files.buildwithfern.com/https://agentmail-production.docs.buildwithfern.com/c0d9867ce68c17edeea7a4e7bc2204c38c2cb9a3a819fe68199c542d28293dd1/assets/webhook-console.png" alt="Ngrok terminal output" />
 
 Copy the **Forwarding URL** (e.g., `https://your-subdomain.ngrok-free.app`). This is the public URL that AgentMail will use to send webhooks.
 
@@ -3019,7 +3019,7 @@ python webhook_receiver.py
 
 Open your browser and visit `http://127.0.0.1:3000` to see the status page confirming your webhook receiver is running:
 
-<img src="file:445e6cfc-8d24-4d5b-9ade-cbf9e21c5f4e" alt="Webhook receiver status page" />
+<img src="https://files.buildwithfern.com/https://agentmail-production.docs.buildwithfern.com/d7c7b41d1738e174e482ce9531f4a706e0d4da350a9ec7545215789633fb09ae/assets/webhook-result.png" alt="Webhook receiver status page" />
 
 ## Testing Your Setup
 
@@ -3516,7 +3516,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:98c9cc4a-14cd-4306-b9af-5add27313bfe" alt="Diagram comparing one inbox sending 1000 emails vs. five inboxes sending 200 each." />
+    <img src="https://files.buildwithfern.com/https://agentmail-production.docs.buildwithfern.com/718d953f857886e2d6c6e554184b6800f3c62fcbd340c506764c5d0669151940/assets/inbox-diversification.png" alt="Diagram comparing one inbox sending 1000 emails vs. five inboxes sending 200 each." />
   </Step>
 
   <Step title="Protect Your Reputation with Multiple Domains">
@@ -5535,7 +5535,7 @@ Done
 
 Go to your AgentMail inbox and filter by labels to organize your emails:
 
-<img src="file:aabdc3e3-f51c-4b2d-93e9-0aeaff841bf8" alt="Test image" />
+<img src="https://files.buildwithfern.com/https://agentmail-production.docs.buildwithfern.com/58630b8f4fda508ac0e6baf8df2c5a3abb992f27f0c0ab1f0642bb8d76f355a7/assets/label-example.png" alt="Test image" />
 
 **Filter by sentiment:**
 
@@ -7736,12 +7736,17 @@ components:
       type: string
     type_attachments:AttachmentFilename:
       type: string
-    type_attachments:AttachmentContentType:
-      type: string
     type_attachments:AttachmentSize:
       type: integer
-    type_attachments:AttachmentInline:
-      type: boolean
+    type_attachments:AttachmentContentType:
+      type: string
+    type_attachments:AttachmentContentDisposition:
+      type: string
+      enum:
+        - value: inline
+        - value: attachment
+    type_attachments:AttachmentContentId:
+      type: string
     type_attachments:Attachment:
       type: object
       properties:
@@ -7749,16 +7754,18 @@ components:
           $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'
+        content_type:
+          $ref: '#/components/schemas/type_attachments:AttachmentContentType'
+        content_disposition:
+          $ref: '#/components/schemas/type_attachments:AttachmentContentDisposition'
+        content_id:
+          $ref: '#/components/schemas/type_attachments:AttachmentContentId'
       required:
         - attachment_id
         - size
-        - inline
+        - content_disposition
     type_threads:ThreadAttachments:
       type: array
       items:
@@ -8054,12 +8061,17 @@ components:
       type: string
     type_attachments:AttachmentFilename:
       type: string
-    type_attachments:AttachmentContentType:
-      type: string
     type_attachments:AttachmentSize:
       type: integer
-    type_attachments:AttachmentInline:
-      type: boolean
+    type_attachments:AttachmentContentType:
+      type: string
+    type_attachments:AttachmentContentDisposition:
+      type: string
+      enum:
+        - value: inline
+        - value: attachment
+    type_attachments:AttachmentContentId:
+      type: string
     type_attachments:Attachment:
       type: object
       properties:
@@ -8067,16 +8079,18 @@ components:
           $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'
+        content_type:
+          $ref: '#/components/schemas/type_attachments:AttachmentContentType'
+        content_disposition:
+          $ref: '#/components/schemas/type_attachments:AttachmentContentDisposition'
+        content_id:
+          $ref: '#/components/schemas/type_attachments:AttachmentContentId'
       required:
         - attachment_id
         - size
-        - inline
+        - content_disposition
     type_threads:ThreadAttachments:
       type: array
       items:
@@ -8909,12 +8923,17 @@ components:
       type: string
     type_attachments:AttachmentFilename:
       type: string
-    type_attachments:AttachmentContentType:
-      type: string
     type_attachments:AttachmentSize:
       type: integer
-    type_attachments:AttachmentInline:
-      type: boolean
+    type_attachments:AttachmentContentType:
+      type: string
+    type_attachments:AttachmentContentDisposition:
+      type: string
+      enum:
+        - value: inline
+        - value: attachment
+    type_attachments:AttachmentContentId:
+      type: string
     type_attachments:Attachment:
       type: object
       properties:
@@ -8922,16 +8941,18 @@ components:
           $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'
+        content_type:
+          $ref: '#/components/schemas/type_attachments:AttachmentContentType'
+        content_disposition:
+          $ref: '#/components/schemas/type_attachments:AttachmentContentDisposition'
+        content_id:
+          $ref: '#/components/schemas/type_attachments:AttachmentContentId'
       required:
         - attachment_id
         - size
-        - inline
+        - content_disposition
     type_messages:MessageAttachments:
       type: array
       items:
@@ -9240,12 +9261,17 @@ components:
       type: string
     type_attachments:AttachmentFilename:
       type: string
-    type_attachments:AttachmentContentType:
-      type: string
     type_attachments:AttachmentSize:
       type: integer
-    type_attachments:AttachmentInline:
-      type: boolean
+    type_attachments:AttachmentContentType:
+      type: string
+    type_attachments:AttachmentContentDisposition:
+      type: string
+      enum:
+        - value: inline
+        - value: attachment
+    type_attachments:AttachmentContentId:
+      type: string
     type_attachments:Attachment:
       type: object
       properties:
@@ -9253,16 +9279,18 @@ components:
           $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'
+        content_type:
+          $ref: '#/components/schemas/type_attachments:AttachmentContentType'
+        content_disposition:
+          $ref: '#/components/schemas/type_attachments:AttachmentContentDisposition'
+        content_id:
+          $ref: '#/components/schemas/type_attachments:AttachmentContentId'
       required:
         - attachment_id
         - size
-        - inline
+        - content_disposition
     type_messages:MessageAttachments:
       type: array
       items:
@@ -9950,6 +9978,13 @@ components:
       type: string
     type_attachments:AttachmentContentType:
       type: string
+    type_attachments:AttachmentContentDisposition:
+      type: string
+      enum:
+        - value: inline
+        - value: attachment
+    type_attachments:AttachmentContentId:
+      type: string
     type_attachments:AttachmentContent:
       type: string
     type_attachments:SendAttachment:
@@ -9959,6 +9994,10 @@ components:
           $ref: '#/components/schemas/type_attachments:AttachmentFilename'
         content_type:
           $ref: '#/components/schemas/type_attachments:AttachmentContentType'
+        content_disposition:
+          $ref: '#/components/schemas/type_attachments:AttachmentContentDisposition'
+        content_id:
+          $ref: '#/components/schemas/type_attachments:AttachmentContentId'
         content:
           $ref: '#/components/schemas/type_attachments:AttachmentContent'
       required:
@@ -10251,6 +10290,13 @@ components:
       type: string
     type_attachments:AttachmentContentType:
       type: string
+    type_attachments:AttachmentContentDisposition:
+      type: string
+      enum:
+        - value: inline
+        - value: attachment
+    type_attachments:AttachmentContentId:
+      type: string
     type_attachments:AttachmentContent:
       type: string
     type_attachments:SendAttachment:
@@ -10260,6 +10306,10 @@ components:
           $ref: '#/components/schemas/type_attachments:AttachmentFilename'
         content_type:
           $ref: '#/components/schemas/type_attachments:AttachmentContentType'
+        content_disposition:
+          $ref: '#/components/schemas/type_attachments:AttachmentContentDisposition'
+        content_id:
+          $ref: '#/components/schemas/type_attachments:AttachmentContentId'
         content:
           $ref: '#/components/schemas/type_attachments:AttachmentContent'
       required:
@@ -10543,6 +10593,13 @@ components:
       type: string
     type_attachments:AttachmentContentType:
       type: string
+    type_attachments:AttachmentContentDisposition:
+      type: string
+      enum:
+        - value: inline
+        - value: attachment
+    type_attachments:AttachmentContentId:
+      type: string
     type_attachments:AttachmentContent:
       type: string
     type_attachments:SendAttachment:
@@ -10552,6 +10609,10 @@ components:
           $ref: '#/components/schemas/type_attachments:AttachmentFilename'
         content_type:
           $ref: '#/components/schemas/type_attachments:AttachmentContentType'
+        content_disposition:
+          $ref: '#/components/schemas/type_attachments:AttachmentContentDisposition'
+        content_id:
+          $ref: '#/components/schemas/type_attachments:AttachmentContentId'
         content:
           $ref: '#/components/schemas/type_attachments:AttachmentContent'
       required:
@@ -10852,12 +10913,17 @@ components:
       type: string
     type_attachments:AttachmentFilename:
       type: string
-    type_attachments:AttachmentContentType:
-      type: string
     type_attachments:AttachmentSize:
       type: integer
-    type_attachments:AttachmentInline:
-      type: boolean
+    type_attachments:AttachmentContentType:
+      type: string
+    type_attachments:AttachmentContentDisposition:
+      type: string
+      enum:
+        - value: inline
+        - value: attachment
+    type_attachments:AttachmentContentId:
+      type: string
     type_attachments:Attachment:
       type: object
       properties:
@@ -10865,16 +10931,18 @@ components:
           $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'
+        content_type:
+          $ref: '#/components/schemas/type_attachments:AttachmentContentType'
+        content_disposition:
+          $ref: '#/components/schemas/type_attachments:AttachmentContentDisposition'
+        content_id:
+          $ref: '#/components/schemas/type_attachments:AttachmentContentId'
       required:
         - attachment_id
         - size
-        - inline
+        - content_disposition
     type_messages:MessageAttachments:
       type: array
       items:
@@ -11237,12 +11305,17 @@ components:
       type: string
     type_attachments:AttachmentFilename:
       type: string
-    type_attachments:AttachmentContentType:
-      type: string
     type_attachments:AttachmentSize:
       type: integer
-    type_attachments:AttachmentInline:
-      type: boolean
+    type_attachments:AttachmentContentType:
+      type: string
+    type_attachments:AttachmentContentDisposition:
+      type: string
+      enum:
+        - value: inline
+        - value: attachment
+    type_attachments:AttachmentContentId:
+      type: string
     type_attachments:Attachment:
       type: object
       properties:
@@ -11250,16 +11323,18 @@ components:
           $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'
+        content_type:
+          $ref: '#/components/schemas/type_attachments:AttachmentContentType'
+        content_disposition:
+          $ref: '#/components/schemas/type_attachments:AttachmentContentDisposition'
+        content_id:
+          $ref: '#/components/schemas/type_attachments:AttachmentContentId'
       required:
         - attachment_id
         - size
-        - inline
+        - content_disposition
     type_drafts:DraftAttachments:
       type: array
       items:
@@ -11548,12 +11623,17 @@ components:
       type: string
     type_attachments:AttachmentFilename:
       type: string
-    type_attachments:AttachmentContentType:
-      type: string
     type_attachments:AttachmentSize:
       type: integer
-    type_attachments:AttachmentInline:
-      type: boolean
+    type_attachments:AttachmentContentType:
+      type: string
+    type_attachments:AttachmentContentDisposition:
+      type: string
+      enum:
+        - value: inline
+        - value: attachment
+    type_attachments:AttachmentContentId:
+      type: string
     type_attachments:Attachment:
       type: object
       properties:
@@ -11561,16 +11641,18 @@ components:
           $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'
+        content_type:
+          $ref: '#/components/schemas/type_attachments:AttachmentContentType'
+        content_disposition:
+          $ref: '#/components/schemas/type_attachments:AttachmentContentDisposition'
+        content_id:
+          $ref: '#/components/schemas/type_attachments:AttachmentContentId'
       required:
         - attachment_id
         - size
-        - inline
+        - content_disposition
     type_drafts:DraftAttachments:
       type: array
       items:
@@ -11896,12 +11978,17 @@ components:
       type: string
     type_attachments:AttachmentFilename:
       type: string
-    type_attachments:AttachmentContentType:
-      type: string
     type_attachments:AttachmentSize:
       type: integer
-    type_attachments:AttachmentInline:
-      type: boolean
+    type_attachments:AttachmentContentType:
+      type: string
+    type_attachments:AttachmentContentDisposition:
+      type: string
+      enum:
+        - value: inline
+        - value: attachment
+    type_attachments:AttachmentContentId:
+      type: string
     type_attachments:Attachment:
       type: object
       properties:
@@ -11909,16 +11996,18 @@ components:
           $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'
+        content_type:
+          $ref: '#/components/schemas/type_attachments:AttachmentContentType'
+        content_disposition:
+          $ref: '#/components/schemas/type_attachments:AttachmentContentDisposition'
+        content_id:
+          $ref: '#/components/schemas/type_attachments:AttachmentContentId'
       required:
         - attachment_id
         - size
-        - inline
+        - content_disposition
     type_drafts:DraftAttachments:
       type: array
       items:
@@ -12254,12 +12343,17 @@ components:
       type: string
     type_attachments:AttachmentFilename:
       type: string
-    type_attachments:AttachmentContentType:
-      type: string
     type_attachments:AttachmentSize:
       type: integer
-    type_attachments:AttachmentInline:
-      type: boolean
+    type_attachments:AttachmentContentType:
+      type: string
+    type_attachments:AttachmentContentDisposition:
+      type: string
+      enum:
+        - value: inline
+        - value: attachment
+    type_attachments:AttachmentContentId:
+      type: string
     type_attachments:Attachment:
       type: object
       properties:
@@ -12267,16 +12361,18 @@ components:
           $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'
+        content_type:
+          $ref: '#/components/schemas/type_attachments:AttachmentContentType'
+        content_disposition:
+          $ref: '#/components/schemas/type_attachments:AttachmentContentDisposition'
+        content_id:
+          $ref: '#/components/schemas/type_attachments:AttachmentContentId'
       required:
         - attachment_id
         - size
-        - inline
+        - content_disposition
     type_drafts:DraftAttachments:
       type: array
       items:
@@ -13316,12 +13412,17 @@ components:
       type: string
     type_attachments:AttachmentFilename:
       type: string
-    type_attachments:AttachmentContentType:
-      type: string
     type_attachments:AttachmentSize:
       type: integer
-    type_attachments:AttachmentInline:
-      type: boolean
+    type_attachments:AttachmentContentType:
+      type: string
+    type_attachments:AttachmentContentDisposition:
+      type: string
+      enum:
+        - value: inline
+        - value: attachment
+    type_attachments:AttachmentContentId:
+      type: string
     type_attachments:Attachment:
       type: object
       properties:
@@ -13329,16 +13430,18 @@ components:
           $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'
+        content_type:
+          $ref: '#/components/schemas/type_attachments:AttachmentContentType'
+        content_disposition:
+          $ref: '#/components/schemas/type_attachments:AttachmentContentDisposition'
+        content_id:
+          $ref: '#/components/schemas/type_attachments:AttachmentContentId'
       required:
         - attachment_id
         - size
-        - inline
+        - content_disposition
     type_threads:ThreadAttachments:
       type: array
       items:
@@ -13626,12 +13729,17 @@ components:
       type: string
     type_attachments:AttachmentFilename:
       type: string
-    type_attachments:AttachmentContentType:
-      type: string
     type_attachments:AttachmentSize:
       type: integer
-    type_attachments:AttachmentInline:
-      type: boolean
+    type_attachments:AttachmentContentType:
+      type: string
+    type_attachments:AttachmentContentDisposition:
+      type: string
+      enum:
+        - value: inline
+        - value: attachment
+    type_attachments:AttachmentContentId:
+      type: string
     type_attachments:Attachment:
       type: object
       properties:
@@ -13639,16 +13747,18 @@ components:
           $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'
+        content_type:
+          $ref: '#/components/schemas/type_attachments:AttachmentContentType'
+        content_disposition:
+          $ref: '#/components/schemas/type_attachments:AttachmentContentDisposition'
+        content_id:
+          $ref: '#/components/schemas/type_attachments:AttachmentContentId'
       required:
         - attachment_id
         - size
-        - inline
+        - content_disposition
     type_threads:ThreadAttachments:
       type: array
       items:
@@ -14272,12 +14382,17 @@ components:
       type: string
     type_attachments:AttachmentFilename:
       type: string
-    type_attachments:AttachmentContentType:
-      type: string
     type_attachments:AttachmentSize:
       type: integer
-    type_attachments:AttachmentInline:
-      type: boolean
+    type_attachments:AttachmentContentType:
+      type: string
+    type_attachments:AttachmentContentDisposition:
+      type: string
+      enum:
+        - value: inline
+        - value: attachment
+    type_attachments:AttachmentContentId:
+      type: string
     type_attachments:Attachment:
       type: object
       properties:
@@ -14285,16 +14400,18 @@ components:
           $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'
+        content_type:
+          $ref: '#/components/schemas/type_attachments:AttachmentContentType'
+        content_disposition:
+          $ref: '#/components/schemas/type_attachments:AttachmentContentDisposition'
+        content_id:
+          $ref: '#/components/schemas/type_attachments:AttachmentContentId'
       required:
         - attachment_id
         - size
-        - inline
+        - content_disposition
     type_drafts:DraftAttachments:
       type: array
       items:
@@ -14575,12 +14692,17 @@ components:
       type: string
     type_attachments:AttachmentFilename:
       type: string
-    type_attachments:AttachmentContentType:
-      type: string
     type_attachments:AttachmentSize:
       type: integer
-    type_attachments:AttachmentInline:
-      type: boolean
+    type_attachments:AttachmentContentType:
+      type: string
+    type_attachments:AttachmentContentDisposition:
+      type: string
+      enum:
+        - value: inline
+        - value: attachment
+    type_attachments:AttachmentContentId:
+      type: string
     type_attachments:Attachment:
       type: object
       properties:
@@ -14588,16 +14710,18 @@ components:
           $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'
+        content_type:
+          $ref: '#/components/schemas/type_attachments:AttachmentContentType'
+        content_disposition:
+          $ref: '#/components/schemas/type_attachments:AttachmentContentDisposition'
+        content_id:
+          $ref: '#/components/schemas/type_attachments:AttachmentContentId'
       required:
         - attachment_id
         - size
-        - inline
+        - content_disposition
     type_drafts:DraftAttachments:
       type: array
       items:
@@ -17169,12 +17293,17 @@ components:
       type: string
     type_attachments:AttachmentFilename:
       type: string
-    type_attachments:AttachmentContentType:
-      type: string
     type_attachments:AttachmentSize:
       type: integer
-    type_attachments:AttachmentInline:
-      type: boolean
+    type_attachments:AttachmentContentType:
+      type: string
+    type_attachments:AttachmentContentDisposition:
+      type: string
+      enum:
+        - value: inline
+        - value: attachment
+    type_attachments:AttachmentContentId:
+      type: string
     type_attachments:Attachment:
       type: object
       properties:
@@ -17182,16 +17311,18 @@ components:
           $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'
+        content_type:
+          $ref: '#/components/schemas/type_attachments:AttachmentContentType'
+        content_disposition:
+          $ref: '#/components/schemas/type_attachments:AttachmentContentDisposition'
+        content_id:
+          $ref: '#/components/schemas/type_attachments:AttachmentContentId'
       required:
         - attachment_id
         - size
-        - inline
+        - content_disposition
     type_messages:MessageAttachments:
       type: array
       items:
@@ -18318,12 +18449,17 @@ components:
       type: string
     type_attachments:AttachmentFilename:
       type: string
-    type_attachments:AttachmentContentType:
-      type: string
     type_attachments:AttachmentSize:
       type: integer
-    type_attachments:AttachmentInline:
-      type: boolean
+    type_attachments:AttachmentContentType:
+      type: string
+    type_attachments:AttachmentContentDisposition:
+      type: string
+      enum:
+        - value: inline
+        - value: attachment
+    type_attachments:AttachmentContentId:
+      type: string
     type_attachments:Attachment:
       type: object
       properties:
@@ -18331,16 +18467,18 @@ components:
           $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'
+        content_type:
+          $ref: '#/components/schemas/type_attachments:AttachmentContentType'
+        content_disposition:
+          $ref: '#/components/schemas/type_attachments:AttachmentContentDisposition'
+        content_id:
+          $ref: '#/components/schemas/type_attachments:AttachmentContentId'
       required:
         - attachment_id
         - size
-        - inline
+        - content_disposition
     type_messages:MessageAttachments:
       type: array
       items:
@@ -21651,12 +21789,17 @@ components:
       type: string
     type_attachments:AttachmentFilename:
       type: string
-    type_attachments:AttachmentContentType:
-      type: string
     type_attachments:AttachmentSize:
       type: integer
-    type_attachments:AttachmentInline:
-      type: boolean
+    type_attachments:AttachmentContentType:
+      type: string
+    type_attachments:AttachmentContentDisposition:
+      type: string
+      enum:
+        - value: inline
+        - value: attachment
+    type_attachments:AttachmentContentId:
+      type: string
     type_attachments:Attachment:
       type: object
       properties:
@@ -21664,16 +21807,18 @@ components:
           $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'
+        content_type:
+          $ref: '#/components/schemas/type_attachments:AttachmentContentType'
+        content_disposition:
+          $ref: '#/components/schemas/type_attachments:AttachmentContentDisposition'
+        content_id:
+          $ref: '#/components/schemas/type_attachments:AttachmentContentId'
       required:
         - attachment_id
         - size
-        - inline
+        - content_disposition
     type_threads:ThreadAttachments:
       type: array
       items:
@@ -21971,12 +22116,17 @@ components:
       type: string
     type_attachments:AttachmentFilename:
       type: string
-    type_attachments:AttachmentContentType:
-      type: string
     type_attachments:AttachmentSize:
       type: integer
-    type_attachments:AttachmentInline:
-      type: boolean
+    type_attachments:AttachmentContentType:
+      type: string
+    type_attachments:AttachmentContentDisposition:
+      type: string
+      enum:
+        - value: inline
+        - value: attachment
+    type_attachments:AttachmentContentId:
+      type: string
     type_attachments:Attachment:
       type: object
       properties:
@@ -21984,16 +22134,18 @@ components:
           $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'
+        content_type:
+          $ref: '#/components/schemas/type_attachments:AttachmentContentType'
+        content_disposition:
+          $ref: '#/components/schemas/type_attachments:AttachmentContentDisposition'
+        content_id:
+          $ref: '#/components/schemas/type_attachments:AttachmentContentId'
       required:
         - attachment_id
         - size
-        - inline
+        - content_disposition
     type_threads:ThreadAttachments:
       type: array
       items:
@@ -22635,12 +22787,17 @@ components:
       type: string
     type_attachments:AttachmentFilename:
       type: string
-    type_attachments:AttachmentContentType:
-      type: string
     type_attachments:AttachmentSize:
       type: integer
-    type_attachments:AttachmentInline:
-      type: boolean
+    type_attachments:AttachmentContentType:
+      type: string
+    type_attachments:AttachmentContentDisposition:
+      type: string
+      enum:
+        - value: inline
+        - value: attachment
+    type_attachments:AttachmentContentId:
+      type: string
     type_attachments:Attachment:
       type: object
       properties:
@@ -22648,16 +22805,18 @@ components:
           $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'
+        content_type:
+          $ref: '#/components/schemas/type_attachments:AttachmentContentType'
+        content_disposition:
+          $ref: '#/components/schemas/type_attachments:AttachmentContentDisposition'
+        content_id:
+          $ref: '#/components/schemas/type_attachments:AttachmentContentId'
       required:
         - attachment_id
         - size
-        - inline
+        - content_disposition
     type_drafts:DraftAttachments:
       type: array
       items:
@@ -22948,12 +23107,17 @@ components:
       type: string
     type_attachments:AttachmentFilename:
       type: string
-    type_attachments:AttachmentContentType:
-      type: string
     type_attachments:AttachmentSize:
       type: integer
-    type_attachments:AttachmentInline:
-      type: boolean
+    type_attachments:AttachmentContentType:
+      type: string
+    type_attachments:AttachmentContentDisposition:
+      type: string
+      enum:
+        - value: inline
+        - value: attachment
+    type_attachments:AttachmentContentId:
+      type: string
     type_attachments:Attachment:
       type: object
       properties:
@@ -22961,16 +23125,18 @@ components:
           $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'
+        content_type:
+          $ref: '#/components/schemas/type_attachments:AttachmentContentType'
+        content_disposition:
+          $ref: '#/components/schemas/type_attachments:AttachmentContentDisposition'
+        content_id:
+          $ref: '#/components/schemas/type_attachments:AttachmentContentId'
       required:
         - attachment_id
         - size
-        - inline
+        - content_disposition
     type_drafts:DraftAttachments:
       type: array
       items:
@@ -23903,3 +24069,203 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+# Get Organization
+
+GET https://api.agentmail.to/v0/organizations
+
+Get the current organization.
+
+Reference: https://docs.agentmail.to/api-reference/organizations/get
+
+## OpenAPI Specification
+
+```yaml
+openapi: 3.1.1
+info:
+  title: Get Organization
+  version: endpoint_organizations.get
+paths:
+  /v0/organizations:
+    get:
+      operationId: get
+      summary: Get Organization
+      description: Get the current organization.
+      tags:
+        - - subpackage_organizations
+      parameters:
+        - 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_organizations:Organization'
+components:
+  schemas:
+    type_:OrganizationId:
+      type: string
+    type_organizations:Organization:
+      type: object
+      properties:
+        organization_id:
+          $ref: '#/components/schemas/type_:OrganizationId'
+        inbox_count:
+          type: integer
+          description: Current number of inboxes.
+        domain_count:
+          type: integer
+          description: Current number of domains.
+        inbox_limit:
+          type: integer
+          description: Maximum number of inboxes allowed.
+        domain_limit:
+          type: integer
+          description: Maximum number of domains allowed.
+        updated_at:
+          type: string
+          format: date-time
+          description: Time at which organization was last updated.
+        created_at:
+          type: string
+          format: date-time
+          description: Time at which organization was created.
+      required:
+        - organization_id
+        - inbox_count
+        - domain_count
+        - updated_at
+        - created_at
+
+```
+
+## SDK Code Examples
+
+```typescript
+import { AgentMailClient } from "agentmail";
+
+async function main() {
+    const client = new AgentMailClient({
+        environment: "https://api.agentmail.to",
+        apiKey: "YOUR_TOKEN_HERE",
+    });
+    await client.organizations.get();
+}
+main();
+
+```
+
+```python
+from agentmail import AgentMail
+
+client = AgentMail(
+    base_url="https://api.agentmail.to",
+    api_key="YOUR_TOKEN_HERE"
+)
+
+client.organizations.get()
+
+```
+
+```go
+package main
+
+import (
+	"fmt"
+	"net/http"
+	"io"
+)
+
+func main() {
+
+	url := "https://api.agentmail.to/v0/organizations"
+
+	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/organizations")
+
+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
+HttpResponse<String> response = Unirest.get("https://api.agentmail.to/v0/organizations")
+  .header("Authorization", "Bearer <api_key>")
+  .asString();
+```
+
+```php
+<?php
+
+$client = new \GuzzleHttp\Client();
+
+$response = $client->request('GET', 'https://api.agentmail.to/v0/organizations', [
+  'headers' => [
+    'Authorization' => 'Bearer <api_key>',
+  ],
+]);
+
+echo $response->getBody();
+```
+
+```csharp
+var client = new RestClient("https://api.agentmail.to/v0/organizations");
+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/organizations")! 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()
+```
+