import { CommuneClient } from 'commune-ai';

const commune = new CommuneClient({ apiKey: process.env.COMMUNE_API_KEY });

const result = await commune.messages.list({
  inboxId: 'inbox_abc123',
  limit: 25,
  direction: 'desc',
});

console.log(result.data.length);  // up to 25

from commune import CommuneClient

client = CommuneClient()

result = client.messages.list(
    inbox_id="inbox_abc123",
    limit=25,
    direction="desc",
)

print(len(result.data))

list_messages(
  inbox_id="inbox_abc123",
  limit=25
)

curl "https://api.commune.email/v1/messages?inbox_id=inbox_abc123&limit=25&order=desc" \
  -H "Authorization: Bearer comm_..."

commune messages list --inbox-id inbox_abc123 --limit 25

{
  "data": [
    {
      "channel": "email",
      "message_id": "49a3999c-0ce1-4ea6-ab68-e08a5c73e498",
      "thread_id": "thread_f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "direction": "inbound",
      "participants": [
        { "role": "sender", "identity": "customer@example.com" },
        { "role": "to", "identity": "support@mycompany.com" }
      ],
      "content": "Hi, I need help with my order.",
      "content_html": "<p>Hi, I need help with my order.</p>",
      "attachments": [],
      "created_at": "2026-02-25T10:30:00.000Z",
      "metadata": {
        "created_at": "2026-02-25T10:30:00.000Z",
        "subject": "Order help",
        "inbox_id": "inbox_abc123",
        "domain_id": "domain_xyz789",
        "delivery_status": "delivered",
        "has_attachments": false,
        "attachment_count": 0,
        "spam_checked": true,
        "spam_score": 0.02,
        "spam_action": "accept",
        "spam_flagged": false,
        "prompt_injection_checked": true,
        "prompt_injection_detected": false,
        "prompt_injection_risk": "none"
      }
    }
  ]
}

{
  "error": "Provide at least one filter: sender, domain_id, or inbox_id"
}

{
  "error": "unauthorized",
  "message": "Invalid or missing API key"
}