Alpha APIActions

Send Email

View as Markdown

Send an e-mail from the vault agent’s mailbox to a VAULT MEMBER or registered stakeholder. Can carry files: pass artifact ids from find_artifact. Can also reply INSIDE an existing thread, or be left as a draft in the connected Gmail account for a person to review and send. Requires a manager API key.

Authentication

AuthorizationBearer
Create a personal key in Alpha settings, or use an access token issued to an approved OAuth client.

Request

This endpoint expects an object.
tostringRequired

Recipient (must belong to this vault)

subjectstringRequired
bodystringRequired

Plain-text body

vaultstringOptional

Exact vault id or name from list_vaults. Required whenever the key can reach more than one vault; never guess or use one client’s vault for another.

cclist of stringsOptional

Copied recipients, subject to the same vault check as to

attachmentIdslist of stringsOptional

artifactId values from find_artifact. Files only, never URLs.

sendAsenumOptional

‘agent’ (default) sends from the vault agent’s address and takes several attachments; ‘me’ sends from the vault’s connected Gmail and takes one.

Allowed values:
replyToThreadIdstringOptional
Gmail thread id, to reply inside an existing conversation
inReplyToMessageIdstringOptional

Message-ID of an earlier agent e-mail, to thread the reply

asDraftbooleanOptional
Leave it in the connected Gmail's Drafts instead of sending. Nothing goes out.

Response headers

X-Request-IdstringOptional
Stable identifier for tracing this request in Alpha logs.

Response

Send Email completed.
datamap from strings to any or list of maps from strings to any
The result returned by the selected Alpha tool.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
429
Too Many Requests Error