Scenario Evaluation Config

List all scenario evaluation configuration entries

{
  "data": [
    {
      "id": "cfg_01HCFG001",
      "scenario_type": "inactivity",
      "org_id": null,
      "inactivity_threshold_days": 7,
      "cooldown_days": 3,
      "enabled": true,
      "updated_at": "2026-01-15T00:00:00Z"
    },
    {
      "id": "cfg_01HCFG002",
      "scenario_type": "certification_expiry",
      "org_id": null,
      "lead_time_days": 30,
      "cooldown_days": 7,
      "enabled": true,
      "updated_at": "2026-01-15T00:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 9
  }
}

Get a specific scenario configuration entry

{
  "id": "cfg_01HCFG001",
  "scenario_type": "inactivity",
  "org_id": null,
  "inactivity_threshold_days": 7,
  "cooldown_days": 3,
  "enabled": true,
  "updated_at": "2026-01-15T00:00:00Z"
}

Create a new scenario evaluation configuration (e.g. org-level override)

{
  "scenario_type": "inactivity",
  "org_id": "org_oslo_01",
  "inactivity_threshold_days": 5,
  "cooldown_days": 2,
  "enabled": true
}

{
  "id": "cfg_01HCFG050",
  "scenario_type": "inactivity",
  "org_id": "org_oslo_01",
  "inactivity_threshold_days": 5,
  "cooldown_days": 2,
  "enabled": true,
  "updated_at": "2026-03-26T10:30:00Z"
}

Update a scenario evaluation configuration entry

{
  "inactivity_threshold_days": 10,
  "cooldown_days": 5
}

{
  "id": "cfg_01HCFG001",
  "scenario_type": "inactivity",
  "org_id": null,
  "inactivity_threshold_days": 10,
  "cooldown_days": 5,
  "enabled": true,
  "updated_at": "2026-03-26T10:31:00Z"
}

Delete a scenario configuration entry

{
  "success": true,
  "deleted_id": "cfg_01HCFG050"
}

Get the inactivity threshold days for a specific scenario type

{
  "scenario_type": "inactivity",
  "org_id": "org_oslo_01",
  "inactivity_threshold_days": 5,
  "source": "org_override"
}

Get the cooldown period in days for a specific scenario type

{
  "scenario_type": "inactivity",
  "org_id": "org_oslo_01",
  "cooldown_days": 2,
  "source": "org_override"
}

Get all milestone thresholds and their trigger counts

{
  "milestone_thresholds": [
    {
      "milestone_type": "first_session_completed",
      "trigger_count": 1,
      "notification_enabled": true
    },
    {
      "milestone_type": "sessions_5_completed",
      "trigger_count": 5,
      "notification_enabled": true
    },
    {
      "milestone_type": "sessions_10_completed",
      "trigger_count": 10,
      "notification_enabled": false
    }
  ]
}

Check whether a scenario type is enabled for a given org

{
  "scenario_type": "inactivity",
  "org_id": "org_oslo_01",
  "enabled": true,
  "source": "org_override"
}

{
  "contract_summary": {
    "total_contracts": 410,
    "total_endpoints": 2416,
    "api_styles_used": [
      "rest"
    ]
  },
  "generated_at": "2026-03-26T06:55:53.316Z"
}