Mailzero Assistant

Get the grounded Today decision queue

Returns the versioned Now, Needs you, Waiting, Upcoming, and recent Handled projections with as_of, lag, coverage, and warnings. Every item links to its source message; nothing here sends mail. Requires the assistant:read scope. Authentication mail (sign-in codes, password resets, magic links) never becomes a matter and never reaches a model. 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/today

Request

  • Base URL: https://domani.run
  • URL: https://domani.run/api/assistant/today
  • Auth: HTTP bearer

Query parameters

agentstring

Only one agent's view: the items of the mailboxes it operates and the items handed to it. A token bound to an agent identity always gets that agent's view; naming another agent answers 403 AGENT_SCOPE.

categorystring

Only one kind of matter (invoice, meeting_request, newsletter...); the response's categories field lists every kind in the view with its count. An unknown kind answers 400 INVALID_CATEGORY.

tagstring

Only the matters carrying this tag (one of the person's tags); the response's tags field lists every tag in the view with its count.

Response

Versioned Now, Needs you, Waiting, Upcoming, and Handled projections

type'today'
as_ofstring
projection_lag_msinteger
categorystring nullable

The kind of matter the view is narrowed to (the category query), or null for every kind.

categoriesobject

Every kind of matter in the view, before the filter, with how many items it holds.

tagstring nullable

The tag the view is narrowed to (the tag query), or null for every matter.

tagsobject

Every tag of the person in the view, before the filter, with how many matters carry it.

Changes

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