API ยท Settings

API overview

GET/api/settings

Requires Bearer token + settings permission.

Return the full site settings object from config/site.json.

// Response 200
{ "siteName": "My Site", "adminTheme": "charcoal-dark", "smtp": { ... }, ... }

PUT/api/settings

Requires Bearer token + settings permission.

Replace the site settings object. Send the full merged object - partial updates overwrite the entire config.

// Request body - full site settings object
{ "siteName": "My Site", "adminTheme": "ocean-dark", ... }

// Response 200
{ "success": true }

POST/api/settings/test-email

Requires Bearer token + settings permission.

Send a test email using the stored SMTP configuration.

Field Type Description
to string Optional. Recipient address. Defaults to the configured From Address. 
// Response 200
{ "success": true, "message": "Test email sent to alice@example.com" }

// Error 400
{ "error": "SMTP is not configured. Save your SMTP settings first." }

GET/api/settings/custom-css

Requires Bearer token + settings permission.

Return the current custom CSS from content/custom.css.

// Response 200
{ "css": "body { font-family: sans-serif; }" }

PUT/api/settings/custom-css

Requires Bearer token + settings permission.

Write CSS to content/custom.css. Maximum size is 100 KB.

Field Type Description
css string CSS string (max 100 KB) 
// Response 200
{ "success": true }