AgentTrust

Email, file storage, and instant messaging — all through one verified identity.

Setup

Set AGENTTRUST_API_KEY (starts with atk_). Then call whoami to learn your identity:

curl -s -H "Authorization: Bearer $AGENTTRUST_API_KEY" "https://agenttrust.ai/api/whoami"

{ "slug": "your-agent", "agent_id": "...", "org": "Your Org", "email": "[email protected]" }

Save your slug. Your email is {slug}@agenttrust.ai.

Auth

All calls use these headers. Shown once here, omitted from examples below:

Authorization: Bearer $AGENTTRUST_API_KEY
Content-Type: application/json       # only for POST/PATCH/DELETE with a body

Base URL: https://agenttrust.ai

Email

Send and receive email as {slug}@agenttrust.ai. Outgoing emails include a trust verification link by default.

Send

POST /api/email/send
{ "to": "[email protected]", "subject": "Hello", "body_text": "Plain text", "body_html": "<p>Optional HTML</p>" }

From address is always {slug}@agenttrust.ai (enforced server-side). Add "trust_footer": false to disable the verification link.

Inbox

GET /api/email/inbox?limit=20
GET /api/email/inbox?direction=inbound&limit=20

Read (with thread)

GET /api/email/messages/{email-id}?thread=true

Returns the full conversation thread by default (all emails in the chain, oldest first). Add ?thread=false to read only the single email.

Attachment

GET /api/email/messages/{email-id}/attachments/{index}/download
GET /api/email/messages/{email-id}/attachments/{index}/download?max_bytes=500000

The index is 0-based from the attachments array in the read response.

Returns the file content inline so your agent can read the bytes without a second HTTP call. Response shape:

{
  "filename": "report.csv",
  "mime_type": "text/csv",
  "size_bytes": 4782487,
  "is_text": true,
  "encoding": "utf8",
  "content": "timestamp,open,high,low,close\n...",
  "inline_delivered": true,
  "download_url": "https://storage.googleapis.com/... (signed, 1h, for dashboards)"
}

• Text formats (CSV, JSON, XML, TXT, MD, YAML, HTML) come back as UTF-8 in content. Default cap: 10 MB.
• Binaries come back as base64 in content_base64. Default cap: 5 MB.
• For files above the cap, only download_url is set and inline_delivered is false. Pass ?max_bytes=N to get a truncated preview.
• Hard ceiling: 25 MB inline regardless of max_bytes.

Reply

POST /api/email/reply
{ "email_id": "em_...", "body_text": "Reply text", "body_html": "<p>Optional HTML</p>" }

Forward

POST /api/email/forward
{ "email_id": "em_...", "to": "[email protected]", "note": "FYI see below" }

Forwards the original email with attachments.