API Reference
API Reference
NornWeave provides two ways to interact with your email data:
Authentication
All API requests require authentication using an API key in the Authorization header:
Authorization: Bearer YOUR_API_KEYBase URL
The REST API is served at:
http://localhost:8000/v1Quick Reference
Inboxes
| Method | Endpoint | Description |
|---|---|---|
POST | /v1/inboxes | Create an inbox |
GET | /v1/inboxes/{id} | Get an inbox |
DELETE | /v1/inboxes/{id} | Delete an inbox |
Threads
| Method | Endpoint | Description |
|---|---|---|
GET | /v1/threads/{id} | Get a thread (LLM-formatted) |
Messages
| Method | Endpoint | Description |
|---|---|---|
POST | /v1/messages | Send a message |
GET | /v1/messages/{id} | Get a message |
Search
| Method | Endpoint | Description |
|---|---|---|
POST | /v1/search | Search messages |
Webhooks
| Method | Endpoint | Description |
|---|---|---|
POST | /webhooks/mailgun | Mailgun inbound |
POST | /webhooks/sendgrid | SendGrid inbound |
POST | /webhooks/ses | AWS SES inbound |