Mailzero Assistant

Get one assistant Work item and exact current plan

Returns the grounded Work item, its open Decision and options, the exact current Action plan, open commitments and expectations, interactions, and receipts. Requires the assistant:read scope. A matter made from authentication mail before such mail was kept out of the assistant is shown with its title, summary, ask and plan effects withheld from a reader without email:auth_secrets.

get/api/assistant/work-items/{id}

Request

  • Base URL: https://domani.run
  • URL: https://domani.run/api/assistant/work-items/{id}
  • Auth: HTTP bearer

Path parameters

idstring required

Work item ID from the Today queue

Response

Grounded Work item, Decision, plan, open loops, and receipts

idstring
versioninteger
status'open' | 'needs_judgment' | 'snoozed' | 'waiting' | 'handled' | 'ignored'
titlestring
summarystring
askstring nullable

The single thing the owner must do or decide, or null.

category'invoice' | 'payment_notice' | 'payment_failure' | 'refund_request' | 'signature_request' | 'meeting_request' | 'calendar_change' | 'support_ticket' | 'partner_inquiry' | 'recurring_alert' | 'account_notice' | 'newsletter' | 'legal_notice' | 'internal_handover' | 'shipping_notice' | 'phishing' | 'other' nullable

The kind of matter the analysis found (an invoice, a meeting request, a newsletter...), or null when no analysis said. Rules match it as the label category:<kind>.

tagsstring[]

The person's tags on the matter (CT-01b): confirmed once or set by hand, each one a label on the thread at the provider. Rules match them as the label tag:<name>.

proposed_tagsstring[]

The tags the engine proposes for the matter (one per project it named), not yet confirmed. Confirm one with the tag interaction; it then applies to the next matter of the same project without a question.

suspectboolean

The trust signals found the sender suspect: the matter sits in the Suspect section, is never Now, carries no decision, and no effect runs on it until the person reports it legitimate.

suspect_reasonsstring[]

Why it looks suspect, one sentence per signal (a failed authentication, a diverging Reply-To, a lookalike domain, a borrowed name, a first contact about money, an instruction to the assistant, a secret asked by return mail).

opened_atstring nullable
delegated_tostring nullable

The slug of the agent the owner handed this item to, or null.

unreadboolean

True until the owner opens the item after its latest change.

evidence_refsstring[]
entity_refsstring[]
snoozed_untilstring nullable

Changes

No recorded changes to this operation across all 2 revisions of this API.