Mailzero Assistant

Record a fenced human Decision

Choose an option, give an instruction, take over, snooze, ignore, correct, report the trust verdict (phishing or legitimate), or approve or reject a waiting plan (an approved plan executes at once, with its receipts in the answer). The call is fenced by work_item_version and replayed idempotently by idempotency_key. Choosing or instructing prepares an exact draft that still goes through the normal reply flow; this endpoint never sends mail. Requires the assistant:write scope.

post/api/assistant/work-items/{id}/interactions

Request

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

Path parameters

idstring required

Request body

scope'item' | 'sender' | 'sender_domain' | 'situation'

With type ignore: also mute the sender, its domain, or this recurring situation so it never comes back.

verdict'phishing' | 'legitimate'

With type report: the person's verdict on the trust signals. Phishing closes the matter, mutes the sender and closes its other live matters; legitimate clears the suspect verdict and its reasons.

plan_idstring

With type approve or reject: the waiting action plan (proposed or escalated).

reasonstring

With type reject: why, kept on the plan.

type'choose' | 'instruct' | 'take_over' | 'snooze' | 'ignore' | 'correct' | 'delegate' | 'approve' | 'reject' | 'report' | 'tag' required
addstring[]

With type tag: tags to put on the matter (a proposed one confirmed, or one by hand; lower case, letters, digits and hyphens). A tag added once is learned: the next matter of the same project gets it without a question.

removestring[]

With type tag: tags to take off the matter (a proposal named here is declined). The learned page forgets a tag for good.

agent_slugstring nullable

With type delegate: the slug of your agent to hand the item to, or null to take it back.

member_idstring nullable

With type delegate: the user id of a member of your workspace to hand the item to instead of an agent; they find it under handed_to_you in their Today and work it through the tasks endpoints under their own access.

work_item_versioninteger required
decision_idstring
decision_versioninteger
option_idstring
instructionstring
untilstring date-time
remind_atstring date-time
fieldstring
correctionstring
idempotency_keystring required

Response

Interaction recorded or idempotently replayed

okboolean
plan_idstring nullable

Changes

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