agentmail 0.5.27 → 0.5.28

package/dist/esm/serialization/resources/accounts/types/UpdateAccountStatus.mjs

@@ -0,0 +1,3 @@
+// This file was auto-generated by Fern from our API Definition.
+import * as core from "../../../../core/index.mjs";
+export const UpdateAccountStatus = core.serialization.enum_(["enabled", "disabled"]);

package/dist/esm/serialization/resources/accounts/types/index.d.mts

@@ -1,4 +1,7 @@
 export * from "./Account.mjs";
 export * from "./AccountId.mjs";
+export * from "./AccountStatus.mjs";
 export * from "./ListAccountsResponse.mjs";
 export * from "./ProviderId.mjs";
+export * from "./UpdateAccountRequest.mjs";
+export * from "./UpdateAccountStatus.mjs";

package/dist/esm/serialization/resources/accounts/types/index.mjs

@@ -1,4 +1,7 @@
 export * from "./Account.mjs";
 export * from "./AccountId.mjs";
+export * from "./AccountStatus.mjs";
 export * from "./ListAccountsResponse.mjs";
 export * from "./ProviderId.mjs";
+export * from "./UpdateAccountRequest.mjs";
+export * from "./UpdateAccountStatus.mjs";

package/dist/esm/serialization/resources/apiKeys/types/ApiKeyPermissions.d.mts

@@ -39,6 +39,7 @@ export declare namespace ApiKeyPermissions {
         api_key_delete?: boolean | null;
         provider_connect?: boolean | null;
         provider_share_owner?: boolean | null;
+        account_update?: boolean | null;
         pod_read?: boolean | null;
         pod_create?: boolean | null;
         pod_delete?: boolean | null;

package/dist/esm/serialization/resources/apiKeys/types/ApiKeyPermissions.mjs

@@ -36,6 +36,7 @@ export const ApiKeyPermissions = core.serialization.object({
     apiKeyDelete: core.serialization.property("api_key_delete", core.serialization.boolean().optional()),
     providerConnect: core.serialization.property("provider_connect", core.serialization.boolean().optional()),
     providerShareOwner: core.serialization.property("provider_share_owner", core.serialization.boolean().optional()),
+    accountUpdate: core.serialization.property("account_update", core.serialization.boolean().optional()),
     podRead: core.serialization.property("pod_read", core.serialization.boolean().optional()),
     podCreate: core.serialization.property("pod_create", core.serialization.boolean().optional()),
     podDelete: core.serialization.property("pod_delete", core.serialization.boolean().optional()),

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "0.5.27";
+export declare const SDK_VERSION = "0.5.28";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "0.5.27";
+export const SDK_VERSION = "0.5.28";

package/dist/llms.txt

@@ -31,6 +31,7 @@
 - [OpenClaw](https://docs.agentmail.to/integrations/openclaw.md): Install AgentMail as an official OpenClaw plugin with one command. Your agent gets its own inbox plus an allowlisted email channel it can be reached at.
 - [Grok Bot](https://docs.agentmail.to/integrations/grokbot.md): AgentMail's Grok Bot, Grok Build, and Grok API integration
 - [Replit](https://docs.agentmail.to/integrations/replit.md): AgentMail's Replit integration
+- [Vercel](https://docs.agentmail.to/integrations/vercel.md): Provision AgentMail from the Vercel Marketplace and authenticate your Vercel functions with OIDC resource tokens or the provisioned API key
 - [x402](https://docs.agentmail.to/integrations/x402.md): AgentMail's x402 integration for HTTP-native payments
 - [MPP](https://docs.agentmail.to/integrations/mpp.md): AgentMail's MPP integration for machine-to-machine payments via Stripe
 - [Integrate LiveKit Agents](https://docs.agentmail.to/integrate-livekit-agents.md): A step-by-step guide to integrate with the LiveKit Agents SDK.
@@ -62,7 +63,7 @@
 - [Join the AgentMail Community](https://docs.agentmail.to/community.md): Connect with the AgentMail team and developers, share what you're building, and get support.
 - [Support](https://docs.agentmail.to/support.md): Get help with AgentMail through our support channels.
 - [Understanding Email Authentication (SPF, DKIM, DMARC)](https://docs.agentmail.to/email-protocols.md): Learn why we ask for DNS records and what SPF, DKIM, and DMARC are.
-- [SOC 2 Compliance](https://docs.agentmail.to/documentation/resources/security-privacy/soc-2-compliance.md): AgentMail's SOC 2 Type I and Type II compliance.
+- [SOC 2 Compliance](https://docs.agentmail.to/documentation/resources/security-privacy/soc-2-compliance.md): AgentMail's completed 2025 SOC 2 Type II audit and 2026 annual audit underway with A-LIGN.
 - [Spam & Virus Detection](https://docs.agentmail.to/spam-virus-detection.md): How AgentMail automatically scans incoming emails for spam and viruses.
 - [API Welcome](https://docs.agentmail.to/api-reference.md): Quick overview of the AgentMail SDK
 - [Knowledge Base](https://docs.agentmail.to/knowledge-base.md): A collection of answers to frequently asked questions.
@@ -82,7 +83,7 @@
 - [Warming Up](https://docs.agentmail.to/knowledge-base/domain-warming.md): Gradually build sending reputation on a new domain or inbox.
 - [How do I avoid MX record conflicts?](https://docs.agentmail.to/knowledge-base/mx-record-conflicts.md): Add AgentMail DNS records without breaking existing email.
 - [What does a 403 error mean?](https://docs.agentmail.to/knowledge-base/api-403-error.md): Common causes of API 403 Forbidden errors and how to fix them.
-- [What are the rate limits?](https://docs.agentmail.to/knowledge-base/rate-limits.md): Understand AgentMail's rate limits and how to work within them.
+- [What are the rate limits?](https://docs.agentmail.to/knowledge-base/rate-limits.md): Understand AgentMail's sending limits and API rate limits, and how to work within them.
 - [How do I prevent duplicate sends?](https://docs.agentmail.to/knowledge-base/preventing-duplicate-sends.md): Use idempotency to avoid sending the same email twice.
 - [Why is my domain not verifying?](https://docs.agentmail.to/knowledge-base/domain-not-verifying.md): What to do when your domain verification is stuck.
 - [Why are my emails bouncing?](https://docs.agentmail.to/knowledge-base/emails-bouncing.md): Diagnose and resolve email bounce issues.
@@ -149,6 +150,8 @@
 - API Reference > Inboxes > API Keys [Create API Key](https://docs.agentmail.to/api-reference/inboxes/api-keys/create.md)
 - API Reference > Inboxes > API Keys [Update API Key](https://docs.agentmail.to/api-reference/inboxes/api-keys/update.md)
 - API Reference > Inboxes > API Keys [Delete API Key](https://docs.agentmail.to/api-reference/inboxes/api-keys/delete.md)
+- API Reference > Inboxes > Accounts [List Accounts](https://docs.agentmail.to/api-reference/inboxes/accounts/list.md)
+- API Reference > Inboxes > Accounts [Get Account](https://docs.agentmail.to/api-reference/inboxes/accounts/get.md)
 - API Reference > Threads [List Threads](https://docs.agentmail.to/api-reference/threads/list.md)
 - API Reference > Threads [Search Threads](https://docs.agentmail.to/api-reference/threads/search.md)
 - API Reference > Threads [Get Thread](https://docs.agentmail.to/api-reference/threads/get.md)
@@ -200,6 +203,7 @@
 - API Reference > Providers [Connect Provider](https://docs.agentmail.to/api-reference/providers/connect.md)
 - API Reference > Accounts [List Accounts](https://docs.agentmail.to/api-reference/accounts/list.md)
 - API Reference > Accounts [Get Account](https://docs.agentmail.to/api-reference/accounts/get.md)
+- API Reference > Accounts [Update Account](https://docs.agentmail.to/api-reference/accounts/update.md)
 - API Reference > Pods [List Pods](https://docs.agentmail.to/api-reference/pods/list.md)
 - API Reference > Pods [Get Pod](https://docs.agentmail.to/api-reference/pods/get.md)
 - API Reference > Pods [Create Pod](https://docs.agentmail.to/api-reference/pods/create.md)
@@ -243,6 +247,8 @@
 - API Reference > Pods > API Keys [Create API Key](https://docs.agentmail.to/api-reference/pods/api-keys/create.md)
 - API Reference > Pods > API Keys [Update API Key](https://docs.agentmail.to/api-reference/pods/api-keys/update.md)
 - API Reference > Pods > API Keys [Delete API Key](https://docs.agentmail.to/api-reference/pods/api-keys/delete.md)
+- API Reference > Pods > Accounts [List Accounts](https://docs.agentmail.to/api-reference/pods/accounts/list.md)
+- API Reference > Pods > Accounts [Get Account](https://docs.agentmail.to/api-reference/pods/accounts/get.md)
 - API Reference > Organizations [Get Organization](https://docs.agentmail.to/api-reference/organizations/get.md)
 - API Reference > Auth [Who Am I](https://docs.agentmail.to/api-reference/auth/me.md)
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "agentmail",
-    "version": "0.5.27",
+    "version": "0.5.28",
     "private": false,
     "repository": {
         "type": "git",
@@ -133,6 +133,17 @@
             },
             "default": "./dist/cjs/api/resources/drafts/exports.js"
         },
+        "./inboxes/accounts": {
+            "import": {
+                "types": "./dist/esm/api/resources/inboxes/resources/accounts/exports.d.mts",
+                "default": "./dist/esm/api/resources/inboxes/resources/accounts/exports.mjs"
+            },
+            "require": {
+                "types": "./dist/cjs/api/resources/inboxes/resources/accounts/exports.d.ts",
+                "default": "./dist/cjs/api/resources/inboxes/resources/accounts/exports.js"
+            },
+            "default": "./dist/cjs/api/resources/inboxes/resources/accounts/exports.js"
+        },
         "./inboxes/apiKeys": {
             "import": {
                 "types": "./dist/esm/api/resources/inboxes/resources/apiKeys/exports.d.mts",
@@ -254,6 +265,17 @@
             },
             "default": "./dist/cjs/api/resources/organizations/exports.js"
         },
+        "./pods/accounts": {
+            "import": {
+                "types": "./dist/esm/api/resources/pods/resources/accounts/exports.d.mts",
+                "default": "./dist/esm/api/resources/pods/resources/accounts/exports.mjs"
+            },
+            "require": {
+                "types": "./dist/cjs/api/resources/pods/resources/accounts/exports.d.ts",
+                "default": "./dist/cjs/api/resources/pods/resources/accounts/exports.js"
+            },
+            "default": "./dist/cjs/api/resources/pods/resources/accounts/exports.js"
+        },
         "./pods/apiKeys": {
             "import": {
                 "types": "./dist/esm/api/resources/pods/resources/apiKeys/exports.d.mts",

package/reference.md

@@ -1243,7 +1243,9 @@ await client.webhooks.delete("webhook_id");
 <dl>
 <dd>
 
-Lists accounts across all providers.
+Lists accounts across all providers, scoped to the API key: an
+organization key sees every account, a pod key its pod's, an inbox key
+its inbox's. Requires `inbox_read`.
 </dd>
 </dl>
 </dd>
@@ -1298,6 +1300,21 @@ await client.accounts.list();
 <dl>
 <dd>
 
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Returns one account by ID. An account outside the key's scope is a 404.
+Requires `inbox_read`.
+</dd>
+</dl>
+</dd>
+</dl>
+
 #### 🔌 Usage
 
 <dl>
@@ -1339,6 +1356,93 @@ await client.accounts.get("d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32");
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.accounts.<a href="/src/api/resources/accounts/client/Client.ts">update</a>(account_id, { ...params }) -> AgentMail.Account</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Updates one account. Set `status` to `disabled` to stop the inbox from
+signing in at the provider again, or to `enabled` to re-enable it.
+Idempotent: disabling an already disabled account keeps its original
+`disabled_at`, and enabling an enabled account is a no-op.
+
+Find the `account_id` with List Accounts. An account exists only after an
+inbox's first sign-in at a provider, so it cannot be disabled in advance.
+A disable applies to that inbox at that provider whichever sign-in key is
+used: the provider's next authorization ends in `access_denied`, and a code
+issued earlier is refused with `invalid_grant`. Access tokens already
+issued stay valid until they expire, and the provider's own session is
+unaffected.
+
+Requires `account_update`, which sign-in keys (`type: public_key`) cannot
+hold, so call this with a bearer API key. An account outside the key's
+scope is a 404. A 409 means the account changed during the write; read it
+again and retry.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.accounts.update("d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32", {});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**account_id:** `AgentMail.AccountId` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request:** `AgentMail.UpdateAccountRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `AccountsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>
@@ -2641,6 +2745,150 @@ await client.drafts.getAttachment("draft_id", "attachment_id");
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+## Inboxes Accounts
+<details><summary><code>client.inboxes.accounts.<a href="/src/api/resources/inboxes/resources/accounts/client/Client.ts">list</a>(inbox_id, { ...params }) -> AgentMail.ListAccountsResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Lists accounts held by the inbox, across all providers. Requires `inbox_read`.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.inboxes.accounts.list("inbox_id");
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**inbox_id:** `AgentMail.InboxId` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request:** `AgentMail.inboxes.ListAccountsRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `AccountsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.inboxes.accounts.<a href="/src/api/resources/inboxes/resources/accounts/client/Client.ts">get</a>(inbox_id, account_id) -> AgentMail.Account</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Returns one account held by the inbox. An account elsewhere is a 404. Requires
+`inbox_read`.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.inboxes.accounts.get("inbox_id", "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32");
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**inbox_id:** `AgentMail.InboxId` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**account_id:** `AgentMail.AccountId` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `AccountsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>
@@ -6668,6 +6916,150 @@ await client.organizations.get();
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+## Pods Accounts
+<details><summary><code>client.pods.accounts.<a href="/src/api/resources/pods/resources/accounts/client/Client.ts">list</a>(pod_id, { ...params }) -> AgentMail.ListAccountsResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Lists accounts held by inboxes in the pod, across all providers. Requires `inbox_read`.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.pods.accounts.list("pod_id");
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**pod_id:** `AgentMail.PodId` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request:** `AgentMail.pods.ListAccountsRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `AccountsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.pods.accounts.<a href="/src/api/resources/pods/resources/accounts/client/Client.ts">get</a>(pod_id, account_id) -> AgentMail.Account</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Returns one account held by inboxes in the pod. An account elsewhere is a 404. Requires
+`inbox_read`.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.pods.accounts.get("pod_id", "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32");
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**pod_id:** `AgentMail.PodId` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**account_id:** `AgentMail.AccountId` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `AccountsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>