Get Thread | AgentMail | Documentation

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

1 { 2 "thread_id": "thread_123", 3 "event_id": "event_123", 4 "labels": [ 5 "RECEIVED", 6 "UNREAD" 7 ], 8 "timestamp": "2024-01-15T09:30:00Z", 9 "senders": [ 10 "alice@example.com" 11 ], 12 "recipients": [ 13 "bob@example.com" 14 ], 15 "message_count": 1, 16 "messages": [ 17 { 18 "thread_id": "thread_123", 19 "message_id": "msg_123", 20 "event_id": "event_123", 21 "labels": [ 22 "RECEIVED", 23 "UNREAD" 24 ], 25 "timestamp": "2024-01-15T09:30:00Z", 26 "from": "alice@example.com", 27 "to": [ 28 "bob@example.com" 29 ], 30 "inbox_id": "yourinbox@agentmail.to", 31 "organization_id": "org_123", 32 "text": "Let's review the timeline for the project." 33 } 34 ], 35 "inbox_id": "yourinbox@agentmail.to", 36 "organization_id": "org_123", 37 "subject": "Project Discussion", 38 "preview": "Let's review the timeline for..." 39 }

Path parameters

inbox_idstringRequired

ID (address) of inbox.

thread_idstringRequired

ID of thread.

Headers

AuthorizationstringRequired

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

Response

This endpoint returns an object.

thread_idstring

ID of thread.

event_idstring

Event ID of thread.

labelslist of strings

Labels of thread.

timestampdatetime

Time at which last message was sent.

senderslist of strings

Addresses of senders in thread. In format username@domain.com or Display Name <username@domain.com>

recipientslist of strings

Addresses of recipients in thread. In format username@domain.com or Display Name <username@domain.com>

message_countinteger

Number of messages in thread.

messageslist of objects

Messages in thread. Ordered by sent_at ascending.

inbox_idstring

ID (address) of inbox.

organization_idstring

ID of organization.

subjectstringOptional

Subject of thread.

previewstringOptional

Text preview of last message in thread.

attachmentslist of objectsOptional

Attachments in thread.

Path parameters

Headers

Response

Errors