Message API

The Message API powers Zeq Message — end-to-end encrypted messaging with ZSP envelope wrapping on every message.

Endpoints

POST /api/message/send

Send an encrypted message to another ZID.

curl -X POST https://www.zeq.dev/api/message/send \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"to": "zid_recipient", "body": "Hello!", "conversationId": "conv_..."}'

Messages are automatically wrapped in a ZSP envelope before storage.

GET /api/message/conversations

List all conversations for the authenticated ZID.

GET /api/message/messages/:conversationId

Get messages in a conversation, newest last.

POST /api/message/conversations

Create a new conversation with one or more participants.

Real-Time Delivery

Messages are delivered in real-time via WebSocket. The WebSocket connection provides typing indicators, presence updates, and read receipts.

Encryption

Every message is wrapped in a ZSP triple-kernel envelope: K_spectral × K_temporal × K_chaos. Recipients decrypt using their ZID private key.

WebSocket API · Auth API · ZSP