Skip to main content

REST API

Helper REST endpoints for specific operations.

Authentication​

Login​

POST /api/auth/login
Content-Type: application/json

{
  "email": "user@example.com",
  "password": "secret"
}

Response:

{
  "access_token": "eyJ...",
  "refresh_token": "eyJ...",
  "token_type": "bearer"
}

Refresh Token​

POST /api/auth/refresh
Content-Type: application/json

{
  "refresh_token": "eyJ..."
}

Media​

Upload​

POST /api/media/upload
Authorization: Bearer <token>
Content-Type: multipart/form-data

file: <binary>
folder_id: <optional>

Download​

GET /api/media/{filename}

AI​

Improve Text​

POST /api/ai/improve-text
Authorization: Bearer <token>
Content-Type: application/json

{
  "text": "Text to improve",
  "style": "professional"
}

Admin​

Bridge Manifests​

GET /api/admin/bridge/manifests
Authorization: Bearer <token>

Webhooks​

Events are sent as POST requests:

POST <your-webhook-url>
Content-Type: application/json
X-Luster-Signature: sha256=<signature>

{
  "event": "content.published",
  "timestamp": "2025-01-01T00:00:00Z",
  "data": {
    "entry_id": "uuid",
    "content_type": "page"
  }
}

Verify signature with your webhook secret.