Latest API and SDK updates. Subscribe via RSS · Discord

June 15, 2025

Summary

Introducing Pods - team collaboration spaces for AgentMail. Share inboxes, domains, and resources across your organization while maintaining granular control. Perfect for teams building multi-agent email systems that need organized resource management.

What’s new?

New endpoints:

  • POST /pods - Create a new pod (team workspace)
  • GET /pods - List all pods in your organization
  • GET /pods/{pod_id} - Get pod details
  • DELETE /pods/{pod_id} - Delete a pod
  • POST /pods/{pod_id}/inboxes - Create inbox within a pod
  • POST /pods/{pod_id}/domains - Add custom domain to a pod
  • GET /pods/{pod_id}/threads - List threads within a pod
  • GET /pods/{pod_id}/metrics - Get metrics for a pod

Pod features:

  • Shared inbox access across team members
  • Per-pod domain configuration
  • Isolated metrics and analytics per pod
  • Organized resource hierarchy

Use cases

Build systems where:

  • Multiple agents share email infrastructure
  • Different teams manage their own inboxes independently
  • Resources are organized by department or project
  • Analytics are tracked per team workspace
  • Billing and usage can be attributed to specific teams
1from agentmail import AgentMail
2
3client = AgentMail(api_key="your-api-key")
4
5# create a pod for your sales team
6pod = client.pods.create(
7 name="Sales Team",
8 description="Shared resources for sales agents"
9)
10
11# create an inbox in the pod
12inbox = client.pods.inboxes.create(
13 pod_id=pod.pod_id,
14 inbox_id="sales@example.com"
15)
16
17# list all pods
18pods = client.pods.list()
19for pod in pods.pods:
20 print(f"Pod: {pod.name} ({len(pod.inbox_ids)} inboxes)")

Learn more about organizing teams with Pods in our documentation.