---
title: "Export derived assistant data"
method: GET
path: "/api/assistant/data"
tags: ["Mailzero Assistant"]
---

# Export derived assistant data

`GET /api/assistant/data`

## Request

- Base URL: `https://domani.run`
- URL: `https://domani.run/api/assistant/data`
- Auth: HTTP bearer

Exports analyses, accepted claims, Decisions, interactions, receipts, and model usage as a JSON attachment. It never includes source email bodies or attachment bytes. Requires the assistant:write scope. It also needs `email:auth_secrets` (403 INSUFFICIENT_SCOPE otherwise): the derived state can hold what the assistant drew from authentication mail before such mail was kept out of it.

## Response `200`

JSON export of derived assistant state

- object
  - `format` 'mailzero-derived-export.v1'
  - `exported_at` string
  - `note` string

## Other responses

- `401`: Missing or invalid API key
- `403`: Exporting needs the assistant:write and email:auth_secrets scopes (INSUFFICIENT_SCOPE)
- `429`: Rate limit exceeded - wait and retry

---

[API](https://skmtc.dev/domani/apis/domani-run-api.md) · [All operations](https://skmtc.dev/domani/apis/domani-run-api/llms.txt) · [OpenAPI document](https://skmtc.dev/domani/apis/domani-run-api/revisions/7679f8159533?raw)