List threads
Lists conversations, most recently active first. query matches subjects, mailboxes, and participants literally; mailbox narrows to one address.
GET
/threadsAuthorization
AuthorizationBearer token (API key) · headerrequiredPass an AI Inbx API key as a Bearer token.
Query parameters
limitintegerMaximum number of resources to return.
min 1 · max 100 · default: 40
cursorstringOpaque cursor from the previous page.
min length 1
spacestringOnly resources in this space. Pass `none` for resources that belong to the workspace itself (`space_id: null`), or omit for the workspace and all its spaces.
matches ^(?:none|spc_[0-9a-f]{32})$
querystringSearch subjects, mailboxes, and participants.
max length 320
mailboxstring<email>Filter by mailbox address.
Responses
200Success.
dataobject[]requiredShow propertiesHide properties
Array of
objectidstringrequiredmatches ^[a-z]+_[0-9a-f]{32}$
space_idstring | anyrequiredWhich space a resource is in. Null is the workspace itself — what every resource of a workspace that has no spaces says.
Show propertiesHide properties
Any of:
string
stringany
anysubjectstringrequiredmailboxstring<email>requiredmatches ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$
participantsstring<email>[]requiredmessage_countintegerrequiredmin 0 · max 9007199254740991
last_message_atstring<date-time>requiredmatches ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
forward_ofstring | anyrequiredThe thread this one was forwarded from, when a forward opened it.
Show propertiesHide properties
Any of:
string
stringany
anymessagesobject[]Show propertiesHide properties
Array of
objectidstringrequiredmatches ^[a-z]+_[0-9a-f]{32}$
thread_idstringrequiredmatches ^[a-z]+_[0-9a-f]{32}$
space_idstring | anyrequiredWhich space a resource is in. Null is the workspace itself — what every resource of a workspace that has no spaces says.
Show propertiesHide properties
Any of:
string
stringany
anydirectionstringrequiredAllowed:
inboundoutboundstatusstringrequiredAllowed:
scheduledcanceledqueuedsendingsentdeliveredbouncedcomplainedfailedreceivedfromobjectrequiredShow propertiesHide properties
namestring | anyShow propertiesHide properties
Any of:
string
stringany
anyaddressstring<email>requiredmatches ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$
tostring<email>[]requiredccstring<email>[]requiredbccstring<email>[]requiredreply_tostring<email>[]requiredsubjectstringrequiredsnippetstringrequiredhtmlstring | anyrequiredShow propertiesHide properties
Any of:
string
stringany
anytextstring | anyrequiredShow propertiesHide properties
Any of:
string
stringany
anycategorystring | anyrequiredShow propertiesHide properties
Any of:
string
stringany
anysuppression_keystring | anyrequiredShow propertiesHide properties
Any of:
string
stringany
anymessage_idstringrequiredin_reply_tostring | anyrequiredShow propertiesHide properties
Any of:
string
stringany
anyidempotency_keystring | anyrequiredShow propertiesHide properties
Any of:
string
stringany
anycreated_atstring<date-time>requiredmatches ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
scheduled_atstring<date-time> | anyrequiredShow propertiesHide properties
Any of:
string<date-time>
string<date-time>any
anysent_atstring<date-time> | anyrequiredShow propertiesHide properties
Any of:
string<date-time>
string<date-time>any
anyattachmentsobject[]requiredShow propertiesHide properties
Array of
objectidstringrequiredmatches ^[a-z]+_[0-9a-f]{32}$
filenamestringrequiredcontent_typestringrequiredsizeintegerrequiredmin 0 · max 9007199254740991
cidstring | anyrequiredShow propertiesHide properties
Any of:
string
stringany
anydownload_urlstring<uri>requiredpreparationobject | anyrequiredShow propertiesHide properties
Any of:
object
statusstringrequiredAllowed:
readypartialunsupportedfailedformatstring | anyrequiredShow propertiesHide properties
Any of:
string
stringany
anypagesinteger | anyrequiredShow propertiesHide properties
Any of:
integer
integerany
anywarningsstring[]requiredcontent_urlstring<uri> | anyrequiredShow propertiesHide properties
Any of:
string<uri>
string<uri>any
anytextstring | anyShow propertiesHide properties
Any of:
string
stringany
anyany
anystripped_textstring | anyrequiredWhat this message says: typed text only, quoted conversation and signature removed.
Show propertiesHide properties
Any of:
string
stringany
anysegmentsobject[]requiredShow propertiesHide properties
Array of
objectkindstringrequiredAllowed:
writtenquotedsignaturetextstringrequiredreferencesstring[]requiredheadersobject[]requiredShow propertiesHide properties
Array of
objectnamestringrequiredvaluestringrequiredeventsobject[]requiredShow propertiesHide properties
Array of
objectidstringrequiredmatches ^[a-z]+_[0-9a-f]{32}$
typestringrequiredAllowed:
scheduledcanceledqueuedreplayedsentdelivereddeferredbouncedcomplainedfailedatstring<date-time>requiredmatches ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
recipientstring<email> | anyrequiredShow propertiesHide properties
Any of:
string<email>
string<email>any
anydetailstring | anyrequiredShow propertiesHide properties
Any of:
string
stringany
anyengagementsobject[]requiredShow propertiesHide properties
Array of
objectkindstringrequiredAllowed:
openclickatstring<date-time>requiredmatches ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
urlstring<uri> | anyrequiredShow propertiesHide properties
Any of:
string<uri>
string<uri>any
anyuser_agentstring | anyrequiredShow propertiesHide properties
Any of:
string
stringany
anymessages_next_cursorstring | anyShow propertiesHide properties
Any of:
string
stringany
anynext_cursorstring | anyrequiredShow propertiesHide properties
Any of:
string
stringany
any400The request is invalid.
typestringrequiredtitlestringrequiredstatusintegerrequiredmin -9007199254740991 · max 9007199254740991
detailstringrequiredcodestringrequiredrequest_idstringrequiredissuesobject[]Show propertiesHide properties
Array of
objectpathstringrequiredmessagestringrequired401The API key is missing or invalid.
typestringrequiredtitlestringrequiredstatusintegerrequiredmin -9007199254740991 · max 9007199254740991
detailstringrequiredcodestringrequiredrequest_idstringrequiredissuesobject[]Show propertiesHide properties
Array of
objectpathstringrequiredmessagestringrequired403The API key does not have the required scope.
typestringrequiredtitlestringrequiredstatusintegerrequiredmin -9007199254740991 · max 9007199254740991
detailstringrequiredcodestringrequiredrequest_idstringrequiredissuesobject[]Show propertiesHide properties
Array of
objectpathstringrequiredmessagestringrequired404The requested resource does not exist.
typestringrequiredtitlestringrequiredstatusintegerrequiredmin -9007199254740991 · max 9007199254740991
detailstringrequiredcodestringrequiredrequest_idstringrequiredissuesobject[]Show propertiesHide properties
Array of
objectpathstringrequiredmessagestringrequired409The request conflicts with the resource's current state.
typestringrequiredtitlestringrequiredstatusintegerrequiredmin -9007199254740991 · max 9007199254740991
detailstringrequiredcodestringrequiredrequest_idstringrequiredissuesobject[]Show propertiesHide properties
Array of
objectpathstringrequiredmessagestringrequired413The request body or attachments are too large.
typestringrequiredtitlestringrequiredstatusintegerrequiredmin -9007199254740991 · max 9007199254740991
detailstringrequiredcodestringrequiredrequest_idstringrequiredissuesobject[]Show propertiesHide properties
Array of
objectpathstringrequiredmessagestringrequired415The request body is not JSON.
typestringrequiredtitlestringrequiredstatusintegerrequiredmin -9007199254740991 · max 9007199254740991
detailstringrequiredcodestringrequiredrequest_idstringrequiredissuesobject[]Show propertiesHide properties
Array of
objectpathstringrequiredmessagestringrequired422The request body failed validation.
typestringrequiredtitlestringrequiredstatusintegerrequiredmin -9007199254740991 · max 9007199254740991
detailstringrequiredcodestringrequiredrequest_idstringrequiredissuesobject[]Show propertiesHide properties
Array of
objectpathstringrequiredmessagestringrequired429The organisation's request budget is spent (`too_many_requests`), or an upstream mail provider is throttling (`rate_limited`).
typestringrequiredtitlestringrequiredstatusintegerrequiredmin -9007199254740991 · max 9007199254740991
detailstringrequiredcodestringrequiredrequest_idstringrequiredissuesobject[]Show propertiesHide properties
Array of
objectpathstringrequiredmessagestringrequired500An internal error occurred.
typestringrequiredtitlestringrequiredstatusintegerrequiredmin -9007199254740991 · max 9007199254740991
detailstringrequiredcodestringrequiredrequest_idstringrequiredissuesobject[]Show propertiesHide properties
Array of
objectpathstringrequiredmessagestringrequired502An upstream mail provider failed.
typestringrequiredtitlestringrequiredstatusintegerrequiredmin -9007199254740991 · max 9007199254740991
detailstringrequiredcodestringrequiredrequest_idstringrequiredissuesobject[]Show propertiesHide properties
Array of
objectpathstringrequiredmessagestringrequired503The service is temporarily unavailable.
typestringrequiredtitlestringrequiredstatusintegerrequiredmin -9007199254740991 · max 9007199254740991
detailstringrequiredcodestringrequiredrequest_idstringrequiredissuesobject[]Show propertiesHide properties
Array of
objectpathstringrequiredmessagestringrequired