diff --git a/samples/api-degradation-scenarios/.devproxy/devproxyrc.json b/samples/api-degradation-scenarios/.devproxy/devproxyrc.json
new file mode 100644
index 0000000..d25e46d
--- /dev/null
+++ b/samples/api-degradation-scenarios/.devproxy/devproxyrc.json
@@ -0,0 +1,56 @@
+{
+  "$schema": "https://raw.githubusercontent.com/dotnet/dev-proxy/main/schemas/v2.0.0/rc.schema.json",
+  "plugins": [
+    {
+      "name": "RetryAfterPlugin",
+      "enabled": true,
+      "pluginPath": "~appFolder/plugins/DevProxy.Plugins.dll"
+    },
+    {
+      "name": "LatencyPlugin",
+      "enabled": true,
+      "pluginPath": "~appFolder/plugins/DevProxy.Plugins.dll",
+      "configSection": "latencyPlugin"
+    },
+    {
+      "name": "RateLimitingPlugin",
+      "enabled": true,
+      "pluginPath": "~appFolder/plugins/DevProxy.Plugins.dll",
+      "configSection": "rateLimitingPlugin"
+    },
+    {
+      "name": "GenericRandomErrorPlugin",
+      "enabled": true,
+      "pluginPath": "~appFolder/plugins/DevProxy.Plugins.dll",
+      "configSection": "genericRandomErrorPlugin"
+    },
+    {
+      "name": "MockResponsePlugin",
+      "enabled": true,
+      "pluginPath": "~appFolder/plugins/DevProxy.Plugins.dll",
+      "configSection": "mockResponsePlugin"
+    }
+  ],
+  "urlsToWatch": [
+    "https://api.example.com/*"
+  ],
+  "latencyPlugin": {
+    "$schema": "https://raw.githubusercontent.com/dotnet/dev-proxy/main/schemas/v2.0.0/latencyplugin.schema.json",
+    "minMs": 3000,
+    "maxMs": 5000
+  },
+  "rateLimitingPlugin": {
+    "$schema": "https://raw.githubusercontent.com/dotnet/dev-proxy/main/schemas/v2.0.0/ratelimitingplugin.schema.json",
+    "costPerRequest": 1,
+    "rateLimit": 10
+  },
+  "genericRandomErrorPlugin": {
+    "$schema": "https://raw.githubusercontent.com/dotnet/dev-proxy/main/schemas/v2.0.0/genericrandomerrorplugin.schema.json",
+    "errorsFile": "errors-503.json",
+    "rate": 30
+  },
+  "mockResponsePlugin": {
+    "$schema": "https://raw.githubusercontent.com/dotnet/dev-proxy/main/schemas/v2.0.0/mockresponseplugin.schema.json",
+    "mocksFile": "mocks.json"
+  }
+}
diff --git a/samples/api-degradation-scenarios/.devproxy/errors-503.json b/samples/api-degradation-scenarios/.devproxy/errors-503.json
new file mode 100644
index 0000000..53ef564
--- /dev/null
+++ b/samples/api-degradation-scenarios/.devproxy/errors-503.json
@@ -0,0 +1,81 @@
+{
+  "$schema": "https://raw.githubusercontent.com/dotnet/dev-proxy/main/schemas/v2.0.0/genericrandomerrorplugin.errorsfile.schema.json",
+  "errors": [
+    {
+      "request": {
+        "url": "https://api.example.com/*"
+      },
+      "responses": [
+        {
+          "statusCode": 503,
+          "headers": [
+            {
+              "name": "Content-Type",
+              "value": "application/json"
+            },
+            {
+              "name": "Retry-After",
+              "value": "@dynamic"
+            },
+            {
+              "name": "Access-Control-Allow-Origin",
+              "value": "*"
+            }
+          ],
+          "body": {
+            "error": {
+              "code": "ServiceUnavailable",
+              "message": "Service is temporarily unavailable. Please retry later."
+            }
+          }
+        },
+        {
+          "statusCode": 503,
+          "headers": [
+            {
+              "name": "Content-Type",
+              "value": "application/json"
+            },
+            {
+              "name": "Retry-After",
+              "value": "@dynamic"
+            },
+            {
+              "name": "Access-Control-Allow-Origin",
+              "value": "*"
+            }
+          ],
+          "body": {
+            "error": {
+              "code": "ServerBusy",
+              "message": "The server is currently busy. Please try again in a few moments."
+            }
+          }
+        },
+        {
+          "statusCode": 503,
+          "headers": [
+            {
+              "name": "Content-Type",
+              "value": "application/json"
+            },
+            {
+              "name": "Retry-After",
+              "value": "@dynamic"
+            },
+            {
+              "name": "Access-Control-Allow-Origin",
+              "value": "*"
+            }
+          ],
+          "body": {
+            "error": {
+              "code": "CapacityExceeded",
+              "message": "Server capacity exceeded. Please wait before retrying."
+            }
+          }
+        }
+      ]
+    }
+  ]
+}
diff --git a/samples/api-degradation-scenarios/.devproxy/intermittent-errors.devproxyrc.json b/samples/api-degradation-scenarios/.devproxy/intermittent-errors.devproxyrc.json
new file mode 100644
index 0000000..dad5699
--- /dev/null
+++ b/samples/api-degradation-scenarios/.devproxy/intermittent-errors.devproxyrc.json
@@ -0,0 +1,34 @@
+{
+  "$schema": "https://raw.githubusercontent.com/dotnet/dev-proxy/main/schemas/v2.0.0/rc.schema.json",
+  "plugins": [
+    {
+      "name": "RetryAfterPlugin",
+      "enabled": true,
+      "pluginPath": "~appFolder/plugins/DevProxy.Plugins.dll"
+    },
+    {
+      "name": "GenericRandomErrorPlugin",
+      "enabled": true,
+      "pluginPath": "~appFolder/plugins/DevProxy.Plugins.dll",
+      "configSection": "genericRandomErrorPlugin"
+    },
+    {
+      "name": "MockResponsePlugin",
+      "enabled": true,
+      "pluginPath": "~appFolder/plugins/DevProxy.Plugins.dll",
+      "configSection": "mockResponsePlugin"
+    }
+  ],
+  "urlsToWatch": [
+    "https://api.example.com/*"
+  ],
+  "genericRandomErrorPlugin": {
+    "$schema": "https://raw.githubusercontent.com/dotnet/dev-proxy/main/schemas/v2.0.0/genericrandomerrorplugin.schema.json",
+    "errorsFile": "errors-503.json",
+    "rate": 30
+  },
+  "mockResponsePlugin": {
+    "$schema": "https://raw.githubusercontent.com/dotnet/dev-proxy/main/schemas/v2.0.0/mockresponseplugin.schema.json",
+    "mocksFile": "mocks.json"
+  }
+}
diff --git a/samples/api-degradation-scenarios/.devproxy/mocks.json b/samples/api-degradation-scenarios/.devproxy/mocks.json
new file mode 100644
index 0000000..70897cc
--- /dev/null
+++ b/samples/api-degradation-scenarios/.devproxy/mocks.json
@@ -0,0 +1,27 @@
+{
+  "$schema": "https://raw.githubusercontent.com/dotnet/dev-proxy/main/schemas/v2.0.0/mockresponseplugin.mocksfile.schema.json",
+  "mocks": [
+    {
+      "request": {
+        "url": "https://api.example.com/*"
+      },
+      "response": {
+        "statusCode": 200,
+        "headers": [
+          {
+            "name": "Content-Type",
+            "value": "application/json"
+          },
+          {
+            "name": "Access-Control-Allow-Origin",
+            "value": "*"
+          }
+        ],
+        "body": {
+          "status": "ok",
+          "message": "Request processed successfully"
+        }
+      }
+    }
+  ]
+}
diff --git a/samples/api-degradation-scenarios/.devproxy/rate-limiting.devproxyrc.json b/samples/api-degradation-scenarios/.devproxy/rate-limiting.devproxyrc.json
new file mode 100644
index 0000000..e718218
--- /dev/null
+++ b/samples/api-degradation-scenarios/.devproxy/rate-limiting.devproxyrc.json
@@ -0,0 +1,34 @@
+{
+  "$schema": "https://raw.githubusercontent.com/dotnet/dev-proxy/main/schemas/v2.0.0/rc.schema.json",
+  "plugins": [
+    {
+      "name": "RetryAfterPlugin",
+      "enabled": true,
+      "pluginPath": "~appFolder/plugins/DevProxy.Plugins.dll"
+    },
+    {
+      "name": "RateLimitingPlugin",
+      "enabled": true,
+      "pluginPath": "~appFolder/plugins/DevProxy.Plugins.dll",
+      "configSection": "rateLimitingPlugin"
+    },
+    {
+      "name": "MockResponsePlugin",
+      "enabled": true,
+      "pluginPath": "~appFolder/plugins/DevProxy.Plugins.dll",
+      "configSection": "mockResponsePlugin"
+    }
+  ],
+  "urlsToWatch": [
+    "https://api.example.com/*"
+  ],
+  "rateLimitingPlugin": {
+    "$schema": "https://raw.githubusercontent.com/dotnet/dev-proxy/main/schemas/v2.0.0/ratelimitingplugin.schema.json",
+    "costPerRequest": 1,
+    "rateLimit": 10
+  },
+  "mockResponsePlugin": {
+    "$schema": "https://raw.githubusercontent.com/dotnet/dev-proxy/main/schemas/v2.0.0/mockresponseplugin.schema.json",
+    "mocksFile": "mocks.json"
+  }
+}
diff --git a/samples/api-degradation-scenarios/.devproxy/slow-responses.devproxyrc.json b/samples/api-degradation-scenarios/.devproxy/slow-responses.devproxyrc.json
new file mode 100644
index 0000000..f8abb21
--- /dev/null
+++ b/samples/api-degradation-scenarios/.devproxy/slow-responses.devproxyrc.json
@@ -0,0 +1,29 @@
+{
+  "$schema": "https://raw.githubusercontent.com/dotnet/dev-proxy/main/schemas/v2.0.0/rc.schema.json",
+  "plugins": [
+    {
+      "name": "LatencyPlugin",
+      "enabled": true,
+      "pluginPath": "~appFolder/plugins/DevProxy.Plugins.dll",
+      "configSection": "latencyPlugin"
+    },
+    {
+      "name": "MockResponsePlugin",
+      "enabled": true,
+      "pluginPath": "~appFolder/plugins/DevProxy.Plugins.dll",
+      "configSection": "mockResponsePlugin"
+    }
+  ],
+  "urlsToWatch": [
+    "https://api.example.com/*"
+  ],
+  "latencyPlugin": {
+    "$schema": "https://raw.githubusercontent.com/dotnet/dev-proxy/main/schemas/v2.0.0/latencyplugin.schema.json",
+    "minMs": 3000,
+    "maxMs": 5000
+  },
+  "mockResponsePlugin": {
+    "$schema": "https://raw.githubusercontent.com/dotnet/dev-proxy/main/schemas/v2.0.0/mockresponseplugin.schema.json",
+    "mocksFile": "mocks.json"
+  }
+}
diff --git a/samples/api-degradation-scenarios/README.md b/samples/api-degradation-scenarios/README.md
new file mode 100644
index 0000000..e1a1420
--- /dev/null
+++ b/samples/api-degradation-scenarios/README.md
@@ -0,0 +1,132 @@
+# Simulate API degradation scenarios
+
+## Summary
+
+This sample demonstrates how to simulate various API degradation scenarios to test how your application handles partial failures, intermittent errors, rate limiting, and slow responses. Use these configurations to build apps that gracefully degrade under stress and verify that your error handling and retry logic works before production.
+
+![API Degradation Monitoring Dashboard](assets/screenshot.png)
+
+## Compatibility
+
+![Dev Proxy v2.0.0](https://aka.ms/devproxy/badge/v2.0.0)
+
+## Contributors
+
+- [Waldek Mastykarz](https://github.com/waldekmastykarz)
+
+## Version history
+
+Version|Date|Comments
+-------|----|--------
+1.0|January 18, 2026|Initial release
+
+## Prerequisites
+
+- [Node.js LTS](https://nodejs.org)
+
+## Minimal path to awesome
+
+- Clone this repository (or [download this solution as a .ZIP file](https://pnp.github.io/download-partial/?url=https://github.com/pnp/proxy-samples/tree/main/samples/api-degradation-scenarios) then unzip it)
+- Start the sample app and Dev Proxy by running `npm start`
+- In a web browser, navigate to `http://localhost:3000` and use the dashboard to test API degradation scenarios
+
+### Using the monitoring dashboard
+
+The included web app provides a real-time monitoring dashboard that shows:
+
+- **Total Requests** - Number of requests made
+- **Success Rate** - Percentage of successful requests
+- **Average Response Time** - Average response time across all requests
+- **Error counts** - Breakdown of 503 and 429 errors
+- **Response Distribution** - Visual bar chart of response types
+
+Use the dashboard buttons to:
+
+- **Send Single Request** - Make one API request
+- **Send Burst (10 requests)** - Make 10 concurrent requests to trigger rate limiting
+- **Start Auto Requests** - Continuously send requests every second
+- **Stop** - Stop auto requests
+- **Clear Stats** - Reset all statistics
+
+### Using Dev Proxy configurations directly
+
+You can also run Dev Proxy with specific configurations:
+
+### All degradation scenarios combined
+
+This configuration combines all three degradation scenarios: intermittent 503 errors (30% of requests), rate limiting (10 requests per minute), and slow responses (3-5 seconds latency).
+
+```bash
+devproxy
+```
+
+### Intermittent 503 errors only
+
+This configuration simulates random 503 Service Unavailable errors for 30% of requests.
+
+```bash
+devproxy --config-file .devproxy/intermittent-errors.devproxyrc.json
+```
+
+### Rate limiting only
+
+This configuration simulates hitting rate limits with 429 Too Many Requests responses after 10 requests per minute.
+
+```bash
+devproxy --config-file .devproxy/rate-limiting.devproxyrc.json
+```
+
+### Slow responses only
+
+This configuration adds random latency (3-5 seconds) to all responses.
+
+```bash
+devproxy --config-file .devproxy/slow-responses.devproxyrc.json
+```
+
+## Features
+
+This sample demonstrates how to use Dev Proxy to simulate API degradation scenarios. Using this sample you can:
+
+- Test your application's handling of intermittent 503 Service Unavailable errors
+- Verify retry logic and exponential backoff implementation
+- Test rate limit handling and proper use of Retry-After headers
+- Measure application performance under slow network conditions
+- Validate graceful degradation patterns in your application
+- Demonstrate that your error handling works before deploying to production
+
+### Configuration files
+
+| File | Description |
+|------|-------------|
+| `.devproxy/devproxyrc.json` | Combined configuration with all degradation scenarios |
+| `.devproxy/intermittent-errors.devproxyrc.json` | 503 errors at 30% failure rate |
+| `.devproxy/rate-limiting.devproxyrc.json` | Rate limiting at 10 requests/minute |
+| `.devproxy/slow-responses.devproxyrc.json` | Random latency between 3-5 seconds |
+| `.devproxy/errors-503.json` | Error responses for the GenericRandomErrorPlugin |
+| `.devproxy/mocks.json` | Mock responses for successful requests |
+| `index.html` | Monitoring dashboard web app |
+| `package.json` | Node.js configuration to run the sample |
+
+### Plugins used
+
+- **GenericRandomErrorPlugin** - Simulates random errors at a configurable rate
+- **LatencyPlugin** - Adds random delays to responses
+- **RateLimitingPlugin** - Simulates API rate limiting behavior
+- **RetryAfterPlugin** - Validates that clients respect Retry-After headers
+
+## Help
+
+We do not support samples, but this community is always willing to help, and we want to improve these samples. We use GitHub to track issues, which makes it easy for community members to volunteer their time and help resolve issues.
+
+You can try looking at [issues related to this sample](https://github.com/pnp/proxy-samples/issues?q=label%3A%22sample%3A%20api-degradation-scenarios%22) to see if anybody else is having the same issues.
+
+If you encounter any issues using this sample, [create a new issue](https://github.com/pnp/proxy-samples/issues/new).
+
+Finally, if you have an idea for improvement, [make a suggestion](https://github.com/pnp/proxy-samples/issues/new).
+
+## Disclaimer
+
+**THIS CODE IS PROVIDED *AS IS* WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING ANY IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, OR NON-INFRINGEMENT.**
+
+![](https://m365-visitor-stats.azurewebsites.net/SamplesGallery/pnp-devproxy-api-degradation-scenarios)
diff --git a/samples/api-degradation-scenarios/assets/sample.json b/samples/api-degradation-scenarios/assets/sample.json
new file mode 100644
index 0000000..173d994
--- /dev/null
+++ b/samples/api-degradation-scenarios/assets/sample.json
@@ -0,0 +1,87 @@
+[
+  {
+    "name": "pnp-devproxy-api-degradation-scenarios",
+    "source": "pnp",
+    "title": "Simulate API degradation scenarios",
+    "shortDescription": "This sample demonstrates how to simulate various API degradation scenarios including intermittent errors, rate limiting, and slow responses to test your application's resilience.",
+    "url": "https://github.com/pnp/proxy-samples/tree/main/samples/api-degradation-scenarios",
+    "downloadUrl": "https://pnp.github.io/download-partial/?url=https://github.com/pnp/proxy-samples/tree/main/samples/api-degradation-scenarios",
+    "longDescription": [
+      "This sample demonstrates how to simulate various API degradation scenarios including intermittent errors, rate limiting, and slow responses to test your application's resilience."
+    ],
+    "creationDateTime": "2026-01-18",
+    "updateDateTime": "2026-01-18",
+    "products": [
+      "Dev Proxy"
+    ],
+    "metadata": [
+      {
+        "key": "SAMPLE ID",
+        "value": "api-degradation-scenarios"
+      },
+      {
+        "key": "PRESET",
+        "value": "No"
+      },
+      {
+        "key": "MOCKS",
+        "value": "Yes"
+      },
+      {
+        "key": "PLUGIN",
+        "value": "No"
+      },
+      {
+        "key": "PROXY VERSION",
+        "value": "v2.0.0"
+      }
+    ],
+    "thumbnails": [
+      {
+        "type": "image",
+        "order": 100,
+        "url": "https://github.com/pnp/proxy-samples/raw/main/samples/api-degradation-scenarios/assets/screenshot.png",
+        "alt": "Dev Proxy simulating API degradation scenarios"
+      }
+    ],
+    "authors": [
+      {
+        "gitHubAccount": "waldekmastykarz",
+        "pictureUrl": "https://github.com/waldekmastykarz.png",
+        "name": "Waldek Mastykarz"
+      }
+    ],
+    "references": [
+      {
+        "name": "Get started with the Dev Proxy",
+        "description": "The tutorial will introduce you to the Dev Proxy and show you how to use its features.",
+        "url": "https://learn.microsoft.com/microsoft-cloud/dev/dev-proxy/get-started"
+      },
+      {
+        "name": "Use preset configurations",
+        "description": "Instructions on how to configure the Dev Proxy to use a different configuration file.",
+        "url": "https://learn.microsoft.com/microsoft-cloud/dev/dev-proxy/how-to/use-preset-configurations"
+      },
+      {
+        "name": "GenericRandomErrorPlugin",
+        "description": "Technical reference for the GenericRandomErrorPlugin.",
+        "url": "https://learn.microsoft.com/microsoft-cloud/dev/dev-proxy/technical-reference/genericrandomerrorplugin"
+      },
+      {
+        "name": "RateLimitingPlugin",
+        "description": "Technical reference for the RateLimitingPlugin.",
+        "url": "https://learn.microsoft.com/microsoft-cloud/dev/dev-proxy/technical-reference/ratelimitingplugin"
+      },
+      {
+        "name": "LatencyPlugin",
+        "description": "Technical reference for the LatencyPlugin.",
+        "url": "https://learn.microsoft.com/microsoft-cloud/dev/dev-proxy/technical-reference/latencyplugin"
+      },
+      {
+        "name": "Test my app with random errors",
+        "description": "How to test your app with random errors.",
+        "url": "https://learn.microsoft.com/microsoft-cloud/dev/dev-proxy/how-to/test-my-app-with-random-errors"
+      }
+    ]
+  }
+]
diff --git a/samples/api-degradation-scenarios/assets/screenshot.png b/samples/api-degradation-scenarios/assets/screenshot.png
new file mode 100644
index 0000000..39e4ba4
Binary files /dev/null and b/samples/api-degradation-scenarios/assets/screenshot.png differ
diff --git a/samples/api-degradation-scenarios/index.html b/samples/api-degradation-scenarios/index.html
new file mode 100644
index 0000000..8e3a871
--- /dev/null
+++ b/samples/api-degradation-scenarios/index.html
@@ -0,0 +1,517 @@
+<!DOCTYPE html>
+<html lang="en">
+
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>API Degradation Scenarios - Monitoring Dashboard</title>
+  <style>
+    * {
+      box-sizing: border-box;
+      margin: 0;
+      padding: 0;
+    }
+
+    body {
+      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell, sans-serif;
+      background: linear-gradient(135deg, #1a1a2e 0%, #16213e 100%);
+      min-height: 100vh;
+      color: #e0e0e0;
+      padding: 20px;
+    }
+
+    .container {
+      max-width: 1200px;
+      margin: 0 auto;
+    }
+
+    h1 {
+      text-align: center;
+      margin-bottom: 30px;
+      color: #00d9ff;
+      font-size: 2em;
+    }
+
+    .dashboard {
+      display: grid;
+      grid-template-columns: repeat(auto-fit, minmax(250px, 1fr));
+      gap: 20px;
+      margin-bottom: 30px;
+    }
+
+    .metric-card {
+      background: rgba(255, 255, 255, 0.05);
+      border-radius: 15px;
+      padding: 25px;
+      text-align: center;
+      border: 1px solid rgba(255, 255, 255, 0.1);
+      backdrop-filter: blur(10px);
+    }
+
+    .metric-card h3 {
+      font-size: 0.9em;
+      text-transform: uppercase;
+      letter-spacing: 1px;
+      margin-bottom: 10px;
+      color: #888;
+    }
+
+    .metric-value {
+      font-size: 2.5em;
+      font-weight: bold;
+    }
+
+    .metric-value.success {
+      color: #00ff88;
+    }
+
+    .metric-value.warning {
+      color: #ffcc00;
+    }
+
+    .metric-value.error {
+      color: #ff4444;
+    }
+
+    .metric-value.neutral {
+      color: #00d9ff;
+    }
+
+    .controls {
+      display: flex;
+      gap: 15px;
+      justify-content: center;
+      margin-bottom: 30px;
+      flex-wrap: wrap;
+    }
+
+    button {
+      background: linear-gradient(135deg, #00d9ff 0%, #0099cc 100%);
+      color: #1a1a2e;
+      border: none;
+      padding: 12px 30px;
+      border-radius: 25px;
+      font-size: 1em;
+      font-weight: bold;
+      cursor: pointer;
+      transition: transform 0.2s, box-shadow 0.2s;
+    }
+
+    button:hover {
+      transform: translateY(-2px);
+      box-shadow: 0 5px 20px rgba(0, 217, 255, 0.4);
+    }
+
+    button:disabled {
+      background: #444;
+      cursor: not-allowed;
+      transform: none;
+      box-shadow: none;
+    }
+
+    button.stop {
+      background: linear-gradient(135deg, #ff4444 0%, #cc0000 100%);
+    }
+
+    button.clear {
+      background: linear-gradient(135deg, #888 0%, #666 100%);
+    }
+
+    .log-container {
+      background: rgba(0, 0, 0, 0.3);
+      border-radius: 15px;
+      padding: 20px;
+      max-height: 400px;
+      overflow-y: auto;
+      border: 1px solid rgba(255, 255, 255, 0.1);
+    }
+
+    .log-container h3 {
+      margin-bottom: 15px;
+      color: #00d9ff;
+    }
+
+    .log-entry {
+      padding: 8px 12px;
+      margin-bottom: 5px;
+      border-radius: 8px;
+      font-family: 'Consolas', 'Monaco', monospace;
+      font-size: 0.85em;
+      display: flex;
+      justify-content: space-between;
+      align-items: center;
+    }
+
+    .log-entry.success {
+      background: rgba(0, 255, 136, 0.1);
+      border-left: 3px solid #00ff88;
+    }
+
+    .log-entry.error {
+      background: rgba(255, 68, 68, 0.1);
+      border-left: 3px solid #ff4444;
+    }
+
+    .log-entry.rate-limit {
+      background: rgba(255, 204, 0, 0.1);
+      border-left: 3px solid #ffcc00;
+    }
+
+    .log-entry .status {
+      font-weight: bold;
+    }
+
+    .log-entry .time {
+      color: #888;
+      font-size: 0.9em;
+    }
+
+    .error-breakdown {
+      margin-top: 30px;
+    }
+
+    .error-breakdown h3 {
+      margin-bottom: 15px;
+      color: #00d9ff;
+    }
+
+    .error-bar {
+      display: flex;
+      align-items: center;
+      margin-bottom: 10px;
+    }
+
+    .error-bar .label {
+      width: 120px;
+      font-size: 0.9em;
+    }
+
+    .error-bar .bar-container {
+      flex: 1;
+      height: 25px;
+      background: rgba(255, 255, 255, 0.1);
+      border-radius: 12px;
+      overflow: hidden;
+      margin: 0 15px;
+    }
+
+    .error-bar .bar {
+      height: 100%;
+      border-radius: 12px;
+      transition: width 0.3s ease;
+    }
+
+    .error-bar .bar.success {
+      background: linear-gradient(90deg, #00ff88, #00cc6a);
+    }
+
+    .error-bar .bar.error-503 {
+      background: linear-gradient(90deg, #ff4444, #cc0000);
+    }
+
+    .error-bar .bar.error-429 {
+      background: linear-gradient(90deg, #ffcc00, #ff9900);
+    }
+
+    .error-bar .count {
+      width: 50px;
+      text-align: right;
+      font-weight: bold;
+    }
+
+    .info-box {
+      background: rgba(0, 217, 255, 0.1);
+      border: 1px solid rgba(0, 217, 255, 0.3);
+      border-radius: 10px;
+      padding: 15px;
+      margin-bottom: 20px;
+      font-size: 0.9em;
+      line-height: 1.6;
+    }
+
+    .info-box code {
+      background: rgba(0, 0, 0, 0.3);
+      padding: 2px 6px;
+      border-radius: 4px;
+      font-family: 'Consolas', 'Monaco', monospace;
+    }
+  </style>
+</head>
+
+<body>
+  <div class="container">
+    <h1>🔥 API Degradation Scenarios</h1>
+
+    <div class="info-box">
+      <strong>How it works:</strong> This dashboard makes requests to <code>https://api.example.com/data</code> through Dev Proxy.
+      Dev Proxy intercepts these requests and simulates various degradation scenarios including 503 errors (30% rate),
+      rate limiting (429 after 10 requests/minute), and slow responses (3-5s latency).
+      <br><br>
+      <strong>Start Dev Proxy first:</strong> <code>devproxy</code>
+    </div>
+
+    <div class="dashboard">
+      <div class="metric-card">
+        <h3>Total Requests</h3>
+        <div class="metric-value neutral" id="totalRequests">0</div>
+      </div>
+      <div class="metric-card">
+        <h3>Pending</h3>
+        <div class="metric-value neutral" id="pendingRequests">0</div>
+      </div>
+      <div class="metric-card">
+        <h3>Success Rate</h3>
+        <div class="metric-value success" id="successRate">100%</div>
+      </div>
+      <div class="metric-card">
+        <h3>Avg Response Time</h3>
+        <div class="metric-value neutral" id="avgResponseTime">0ms</div>
+      </div>
+      <div class="metric-card">
+        <h3>Errors (503)</h3>
+        <div class="metric-value error" id="errors503">0</div>
+      </div>
+      <div class="metric-card">
+        <h3>Rate Limited (429)</h3>
+        <div class="metric-value warning" id="errors429">0</div>
+      </div>
+      <div class="metric-card">
+        <h3>Other Errors</h3>
+        <div class="metric-value error" id="otherErrors">0</div>
+      </div>
+      <div class="metric-card">
+        <h3>Successful (2xx)</h3>
+        <div class="metric-value success" id="successCount">0</div>
+      </div>
+    </div>
+
+    <div class="controls">
+      <button id="singleRequest">Send Single Request</button>
+      <button id="burstRequests">Send Burst (10 requests)</button>
+      <button id="autoRequests">Start Auto Requests</button>
+      <button id="stopRequests" class="stop" disabled>Stop</button>
+      <button id="clearStats" class="clear">Clear Stats</button>
+    </div>
+
+    <div class="error-breakdown">
+      <h3>Response Distribution</h3>
+      <div class="error-bar">
+        <span class="label">Success (2xx)</span>
+        <div class="bar-container">
+          <div class="bar success" id="successBar" style="width: 0%"></div>
+        </div>
+        <span class="count" id="successPercent">0%</span>
+      </div>
+      <div class="error-bar">
+        <span class="label">Error (503)</span>
+        <div class="bar-container">
+          <div class="bar error-503" id="error503Bar" style="width: 0%"></div>
+        </div>
+        <span class="count" id="error503Percent">0%</span>
+      </div>
+      <div class="error-bar">
+        <span class="label">Rate Limit (429)</span>
+        <div class="bar-container">
+          <div class="bar error-429" id="error429Bar" style="width: 0%"></div>
+        </div>
+        <span class="count" id="error429Percent">0%</span>
+      </div>
+      <div class="error-bar">
+        <span class="label">Other Errors</span>
+        <div class="bar-container">
+          <div class="bar error-503" id="otherErrorsBar" style="width: 0%"></div>
+        </div>
+        <span class="count" id="otherErrorsPercent">0%</span>
+      </div>
+    </div>
+
+    <div class="log-container">
+      <h3>Request Log</h3>
+      <div id="logEntries"></div>
+    </div>
+  </div>
+
+  <script>
+    const stats = {
+      total: 0,
+      pending: 0,
+      success: 0,
+      error503: 0,
+      error429: 0,
+      otherErrors: 0,
+      totalResponseTime: 0,
+      responseTimes: []
+    };
+
+    let autoRequestInterval = null;
+
+    function updateUI() {
+      document.getElementById('totalRequests').textContent = stats.total;
+      document.getElementById('pendingRequests').textContent = stats.pending;
+      const pendingEl = document.getElementById('pendingRequests');
+      pendingEl.textContent = stats.pending;
+      pendingEl.className = 'metric-value ' + (stats.pending > 0 ? 'warning' : 'neutral');
+      document.getElementById('successCount').textContent = stats.success;
+      document.getElementById('errors503').textContent = stats.error503;
+      document.getElementById('errors429').textContent = stats.error429;
+      document.getElementById('otherErrors').textContent = stats.otherErrors;
+
+      const successRate = stats.total > 0 ? ((stats.success / stats.total) * 100).toFixed(1) : 100;
+      const successRateEl = document.getElementById('successRate');
+      successRateEl.textContent = successRate + '%';
+      successRateEl.className = 'metric-value ' + (successRate >= 80 ? 'success' : successRate >= 50 ? 'warning' : 'error');
+
+      const avgTime = stats.total > 0 ? Math.round(stats.totalResponseTime / stats.total) : 0;
+      const avgTimeEl = document.getElementById('avgResponseTime');
+      avgTimeEl.textContent = avgTime + 'ms';
+      avgTimeEl.className = 'metric-value ' + (avgTime < 1000 ? 'success' : avgTime < 3000 ? 'warning' : 'error');
+
+      // Update bars
+      if (stats.total > 0) {
+        const successPercent = (stats.success / stats.total) * 100;
+        const error503Percent = (stats.error503 / stats.total) * 100;
+        const error429Percent = (stats.error429 / stats.total) * 100;
+        const otherErrorsPercent = (stats.otherErrors / stats.total) * 100;
+
+        document.getElementById('successBar').style.width = successPercent + '%';
+        document.getElementById('error503Bar').style.width = error503Percent + '%';
+        document.getElementById('error429Bar').style.width = error429Percent + '%';
+        document.getElementById('otherErrorsBar').style.width = otherErrorsPercent + '%';
+
+        document.getElementById('successPercent').textContent = successPercent.toFixed(0) + '%';
+        document.getElementById('error503Percent').textContent = error503Percent.toFixed(0) + '%';
+        document.getElementById('error429Percent').textContent = error429Percent.toFixed(0) + '%';
+        document.getElementById('otherErrorsPercent').textContent = otherErrorsPercent.toFixed(0) + '%';
+      }
+    }
+
+    function addLogEntry(status, responseTime, message) {
+      const logEntries = document.getElementById('logEntries');
+      const entry = document.createElement('div');
+
+      let className = 'log-entry ';
+      if (status >= 200 && status < 300) className += 'success';
+      else if (status === 429) className += 'rate-limit';
+      else className += 'error';
+
+      const timestamp = new Date().toLocaleTimeString();
+
+      entry.className = className;
+      entry.innerHTML = `
+        <span><span class="status">${status}</span> - ${message}</span>
+        <span class="time">${responseTime}ms | ${timestamp}</span>
+      `;
+
+      logEntries.insertBefore(entry, logEntries.firstChild);
+
+      // Keep only last 50 entries
+      while (logEntries.children.length > 50) {
+        logEntries.removeChild(logEntries.lastChild);
+      }
+    }
+
+    async function makeRequest() {
+      const startTime = performance.now();
+      stats.pending++;
+      updateUI();
+
+      try {
+        const response = await fetch('https://api.example.com/data', {
+          method: 'GET',
+          headers: {
+            'Accept': 'application/json'
+          }
+        });
+
+        const endTime = performance.now();
+        const responseTime = Math.round(endTime - startTime);
+
+        stats.pending--;
+        stats.total++;
+        stats.totalResponseTime += responseTime;
+        stats.responseTimes.push(responseTime);
+
+        if (response.ok) {
+          stats.success++;
+          addLogEntry(response.status, responseTime, 'Request successful');
+        } else if (response.status === 503) {
+          stats.error503++;
+          const data = await response.json().catch(() => ({}));
+          addLogEntry(response.status, responseTime, data.error?.message || 'Service Unavailable');
+        } else if (response.status === 429) {
+          stats.error429++;
+          const retryAfter = response.headers.get('Retry-After');
+          addLogEntry(response.status, responseTime, `Rate limited. Retry after: ${retryAfter || 'unknown'}s`);
+        } else {
+          stats.otherErrors++;
+          addLogEntry(response.status, responseTime, `HTTP ${response.status}`);
+        }
+      } catch (error) {
+        const endTime = performance.now();
+        const responseTime = Math.round(endTime - startTime);
+        stats.pending--;
+        stats.total++;
+        stats.totalResponseTime += responseTime;
+
+        addLogEntry(0, responseTime, `Network error: ${error.message}`);
+      }
+
+      updateUI();
+    }
+
+    async function sendBurst(count) {
+      const promises = [];
+      for (let i = 0; i < count; i++) {
+        promises.push(makeRequest());
+      }
+      await Promise.all(promises);
+    }
+
+    function startAutoRequests() {
+      if (autoRequestInterval) return;
+
+      document.getElementById('autoRequests').disabled = true;
+      document.getElementById('stopRequests').disabled = false;
+
+      autoRequestInterval = setInterval(() => {
+        makeRequest();
+      }, 1000);
+    }
+
+    function stopAutoRequests() {
+      if (autoRequestInterval) {
+        clearInterval(autoRequestInterval);
+        autoRequestInterval = null;
+      }
+
+      document.getElementById('autoRequests').disabled = false;
+      document.getElementById('stopRequests').disabled = true;
+    }
+
+    function clearStats() {
+      stats.total = 0;
+      stats.pending = 0;
+      stats.success = 0;
+      stats.error503 = 0;
+      stats.error429 = 0;
+      stats.otherErrors = 0;
+      stats.totalResponseTime = 0;
+      stats.responseTimes = [];
+
+      document.getElementById('logEntries').innerHTML = '';
+      updateUI();
+    }
+
+    // Event listeners
+    document.getElementById('singleRequest').addEventListener('click', makeRequest);
+    document.getElementById('burstRequests').addEventListener('click', () => sendBurst(10));
+    document.getElementById('autoRequests').addEventListener('click', startAutoRequests);
+    document.getElementById('stopRequests').addEventListener('click', stopAutoRequests);
+    document.getElementById('clearStats').addEventListener('click', clearStats);
+
+    // Initialize UI
+    updateUI();
+  </script>
+</body>
+
+</html>
diff --git a/samples/api-degradation-scenarios/package.json b/samples/api-degradation-scenarios/package.json
new file mode 100644
index 0000000..15ac450
--- /dev/null
+++ b/samples/api-degradation-scenarios/package.json
@@ -0,0 +1,17 @@
+{
+  "name": "api-degradation-scenarios",
+  "version": "1.0.0",
+  "description": "Demo web app to test API degradation scenarios with Dev Proxy",
+  "main": "index.html",
+  "scripts": {
+    "start": "npx concurrently \"npx http-server -p 3000\" \"devproxy\""
+  },
+  "keywords": [
+    "dev-proxy",
+    "api-testing",
+    "degradation",
+    "resilience"
+  ],
+  "author": "Waldek Mastykarz",
+  "license": "ISC"
+}