Email API Reference

Authorization: Bearer YOUR_API_KEY

GET /email/address

curl -X GET https://api.trixdb.com/v1/email/address \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "email": "[email protected]",
  "localPart": "abc12xyz",
  "domain": "mail.trixdb.com",
  "isActive": true,
  "createdAt": "2024-01-15T10:30:00Z"
}

POST /email/address

curl -X POST https://api.trixdb.com/v1/email/address \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"regenerate": false}'

POST /email/address/rotate

curl -X POST https://api.trixdb.com/v1/email/address/rotate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"gracePeriodDays": 30}'

{
  "id": "660e8400-e29b-41d4-a716-446655440001",
  "email": "[email protected]",
  "previousEmail": "[email protected]",
  "gracePeriodDays": 30,
  "createdAt": "2024-01-20T10:30:00Z"
}

GET /email/addresses

DELETE /email/address

GET /email/history?limit=20&offset=0&status=completed

GET /email/history/:id

{
  "id": "email-uuid-1",
  "sender": "[email protected]",
  "recipient": "[email protected]",
  "subject": "STORE: Meeting notes @work #meeting p1",
  "bodyPlain": "Discussed budget allocation...",
  "status": "completed",
  "parsedIntent": {
    "command": "store",
    "content": "Meeting notes",
    "metadata": {
      "space": "work",
      "tags": ["meeting"],
      "priority": 1
    },
    "method": "subject"
  },
  "responseMemoryId": "memory-uuid-1",
  "createdAt": "2024-01-15T10:30:00Z",
  "processedAt": "2024-01-15T10:30:02Z"
}

GET /email/senders?ruleType=block

POST /email/senders

curl -X POST https://api.trixdb.com/v1/email/senders \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "emailPattern": "*@spam.com",
    "ruleType": "block",
    "reason": "Known spam domain"
  }'

POST /email/senders/check

curl -X POST https://api.trixdb.com/v1/email/senders/check \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "[email protected]"}'

{
  "allowed": true,
  "reason": null,
  "matchedRule": null
}

DELETE /email/senders/:pattern

GET /email/reactions

POST /email/reactions

curl -X POST https://api.trixdb.com/v1/email/reactions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Important Meeting Alert",
    "triggerType": "memory_created",
    "triggerConditions": {
      "tags": ["important", "meeting"],
      "contentContains": "deadline"
    },
    "emailSubjectTemplate": "Alert: New Memory",
    "emailBodyTemplate": "A memory was created.",
    "cooldownMinutes": 60,
    "maxPerDay": 10
  }'

PATCH /email/reactions/:id

DELETE /email/reactions/:id

GET /email/digests

POST /email/digests

curl -X POST https://api.trixdb.com/v1/email/digests \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Weekly Summary",
    "scheduleType": "weekly",
    "timezone": "America/New_York",
    "includeNewMemories": true,
    "includeHighlights": true,
    "maxItems": 10,
    "tags": ["meeting"],
    "isActive": true
  }'

PATCH /email/digests/:id

DELETE /email/digests/:id

POST /email/digests/:id/send

GET /email/history/:id/attachments

GET /email/attachments/:id

GET /email/attachments/:id/download?expiresIn=3600

{
  "url": "https://s3.amazonaws.com/bucket/path?signature=...",
  "expiresIn": 3600
}

DELETE /email/attachments/:id

{
  "error": "not_found",
  "message": "Email address not found"
}