List Threads | AgentMail

1 from agentmail import AgentMail 2 3 client = AgentMail( 4 api_key="YOUR_API_KEY", 5 ) 6 client.threads.list( 7 inbox_id="yourinbox@agentmail.to", 8 limit=10, 9 )

1 { 2 "threads": [ 3 { 4 "thread_id": "thread_123", 5 "event_id": "event_123", 6 "labels": [ 7 "RECEIVED", 8 "UNREAD" 9 ], 10 "timestamp": "2024-01-15T09:30:00Z", 11 "senders": [ 12 "alice@example.com", 13 "bob@example.com" 14 ], 15 "recipients": [ 16 "alice@example.com", 17 "bob@example.com" 18 ], 19 "message_count": 3, 20 "subject": "Project Discussion", 21 "preview": "Let's review the timeline for..." 22 }, 23 { 24 "thread_id": "thread_456", 25 "event_id": "event_456", 26 "labels": [ 27 "SENT" 28 ], 29 "timestamp": "2024-01-15T10:15:00Z", 30 "senders": [ 31 "charlie@example.com" 32 ], 33 "recipients": [ 34 "david@example.com" 35 ], 36 "message_count": 1, 37 "subject": "Weekly Update", 38 "preview": "Here's what we accomplished..." 39 } 40 ], 41 "count": 2, 42 "limit": 10, 43 "last_key": "thread_456#2024-01-15T10:15:00Z" 44 }

Path parameters

inbox_idstringRequired

ID (address) of inbox.

Headers

AuthorizationstringRequired

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

limitintegerOptional

Limit of number of items returned.

last_keystringOptional

Key of last item.

labelslist of stringsOptional

Labels to filter by.

Response

This endpoint returns an object.

threadslist of objects

Thread items. Ordered by updated_at descending.

countinteger

Number of items returned.