import { CommuneClient } from 'commune-ai';

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

const result = await commune.threads.list({
  inboxId: 'inbox_abc123',
  limit: 20,
});

console.log(result.data.length);    // up to 20 threads
console.log(result.next_cursor);    // pass to next call for more
console.log(result.has_more);       // true if more pages exist

from commune import CommuneClient

client = CommuneClient()

result = client.threads.list(
    inbox_id="inbox_abc123",
    limit=20,
)

print(result.next_cursor)

list_threads(inbox_id="inbox_abc123", limit=20)

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

commune threads list --inbox-id inbox_abc123

{
  "data": [
    {
      "thread_id": "thread_f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "subject": "Order help",
      "last_message_at": "2026-02-25T10:30:00.000Z",
      "first_message_at": "2026-02-25T09:00:00.000Z",
      "message_count": 3,
      "snippet": "Hi, I need help with my order.",
      "last_direction": "inbound",
      "inbox_id": "inbox_abc123",
      "domain_id": "domain_xyz789",
      "has_attachments": false
    }
  ],
  "next_cursor": "eyJsYXN0X21lc3NhZ2VfYXQiOiIyMDI2LTAyLTI1VDEwOjMwOjAwLjAwMFoiLCJpZCI6InRocmVhZF9mNDdhYzEwYiJ9",
  "has_more": true
}

{
  "error": "Missing required query parameter: inbox_id or domain_id"
}

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