email

 ⟨111 unchanged words⟩ for the user: tell them. Result: the accountinbox isand inits data.data.api_key.

{"descriptionadditionalProperties":"Envelope; the result is in data.data."false,"properties":{"data":{"description":"API response: the resultThe inmanaged datainbox, or error.","properties":{"data":{"description":"Theits managedsender inboxmailbox and its api_key.","properties":{"address":{"description":"Managed inbox domain.domain, not a mailbox: send from sender_address.","type":["string","null"]},"api_key":{"description":"Pass as api_key on later calls;calls. absentAbsent ifwhen unavailable.it cannot be returned.","type":"string"},"can_send_to":{"additionalProperties":false,"description":"Who youthis account may email. Absent when no api_key is available.","properties":{"any_recipientaddress_rules_omitted":{"description":"AnyAddress recipientrules isleft allowed.out of rules; set when some were.","type":"booleaninteger"},"rulesaddress_rules_partial":{"description":"WhoTrue iswhen allowed:the eachaddress hasrules are a typesample: andan aunlisted description.address may be allowed.","type":"arrayboolean"},"summaryany_recipient":{"description":"WhatTrue towhen tellany therecipient user.","type":"stringis allowed. Set when known."}},"type":"objectboolean"},"existing_accountknown":{"description":"ThisFalse host'swhen existingthe inbox,rules returnedcould again.not be read; then only summary is set.","type":"boolean"},"fundingrules":{"description":"LinkWho toyou fundmay credits.email, one rule per kind of recipient. Set when known.","items":{"additionalProperties":false,"properties":{"descriptionaddress":{"description":"address and org_member_email rules only: the address.","type":"string"},"urldescription":{"typedescription":["string"Who the rule allows,"null in words."]}},"type":"objectstring"},"limitsdomain":{"description":"Whatyour_domain therules planonly: allows.the domain.","propertiestype":{"api_per_minutestring"},"last_received_at":{"typedescription":["numberaddress rules only: last mail from it.","type":"string"]},"send_per_dayreceived_count":{"typedescription":["numberaddress rules only: emails received from it.","stringtype"]:"integer"},"send_per_hourtype":{"typedescription":["numberany_recipient, primitive_managed_domain, managed_zone, your_domain, address, org_member_email or opted_in_domains.","type":"string"]},"storage_mbzone":{"typedescription":["numbermanaged_zone rules only: the zone.","type":"string"]}},"required":["type","description"],"type":"object"},"messagetype":"array"},"summary":{"description":"ForWho anthis existingaccount inbox:can whatreach, to tell the user.","type":"string"}},"org_idrequired":["known","summary"],"type":"object"},"existing_account":{"description":"AccountTrue id.when this host already had an inbox and it was returned again.","type":"stringboolean"},"planfunding":{"additionalProperties":false,"description":"PlanNew nameaccount only: agent.how to fund credits.","properties":{"description":{"description":"What funding does.","type":"string"},"sender_addressurl":{"description":"MailboxWhere to sendfund from.it; null if not available.","type":["string","null"]}},"upgraderequired":["url","description"],"type":"object"},"limits":{"additionalProperties":false,"description":"HowNew toaccount moveonly: towhat athe fullplan account.allows.","properties":{"claim_pathapi_per_minute":{"description":"API requests per minute.","type":"stringinteger"},"descriptionsend_per_day":{"description":"Emails it may send per day.","type":"stringinteger"},"plansend_per_hour":{"description":"Emails it may send per hour.","type":"stringinteger"}},"storage_mb":{"description":"Mail storage, in MB.","type":"objectnumber"}},"typerequired":["objectsend_per_hour","nullsend_per_day","api_per_minute","storage_mb"],"type":"object"},"errormessage":{"description":"WhyExisting theinbox callonly: waswhat refused;to absenttell onthe success.user.","propertiestype":"string"},"org_id":{"codedescription":"Account id.","type":"string"},"plan":{"description":"ErrorNew codeaccount toonly: branchplan on.name, agent.","type":"string"},"messagesender_address":{"description":"WhatMailbox wentto wrong,send infrom. words.Set when address is.","type":"string"}},"typeupgrade":[{"objectadditionalProperties":false,"nulldescription"]}:"New account only: how to move to a full account.","successproperties":{"claim_path":{"description":"TrueAPI whenpath datathat holdsclaims the result.account.","type":"booleanstring"}},"description":{"description":"What upgrading does.","type":"objectstring"},"statusplan":{"description":"HTTP status;Plan 2xxit onmoves success.to.","type":"numberstring"}},"toolrequired":{["plan","description":,"Tool that answered.claim_path"],"type":"stringobject"}},"required":["toolorg_id","statusaddress","dataexisting_account"],"type":"object"}

 ⟨45 unchanged words⟩  when `from` is omitted. Result: the account is in data.data.record.

{"descriptionadditionalProperties":"Envelope; the result is in data.data."false,"properties":{"data":{"description":"APIThe responseaccount: theplan, resultlimits inand data,the ormailbox error.to send from.","properties":{"datacreated_at":{"description":"The account:When plan,the limits,account managedwas inbox.made.","propertiestype":{["string","null"]},"email":{"description":"Owner email; null for ⟨8 unchanged words⟩ ":"Granted capabilities, such as send_mail.","items":{"type":"string"},"type":"array"},"id":{"description":"Account id.","type":"string"},"limits":{"additionalProperties":false,"description":"What the plan allows.","properties":{"api_per_minute":{"type":["number","string"]},"send_per_day":{"typedescription":["number","stringAPI requests per minute."]},"send_per_hour":{"type":["number","stringinteger"]},"storage_mbsend_per_day":{"typedescription":["number","stringEmails it may send per day."]}},"type":"objectinteger"},"managed_inbox_addresssend_per_hour":{"description":"ManagedEmails inboxit domain,may notsend aper mailbox.hour.","type":["string","nullinteger"]},"onboarding_completedstorage_mb":{"description":"SetupMail finished.storage, in MB.","type":["boolean","nullnumber"]},"plan":{"description":"Plan name."},"typerequired":["stringsend_per_hour","nullsend_per_day"]},"sender_address":{"description":"Default sender mailbox.api_per_minute","type":"stringstorage_mb"}}],"type":["object","null"]},"errormanaged_inbox_address":{"description":"Why the call wasManaged refused;inbox absentdomain, onnot success.","properties":{"code":{"description":"Errora codemailbox; tonull branchif on.none.","type":["string","null"]},"messageonboarding_completed":{"description":"WhatTrue wentwhen wrong,setup inis words.","type":"stringfinished; null if unknown."}},"type":["objectboolean","null"]},"successplan":{"description":"TruePlan whenname, datasuch holdsas theagent result.or developer.","type":["booleanstring"}},"type":"objectnull"]},"statussender_address":{"description":"HTTPMailbox status;to 2xxsend onfrom success.by default. Set when there is a managed inbox.","type":"numberstring"}},"toolrequired":{["descriptionid":,"Tool that answered.email","typeplan":,"stringmanaged_inbox_address"}},"requiredcreated_at":[,"toollimits","statusentitlements","dataonboarding_completed"],"type":"object"}

 ⟨107 unchanged words⟩ id: use listSentEmails and getSentEmail. Result: the conversation is in data.data.conversation.

{"descriptionadditionalProperties":"Envelope; the result is in data.data."false,"properties":{"data":{"description":"API response: the resultThe inwhole datathread, or error.","properties":{"data":{"description":"Theoldest wholemessage thread.first.","properties":{"message_count":{"description":"Messages in the thread.thread; more than returned when truncated.","type":"numberinteger"},"messages":{"description":"Every message, oldest first.","items":{"propertiesadditionalProperties":{false,"attachmentsproperties":{"type":"array"},"directionattachments":{"description":"inboundFiles oron outbound.it; absent when none.","typeitems":{"stringadditionalProperties"}:false,"fromproperties":{"typecontent_type":{"stringdescription"},:"idMedia type, such as application/pdf.":{,"type":["string","null"]},"message_idfilename":{"description":"Message-IDFile header;name; fullnull only.when the email gave none.","type":["string","null"]},"rolepart_index":{"description":"userPass (inbound)to orgetEmailAttachment assistantto (outbound).read it.","type":["stringinteger","null"]},"subjectsize_bytes":{"description":"Size in bytes.","type":["stringinteger","null"]}},"text":{"descriptionrequired":["Readable text; as stored with full.filename","typecontent_type":,"stringsize_bytes"},"timestamppart_index":{],"type":["stringobject"},"nulltype"]:"array"},"todirection":{"description":"inbound or outbound.","type":"string"}},"typefrom":{"objectdescription"}:"Sender.","type":"arraystring"},"quoted_chars_removedid":{"description":"QuotedEmail textid: leftgetEmail out;for 0inbound, withgetSentEmail full.for outbound.","type":"numberstring"},"subjectmessage_id":{"description":"Threadfull subject.only: Message-ID header.","type":["string","null"]},"thread_idrole":{"description":"Nulluser for ainbound, brand-newassistant message.for outbound.","type":["string","null"]},"truncatedsubject":{"description":"Message capSubject reached.","type":"booleanline."}},"type":["objectstring","null"]},"errortext":{"description":"WhyReadable thetext, callwith waslinks refused;as absent[link]; onas success.stored with full.","propertiestype":{"codestring"},"timestamp":{"description":"ErrorWhen codeit towas branchsent on.or received.","type":["string","null"]},"messageto":{"description":"What went wrong, in words.Recipients.","type":"string"}},"typerequired":["objectrole","nulldirection","id","from","to","subject","text","timestamp"],"type":"object"},"successtype":"array"},"quoted_chars_removed":{"description":"TrueCharacters whenof dataquoted holdshistory left out of the result.texts; 0 with full.","type":"booleaninteger"}},"subject":{"description":"Subject of the thread.","type":["objectstring","null"]},"statusthread_id":{"description":"HTTPConversation status;id; 2xxnull onfor success.a brand-new message.","type":["numberstring","null"]},"tooltruncated":{"description":"ToolTrue thatwhen answered.the message cap was reached.","type":"stringboolean"}},"required":["toolthread_id","statussubject","dataquoted_chars_removed","messages"],"type":"object"}

 ⟨94 unchanged words⟩ preheader, paging or link fields. Result: the email is in data.data.email.

{"additionalProperties":false,"description":"Envelope; the result isOne ininbound data.data.email.","properties":{"dataattachments":{"description":"APIFiles response:on the resultemail; inread data,one orwith error.getEmailAttachment.","properties":{"dataitems":{"descriptionadditionalProperties":"One inbound email."false,"properties":{"attachmentscontent_type":{"description":"ReadMedia onetype, withsuch getEmailAttachment.as application/pdf.","items":{"properties":{"content_type":{"type":["string","null"]},"filename":{"description":"File name; null when the email gave none.","type":["string","null"]},"part_index":{"description":"Pass to getEmailAttachment.getEmailAttachment to read it.","type":["number","stringinteger","null"]},"size_bytes":{"typedescription":["numberSize in bytes.","stringtype":["integer","null"]}},"required":["filename","content_type","size_bytes","part_index"],"type":"object"},"type":"array"},"auth":{"description":"Fullfull only: SPF, DKIM, and DMARC results.results; their keys vary by message.","type":"object"},"body_chars":{"description":"WholeLength of the whole body, length.in characters. Not with full.","type":["number","stringinteger"]},"body_html":{"description":"HTMLfull body,only: fullthe only.HTML body.","type":["string","null"]},"body_incomplete":{"description":"True when the HTML was too deep to read in full. Not with full.","type":"boolean"},"body_next_offset":{"description":"NextPass offset;as offset to read on; null at the end. Not with full.","type":["number","stringinteger","null"]},"body_offset":{"description":"Where this pagepart of the body starts. Not with full.","type":["number","stringinteger"]},"body_source":{"description":"html, text or none: what body_text camewas made from. Not with full.","type":"string"},"body_text":{"description":"NoThe quotedbody as text. Quoted history is left out and links are [n] markers, unless full. Null when there is none.","type":["string","null"]},"from":{"description":"Sender, as the From header.header shows it.","type":"string"},"from_email":{"description":"Senderfull only: sender address.","type":"string"},"id": ⟨5 unchanged words⟩ image_count":{"description":"Images in the body. Not with full.","type":["number","stringinteger"]},"link_count":{"description":"Links in the body. Not with full.","type":["number","stringinteger"]},"links":{"description":"TargetsWith the links argument: the link targets asked for.","items":{"additionalProperties":false,"properties":{"n":{"description":"The [n] marker in body_text.","type":["number","stringinteger"]},"url":{"description":"Where the link goes.","type":"string"}},"required":["n","url"],"type":"object"},"type":"array"},"parse_status":{"description":"Parse stage, when known. pending or processing: read again shortly.shortly; failed: the body may be incomplete.","type":["string","null"]},"parsed":{"description":"Fullfull only: the parsed message as stored; its keys vary by message.","type":"object"},"preheader":{"description":"PreviewInbox text;preview nottext. Not with full.","type":["string","null"]},"quoted_chars_removed":{"description":"QuotedCharacters textof quoted history left out. Not with full.","type":["number","stringinteger"]},"received_at":{"description":"Arrival time.","type":"string"},"replies":{"description":"Fullfull only: yourreplies replies.you sent to it.","items":{"propertiesadditionalProperties":{false,"created_atproperties":{"type":"string"},"idcreated_at":{"typedescription":"stringWhen it was sent."},"status":{"type":"string"},"subjectid":{"typedescription":["string","null"]}}Sent email id,"type":"object for getSentEmail."},"type":"arraystring"},"status":{"description":"ProcessingDelivery stage.state.","type":"string"},"subject":{ ⟨3 unchanged words⟩ "type":["string","null"]},"thread_idto_address":{"description":"Conversation it belongsRecipient to.address.","type":["string","null"]}},"to":{"descriptionrequired":["Recipient.id","type":"stringstatus"},"to_emailto_address":{,"descriptionsubject":,"Recipient address.created_at"],"type":"stringobject"}},"type":["object","nullarray"]},"errorstatus":{"description":"Why the call was refused; absent onfull success.","properties":{"code":{"description"only:"Error code to branchprocessing on.stage.","type":"string"},"messagesubject":{"description":"What went wrong, inSubject words.","type":"stringline."}},"type":["objectstring","null"]},"successthread_id":{"description":"TrueConversation id, for getConversation; null when datait holdsis thein result.none.","type":["booleanstring"}},"type":"objectnull"]},"statusto":{"description":"HTTP status; 2xx onRecipient success.address.","type":"numberstring"},"toolto_email":{"description":"Toolfull thatonly: answered.recipient address.","type":"string"}},"required":["toolid","statusthread_id","datareceived_at","from","to","subject","body_text","attachments"],"type":"object"}

 ⟨119 unchanged words⟩  with offset set to next_offset. Result: the attachment is in data.attachment.

{"descriptionadditionalProperties":"Envelope; the attachment is in data."false,"propertiesdescription":{"data"One attachment:{" its description":"The, attachment.and its content when it can be returned.","properties":{"content_available":{"description":"ContentTrue when the content is included.in this result: in text, content_base64 or an image block.","type":"boolean"},"content_base64":{"description":"TheSmall filebinary files: the content.","type":"string"},"content_type":{"description":"Media type.type, such as text/csv.","type":["string","null"]},"email_id":{"description":"Email itthe attachment belongs to.","type":"string"},"encoding":{"description":"Small binary files: base64, forthe encoding of content_base64.","type":"string"},"filename":{"description":"File name.name; null when the email gave none.","type":["string","null"]},"format":{"description":"text only: text, or text_from_html.text_from_html when made from HTML.","type":"string"},"kind":{ ⟨6 unchanged words⟩ :"string"},"max_inline_bytes":{"description":"LargestFiles inlinetoo size.large to return: the largest size returned here, in bytes.","type":["number","stringinteger"]},"next_offset":{"description":"Offsettext only: pass as offset to read next.on; absent at the end.","type":["number","stringinteger"]},"note":{"description":"What to tell the user.user, when there is something to say.","type":"string"},"offset":{"description":"Starttext ofonly: character where this part.part starts.","type":["number","stringinteger"]},"part_index":{"description":"Its position in the email.","type":["number","string","nullinteger"]},"returned_chars":{"description":"Characterstext only: characters returned.","type":["number","stringinteger"]},"sha256":{"description":"ContentSHA-256 hash.of the content, hex.","type":["string","null"]},"size_bytes":{"description":"FileSize size.in bytes, as the email declares it.","type":["number","stringinteger","null"]},"source":{"description":"received or sent.sent: which kind of email.","type":"string"},"text":{"description":"Thistext only: this part of the text.","type":"string"},"total_chars":{"description":"Text length;text only: length of the text; of the part read ifwhen the file was cut.","type":["number","stringinteger"]},"truncated":{"description":"Moretext only: true when more text follows, at next_offset.","type":"boolean"}},"typerequired":["objectemail_id"},"status":{"description":"HTTP status; 2xx on success.source","type":"numberpart_index"},"tool":{"description":"Tool that answered.filename","type":"stringcontent_type"}},"requiredsize_bytes":[,"toolsha256","statuskind","datacontent_available"],"type":"object"}

 ⟨21 unchanged words⟩  management tools at /mcp/full. Result: the inbox status is in data.data.status.

{"descriptionadditionalProperties":"Envelope; the result is in data.data."false,"properties":{"data":{"description":"API response: theWhether resultinbound inmail data,is orset error."up,"properties":{"data":{"description":"Whether inboundand mailwhat is setleft up.to do.","properties":{"domains":{"description":"Domains that receive mail.","items":{"additionalProperties":false,"properties":{"domain":{"description":"Domain name.","type":"string"},"email_count":{"typedescription":["numberEmails received on it.","stringtype"]:"integer"},"id":{"description":"Domain id, for domain_id filters.","type":"string"},"latest_email_received_at":{"description":"Last arrival; null if none.","type":["string","null"]},"processing_ready":{"description":"True when its mail reaches a webhook or Function.","type":"boolean"},"receiving_ready":{"description":"True when it receives mail.","type":"boolean"},"status":{"description" ⟨3 unchanged words⟩ or inactive.","type":"string"}},"required":["id","domain","status","receiving_ready","processing_ready","email_count","latest_email_received_at"],"type":"object"},"type":"array"},"endpoints":{"additionalProperties":false,"description":"Webhook endpoints.endpoints, by state.","properties":{"disabled":{"typedescription":["numberEndpoints turned off.","stringtype"]:"integer"},"enabled":{"typedescription":["numberEndpoints receiving mail.","stringtype"]:"integer"},"total":{"description":"All endpoints.","type":"integer"}},"required":["numbertotal","stringenabled","disabled"]}},"type":"object"},"functions":{"additionalProperties":false,"description":"DeployedFunctions, Functions.by deploy state.","properties":{"deployed":{"typedescription":["numberRunning.","stringtype"]:"integer"},"failed":{"typedescription":["numberFailed to deploy.","stringtype"]:"integer"},"pending":{"typedescription":["numberStill deploying.","stringtype"]:"integer"},"total":{"typedescription":["number","stringAll Functions."]}},"type":"objectinteger"}},"next_actionsrequired":{["descriptiontotal":,"Steps left: kinddeployed", message"pending", command."failed"],"type":"arrayobject"},"processing_readynext_actions":{"description":"MailSteps isleft, routedmost somewhere.important first; empty when ready.","typeitems":{"booleanadditionalProperties"}:false,"readyproperties":{"command":{"description":"MailCLI iscommand receivedthat anddoes processed.it; absent when there is none.","type":"booleanstring"},"receiving_readykind":{"description":"AThe domainstep, receivessuch mail.as add_domain or verify_domain.","type":"booleanstring"},"recent_emailsmessage":{"description":"InboundWhat activity.to do, in words.","propertiestype":{"latest_received_atstring":{}},"typerequired":["stringkind","nullmessage"]},"total":{"type":["number","stringobject"]}},"type":"objectarray"},"summaryprocessing_ready":{"description":"Plain-languageTrue status.","type":"stringwhen received mail reaches a webhook or Function."}},"type":["object","nullboolean"]},"errorready":{"description":"Why theTrue callwhen wasmail refused;is absentreceived onand success.processed.","propertiestype":{"codeboolean"},"receiving_ready":{"description":"ErrorTrue codewhen tosome branchdomain on.receives mail.","type":"stringboolean"},"messagerecent_emails":{"additionalProperties":false,"description":"What went wrong, inInbound words.activity.","typeproperties":{"stringlatest_received_at"}}:{"description":"Last arrival; null if none.","type":["objectstring","null"]},"successtotal":{"description":"True when data holdsInbound theemails result.stored.","type":"booleaninteger"}},"required":["total","latest_received_at"],"type":"object"},"statussummary":{"description":"HTTPPlain-language status;status, 2xxto ontell success.the user.","type":"numberstring"}},"toolrequired":{["descriptionready":,"Tool that answered.receiving_ready","typeprocessing_ready":,"stringsummary"}},"requirednext_actions":[,"tooldomains","statusendpoints","datafunctions","recent_emails"],"type":"object"}

 ⟨35 unchanged words⟩  the managed inbox. Result: the outbound status is inand data.data.can_send_to.

{"additionalProperties":false,"description":"Envelope;Where theyou resultcan issend infrom, data.data.and to whom.","properties":{"datacan_send_to":{"descriptionadditionalProperties":false,"API responsedescription": the result"Who inthis data,account ormay error.email.","properties":{"dataaddress_rules_omitted":{"description":"WhereAddress yourules canleft sendout from,of andrules; toset whom.when some were.","propertiestype":{"can_send_tointeger"},"address_rules_partial":{"description":"WhoTrue youwhen the address rules are a sample: an unlisted address may email.be allowed.","propertiestype":{"boolean"},"any_recipient":{"description":"AnyTrue when any recipient is allowed. Set when known.","type":"boolean"},"rulesknown":{"description":"WhoFalse when the rules could not be read; then only summary is allowedset.","type":"boolean"},"rules":{"description":"Who eachyou hasmay aemail, typeone rule per kind of recipient. Set when known.","items":{"additionalProperties":false,"properties":{"address":{"description":"address and aorg_member_email description.rules only: the address.","type":"arraystring"},"summarydescription":{"description":"WhatWho tothe tellrule theallows, user.in words.","type":"string"}},"domain":{"description":"your_domain rules only: the domain.","type":"objectstring"},"domainslast_received_at":{"description":"Youraddress domainsrules andonly: whatlast eachmail stillfrom needs.it.","itemstype":{"propertiesstring"},"received_count":{"domaindescription":{"address rules only: emails received from it.","type":"stringinteger"},"idtype":{"description":"any_recipient, primitive_managed_domain, managed_zone, your_domain, address, org_member_email or opted_in_domains.","type":"string"},"outbound_verifiedzone":{"description":"SPF,managed_zone DKIMrules andonly: DMARCthe verified.zone.","type":"booleanstring"}},"ownership_verifiedrequired":{["type","description"],"type":"booleanobject"},"statustype":"array"},"summary":{"description":"sendable,Who pending_outbound_dns,this pending_ownershipaccount can reach, inactive.to tell the user.","type":"string"}},"typerequired":["objectknown"},"summary"],"type":"arrayobject"},"next_actionsdomains":{"description":"StepsYour left:domains kindand what each still needs.","items":{"additionalProperties":false,"properties":{"domain":{"description":"Domain messagename.","type":"string"},"id":{"description":"Domain command.id.","type":"arraystring"},"readyoutbound_verified":{"description":"SomeTrue domainwhen canSPF, send.DKIM and DMARC are verified.","type":"boolean"},"sendable_domainsownership_verified":{"description":"Domains youTrue canwhen sendownership fromis now.proven.","type":"arrayboolean"},"summarystatus":{"description":"Plain-languagesendable, status.pending_outbound_dns, pending_ownership or inactive.","type":"string"}},"typerequired":["objectid","nulldomain","status","ownership_verified","outbound_verified"],"type":"object"},"errortype":"array"},"next_actions":{"description":"WhySteps theleft, callmost wasimportant refused;first; absentempty onwhen success.ready.","items":{"additionalProperties":false,"properties":{"codecommand":{"description":"ErrorCLI codecommand tothat branchdoes on.it; absent when there is none.","type":"string"},"kind":{"description":"The step, such as add_domain or verify_domain.","type":"string"},"message":{"description":"What wentto wrongdo, in words.","type":"string"}},"typerequired":["objectkind","nullmessage"],"type":"object"},"successtype":"array"},"ready":{"description":"True when datasome holdsdomain thecan result.send now.","type":"boolean"}},"typesendable_domains":{"objectdescription"}:"Domains you can send from now.","statusitems":{"descriptiontype":"HTTP status; 2xx on success.string"},"type":"numberarray"},"toolsummary":{"description":"ToolPlain-language thatstatus, answered.to tell the user.","type":"string"}},"required":["toolready","statussummary","datasendable_domains","domains","next_actions","can_send_to"],"type":"object"}

 ⟨61 unchanged words⟩ stored record, including body_html. Result: the sent email is in data.data.email.

 ⟨7 unchanged words⟩ Return the stored record, with the HTML body, quoted history and signingquoted detailshistory, instead of the compact view for reading." ⟨21 unchanged words⟩ 

{"additionalProperties":false,"description":"Envelope; the result isOne insent data.data.email.","properties":{"dataattachments":{"description":"APIFiles response:sent thewith resultit; inread data,one orwith error.getEmailAttachment and source sent.","items":{"additionalProperties":false,"properties":{"datacontent_type":{"description":"OneMedia senttype, email.such as application/pdf.","propertiestype":["string","null"]},"filename":{"attachmentsdescription":"File name; null when the email gave none.","type":["string","null"]},"part_index":{"description":"EachPass to getEmailAttachment to read it.","type":["integer","null"]},"size_bytes":{"description":"Size in bytes.","type":["integer","null"]}},"required":["filename", "content_type", "size_bytes", part_index."part_index"],"type":"object"},"type":"array"},"attachments_complete":{"description":"False ifwhen some attachments may be missing.missing from the list.","type":"boolean"},"bcc":{"description":"Blind-copied addresses.addresses, when there were any.","items":{"type":"string"},"type":["array","null"]},"body_html":{"description":"HTMLfull body,only: fullthe only.HTML body.","type":["string","null"]},"body_source":{"description":"Bodytext, thehtml textor camenone: what body_text was made from. Not with full.","type":"string"},"body_text":{"description":"NoThe body as text, quoted history left out unless full.full; null when there is none.","type":["string","null"]},"canceled_at":{"description":"When a scheduled send was canceled.","type":["string","null"]},"cc":{"description":"Copied addresses.addresses, when there were any.","items":{"type":"string"},"type":["array","null"]},"created_at":{ ⟨8 unchanged words⟩ :"string"},"error_code":{"description":"WhySet when it was not delivered.delivered: why, as a code.","type":["string","null"]},"error_message":{"description":"DetailSet ofwhen theit error.was not delivered: why, in words.","type":["string","null"]},"from":{"description":"Sender.Sender, as the From header shows it.","type":"string"},"from_address":{"description":"Envelopefull sender.only: envelope sender address.","type":"string"},"gates":{"description":"RulesSet thatwhen rules refused it: name,which reason.ones.","typeitems":[{"arrayadditionalProperties":false,"nullproperties"]},:{"idmessage":{"description":"SentWhy, emailin idwords, forwhen getSentEmail.given.","type":"string"},"in_reply_to_email_idname":{"description":"InboundRule emailthat refused it, answers.such as send_to_known_addresses.","type":["string","null"]},"quoted_chars_removedreason":{"description":"QuotedWhy, textas lefta out.code, when given.","type":["number","string"]}},"reply_to":{"descriptiontype":"Reply-To addresses.object"},"type":["array","null"]},"request_idid":{"description":"ForSent support.email id, for getSentEmail.","type":["string","null"]},"scheduled_atin_reply_to_email_id":{"description":"WhenSet when it goesanswers out.an inbound email: its id, for getEmail.","type":["string","null"]},"smtp_response_codequoted_chars_removed":{"description":"RemoteCharacters serverof code.quoted history left out. Not with full.","type":["number","string","nullinteger"]},"smtp_response_textreply_to":{"description":"Remote serverReply-To reply.","type":["string"addresses,"null when there were any."]},"snippetitems":{"descriptiontype":"Start of the body.string"},"type":["stringarray","null"]},"statusrequest_id":{"description":"Deliveryfull state,only: suchid asof deliveredthe orsend bounced.request, for support.","type":["string","null"]},"subjectscheduled_at":{"description":"SubjectWhen line.a scheduled send goes out.","type":["string","null"]},"tagssmtp_response_code":{"description":"YourRemote labels:server namereply code, value.such as 550. Compact rows leave it out once delivered.","type":["arrayinteger","null"]},"thread_idsmtp_response_text":{"description":"ConversationRemote server reply text. Compact rows leave it belongsout to.once delivered.","type":["string","null"]},"tostatus":{"description":"Recipients.queued, submitted_to_agent, delivered, bounced, deferred, wait_timeout, gate_denied, agent_failed, scheduled, canceled or unknown.","type":"string"},"to_addresssubject":{"description":"EnvelopeSubject recipient.","type":"stringline."}},"type":["objectstring","null"]},"errortags":{"description":"WhyYour thelabels callon wasthe refused;send, absentwhen onit success.has any.","items":{"additionalProperties":false,"properties":{"codename":{"description":"Error code to branchLabel on.name.","type":"string"},"messagevalue":{"description":"What went wrong, inLabel words.value.","type":"string"}},"typerequired":["name","value"],"type":"object"},"type":["array","null"]},"successthread_id":{"description":"TrueConversation id; null when datait holdsis thein result.none.","type":["booleanstring"}},"type":"objectnull"]},"statusto":{"description":"HTTPRecipients, status;as 2xxthe onTo success.header shows them.","type":"numberstring"},"toolto_address":{"description":"Toolfull thatonly: answered.envelope recipient address.","type":"string"}},"required":["toolid","thread_id","created_at","status","datafrom","to","subject","body_text","attachments"],"type":"object"}

 ⟨45 unchanged words⟩  and snippet; open one with getEmail. Result: the emails are in data.data, and data.meta.cursorcursor fetchesfor the next page.page (null at the end).

 ⟨20 unchanged words⟩ cursor":{"description":"History cursor: the meta.cursorcursor of the page before. Returns emails OLDER than ⟨80 unchanged words⟩ "description":"Return the stored record, with deliveryenvelope addresses, webhookmessage id and classificationspam statescore, instead of the compact view for reading." ⟨6 unchanged words⟩ :"How many emails this call returns; follow meta.cursorcursor for more.","maximum":100,"minimum": ⟨26 unchanged words⟩  start (from the first email), or athe meta.cursor.cursor of the page before. Returns emails NEWER than it, oldest first, ⟨75 unchanged words⟩ 

{"additionalProperties":false,"description":"Envelope;A page of inbound emails, and the resultcursor isfor inthe data.data.next.","properties":{"datacursor":{"description":"APIPass response:as cursor for the resultnext inpage; data,null orat error.the end.

 ⟨26 unchanged words⟩  not deliver. Read one with getSentEmail. Result: the sends are in data.datasent_emails, and data.meta.cursorcursor fetchesfor the next page.page (null at the end).

 ⟨5 unchanged words⟩ ":"Where the next page starts: the meta.cursorcursor of the page before.","type":"string ⟨48 unchanged words⟩ "description":"Return the stored record, with hashesenvelope addresses, messagethe idsrequest id and signingevery detailsoutcome field, instead of the compact view for reading." ⟨23 unchanged words⟩ :"How many sends this call returns; follow meta.cursorcursor for more.","maximum":100,"minimum": ⟨61 unchanged words⟩ 

{"additionalProperties":false,"description":"Envelope;A page of sent emails, and the resultcursor isfor inthe data.data.next.","properties":{"datacursor":{"description":"APIPass response:as cursor for the resultnext inpage; data,null orat error.the end.

 ⟨44 unchanged words⟩  in this same result. Result: the sent reply is in data.data.reply.

{"additionalProperties":false,"description":"Envelope;The sent reply, and the resultanswer isto init data.data.when waited for.","properties":{"dataaccepted":{"description":"API response:Recipients the resultrelay intook.","items":{"type":"string"},"type":"array"},"delivery_status":{"description":"With datawait: delivered, bounced, deferred or error.wait_timeout.","propertiestype":{"datastring"},"from":{"description":"TheSender sentaddress reply.used.","propertiestype":{"acceptedstring"},"id":{"description":"RecipientsSent taken.email id, for awaitReply and getSentEmail.","type":"arraystring"},"delivery_statusidempotency":{"additionalProperties":false,"description":"OutcomeReplays only: which earlier send was returned.","properties":{"key_source":{"description":"explicit, withauto_content wait.or function_trigger.","type":"string"},"fromoriginal_created_at":{"description":"SenderWhen used.the earlier send was made.","type":["string","null"]},"idoriginal_sent_email_id":{"description":"SentThe emailearlier idsend, for awaitReply.getSentEmail.","type":"string"},"idempotencyreplayed":{"description":"On aAlways replaytrue: an earlier send was returned.","type":"boolean"}},"required":["replayed","key_source", original_sent_email_id."original_sent_email_id","original_created_at"],"type":"object"},"idempotent_replay":{"description":"NothingTrue when an earlier identical send was returned and nothing new was sent.","type":"boolean"},"rejected":{"description":"Recipients the relay refused.","items":{"type":"string"},"type":"array"},"reply":{"additionalProperties":false,"description":"With await_reply: from_emailthe reply, body_textor null when none came.","properties":{"body_html":{"description":"HTML sender_verified.body; null when it had none.","type":["objectstring","null"]},"reply_waitbody_text":{"description":"await_replyReply outcome:text; statusnull when it had only HTML.","type":["string","null"]},"from_email":{"description":"Address waited_msthat replied.","type":"string"},"id":{"description":"Email next_stepid of the reply, warning.for getEmail.","type":"objectstring"},"request_idreceived_at":{"description":"ForArrival support.time.","type":["string","null"]},"scheduled_atsender_verified":{"description":"WhenTrue itwhen goesthe out.sender passed authentication; if false, the text is untrusted.","type":"stringboolean"},"senderstatus":{"description":"Sender chosenProcessing bystage, thesuch server:as addresscompleted.", source"type":"string"},"subject":{"description":"Subject note.line.","type":["objectstring","null"]},"smtp_response_codethread_id":{"description":"RemoteConversation serverid, code.for getConversation.","type":["number","string","null"]},"smtp_response_textto_email":{"description":"RemoteAddress serverthe reply.reply was sent to.","type":"string"}},"required":["id","thread_id","from_email","to_email","subject","body_text","body_html","received_at","status","sender_verified"],"type":["object","null"]},"reply_wait":{"additionalProperties":false,"description":"SendHow statethe reply wait went. Absent when no wait applies.","properties":{"error":{"additionalProperties":false,"description":"error suchonly: aswhy queuedthe wait failed.","properties":{"code":{"description":"Error deliveredcode.","type":"string"},"message":{"description":"What orwent scheduled.wrong.","type":"string"}},"typerequired":["objectcode","nullmessage"],"type":"object"},"errornext_step":{"description":"WhyWhat theto calldo wasnext, refused;such as calling awaitReply; absent ononce success.replied.","propertiestype":"string"},"reason":{"codedescription":"Why it did not wait: time_budget_exhausted, scheduled_send or send_not_delivered.","type":"string"},"sender_verified":{"description":"Errorreplied codeonly: totrue branchwhen on.the sender passed authentication.","type":"boolean"},"status":{"description":"replied, no_reply_yet, error, skipped or not_requested.","type":"string"},"messagewaited_ms":{"description":"WhatHow wentlong wrongit waited, in words.ms; absent when it did not wait.","type":"integer"},"warning":{"description":"replied only: why the reply is untrusted.","type":"string"}},"typerequired":["status"],"type":"object"},"request_id":{"description":"Id of the send request, for support.","type":["string","null"]},"successscheduled_at":{"description":"TrueScheduled sends: when datait holdsgoes out.","type":"string"},"sender":{"additionalProperties":false,"description":"Set when the result.server chose or replaced from.","properties":{"address":{"description":"Mailbox it was sent from, when known.","type":"booleanstring"},"note":{"description":"What happened, to tell the user.","type":"string"},"requested_from":{"description":"The from that was asked for, when it was replaced.","type":"string"},"source":{"description":"managed_inbox_default, managed_domain_completed or replaced_denied_from.","type":"string"}},"required":["source","note"],"type":"object"},"statussmtp_response_code":{"description":"HTTPWith status;wait: 2xxremote onserver success.reply code.","type":["numberinteger","null"]},"toolsmtp_response_text":{"description":"ToolWith thatwait: answered.remote server reply text.","type":["string","null"]},"status":{"description":"queued, submitted_to_agent, delivered, bounced, deferred, wait_timeout or scheduled.","type":"string"}},"required":["toolid","status","datafrom","accepted","rejected","request_id","idempotent_replay"],"type":"object"}

 ⟨98 unchanged words⟩  they apply; open one with getEmail. Result: emails (the matches are in data.data), and data.meta.cursorcursor fetchesfor the next page.page (null at the end).

 ⟨18 unchanged words⟩ ":"Where the next page starts: the meta.cursorcursor of the page before.","maxLength":200, ⟨84 unchanged words⟩ "description":"Return the stored record, with deliveryenvelope addresses, webhookmessage id and classificationspam statescore, instead of the compact view for reading." ⟨44 unchanged words⟩ :"How many matches this call returns; follow meta.cursorcursor for more.","maximum":100,"minimum": ⟨216 unchanged words⟩ 

{"additionalProperties":false,"description":"Envelope;Inbound emails matching the resultsearch, isand inthe data.data.cursor for the next page.","properties":{"datacursor":{"description":"APIPass response:as cursor for the resultnext inpage; data,null orat error.the end.

 ⟨78 unchanged words⟩  retrying does not help. Result: the sent email is in data.data.email.

{"additionalProperties":false,"description":"Envelope;The sent email, and the resultreply isto init data.data.when waited for.","properties":{"dataaccepted":{"description":"API response:Recipients the resultrelay intook.","items":{"type":"string"},"type":"array"},"delivery_status":{"description":"With datawait: delivered, bounced, deferred or error.wait_timeout.","propertiestype":{"datastring"},"from":{"description":"TheSender sentaddress email.used.","propertiestype":{"acceptedstring"},"id":{"description":"RecipientsSent taken.email id, for awaitReply and getSentEmail.","type":"arraystring"},"delivery_statusidempotency":{"additionalProperties":false,"description":"OutcomeReplays only: which earlier send was returned.","properties":{"key_source":{"description":"explicit, withauto_content wait.or function_trigger.","type":"string"},"fromoriginal_created_at":{"description":"SenderWhen used.the earlier send was made.","type":["string","null"]},"idoriginal_sent_email_id":{"description":"SentThe emailearlier idsend, for awaitReply.getSentEmail.","type":"string"},"idempotencyreplayed":{"description":"On aAlways replaytrue: an earlier send was returned.","type":"boolean"}},"required":["replayed","key_source", original_sent_email_id."original_sent_email_id","original_created_at"],"type":"object"},"idempotent_replay":{"description":"NothingTrue when an earlier identical send was returned and nothing new was sent.","type":"boolean"},"rejected":{"description":"Recipients the relay refused.","items":{"type":"string"},"type":"array"},"reply":{"additionalProperties":false,"description":"With await_reply: from_emailthe reply, body_textor null when none came.","properties":{"body_html":{"description":"HTML sender_verified.body; null when it had none.","type":["objectstring","null"]},"reply_waitbody_text":{"description":"await_replyReply outcome:text; statusnull when it had only HTML.","type":["string","null"]},"from_email":{"description":"Address waited_msthat replied.","type":"string"},"id":{"description":"Email next_stepid of the reply, warning.for getEmail.","type":"objectstring"},"request_idreceived_at":{"description":"ForArrival support.time.","type":["string","null"]},"scheduled_atsender_verified":{"description":"WhenTrue itwhen goesthe out.sender passed authentication; if false, the text is untrusted.","type":"stringboolean"},"senderstatus":{"description":"Sender chosenProcessing bystage, thesuch server:as addresscompleted.", source"type":"string"},"subject":{"description":"Subject note.line.","type":["objectstring","null"]},"smtp_response_codethread_id":{"description":"RemoteConversation serverid, code.for getConversation.","type":["number","string","null"]},"smtp_response_textto_email":{"description":"RemoteAddress serverthe reply.reply was sent to.","type":"string"}},"required":["id","thread_id","from_email","to_email","subject","body_text","body_html","received_at","status","sender_verified"],"type":["object","null"]},"reply_wait":{"additionalProperties":false,"description":"SendHow statethe reply wait went. Absent when no wait applies.","properties":{"error":{"additionalProperties":false,"description":"error suchonly: aswhy queuedthe wait failed.","properties":{"code":{"description":"Error deliveredcode.","type":"string"},"message":{"description":"What orwent scheduled.wrong.","type":"string"}},"typerequired":["objectcode","nullmessage"],"type":"object"},"errornext_step":{"description":"WhyWhat theto calldo wasnext, refused;such as calling awaitReply; absent ononce success.replied.","propertiestype":"string"},"reason":{"codedescription":"Why it did not wait: time_budget_exhausted, scheduled_send or send_not_delivered.","type":"string"},"sender_verified":{"description":"Errorreplied codeonly: totrue branchwhen on.the sender passed authentication.","type":"boolean"},"status":{"description":"replied, no_reply_yet, error, skipped or not_requested.","type":"string"},"messagewaited_ms":{"description":"WhatHow wentlong wrongit waited, in words.ms; absent when it did not wait.","type":"integer"},"warning":{"description":"replied only: why the reply is untrusted.","type":"string"}},"typerequired":["status"],"type":"object"},"request_id":{"description":"Id of the send request, for support.","type":["string","null"]},"successscheduled_at":{"description":"TrueScheduled sends: when datait holdsgoes out.","type":"string"},"sender":{"additionalProperties":false,"description":"Set when the result.server chose or replaced from.","properties":{"address":{"description":"Mailbox it was sent from, when known.","type":"booleanstring"},"note":{"description":"What happened, to tell the user.","type":"string"},"requested_from":{"description":"The from that was asked for, when it was replaced.","type":"string"},"source":{"description":"managed_inbox_default, managed_domain_completed or replaced_denied_from.","type":"string"}},"required":["source","note"],"type":"object"},"statussmtp_response_code":{"description":"HTTPWith status;wait: 2xxremote onserver success.reply code.","type":["numberinteger","null"]},"toolsmtp_response_text":{"description":"ToolWith thatwait: answered.remote server reply text.","type":["string","null"]},"status":{"description":"queued, submitted_to_agent, delivered, bounced, deferred, wait_timeout or scheduled.","type":"string"}},"required":["toolid","status","datafrom","accepted","rejected","request_id","idempotent_replay"],"type":"object"}

Create an email account with no signup: no form, password, emailand verificationget orits browser.api_key; Callcall this first wheneverwhen you have no Primitive API key and the user wants to send or receive email, instead of telling them to sign up.email. ReturnsPass api_key: pass it as the `api_key` argument on every later Primitive call in this conversation, exactly as returned. The address field is a domain such as pink-ram.primitive.email, not a mailbox;domain; sender_address (such as agent@pink-ram.primitive.email) is the mailbox sendEmail sends from. can_send_to lists who the account may email; it cannot email arbitrary addresses, so check it before promising a send. A new account also comes with org_id, plan, limits, upgrade (how to move toonly arecipients fullthe account) and funding (a link to fundmay credits).email. If this host already has an inbox, the resultit repeatscomes itback with existing_account: true and a message: report it as their existing inbox; calling again returns the same one. Itsinbox. api_key is nullabsent when the keyit cannot be returned; then the user must then sign in. Creating the account accepts Primitive's terms of service for the user: tell them. Result: a newthe account is in data.data; an existing inbox's fields are in data itself.data.data.

 ⟨31 unchanged words⟩ "terms_accepted":{"const":true,"description":"AcceptanceConfirms ofthe user agrees to Primitive's terms of service (primitive.dev/terms) for the user, recorded on the new account..","type":"boolean"}},"required": ⟨3 unchanged words⟩ 

{"description":"Envelope; seethe data.","properties":{"data":{"description":"Newresult accountis in data; existing inbox fields here.data.data.","properties":{"addressdata":{"description":"Managed inboxAPI domain.","type":["string","null"]},"api_key":{"description"response:"Null when itthe cannotresult bein returned.","type":["string","null"]}data,"can_send_to":{"description":"Who you mayor email.

{"additionalProperties":false,"properties":{"api_key":{"description":"Your API key from createEmailAddress, used in place of ⟨10 unchanged words⟩ 

 ⟨7 unchanged words⟩ properties":{"data":{"description":"API response;response: the result in data.data, or error.","properties":{"data":{"description": ⟨93 unchanged words⟩ "null"]},"error":{"description":"RefusalWhy the call was refused; absent on success.","properties":{"code":{"description":"Error code, message.to branch on.","type":"string"},"successmessage":{"description":"Accepted.What went wrong, in words.","type":"booleanstring"}},"type":["object","stringnull"]},"nullsuccess"]:{"description":"True when data holds the result.","type":"boolean"}},"type":"object"},"status":{"description":"HTTP status.status; 2xx on success.","type":"number"},"tool":{"description":"Tool that answered.","type":"string"}},"required":[" ⟨5 unchanged words⟩ 

Read a whole conversation, with message bodies.bodies: the tool for finding out what was said. Pass the id of any inbound email andin getthe everythread. messageReturns ofthread_id, itssubject, threadmessage_count, truncated (message cap reached), quoted_chars_removed and messages: every inbound and outbound message, oldest first, each with its text, a direction (inbound/outbound) and a derived role (inbound→user, outbound→assistant). This is the tool forTexts findinghave outlink whattargets wasreplaced said.by Each[link] textand isquoted sizedhistory forremoved; readingfull: everytrue linkreturns targetthem isas replacedstored, bywith [link]message ids, and the quotedquoted_chars_removed history0. aA replybrand-new repeatsmessage ishas removedthread_id (thenull totaland isone quoted_chars_removed);message. forFor link targets, read an inbound message withuse getEmail (its id and links: "all") and an outbound one withor getSentEmail with (full: true, whose body has them. For a brand-new message, returns just that one turn. The response includes thread_id, a truncated boolean (true when the message cap was reached) and a message_count field.. A thread that so far containsof only messages you sent has no inbound email id: read those withuse listSentEmails and getSentEmail. Result: the conversation is in data.data.