Send plain-text email
Enqueued: answers 202 with the execution receipt; poll action_executions.get for the outcome. idempotency_key is required: repeating the call with the same key and arguments answers the same execution.
Authorizations
Section titled “Authorizations ”Request Body required
Section titled “Request Body required ”object
Active connected Gmail mailbox with read and send grants.
New requires subject and forbids thread_id; reply requires thread_id and messages:read, forbids subject, and uses the authorised anchor.
Plain text, at most 65536 UTF-8 bytes. Exact bytes are preserved; no attachments.
Your key for this call: a repeat with the same key and arguments answers the same execution, and the same key with other arguments is 409 idempotency_key_reused. Unique per caller.
Responses
Section titled “ Responses ”Success
object
The enqueued operation this executes, for example messages.send.
Queued (waiting or between attempts), claimed (an attempt is running), done or failed.
The operation’s final arguments, fixed when it was authorised.
object
The approved action request this executes; null for a direct call.
The principal that asked: the proposer for an approved request, the caller for a direct call.
The principal whose authority it runs under: the approver, or the caller for a direct call.
The caller’s key of a direct call; null for an approved request.
What the operation produced; null until done.
Why it failed: reauth_required, permission_missing, anchor_missing, provider_rejected, outcome_unknown, attempts_exhausted or deadline_passed.
The vault’s sentence for the failure; never a provider’s own text.
When a never-attempted execution stops being attempted.
When it was executed: when it finished, done or failed; null while queued or claimed.
When it was queued: the moment it was authorised. For an approved action request that is the approval, equal to the request’s decided_at; for a direct call, the call.