Settings API

Manage system settings and configuration

All settings endpoints require admin role. Unauthorized users will receive a 403 Forbidden response.

Overview

The Settings API allows administrators to view and modify Mission Control’s system configuration including retention policies, gateway settings, and feature toggles.

Settings are organized into categories:

• retention: Data retention periods for activities, logs, and other records
• gateway: Gateway connection configuration
• general: System-wide settings including backups and cleanup

Get All Settings

cURL

curl -X GET https://your-domain.com/api/settings \
  -H "Cookie: mc-session=YOUR_SESSION_TOKEN"

Response

settings · array

Array of all setting objects

key · string · required

Setting key (e.g., retention.activities_days)

value · string · required

Current value

description · string

Human-readable description

category · string · required

Setting category (retention, gateway, general)

updated_by · string

Username of last modifier

updated_at · integer

Unix timestamp of last update

is_default · boolean · required

Whether this setting is at its default value

grouped · object

Settings organized by category for easier navigation

Available Settings

Retention Settings

• retention.activities_days - Days to keep activity records (default: 90)
• retention.audit_log_days - Days to keep audit log entries (default: 180)
• retention.logs_days - Days to keep log files (default: 30)
• retention.notifications_days - Days to keep notifications (default: 30)
• retention.pipeline_runs_days - Days to keep pipeline run history (default: 90)
• retention.token_usage_days - Days to keep token usage data (default: 90)

Gateway Settings

• gateway.host - Gateway hostname
• gateway.port - Gateway port number

General Settings

• general.site_name - Mission Control display name (default: “Mission Control”)
• general.auto_cleanup - Enable automatic data cleanup (default: false)
• general.auto_backup - Enable automatic daily backups (default: false)
• general.backup_retention_count - Number of backup files to keep (default: 10)

Update Settings

cURL

curl -X PUT https://your-domain.com/api/settings \
  -H "Cookie: mc-session=YOUR_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "settings": {
      "retention.activities_days": "60",
      "general.auto_backup": "true",
      "general.backup_retention_count": "15"
    }
  }'

Request Body

settings · object · required

Map of setting keys to new values. All values should be strings.

Response

updated · array

Array of setting keys that were updated

count · integer

Number of settings updated

Changes are logged to the audit trail with before/after values.

Reset Setting to Default

Delete a custom setting value to restore its default.

cURL

curl -X DELETE https://your-domain.com/api/settings \
  -H "Cookie: mc-session=YOUR_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"key": "retention.activities_days"}'

Request Body

key · string · required

Setting key to reset (e.g., retention.activities_days)

Response

reset · string

The key that was reset

default_value · string

The default value that will now be used

Error Responses

401 Unauthorized

User is not authenticated. Check session cookie.

403 Forbidden

User does not have admin role. Only admins can manage settings.

404 Not Found

Setting not found (DELETE only)

429 Too Many Requests

Rate limit exceeded. Wait before retrying.