REST API

Full HTTP API for emails, threads, agents, calendar, scheduled emails, storage, 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

Emails

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

Threads

GET/emails/threadsList email threads

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

Search

POST/searchSemantic search across emails and attachments

Agents

GET/agentsGet your agent info

GET/agents/{id}Get agent details

PATCH/agents/{id}Update agent

Storage

GET/store/collectionsList all collections

POST/store/collectionsCreate a collection

DELETE/store/collections/{name}Delete collection and all documents

GET/store/{collection}/documentsList documents (with metadata filter, pagination)

POST/store/{collection}/documentsCreate document (auto-creates collection)

GET/store/{collection}/documents/{id}Get document by ID

PUT/store/{collection}/documents/{id}Replace document data

PATCH/store/{collection}/documents/{id}Partial merge update

DELETE/store/{collection}/documents/{id}Delete document

POST/store/searchSemantic search across documents

POST/store/askAsk AI (RAG) — answer with citations

Documents are JSON objects stored in named collections. Each document is automatically embedded for semantic search. The /ask endpoint retrieves relevant docs and generates an AI answer with source citations.

Calendar

GET/calendar/eventsList calendar events with date/status filters

POST/calendar/eventsCreate a calendar event

GET/calendar/events/{id}Get calendar event details

PATCH/calendar/events/{id}Update calendar event

DELETE/calendar/events/{id}Delete calendar event

POST/calendar/events/searchSemantic search across events

Scheduled Emails

GET/calendar/scheduled-emailsList scheduled emails

POST/calendar/scheduled-emailsSchedule an email for future delivery

GET/calendar/scheduled-emails/{id}Get scheduled email details

DELETE/calendar/scheduled-emails/{id}Cancel a pending scheduled email

Event Hooks (Webhooks)

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

Trusted Senders

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.

Code Examples Examples