List email threads
org.intentschema.communication.email.thread.list.v1
JSON: bare · @sha256:eb952aea7b3f…
Hash: sha256:eb952aea7b3f22fe8a5f95f677f1447dc2610a82888d05249bbded4069cd6ebb
List email threads (conversations) matching a query or filter. Useful for thread-level triage.
Payload
| Field | Type | Description |
|---|
target * | Target | |
object | object | |
object
| Field | Type | Description |
|---|
query | string | Provider-specific search string (Gmail q-syntax, JMAP filter, Graph KQL). |
filter | object | |
limit | integer (minimum 1; maximum 500; default 50) | |
cursor | string | |
filter
| Field | Type | Description |
|---|
labels_any | string[] | |
labels_all | string[] | |
is_unread | boolean | |
after | string (date-time) | |
before | string (date-time) | |
Result
| Field | Type | Description |
|---|
items * | object[] | |
next_cursor | string | |
items[]
| Field | Type | Description |
|---|
external_id | string | |
subject | string | |
snippet | string | |
message_count | integer | |
latest_message_date | string (date-time) | |
labels | string[] | |
has_unread | boolean | |
Examples
unread threads in inbox
{
"target": {
"system": "gmail"
},
"object": {
"query": "label:inbox is:unread"
}
}
Profiles