API Reference

Authentication

All API endpoints require authentication via Bearer token.

curl -H "Authorization: Bearer <token>" \
     https://api.zenlym.com/v1/emails

Endpoints

List Emails

GET /api/v1/emails

Query Parameters:

Parameter	Type	Description
page	integer	Page number (default: 1)
limit	integer	Items per page (default: 20)
category	string	Filter by category

Response:

{
  "data": [
    {
      "id": "uuid",
      "subject": "Meeting Tomorrow",
      "sender": "john@example.com",
      "category": "action_required",
      "received_at": "2024-01-15T10:30:00Z"
    }
  ],
  "meta": {
    "page": 1,
    "total": 150
  }
}

Get Email Detail

GET /api/v1/emails/:id

Classify Email

POST /api/v1/emails/:id/classify

Rate Limiting

API is limited to 100 requests per minute per user.