Domani

Domani Mailzero Assistant API

The Mailzero Assistant API from Domani — 36 operation(s) for mailzero assistant.

GitHub OpenAPI

Operations 44

GET /api/assistant/rules List the standing delegations #
POST /api/assistant/rules Create a standing delegation #
PUT /api/assistant/rules/{id} Change a standing delegation #
DELETE /api/assistant/rules/{id} Delete a standing delegation #
POST /api/assistant/rules/test Try the standing delegations on sample facts #
POST /api/assistant/rules/{id}/check Try an effect against a standing delegation's level and grants #
GET /api/assistant/metrics Read the task metrics #
GET /api/assistant/approvals List the approvals queue #
GET /api/assistant/suggestions List the delegation suggestions #
POST /api/assistant/suggestions/{id} Accept or dismiss a delegation suggestion #
GET /api/assistant/grants List the grants attached to assignees #
PUT /api/assistant/grants Set the grants of an assignee #
DELETE /api/assistant/grants/{type}/{ref} Remove the grants of an assignee #
GET /api/assistant/tasks/{id} Read a task envelope #
POST /api/assistant/tasks/{id}/lease Take or renew the lease on a task #
DELETE /api/assistant/tasks/{id}/lease Give the lease back #
POST /api/assistant/tasks/{id}/effects Ask for effects on a task #
POST /api/assistant/tasks/{id}/escalate Stop and ask the owner #
POST /api/assistant/tasks/{id}/report Report on a task #
GET /api/emails/{address}/messages/{id}/facts Read what the assistant established about a message #
POST /api/emails/{address}/messages/{id}/extract Extract the fields you need from a message with your own schema #
GET /api/assistant/settings Get Mailzero assistant settings #
PUT /api/assistant/settings Update Mailzero assistant settings #
POST /api/assistant/preview Consent to and start a background history import #
GET /api/assistant/backfill Get background history-import progress #
POST /api/assistant/backfill Retry failed history-import messages #
GET /api/assistant/today Get the grounded Today decision queue #
GET /api/assistant/work-items/{id} Get one assistant Work item and exact current plan #
GET /api/assistant/work-items/{id}/brief Read the situation brief of a Work item #
GET /api/assistant/brief Read the situation brief for a correspondent #
GET /api/assistant/work-items/{id}/facts Read the facts behind a Work item #
POST /api/assistant/work-items/{id}/open Mark a Work item as opened #
GET /api/assistant/learned What the assistant learned about you #
DELETE /api/assistant/learned/mutes Forget a mute #
DELETE /api/assistant/learned/tags Forget a tag #
GET /api/assistant/work-items/{id}/investigate Investigate a matter: what the registry and the links say #
GET /api/assistant/work-items/{id}/sender Who is behind a matter: the organisation, the people involved, the history #
POST /api/assistant/work-items/{id}/interactions Record a fenced human Decision #
GET /api/assistant/action-plans/{id} Get the exact action preview by opaque ID #
GET /api/assistant/activity Get content-minimized assistant Activity #
GET /api/assistant/data Export derived assistant data #
DELETE /api/assistant/data Delete assistant-derived data #
POST /api/assistant/devices Register a device for redacted Now alerts #
DELETE /api/assistant/devices Revoke a device registration #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/domani-run/openapi/domani-run-mailzero-assistant-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/domani-run/json-schema/domani-run-assistant-brief-schema.json
📊
JSONSchema
https://artifacts.apis.io/domani-run/json-schema/domani-run-assistant-work-item-schema.json
📊
JSONSchema
https://artifacts.apis.io/domani-run/json-schema/domani-run-domain-detail-schema.json
📊
JSONSchema
https://artifacts.apis.io/domani-run/json-schema/domani-run-search-result-schema.json
📊
JSONSchema
https://artifacts.apis.io/domani-run/json-schema/domani-run-mailbox-connection-schema.json
📊
JSONSchema
https://artifacts.apis.io/domani-run/json-schema/domani-run-account-info-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/domani-run:domani-run-mailzero-assistant-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

domani-run-mailzero-assistant-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: domani.run Mailzero Assistant API
  version: 1.0.0
  description: 'Domain infrastructure for AI agents. One API to search, register, and connect domain names.


    ## Authentication


    All authenticated endpoints require a Bearer token:


    ```

    Authorization: Bearer domani_sk_xxx

    ```


    Get your API key by registering:


    ```bash

    curl -X POST https://domani.run/api/auth/register \

    -H "Content-Type: application/json" \

    -d ''{"email": "you@example.com"}''

    ```


    ## Rate Limits


    Every response includes `X-RateLimit-Limit`, `X-RateLimit-Remaining`, and `X-RateLimit-Reset` headers. When rate limited (HTTP 429), check the `Retry-After` header for seconds to wait.


    ## Error Handling


    All errors return a consistent JSON envelope with `error`, `code`, `hint`, and `documentation_url` fields. Use the `code` field for programmatic handling and the `hint` field for recovery guidance.


    ## MCP Server


    A real-time MCP (Model Context Protocol) server is available at `POST /mcp` using Streamable HTTP transport. Connect any MCP-compatible agent (Claude Code, Cursor, etc.) with your Bearer token for typed tool access (search, buy, DNS, etc.).


    ## Pagination


    The `GET /api/tlds` endpoint supports `limit` and `offset` query parameters. When paginated, the response includes a `Link` header with `rel="next"` for the next page.'
  contact:
    name: domani.run
    url: https://domani.run
servers:
- url: https://domani.run
  description: Production
security:
- BearerAuth: []
tags:


# --- truncated at 32 KB (255 KB total) ---
# Full source: https://artifacts.apis.io/domani-run/openapi/domani-run-mailzero-assistant-api-openapi.yml