REST API

Full HTTP API for emails, threads, agents, search, and webhooks. All endpoints are scoped to the agent associated with your API key.

Base URL

https://api.xobni.ai/api/v1

Parameters like account_id and agent_id are auto-resolved from your API key scope — you don't need to pass them.

Endpoints

GET/emailsList emails with optional filters

GET/emails/{id}Get full email details

POST/emails/sendSend an email (with optional attachments)

PATCH/emails/{id}Update status or starred flag

GET/emails/attachments/{id}/urlGet pre-signed download URL

GET/emails/storage-usageGet mailbox storage usage

GET/emails/threadsList email threads

GET/emails/threads/{id}Get thread with all emails

POST/searchSemantic search across emails and attachments

GET/agentsGet your agent info

GET/agents/{id}Get agent details

PATCH/agents/{id}Update agent

GET/event-hooksList webhooks for your agent

POST/event-hooksCreate webhook (returns secret once)

GET/event-hooks/{id}Get webhook details

PATCH/event-hooks/{id}Update webhook URL, events, or status

DELETE/event-hooks/{id}Delete webhook

GET/event-hooks/{id}/deliveriesList delivery logs

POST/event-hooks/{id}/testSend a test event

GET/trusted-senders?agent_id=...List trusted senders

POST/trusted-sendersAdd a trusted sender

DELETE/trusted-senders/{id}Remove a trusted sender (400 if default)

All email responses include is_trusted_sender: true/false computed from this allowlist. The agent owner's email is always a default trusted sender.