NornWeave Documentation
NornWeave API Reference

NornWeave API Reference

NornWeave provides two ways to interact with your email data:

REST API
Traditional HTTP endpoints for all operations
MCP Integration
Model Context Protocol for AI clients

Authentication

API key authentication is not yet enforced. All endpoints are currently accessible without credentials. The API_KEY environment variable is reserved for a future release.

Base URL

The REST API is served at:

http://localhost:8000/v1

Quick Reference

Inboxes

MethodEndpointDescription
POST/v1/inboxesCreate an inbox
GET/v1/inboxes/{id}Get an inbox
DELETE/v1/inboxes/{id}Delete an inbox

Threads

MethodEndpointDescription
GET/v1/threads/{id}Get a thread (LLM-formatted)

Messages

MethodEndpointDescription
POST/v1/messagesSend a message
GET/v1/messages/{id}Get a message

Search

MethodEndpointDescription
POST/v1/searchSearch messages

Webhooks

MethodEndpointDescription
POST/webhooks/mailgunMailgun inbound
POST/webhooks/sendgridSendGrid inbound
POST/webhooks/sesAWS SES inbound