diff --git a/src/components/FastNav.astro b/src/components/FastNav.astro
index c3ebcecc..40b2d613 100644
--- a/src/components/FastNav.astro
+++ b/src/components/FastNav.astro
@@ -118,29 +118,6 @@
       oldToc.innerHTML = newToc.innerHTML;
     }
 
-    // Swap API right panel (for API pages with two-column layout)
-    var newRight = doc.getElementById('api-right-panel');
-    var oldRight = document.getElementById('api-right-panel');
-    if (newRight && oldRight) {
-      oldRight.innerHTML = newRight.innerHTML;
-    }
-    // Also move any new .apg-right-panel into the aside
-    var newApgRight = document.querySelector('article .apg-right-panel');
-    if (newApgRight && oldRight) {
-      oldRight.innerHTML = '';
-      oldRight.appendChild(newApgRight);
-      newApgRight.style.display = 'block';
-    }
-
-    // Re-run inline scripts from the new content (ApiPlayground JS)
-    var newScripts = doc.querySelectorAll('article script, .apg-right-panel script');
-    newScripts.forEach(function(oldScript) {
-      var newScript = document.createElement('script');
-      newScript.textContent = oldScript.textContent;
-      document.body.appendChild(newScript);
-      document.body.removeChild(newScript);
-    });
-
     // Update document title
     var newTitle = doc.querySelector('title');
     if (newTitle) document.title = newTitle.textContent;
@@ -152,6 +129,31 @@
       oldSidebar.innerHTML = newSidebar.innerHTML;
     }
 
+    // Re-execute inline scripts in swapped article
+    // (innerHTML doesn't execute <script> tags — clone them so the browser runs them)
+    // This populates ApiPlayground code displays, sets up event listeners, etc.
+    if (oldArticle) {
+      oldArticle.querySelectorAll('script').forEach(function(dead) {
+        var live = document.createElement('script');
+        Array.from(dead.attributes).forEach(function(a) {
+          live.setAttribute(a.name, a.value);
+        });
+        live.textContent = dead.textContent;
+        dead.parentNode.replaceChild(live, dead);
+      });
+    }
+
+    // Move ApiPlayground's .apg-right-panel into the aside (AFTER scripts have populated it)
+    var rightPanel = document.getElementById('api-right-panel');
+    if (rightPanel) {
+      rightPanel.innerHTML = '';
+      var newPanel = document.querySelector('.apg-right-panel');
+      if (newPanel) {
+        rightPanel.appendChild(newPanel);
+        newPanel.style.display = 'block';
+      }
+    }
+
     // Scroll content to top
     var main = document.querySelector('main');
     if (main) main.scrollTop = 0;
@@ -195,8 +197,11 @@
     }
   });
 
-  // Cache current page
-  pageCache[window.location.pathname] = document.documentElement.outerHTML;
+  // Cache current page from server (not live DOM which has JS mutations)
+  fetch(window.location.pathname)
+    .then(function(r) { return r.text(); })
+    .then(function(html) { pageCache[window.location.pathname] = html; })
+    .catch(function() {});
 
   // Prefetch visible sidebar links into cache
   function prefetchVisible() {
@@ -221,7 +226,6 @@
 
   // Re-init on Astro view transitions (fallback)
   document.addEventListener('astro:page-load', function() {
-    pageCache[window.location.pathname] = document.documentElement.outerHTML;
     initFastNav();
     setTimeout(prefetchVisible, 500);
   });
diff --git a/src/components/Sidebar.astro b/src/components/Sidebar.astro
index 33f78ace..5bdc77a0 100644
--- a/src/components/Sidebar.astro
+++ b/src/components/Sidebar.astro
@@ -402,38 +402,38 @@ function inferApiMethod(title: string): { method: string; css: string } | null {
       }
     }
 
-    var SCROLL_KEY = 'sidebar-scroll';
-
-    function saveScroll() {
+    function scrollToActiveItem() {
       var nav = document.querySelector('#sidebar nav');
-      if (nav) sessionStorage.setItem(SCROLL_KEY, nav.scrollTop);
-    }
-
-    function restoreScroll() {
-      var saved = sessionStorage.getItem(SCROLL_KEY);
-      if (saved !== null) {
-        var nav = document.querySelector('#sidebar nav');
-        if (nav) nav.scrollTop = parseInt(saved, 10);
+      if (!nav) return;
+      // Find the active link — it has font-medium + bg-hover styling applied server-side
+      var active = nav.querySelector('a.font-medium');
+      if (!active) return;
+      // Calculate position relative to the nav scroll container
+      var navRect = nav.getBoundingClientRect();
+      var activeRect = active.getBoundingClientRect();
+      // Only scroll if the active item is outside the visible area
+      if (activeRect.top < navRect.top || activeRect.bottom > navRect.bottom) {
+        var offset = active.offsetTop - nav.offsetTop - navRect.height / 3;
+        nav.scrollTop = Math.max(0, offset);
       }
     }
 
     setupSidebar();
-    restoreScroll();
+    scrollToActiveItem();
 
     // Register global listeners only once (script re-executes on view transitions)
     if (!window.__sidebarListenersReady) {
       window.__sidebarListenersReady = true;
 
-      document.addEventListener('astro:before-swap', saveScroll);
-
       document.addEventListener('astro:page-load', function() {
         setupSidebar();
-        restoreScroll();
+        scrollToActiveItem();
       });
 
       // Re-init after FastNav swaps sidebar innerHTML
       window.addEventListener('fastnav', function() {
         setupSidebar();
+        scrollToActiveItem();
       });
     }
 
diff --git a/src/components/docs/ApiCollapsible.astro b/src/components/docs/ApiCollapsible.astro
index 0a99c257..957dcc84 100644
--- a/src/components/docs/ApiCollapsible.astro
+++ b/src/components/docs/ApiCollapsible.astro
@@ -28,29 +28,31 @@ const cid = `apic-${Math.random().toString(36).slice(2, 8)}`;
   </div>
 </div>
 
-<script is:inline define:vars={{ cid, title }}>
-(function(){
-  var el = document.getElementById(cid);
-  if (!el || el._apicBound) return;
-  el._apicBound = true;
+<script is:inline>
+function initApiCollapsibles() {
+  document.querySelectorAll('.api-collapsible').forEach(function(el) {
+    if (el._apicBound) return;
+    el._apicBound = true;
 
-  var trigger = el.querySelector('[data-apic-trigger]');
-  var content = el.querySelector('[data-apic-content]');
-  var icon = el.querySelector('[data-apic-icon]');
-  var label = el.querySelector('[data-apic-label]');
-  var isOpen = false;
+    var trigger = el.querySelector('[data-apic-trigger]');
+    var icon = el.querySelector('[data-apic-icon]');
+    var label = el.querySelector('[data-apic-label]');
+    var isOpen = false;
+    var showTitle = label ? label.textContent : 'Show properties';
+    var hideTitle = showTitle.replace(/^Show\b/, 'Hide');
 
-  var openTitle = title.replace(/^Show\b/, 'Hide');
-
-  if (trigger) {
-    trigger.addEventListener('click', function() {
-      isOpen = !isOpen;
-      el.classList.toggle('api-collapsible-open', isOpen);
-      if (icon) icon.textContent = isOpen ? '\u00d7' : '+';
-      if (label) label.textContent = isOpen ? openTitle : title;
-    });
-  }
-})();
+    if (trigger) {
+      trigger.addEventListener('click', function() {
+        isOpen = !isOpen;
+        el.classList.toggle('api-collapsible-open', isOpen);
+        if (icon) icon.textContent = isOpen ? '\u00d7' : '+';
+        if (label) label.textContent = isOpen ? hideTitle : showTitle;
+      });
+    }
+  });
+}
+initApiCollapsibles();
+document.addEventListener('astro:page-load', initApiCollapsibles);
 </script>
 
 <style is:global>
diff --git a/src/lib/api-navigation.ts b/src/lib/api-navigation.ts
index 4ec0959e..018fda23 100644
--- a/src/lib/api-navigation.ts
+++ b/src/lib/api-navigation.ts
@@ -69,6 +69,36 @@ export const apiNavigation: ApiNavGroup[] = [
       }
     ]
   },
+  {
+    "title": "Personas",
+    "items": [
+      {
+        "title": "List personas",
+        "href": "/docs/api/personas/listpersonas",
+        "method": "GET"
+      },
+      {
+        "title": "Create persona",
+        "href": "/docs/api/personas/createpersona",
+        "method": "POST"
+      },
+      {
+        "title": "Update persona",
+        "href": "/docs/api/personas/updatepersona",
+        "method": "PATCH"
+      },
+      {
+        "title": "Delete persona",
+        "href": "/docs/api/personas/deletepersona",
+        "method": "DELETE"
+      },
+      {
+        "title": "Duplicate persona",
+        "href": "/docs/api/personas/duplicatepersona",
+        "method": "POST"
+      }
+    ]
+  },
   {
     "title": "Agent Definitions",
     "items": [
@@ -132,15 +162,165 @@ export const apiNavigation: ApiNavGroup[] = [
   {
     "title": "Run Tests",
     "items": [
+      {
+        "title": "List test runs",
+        "href": "/docs/api/run-tests/listruntests",
+        "method": "GET"
+      },
       {
         "title": "Create a New Test Run",
         "href": "/docs/api/run-tests/createruntest",
         "method": "POST"
       },
+      {
+        "title": "Get test run details",
+        "href": "/docs/api/run-tests/getruntestdetails",
+        "method": "GET"
+      },
+      {
+        "title": "Delete a test run",
+        "href": "/docs/api/run-tests/deleteruntest",
+        "method": "DELETE"
+      },
       {
         "title": "Execute a test run",
         "href": "/docs/api/run-tests/executeruntest",
         "method": "POST"
+      },
+      {
+        "title": "Update test run components",
+        "href": "/docs/api/run-tests/updatetestcomponents",
+        "method": "PATCH"
+      },
+      {
+        "title": "Get test executions",
+        "href": "/docs/api/run-tests/gettestexecutions",
+        "method": "GET"
+      },
+      {
+        "title": "Get scenarios for a test run",
+        "href": "/docs/api/run-tests/gettestscenarios",
+        "method": "GET"
+      },
+      {
+        "title": "Get call executions for a test run",
+        "href": "/docs/api/run-tests/getcallexecutions",
+        "method": "GET"
+      },
+      {
+        "title": "Get evaluation summary",
+        "href": "/docs/api/run-tests/getevalsummary",
+        "method": "GET"
+      },
+      {
+        "title": "Compare evaluation summaries",
+        "href": "/docs/api/run-tests/compareevalsummaries",
+        "method": "GET"
+      },
+      {
+        "title": "Add evaluation configurations",
+        "href": "/docs/api/run-tests/addevalconfigs",
+        "method": "POST"
+      },
+      {
+        "title": "Update evaluation configuration",
+        "href": "/docs/api/run-tests/updateevalconfig",
+        "method": "PATCH"
+      },
+      {
+        "title": "Delete evaluation configuration",
+        "href": "/docs/api/run-tests/deleteevalconfig",
+        "method": "DELETE"
+      },
+      {
+        "title": "Run new evaluations on test executions",
+        "href": "/docs/api/run-tests/runnewevalsontestexecution",
+        "method": "POST"
+      },
+      {
+        "title": "Rerun test executions",
+        "href": "/docs/api/run-tests/reruntestexecutions",
+        "method": "POST"
+      },
+      {
+        "title": "Delete test executions",
+        "href": "/docs/api/run-tests/deletetestexecutions",
+        "method": "POST"
+      }
+    ]
+  },
+  {
+    "title": "Test Executions",
+    "items": [
+      {
+        "title": "Get test execution details",
+        "href": "/docs/api/test-executions/gettestexecutiondetails",
+        "method": "GET"
+      },
+      {
+        "title": "Get execution KPIs",
+        "href": "/docs/api/test-executions/getkpis",
+        "method": "GET"
+      },
+      {
+        "title": "Get performance summary",
+        "href": "/docs/api/test-executions/getperformancesummary",
+        "method": "GET"
+      },
+      {
+        "title": "Get eval explanation summary",
+        "href": "/docs/api/test-executions/getevalexplanationsummary",
+        "method": "GET"
+      },
+      {
+        "title": "Cancel test execution",
+        "href": "/docs/api/test-executions/cancelexecution",
+        "method": "POST"
+      },
+      {
+        "title": "Rerun call executions",
+        "href": "/docs/api/test-executions/reruncalls",
+        "method": "POST"
+      }
+    ]
+  },
+  {
+    "title": "Call Executions",
+    "items": [
+      {
+        "title": "Get call execution details",
+        "href": "/docs/api/call-executions/getcallexecutiondetails",
+        "method": "GET"
+      },
+      {
+        "title": "Compare execution sessions",
+        "href": "/docs/api/call-executions/getsessioncomparison",
+        "method": "GET"
+      }
+    ]
+  },
+  {
+    "title": "Prompt Simulations",
+    "items": [
+      {
+        "title": "List prompt simulation scenarios",
+        "href": "/docs/api/prompt-simulations/listscenarios",
+        "method": "GET"
+      },
+      {
+        "title": "List simulations for prompt template",
+        "href": "/docs/api/prompt-simulations/listsimulations",
+        "method": "GET"
+      },
+      {
+        "title": "Get prompt simulation details",
+        "href": "/docs/api/prompt-simulations/getsimulationdetails",
+        "method": "GET"
+      },
+      {
+        "title": "Execute prompt simulation",
+        "href": "/docs/api/prompt-simulations/executesimulation",
+        "method": "POST"
       }
     ]
   },
diff --git a/src/lib/navigation.ts b/src/lib/navigation.ts
index a1e75d63..a59133dd 100644
--- a/src/lib/navigation.ts
+++ b/src/lib/navigation.ts
@@ -1001,6 +1001,16 @@ export const tabNavigation: NavTab[] = [
               { title: 'Add Empty Rows', href: '/docs/api/scenarios/addemptyrowstodataset' },
             ]
           },
+          {
+            title: 'Personas',
+            items: [
+              { title: 'List Personas', href: '/docs/api/personas/listpersonas' },
+              { title: 'Create Persona', href: '/docs/api/personas/createpersona' },
+              { title: 'Update Persona', href: '/docs/api/personas/updatepersona' },
+              { title: 'Delete Persona', href: '/docs/api/personas/deletepersona' },
+              { title: 'Duplicate Persona', href: '/docs/api/personas/duplicatepersona' },
+            ]
+          },
           {
             title: 'Agent Definitions',
             items: [
@@ -1024,8 +1034,50 @@ export const tabNavigation: NavTab[] = [
           {
             title: 'Run Tests',
             items: [
+              { title: 'List Test Runs', href: '/docs/api/run-tests/listruntests' },
               { title: 'Create Run Test', href: '/docs/api/run-tests/createruntest' },
+              { title: 'Get Test Run Details', href: '/docs/api/run-tests/getruntestdetails' },
+              { title: 'Delete Test Run', href: '/docs/api/run-tests/deleteruntest' },
               { title: 'Execute Run Test', href: '/docs/api/run-tests/executeruntest' },
+              { title: 'Update Components', href: '/docs/api/run-tests/updatetestcomponents' },
+              { title: 'Get Test Executions', href: '/docs/api/run-tests/gettestexecutions' },
+              { title: 'Get Test Scenarios', href: '/docs/api/run-tests/gettestscenarios' },
+              { title: 'Get Call Executions', href: '/docs/api/run-tests/getcallexecutions' },
+              { title: 'Get Eval Summary', href: '/docs/api/run-tests/getevalsummary' },
+              { title: 'Compare Eval Summaries', href: '/docs/api/run-tests/compareevalsummaries' },
+              { title: 'Add Eval Configs', href: '/docs/api/run-tests/addevalconfigs' },
+              { title: 'Update Eval Config', href: '/docs/api/run-tests/updateevalconfig' },
+              { title: 'Delete Eval Config', href: '/docs/api/run-tests/deleteevalconfig' },
+              { title: 'Run New Evals', href: '/docs/api/run-tests/runnewevalsontestexecution' },
+              { title: 'Rerun Test Executions', href: '/docs/api/run-tests/reruntestexecutions' },
+              { title: 'Delete Test Executions', href: '/docs/api/run-tests/deletetestexecutions' },
+            ]
+          },
+          {
+            title: 'Test Executions',
+            items: [
+              { title: 'Get Execution Details', href: '/docs/api/test-executions/gettestexecutiondetails' },
+              { title: 'Get Execution KPIs', href: '/docs/api/test-executions/getkpis' },
+              { title: 'Get Performance Summary', href: '/docs/api/test-executions/getperformancesummary' },
+              { title: 'Get Eval Explanation', href: '/docs/api/test-executions/getevalexplanationsummary' },
+              { title: 'Cancel Execution', href: '/docs/api/test-executions/cancelexecution' },
+              { title: 'Rerun Calls', href: '/docs/api/test-executions/reruncalls' },
+            ]
+          },
+          {
+            title: 'Call Executions',
+            items: [
+              { title: 'Get Call Details', href: '/docs/api/call-executions/getcallexecutiondetails' },
+              { title: 'Compare Sessions', href: '/docs/api/call-executions/getsessioncomparison' },
+            ]
+          },
+          {
+            title: 'Prompt Simulations',
+            items: [
+              { title: 'List Scenarios', href: '/docs/api/prompt-simulations/listscenarios' },
+              { title: 'List Simulations', href: '/docs/api/prompt-simulations/listsimulations' },
+              { title: 'Get Simulation Details', href: '/docs/api/prompt-simulations/getsimulationdetails' },
+              { title: 'Execute Simulation', href: '/docs/api/prompt-simulations/executesimulation' },
             ]
           },
           {
diff --git a/src/pages/docs/api/agent-definitions/getagentdefinition.mdx b/src/pages/docs/api/agent-definitions/getagentdefinition.mdx
index 6592f3e7..2fdb2f36 100644
--- a/src/pages/docs/api/agent-definitions/getagentdefinition.mdx
+++ b/src/pages/docs/api/agent-definitions/getagentdefinition.mdx
@@ -59,6 +59,14 @@ description: "Retrieves a specific agent definition with all its versions."
   <ResponseField name="model" type="string">AI model identifier, if set.</ResponseField>
   <ResponseField name="model_details" type="object">Extended model configuration, if available.</ResponseField>
   <ResponseField name="versions" type="array">All version objects for this agent definition.</ResponseField>
+  <ApiCollapsible title="Show 6 properties">
+    <ResponseField name="id" type="string">UUID of the version.</ResponseField>
+    <ResponseField name="version_number" type="integer">Sequential version number.</ResponseField>
+    <ResponseField name="status" type="string">Lifecycle status: `draft`, `active`, `archived`, or `deprecated`.</ResponseField>
+    <ResponseField name="score" type="number">Evaluation score (`0.0`-`10.0`). `null` if untested.</ResponseField>
+    <ResponseField name="commit_message" type="string">Commit message for this version.</ResponseField>
+    <ResponseField name="created_at" type="datetime">ISO 8601 creation timestamp.</ResponseField>
+  </ApiCollapsible>
   <ResponseField name="active_version" type="object">Currently active version, or `null`.</ResponseField>
   <ResponseField name="version_count" type="integer">Total number of versions.</ResponseField>
   <ResponseField name="created_at" type="datetime">ISO 8601 creation timestamp.</ResponseField>
diff --git a/src/pages/docs/api/agent-definitions/listagentdefinitions.mdx b/src/pages/docs/api/agent-definitions/listagentdefinitions.mdx
index 82839e27..c17786f1 100644
--- a/src/pages/docs/api/agent-definitions/listagentdefinitions.mdx
+++ b/src/pages/docs/api/agent-definitions/listagentdefinitions.mdx
@@ -56,6 +56,29 @@ description: "Returns a paginated list of agent definitions with optional search
   <ResponseField name="next" type="string">URL of the next page, or `null`.</ResponseField>
   <ResponseField name="previous" type="string">URL of the previous page, or `null`.</ResponseField>
   <ResponseField name="results" type="array">Array of agent definition objects for the current page.</ResponseField>
+  <ApiCollapsible title="Show 21 properties">
+    <ResponseField name="id" type="string">UUID of the agent definition.</ResponseField>
+    <ResponseField name="agent_name" type="string">Display name.</ResponseField>
+    <ResponseField name="agent_type" type="string">`voice` or `text`.</ResponseField>
+    <ResponseField name="contact_number" type="string">Phone number with country code. `null` for text agents.</ResponseField>
+    <ResponseField name="inbound" type="boolean">Whether the agent handles inbound calls.</ResponseField>
+    <ResponseField name="description" type="string">Agent description.</ResponseField>
+    <ResponseField name="assistant_id" type="string">External assistant ID from the voice provider. `null` if not configured.</ResponseField>
+    <ResponseField name="provider" type="string">Voice provider: `vapi`, `retell`, `eleven_labs`, `livekit`, or `others`. `null` for text agents.</ResponseField>
+    <ResponseField name="language" type="string">ISO 639-1 language code.</ResponseField>
+    <ResponseField name="languages" type="array">All supported language codes.</ResponseField>
+    <ResponseField name="websocket_url" type="string">WebSocket URL for real-time communication. `null` if not configured.</ResponseField>
+    <ResponseField name="websocket_headers" type="object">Custom WebSocket headers. `null` if not configured.</ResponseField>
+    <ResponseField name="workspace" type="string">UUID of the workspace. `null` if not workspace-scoped.</ResponseField>
+    <ResponseField name="knowledge_base" type="string">UUID of the linked knowledge base.</ResponseField>
+    <ResponseField name="organization" type="string">UUID of the owning organization.</ResponseField>
+    <ResponseField name="created_at" type="datetime">ISO 8601 creation timestamp.</ResponseField>
+    <ResponseField name="updated_at" type="datetime">ISO 8601 last-modified timestamp.</ResponseField>
+    <ResponseField name="latest_version" type="integer">Most recent version number.</ResponseField>
+    <ResponseField name="latest_version_id" type="string">UUID of the most recent version.</ResponseField>
+    <ResponseField name="model" type="string">AI model identifier, if set.</ResponseField>
+    <ResponseField name="model_details" type="object">Extended model configuration details.</ResponseField>
+  </ApiCollapsible>
 </ApiSection>
 
 <ApiSection title="Errors">
diff --git a/src/pages/docs/api/agent-versions/getagentversion.mdx b/src/pages/docs/api/agent-versions/getagentversion.mdx
index fe913f60..8c5209f3 100644
--- a/src/pages/docs/api/agent-versions/getagentversion.mdx
+++ b/src/pages/docs/api/agent-versions/getagentversion.mdx
@@ -64,6 +64,24 @@ description: "Retrieves a specific version of an agent definition."
   <ResponseField name="agent_definition" type="string">UUID of the parent agent definition.</ResponseField>
   <ResponseField name="organization" type="string">UUID of the owning organization.</ResponseField>
   <ResponseField name="configuration_snapshot" type="object">Immutable snapshot of the agent configuration at version creation time.</ResponseField>
+  <ApiCollapsible title="Show 16 properties">
+    <ResponseField name="agent_name" type="string">Agent display name at snapshot time.</ResponseField>
+    <ResponseField name="agent_type" type="string">`voice` or `text`.</ResponseField>
+    <ResponseField name="inbound" type="boolean">Whether the agent handled inbound calls.</ResponseField>
+    <ResponseField name="languages" type="array">Supported language codes.</ResponseField>
+    <ResponseField name="language" type="string">Primary ISO 639-1 language code.</ResponseField>
+    <ResponseField name="provider" type="string">Voice provider.</ResponseField>
+    <ResponseField name="contact_number" type="string">Phone number at snapshot time.</ResponseField>
+    <ResponseField name="assistant_id" type="string">External assistant ID.</ResponseField>
+    <ResponseField name="api_key" type="string">Provider API key.</ResponseField>
+    <ResponseField name="authentication_method" type="string">Authentication method for provider.</ResponseField>
+    <ResponseField name="observability_enabled" type="boolean">Whether observability was enabled.</ResponseField>
+    <ResponseField name="description" type="string">Agent description at snapshot time.</ResponseField>
+    <ResponseField name="knowledge_base" type="string">UUID of linked knowledge base.</ResponseField>
+    <ResponseField name="commit_message" type="string">Commit message.</ResponseField>
+    <ResponseField name="model" type="string">AI model identifier.</ResponseField>
+    <ResponseField name="model_details" type="object">Extended model configuration.</ResponseField>
+  </ApiCollapsible>
   <ResponseField name="is_active" type="boolean">Whether this is the currently active version.</ResponseField>
   <ResponseField name="is_latest" type="boolean">Whether this is the most recently created version.</ResponseField>
   <ResponseField name="created_at" type="datetime">ISO 8601 creation timestamp.</ResponseField>
diff --git a/src/pages/docs/api/agent-versions/getversioncallexecutions.mdx b/src/pages/docs/api/agent-versions/getversioncallexecutions.mdx
index faa86510..6eea804d 100644
--- a/src/pages/docs/api/agent-versions/getversioncallexecutions.mdx
+++ b/src/pages/docs/api/agent-versions/getversioncallexecutions.mdx
@@ -51,28 +51,28 @@ description: "Retrieves paginated call executions with evaluation results for an
 </ApiSection>
 
 <ApiSection title="Response" status={200} statusText="OK">
-  <ResponseField name="count" type="integer">Total completed call executions with evaluation results.</ResponseField>
+  <ResponseField name="count" type="integer">Total completed call executions with results.</ResponseField>
   <ResponseField name="next" type="string">URL of the next page. `null` if last page.</ResponseField>
   <ResponseField name="previous" type="string">URL of the previous page. `null` if first page.</ResponseField>
-  <ResponseField name="results" type="array">
-    Array of call execution objects. Each includes:
-    - `id` — Call execution UUID.
-    - `service_provider_call_id` — External provider call ID. `null` if unavailable.
-    - `session_id` — Session identifier. `null` if not applicable.
-    - `status` — Call status (only `completed` calls returned).
-    - `duration` — Duration in seconds. `null` if not recorded.
-    - `start_time` — ISO 8601 start timestamp.
-    - `transcript` — Array of transcript turn objects.
-    - `scenario` — Scenario name.
-    - `overall_score` — Aggregate evaluation score. `null` if unscored.
-    - `eval_outputs` — Detailed evaluation results per template.
-    - `eval_metrics` — Aggregated evaluation metrics. `null` if unavailable.
-    - `scenario_columns` — Additional scenario column data.
-    - `customer_name` — Simulated customer name. `null` if not set.
-    - `call_summary` — AI-generated call summary. `null` if not generated.
-    - `ended_reason` — Reason the call ended. `null` if not recorded.
-    - `created_at` — ISO 8601 creation timestamp.
-  </ResponseField>
+  <ResponseField name="results" type="array">Array of call execution objects.</ResponseField>
+  <ApiCollapsible title="Show 16 properties">
+    <ResponseField name="id" type="string">UUID of the call execution.</ResponseField>
+    <ResponseField name="service_provider_call_id" type="string">External provider call ID. `null` if unavailable.</ResponseField>
+    <ResponseField name="session_id" type="string">Session identifier. `null` if not applicable.</ResponseField>
+    <ResponseField name="status" type="string">Call status (only `completed` calls returned).</ResponseField>
+    <ResponseField name="duration" type="number">Duration in seconds. `null` if not recorded.</ResponseField>
+    <ResponseField name="start_time" type="datetime">ISO 8601 start timestamp.</ResponseField>
+    <ResponseField name="transcript" type="array">Array of transcript turn objects.</ResponseField>
+    <ResponseField name="scenario" type="string">Scenario name.</ResponseField>
+    <ResponseField name="overall_score" type="number">Aggregate evaluation score. `null` if unscored.</ResponseField>
+    <ResponseField name="eval_outputs" type="object">Detailed evaluation results per template.</ResponseField>
+    <ResponseField name="eval_metrics" type="object">Aggregated evaluation metrics. `null` if unavailable.</ResponseField>
+    <ResponseField name="scenario_columns" type="object">Additional scenario column data.</ResponseField>
+    <ResponseField name="customer_name" type="string">Simulated customer name. `null` if not set.</ResponseField>
+    <ResponseField name="call_summary" type="string">AI-generated call summary. `null` if not generated.</ResponseField>
+    <ResponseField name="ended_reason" type="string">Reason the call ended. `null` if not recorded.</ResponseField>
+    <ResponseField name="created_at" type="datetime">ISO 8601 creation timestamp.</ResponseField>
+  </ApiCollapsible>
 </ApiSection>
 
 <ApiSection title="Errors">
diff --git a/src/pages/docs/api/agent-versions/listagentversions.mdx b/src/pages/docs/api/agent-versions/listagentversions.mdx
index 4ab4b42c..48f9b766 100644
--- a/src/pages/docs/api/agent-versions/listagentversions.mdx
+++ b/src/pages/docs/api/agent-versions/listagentversions.mdx
@@ -47,10 +47,26 @@ description: "Retrieves a paginated list of versions for an agent definition."
 </ApiSection>
 
 <ApiSection title="Response" status={200} statusText="OK">
-  <ResponseField name="count" type="integer">Total versions for this agent definition.</ResponseField>
+  <ResponseField name="count" type="integer">Total versions for this agent.</ResponseField>
   <ResponseField name="next" type="string">URL of the next page. `null` if last page.</ResponseField>
   <ResponseField name="previous" type="string">URL of the previous page. `null` if first page.</ResponseField>
-  <ResponseField name="results" type="array">Array of version objects with `id`, `version_number`, `version_name`, `version_name_display`, `status`, `status_display`, `score`, `test_count`, `pass_rate`, `description`, `commit_message`, `is_active`, `is_latest`, and `created_at`.</ResponseField>
+  <ResponseField name="results" type="array">Array of version objects.</ResponseField>
+  <ApiCollapsible title="Show 14 properties">
+    <ResponseField name="id" type="string">UUID of the version.</ResponseField>
+    <ResponseField name="version_number" type="integer">Sequential version number.</ResponseField>
+    <ResponseField name="version_name" type="string">Short version name (e.g., `v1`, `v2`).</ResponseField>
+    <ResponseField name="version_name_display" type="string">Formatted display name.</ResponseField>
+    <ResponseField name="status" type="string">Lifecycle status: `draft`, `active`, `archived`, or `deprecated`.</ResponseField>
+    <ResponseField name="status_display" type="string">Human-readable status label.</ResponseField>
+    <ResponseField name="score" type="number">Evaluation score (`0.0`-`10.0`). `null` if untested.</ResponseField>
+    <ResponseField name="test_count" type="integer">Total test executions run.</ResponseField>
+    <ResponseField name="pass_rate" type="number">Test pass percentage (`0`-`100`). `null` if untested.</ResponseField>
+    <ResponseField name="description" type="string">Version description.</ResponseField>
+    <ResponseField name="commit_message" type="string">Commit message.</ResponseField>
+    <ResponseField name="is_active" type="boolean">Whether this is the active version.</ResponseField>
+    <ResponseField name="is_latest" type="boolean">Whether this is the most recent version.</ResponseField>
+    <ResponseField name="created_at" type="datetime">ISO 8601 creation timestamp.</ResponseField>
+  </ApiCollapsible>
 </ApiSection>
 
 <ApiSection title="Errors">
diff --git a/src/pages/docs/api/call-executions/getcallexecutiondetails.mdx b/src/pages/docs/api/call-executions/getcallexecutiondetails.mdx
new file mode 100644
index 00000000..33e8eea0
--- /dev/null
+++ b/src/pages/docs/api/call-executions/getcallexecutiondetails.mdx
@@ -0,0 +1,136 @@
+---
+title: "Get call execution details"
+description: "Retrieves a specific call execution."
+---
+
+<ApiPlayground
+  method="GET"
+  endpoint="/simulate/call-executions/{call_execution_id}/"
+  baseUrl="https://api.futureagi.com"
+  parameters={[
+    {"name": "call_execution_id", "in": "path", "required": true, "description": "UUID of the call execution.", "type": "string"}
+  ]}
+  responseExample={{
+    id: "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
+    service_provider_call_id: "prov-call-001",
+    session_id: "sess-001",
+    status: "completed",
+    duration: 125.4,
+    start_time: "2026-03-15T10:30:00Z",
+    timestamp: "2026-03-15T10:32:05Z",
+    call_type: "Outbound",
+    transcript: [
+      { role: "assistant", content: "Hello, how can I help you today?" },
+      { role: "user", content: "I have a billing question." }
+    ],
+    scenario: "Billing Inquiry",
+    scenario_id: "f7a8b9c0-d1e2-3456-789a-bcdef0123456",
+    scenario_columns: [{ column_name: "intent", value: "billing" }],
+    overall_score: 8.5,
+    response_time: 1.23,
+    eval_outputs: { tone_check: { score: 9, explanation: "Polite and professional" } },
+    eval_metrics: {},
+    audio_url: "https://storage.example.com/recordings/call-001.wav",
+    recordings: {},
+    customer_name: "Jane Doe",
+    call_summary: "Customer inquired about billing charges.",
+    ended_reason: "customer_hangup",
+    simulatorAgentName: "Billing Simulator",
+    simulatorAgentId: "sim-agent-uuid",
+    agent_definition_used_name: "Support Agent v2",
+    agent_definition_used_id: "agent-def-uuid",
+    tool_outputs: null,
+    rerun_snapshots: [],
+    avg_agent_latency: 0.85,
+    user_interruption_count: 1,
+    user_interruption_rate: 0.05,
+    user_wpm: 130,
+    bot_wpm: 145,
+    talk_ratio: 0.55,
+    ai_interruption_count: 0,
+    ai_interruption_rate: 0.0,
+    avg_stop_time_after_interruption: 0.3,
+    stt_cost: 0.012,
+    llm_cost: 0.045,
+    tts_cost: 0.008,
+    storage_cost: 0.002,
+    total_cost: 0.067
+  }}
+  responseStatus={200}
+  responseStatusText="OK"
+/>
+
+<ApiSection title="Authentication">
+  <ParamField name="X-Api-Key" type="API Key" required>
+    Your Future AGI API key used to authenticate requests. You can find and manage your API keys in the [Dashboard](https://app.futureagi.com) under Settings.
+  </ParamField>
+  <ParamField name="X-Secret-Key" type="Secret Key" required>
+    Your Future AGI secret key, used alongside the API key for request authentication. This is generated when you create an API key in the [Dashboard](https://app.futureagi.com).
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Path parameters">
+  <ParamField path="call_execution_id" type="UUID" required>
+    The call execution ID.
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Response" status={200} statusText="OK">
+  <ResponseField name="id" type="string">UUID of the call execution.</ResponseField>
+  <ResponseField name="service_provider_call_id" type="string or null">External call ID from the telephony provider.</ResponseField>
+  <ResponseField name="session_id" type="string or null">Session ID linking this call to a broader conversation.</ResponseField>
+  <ResponseField name="status" type="string">Call status. One of `pending`, `queued`, `ongoing`, `completed`, `failed`, `analyzing`, or `cancelled`.</ResponseField>
+  <ResponseField name="duration" type="number or null">Call duration in seconds.</ResponseField>
+  <ResponseField name="start_time" type="datetime or null">ISO 8601 timestamp when the call connected.</ResponseField>
+  <ResponseField name="timestamp" type="datetime">ISO 8601 timestamp when the record was created.</ResponseField>
+  <ResponseField name="call_type" type="string or null">`Inbound` or `Outbound`. `null` for text agents.</ResponseField>
+  <ResponseField name="transcript" type="array">Ordered conversation turns.</ResponseField>
+  <ApiCollapsible title="Show 2 properties">
+    <ResponseField name="role" type="string">Speaker: `user`, `assistant`, `system`, `tool_calls`, or `tool_call_result`.</ResponseField>
+    <ResponseField name="content" type="string">Text content of the utterance.</ResponseField>
+  </ApiCollapsible>
+  <ResponseField name="scenario" type="string">Scenario name.</ResponseField>
+  <ResponseField name="scenario_id" type="string or null">UUID of the scenario.</ResponseField>
+  <ResponseField name="scenario_columns" type="array">Dataset column values used for this call.</ResponseField>
+  <ResponseField name="overall_score" type="number or null">Aggregated evaluation score (0-10).</ResponseField>
+  <ResponseField name="response_time" type="number or null">Average agent response time in seconds.</ResponseField>
+  <ResponseField name="eval_outputs" type="object or null">Evaluation results keyed by evaluation name.</ResponseField>
+  <ResponseField name="eval_metrics" type="object or null">Supplementary evaluation metric aggregations.</ResponseField>
+  <ResponseField name="audio_url" type="string or null">URL to the call audio recording.</ResponseField>
+  <ResponseField name="recordings" type="object or null">Provider-specific recording URLs and metadata.</ResponseField>
+  <ResponseField name="customer_name" type="string or null">Simulated customer persona name.</ResponseField>
+  <ResponseField name="call_summary" type="string or null">AI-generated conversation summary.</ResponseField>
+  <ResponseField name="ended_reason" type="string or null">Reason the call ended, e.g. `customer_hangup`, `agent_hangup`, `timeout`, `error`.</ResponseField>
+  <ResponseField name="simulatorAgentName" type="string or null">Simulator agent name.</ResponseField>
+  <ResponseField name="simulatorAgentId" type="string or null">UUID of the simulator agent.</ResponseField>
+  <ResponseField name="agent_definition_used_name" type="string or null">Agent definition name.</ResponseField>
+  <ResponseField name="agent_definition_used_id" type="string or null">UUID of the agent definition.</ResponseField>
+  <ResponseField name="tool_outputs" type="object or null">Tool call outputs from the conversation.</ResponseField>
+  <ResponseField name="rerun_snapshots" type="array">Snapshots from previous reruns.</ResponseField>
+  <ResponseField name="avg_agent_latency" type="number or null">Average agent response latency in seconds. Voice only.</ResponseField>
+  <ResponseField name="user_interruption_count" type="integer or null">User interruption count. Voice only.</ResponseField>
+  <ResponseField name="user_interruption_rate" type="number or null">Proportion of agent turns interrupted by user (0-1). Voice only.</ResponseField>
+  <ResponseField name="user_wpm" type="number or null">User speaking rate in words per minute. Voice only.</ResponseField>
+  <ResponseField name="bot_wpm" type="number or null">Agent speaking rate in words per minute. Voice only.</ResponseField>
+  <ResponseField name="talk_ratio" type="number or null">Agent talk time proportion (0-1). Voice only.</ResponseField>
+  <ResponseField name="ai_interruption_count" type="integer or null">Agent interruption count. Voice only.</ResponseField>
+  <ResponseField name="ai_interruption_rate" type="number or null">Proportion of user turns interrupted by agent (0-1). Voice only.</ResponseField>
+  <ResponseField name="avg_stop_time_after_interruption" type="number or null">Average seconds to stop speaking after interruption. Voice only.</ResponseField>
+  <ResponseField name="total_tokens" type="integer or null">Total tokens consumed. Text only.</ResponseField>
+  <ResponseField name="input_tokens" type="integer or null">Input tokens sent to the model. Text only.</ResponseField>
+  <ResponseField name="output_tokens" type="integer or null">Output tokens generated. Text only.</ResponseField>
+  <ResponseField name="avg_latency_ms" type="number or null">Average response latency in milliseconds. Text only.</ResponseField>
+  <ResponseField name="turn_count" type="integer or null">Total conversation turns. Text only.</ResponseField>
+  <ResponseField name="csat_score" type="number or null">Customer satisfaction score. Text only.</ResponseField>
+  <ResponseField name="stt_cost" type="number or null">Speech-to-text cost in USD. Voice only.</ResponseField>
+  <ResponseField name="llm_cost" type="number or null">LLM inference cost in USD.</ResponseField>
+  <ResponseField name="tts_cost" type="number or null">Text-to-speech cost in USD. Voice only.</ResponseField>
+  <ResponseField name="storage_cost" type="number or null">Storage cost in USD.</ResponseField>
+  <ResponseField name="total_cost" type="number or null">Total cost in USD.</ResponseField>
+</ApiSection>
+
+<ApiSection title="Errors">
+  <ParamField name="401" type="Unauthorized">Invalid or missing credentials.</ParamField>
+  <ParamField name="404" type="Not Found">Call execution not found.</ParamField>
+  <ParamField name="500" type="Internal Server Error">Unexpected server error.</ParamField>
+</ApiSection>
diff --git a/src/pages/docs/api/call-executions/getsessioncomparison.mdx b/src/pages/docs/api/call-executions/getsessioncomparison.mdx
new file mode 100644
index 00000000..9861468a
--- /dev/null
+++ b/src/pages/docs/api/call-executions/getsessioncomparison.mdx
@@ -0,0 +1,84 @@
+---
+title: "Compare execution sessions"
+description: "Compares a call execution with its most recent rerun snapshot."
+---
+
+<ApiPlayground
+  method="GET"
+  endpoint="/simulate/call-executions/{call_execution_id}/session-comparison/"
+  baseUrl="https://api.futureagi.com"
+  parameters={[
+    {"name": "call_execution_id", "in": "path", "required": true, "description": "UUID of the call execution.", "type": "string"}
+  ]}
+  responseExample={{
+    metrics_comparison: {
+      current: { avg_agent_latency: 0.85, talk_ratio: 0.55 },
+      previous: { avg_agent_latency: 1.12, talk_ratio: 0.48 }
+    },
+    transcript_comparison: {
+      current: [
+        { role: "assistant", content: "Hello, how can I help you today?" },
+        { role: "user", content: "I have a billing question." }
+      ],
+      previous: [
+        { role: "assistant", content: "Hi there, what can I do for you?" },
+        { role: "user", content: "I need help with my bill." }
+      ]
+    },
+    recording_urls: {
+      current: "https://storage.example.com/recordings/call-v2.wav",
+      previous: "https://storage.example.com/recordings/call-v1.wav"
+    },
+    eval_comparison: {
+      current: { tone_check: { score: 9 } },
+      previous: { tone_check: { score: 7 } }
+    }
+  }}
+  responseStatus={200}
+  responseStatusText="OK"
+/>
+
+<ApiSection title="Authentication">
+  <ParamField name="X-Api-Key" type="API Key" required>
+    Your Future AGI API key used to authenticate requests. You can find and manage your API keys in the [Dashboard](https://app.futureagi.com) under Settings.
+  </ParamField>
+  <ParamField name="X-Secret-Key" type="Secret Key" required>
+    Your Future AGI secret key, used alongside the API key for request authentication. This is generated when you create an API key in the [Dashboard](https://app.futureagi.com).
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Path parameters">
+  <ParamField path="call_execution_id" type="UUID" required>
+    The call execution ID. Must have at least one rerun snapshot.
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Response" status={200} statusText="OK">
+  <ResponseField name="metrics_comparison" type="object">Performance metrics for current and previous sessions.</ResponseField>
+  <ApiCollapsible title="Show 2 properties">
+    <ResponseField name="current" type="object">Current execution metrics.</ResponseField>
+    <ResponseField name="previous" type="object">Previous rerun snapshot metrics.</ResponseField>
+  </ApiCollapsible>
+  <ResponseField name="transcript_comparison" type="object">Transcripts for current and previous sessions.</ResponseField>
+  <ApiCollapsible title="Show 2 properties">
+    <ResponseField name="current" type="array of objects">Current session transcript with `role` and `content`.</ResponseField>
+    <ResponseField name="previous" type="array of objects">Previous rerun snapshot transcript.</ResponseField>
+  </ApiCollapsible>
+  <ResponseField name="recording_urls" type="object">Audio recording URLs. Voice only.</ResponseField>
+  <ApiCollapsible title="Show 2 properties">
+    <ResponseField name="current" type="string">Current execution recording URL.</ResponseField>
+    <ResponseField name="previous" type="string">Previous rerun snapshot recording URL.</ResponseField>
+  </ApiCollapsible>
+  <ResponseField name="eval_comparison" type="object">Evaluation results for both sessions.</ResponseField>
+  <ApiCollapsible title="Show 2 properties">
+    <ResponseField name="current" type="object">Current execution eval results.</ResponseField>
+    <ResponseField name="previous" type="object">Previous rerun snapshot eval results.</ResponseField>
+  </ApiCollapsible>
+</ApiSection>
+
+<ApiSection title="Errors">
+  <ParamField name="400" type="Bad Request">No rerun snapshot available for comparison.</ParamField>
+  <ParamField name="401" type="Unauthorized">Invalid or missing credentials.</ParamField>
+  <ParamField name="404" type="Not Found">Call execution not found.</ParamField>
+  <ParamField name="500" type="Internal Server Error">Unexpected server error.</ParamField>
+</ApiSection>
diff --git a/src/pages/docs/api/eval-tasks/get-eval-task.mdx b/src/pages/docs/api/eval-tasks/get-eval-task.mdx
index 14bda839..12124d58 100644
--- a/src/pages/docs/api/eval-tasks/get-eval-task.mdx
+++ b/src/pages/docs/api/eval-tasks/get-eval-task.mdx
@@ -53,6 +53,11 @@ description: "Retrieves a specific eval task by ID."
   <ResponseField name="run_type" type="string">Execution mode: `continuous` or `historical`.</ResponseField>
   <ResponseField name="evals" type="array">List of custom eval config UUIDs attached to this task.</ResponseField>
   <ResponseField name="evals_details" type="array">Expanded details for each attached eval config, including `id` and `name`.</ResponseField>
+  <ApiCollapsible title="Show 3 properties">
+    <ResponseField name="id" type="string">UUID of the eval config.</ResponseField>
+    <ResponseField name="name" type="string">Eval config name.</ResponseField>
+    <ResponseField name="template" type="object">Evaluation template info.</ResponseField>
+  </ApiCollapsible>
   <ResponseField name="filters" type="object">Query filters applied to eligible spans. Empty object means all spans.</ResponseField>
   <ResponseField name="failed_spans" type="array">Span IDs that failed during evaluation.</ResponseField>
   <ResponseField name="start_time" type="datetime">When the eval task began executing. `null` if not started.</ResponseField>
diff --git a/src/pages/docs/api/eval-tasks/list-eval-tasks-filtered.mdx b/src/pages/docs/api/eval-tasks/list-eval-tasks-filtered.mdx
index 59de1d09..a490d00d 100644
--- a/src/pages/docs/api/eval-tasks/list-eval-tasks-filtered.mdx
+++ b/src/pages/docs/api/eval-tasks/list-eval-tasks-filtered.mdx
@@ -49,6 +49,16 @@ description: "Returns a paginated list of eval tasks with optional filters."
 <ApiSection title="Response" status={200} statusText="OK">
   <ResponseField name="metadata" type="object">Pagination metadata including `total_rows`.</ResponseField>
   <ResponseField name="table" type="array">Array of eval task objects for the current page.</ResponseField>
+  <ApiCollapsible title="Show 8 properties">
+    <ResponseField name="id" type="string">UUID of the eval task.</ResponseField>
+    <ResponseField name="name" type="string">Task name.</ResponseField>
+    <ResponseField name="status" type="string">Current execution status.</ResponseField>
+    <ResponseField name="filters_applied" type="object">Query filters applied.</ResponseField>
+    <ResponseField name="created_at" type="datetime">ISO 8601 creation timestamp.</ResponseField>
+    <ResponseField name="evals_applied" type="integer">Number of eval configs attached.</ResponseField>
+    <ResponseField name="sampling_rate" type="number">Percentage of spans evaluated.</ResponseField>
+    <ResponseField name="last_run" type="datetime">Most recent evaluation cycle.</ResponseField>
+  </ApiCollapsible>
   <ResponseField name="config" type="object">Table column configuration metadata.</ResponseField>
 </ApiSection>
 
diff --git a/src/pages/docs/api/eval-tasks/update-eval-task.mdx b/src/pages/docs/api/eval-tasks/update-eval-task.mdx
index 9cc51c69..4abc7033 100644
--- a/src/pages/docs/api/eval-tasks/update-eval-task.mdx
+++ b/src/pages/docs/api/eval-tasks/update-eval-task.mdx
@@ -5,10 +5,11 @@ description: "Partially updates an eval task's configuration."
 
 <ApiPlayground
   method="PATCH"
-  endpoint="/tracer/eval-task/{id}/"
+  endpoint="/tracer/eval-task/update_eval_task/"
   baseUrl="https://api.futureagi.com"
-  parameters={[{"name": "id", "in": "path", "required": true, "description": "UUID of the eval task to update.", "type": "string"}]}
   requestBody={{
+    eval_task_id: "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
+    edit_type: "edit_rerun",
     name: "updated-task-name",
     sampling_rate: 50.0
   }}
@@ -31,21 +32,23 @@ description: "Partially updates an eval task's configuration."
   </ParamField>
 </ApiSection>
 
-<ApiSection title="Path parameters">
-  <ParamField path="id" type="UUID" required>
-    The eval task ID. Task must not be in `running` state.
-  </ParamField>
-</ApiSection>
-
 <ApiSection title="Request body">
   Only included fields are updated. Omitted fields retain their current values.
 
+  <ParamField body="eval_task_id" type="string" required>
+    UUID of the eval task. Must not be `running` or `deleted`.
+  </ParamField>
+
+  <ParamField body="edit_type" type="string" required>
+    Update mode. Values: `"fresh_run"` (clears all previous results), `"edit_rerun"` (preserves existing results, runs missing evals only).
+  </ParamField>
+
   <ParamField body="name" type="string" optional>
-    Updated name. Must be 1–255 characters.
+    Updated name. 1-255 characters.
   </ParamField>
 
   <ParamField body="evals" type="array" optional>
-    Updated list of custom eval config UUIDs. Replaces the existing list entirely. Must contain at least one valid config.
+    Updated list of custom eval config UUIDs. Replaces the existing list.
   </ParamField>
 
   <ParamField body="sampling_rate" type="number" optional>
@@ -53,15 +56,15 @@ description: "Partially updates an eval task's configuration."
   </ParamField>
 
   <ParamField body="run_type" type="string" optional>
-    Updated execution mode: `"continuous"` or `"historical"`.
+    Updated execution mode. Values: `"continuous"`, `"historical"`.
   </ParamField>
 
   <ParamField body="spans_limit" type="integer" optional>
-    Updated max spans to evaluate. Required when `run_type` is `"historical"`. Accepts `1`–`1000000`.
+    Updated max spans. Required for `"historical"` run type. Range: `1`-`1000000`.
   </ParamField>
 
   <ParamField body="filters" type="object" optional>
-    Updated query filters. Pass `{}` to clear all filters.
+    Updated query filters. Pass `null` to clear.
   </ParamField>
 </ApiSection>
 
diff --git a/src/pages/docs/api/index.mdx b/src/pages/docs/api/index.mdx
index caa16b95..1210d193 100644
--- a/src/pages/docs/api/index.mdx
+++ b/src/pages/docs/api/index.mdx
@@ -50,10 +50,10 @@ Get your API key from the [Future AGI Dashboard](https://app.futureagi.com/setti
   <Card title="Run Tests" href="/docs/api/run-tests/createruntest" icon="code">
     Test execution management
   </Card>
-  <Card title="Test Executions" href="/docs/api/test-executions" icon="code">
+  <Card title="Test Executions" href="/docs/api/test-executions/gettestexecutiondetails" icon="code">
     Test execution tracking and analytics
   </Card>
-  <Card title="Call Executions" href="/docs/api/call-executions" icon="code">
+  <Card title="Call Executions" href="/docs/api/call-executions/getcallexecutiondetails" icon="code">
     Individual call execution details
   </Card>
   <Card title="Call Transcripts" href="/docs/api/call-transcripts" icon="code">
@@ -110,6 +110,9 @@ Get your API key from the [Future AGI Dashboard](https://app.futureagi.com/setti
   <Card title="Eval Configuration" href="/docs/api/eval-configuration" icon="code">
     Evaluation configuration and templates retrieval
   </Card>
+  <Card title="Prompt Simulations" href="/docs/api/prompt-simulations/listscenarios" icon="code">
+    Prompt simulation scenarios, runs, and execution
+  </Card>
   <Card title="API Keys" href="/docs/api/api-keys" icon="code">
     API key management
   </Card>
diff --git a/src/pages/docs/api/personas/createpersona.mdx b/src/pages/docs/api/personas/createpersona.mdx
new file mode 100644
index 00000000..49d84fd0
--- /dev/null
+++ b/src/pages/docs/api/personas/createpersona.mdx
@@ -0,0 +1,148 @@
+---
+title: "Create persona"
+description: "Creates a new workspace-level persona with configurable attributes for voice or text simulation testing."
+---
+
+<ApiPlayground
+  method="POST"
+  endpoint="/simulate/api/personas/"
+  baseUrl="https://api.futureagi.com"
+  requestBody={{
+    name: "Skeptical Customer",
+    description: "A cautious customer who asks many questions",
+    gender: ["female"],
+    ageGroup: ["32-40"],
+    personality: ["Cautious and skeptical"],
+    communicationStyle: ["Questioning"],
+    simulationType: "voice"
+  }}
+  responseExample={{
+    status: "success",
+    result: {
+      id: "550e8400-e29b-41d4-a716-446655440000",
+      name: "Skeptical Customer",
+      description: "A cautious customer who asks many questions",
+      persona_type: "workspace",
+      gender: ["female"],
+      ageGroup: ["32-40"],
+      personality: ["Cautious and skeptical"],
+      communicationStyle: ["Questioning"],
+      simulationType: "voice",
+      created_at: "2026-04-04T12:00:00Z",
+      updated_at: "2026-04-04T12:00:00Z"
+    }
+  }}
+  responseStatus={201}
+  responseStatusText="Created"
+/>
+
+<ApiSection title="Authentication">
+  <ParamField name="X-Api-Key" type="string" required>
+    Your Future AGI API key used to authenticate requests. You can find and manage your API keys in the [Dashboard](https://app.futureagi.com) under Settings.
+  </ParamField>
+  <ParamField name="X-Secret-Key" type="string" required>
+    Your Future AGI secret key, used alongside the API key for request authentication. This is generated when you create an API key in the [Dashboard](https://app.futureagi.com).
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Request body">
+  <ParamField body="name" type="string" required>
+    A human-readable name for the persona. Must be unique within your workspace and must not conflict with any system-level persona names. The comparison is case-insensitive, so `"Friendly Agent"` and `"friendly agent"` are treated as duplicates. Maximum 255 characters.
+  </ParamField>
+  <ParamField body="description" type="string" required>
+    A non-empty description that explains the persona's role, behavior, and characteristics. This description helps team members understand the persona's purpose and is displayed in the dashboard when browsing personas.
+  </ParamField>
+  <ParamField body="simulationType" type="string" optional>
+    The type of simulation this persona is designed for. Accepted values: `voice` or `text`. Defaults to `voice`. This determines whether the persona will be used in voice-based call simulations or text-based simulations, and influences which attributes (such as `accent` and `conversationSpeed`) are relevant.
+  </ParamField>
+  <ParamField body="gender" type="array of string" optional>
+    An array specifying the gender characteristics of the persona. Accepted values: `male`, `female`. You can include one or both values to create a persona that can operate with either gender in simulations.
+  </ParamField>
+  <ParamField body="ageGroup" type="array of string" optional>
+    An array of age range brackets that define the persona's demographic. Accepted values: `18-25`, `25-32`, `32-40`, `40-50`, `50-60`, `60+`. Multiple values can be provided to represent a persona that spans multiple age groups.
+  </ParamField>
+  <ParamField body="location" type="array of string" optional>
+    An array of geographic locations associated with the persona. Accepted values: `United States`, `Canada`, `United Kingdom`, `Australia`, `India`. These influence the persona's cultural context and regional speech patterns during simulation.
+  </ParamField>
+  <ParamField body="profession" type="array of string" optional>
+    An array of professional roles that define the persona's occupational background. Accepted values: `Student`, `Teacher`, `Engineer`, `Doctor`, `Nurse`, `Business Owner`, `Manager`, `Sales Representative`, `Customer Service`, `Technician`, `Consultant`, `Accountant`, `Marketing Professional`, `Retired`, `Homemaker`, `Freelancer`, `Other`. The profession influences the persona's vocabulary, expectations, and communication patterns.
+  </ParamField>
+  <ParamField body="personality" type="array of string" optional>
+    An array of personality traits that shape how the persona behaves during conversations. Accepted values: `Friendly and cooperative`, `Professional and formal`, `Cautious and skeptical`, `Impatient and direct`, `Detail-oriented`, `Easy-going`, `Anxious`, `Confident`, `Analytical`, `Emotional`, `Reserved`, `Talkative`. Multiple traits can be combined to create nuanced persona behaviors.
+  </ParamField>
+  <ParamField body="communicationStyle" type="array of string" optional>
+    An array of communication style descriptors that control how the persona expresses itself. Accepted values: `Direct and concise`, `Detailed and elaborate`, `Casual and friendly`, `Formal and polite`, `Technical`, `Simple and clear`, `Questioning`, `Assertive`, `Passive`, `Collaborative`. These styles affect sentence structure, word choice, and conversational flow.
+  </ParamField>
+  <ParamField body="accent" type="array of string" optional>
+    An array of accent options for voice simulations. Accepted values: `American`, `Australian`, `Indian`, `Canadian`, `Neutral`. This field is primarily relevant when `simulationType` is `voice` and controls the speech accent used during call simulations.
+  </ParamField>
+  <ParamField body="multilingual" type="boolean" optional>
+    Enables multi-language support for the persona. When set to `true`, the `language` field becomes required and the persona can switch between the specified languages during simulation. Defaults to `false`.
+  </ParamField>
+  <ParamField body="language" type="array of string" optional>
+    An array of languages the persona can communicate in. Accepted values: `English`, `Hindi`. This field is required when `multilingual` is set to `true`. If `multilingual` is `false` or omitted, this field is ignored.
+  </ParamField>
+  <ParamField body="conversationSpeed" type="array of string" optional>
+    An array of conversation speed multipliers that control the pace of the persona's speech. Accepted values: `0.5`, `0.75`, `1.0`, `1.25`, `1.5`. A value of `1.0` represents normal speed, values below `1.0` are slower, and values above `1.0` are faster. Primarily relevant for voice simulations.
+  </ParamField>
+  <ParamField body="backgroundSound" type="boolean" optional>
+    Controls whether background sounds are included during voice simulations with this persona. When enabled, ambient noise is added to create a more realistic simulation environment.
+  </ParamField>
+  <ParamField body="finishedSpeakingSensitivity" type="array of integer" optional>
+    An array of integer values from `1` to `10` that control how sensitive the system is to detecting when the persona has finished speaking. Higher values make the system more responsive to pauses, while lower values require longer silence before the agent responds. Relevant for voice simulations.
+  </ParamField>
+  <ParamField body="interruptSensitivity" type="array of integer" optional>
+    An array of integer values from `1` to `10` that control how easily the persona can be interrupted during speech. Higher values make the persona easier to interrupt, simulating more natural conversational dynamics. Relevant for voice simulations.
+  </ParamField>
+  <ParamField body="keywords" type="array of string" optional>
+    An array of keywords or tags associated with the persona. These keywords are searchable and help categorize and discover personas when browsing or filtering in the dashboard.
+  </ParamField>
+  <ParamField body="customProperties" type="object" optional>
+    A key-value object for attaching arbitrary metadata to the persona. Both keys and values must be non-empty strings. Use this to store custom attributes that are not covered by the standard fields, such as internal identifiers or domain-specific labels.
+  </ParamField>
+  <ParamField body="additionalInstruction" type="string" optional>
+    Free-form text providing extra behavioral instructions for the persona. Use this field to specify nuanced behaviors, edge cases, or specific conversational patterns that are not captured by the predefined attribute fields. These instructions are passed directly to the simulation engine.
+  </ParamField>
+  <ParamField body="tone" type="string" optional>
+    The overall tone of the persona's communication. Accepted values: `formal`, `casual`, `neutral`. Defaults to `casual`. This influences word choice, sentence structure, and the general register of the persona's language.
+  </ParamField>
+  <ParamField body="punctuation" type="string" optional>
+    The punctuation style used in the persona's text output. Accepted values: `clean` (standard punctuation), `minimal` (reduced punctuation), `expressive` (heavy use of exclamation marks, ellipses, etc.), `erratic` (inconsistent punctuation). Defaults to `clean`. Primarily relevant for chat simulations.
+  </ParamField>
+  <ParamField body="slangUsage" type="string" optional>
+    Controls the degree of slang and informal language the persona uses. Accepted values: `none`, `moderate`, `heavy`, `light`. Defaults to `light`. Higher levels of slang create a more casual, colloquial persona.
+  </ParamField>
+  <ParamField body="typosFrequency" type="string" optional>
+    Controls how often the persona introduces typographical errors into text output. Accepted values: `none`, `rare`, `occasional`, `frequent`. Defaults to `rare`. This creates more realistic user-like behavior in chat simulations.
+  </ParamField>
+  <ParamField body="regionalMix" type="string" optional>
+    Controls the degree of regional language variation in the persona's output. Accepted values: `none`, `moderate`, `heavy`, `light`. Defaults to `light`. Higher values introduce more region-specific vocabulary, idioms, and phrasing.
+  </ParamField>
+  <ParamField body="emojiUsage" type="string" optional>
+    Controls how frequently the persona uses emojis in text output. Accepted values: `never`, `light`, `regular`, `heavy`. Defaults to `light`. Primarily relevant for chat simulations where emoji usage affects the perceived personality.
+  </ParamField>
+  <ParamField body="verbosity" type="string" optional>
+    Controls the length and detail level of the persona's responses. Accepted values: `brief` (short, concise responses), `balanced` (moderate detail), `detailed` (longer, more elaborate responses). Defaults to `balanced`.
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Response" status={201} statusText="Created">
+  <ResponseField name="status" type="string">
+    Indicates the outcome of the request. Returns `"success"` when the persona is created successfully.
+  </ResponseField>
+  <ResponseField name="result" type="object">
+    The full persona object including the server-generated `id` (UUID), `persona_type` set to `"workspace"`, and all attributes provided in the request body along with `created_at` and `updated_at` timestamps.
+  </ResponseField>
+</ApiSection>
+
+<ApiSection title="Errors">
+  <ParamField name="400" type="Bad Request">
+    The request payload is invalid. This can occur when required fields (`name`, `description`) are missing or empty, when the persona name already exists in your workspace or conflicts with a system persona name (case-insensitive), when `multilingual` is set to `true` but no `language` array is provided, or when any field contains a value outside the allowed choices. Review the response body for specific field-level validation errors.
+  </ParamField>
+  <ParamField name="401" type="Unauthorized">
+    Authentication credentials were not provided or are invalid. Ensure that both `X-Api-Key` and `X-Secret-Key` headers are included in your request and contain valid, non-expired keys. Verify your API keys in the [Dashboard](https://app.futureagi.com) under Settings.
+  </ParamField>
+  <ParamField name="500" type="Internal Server Error">
+    An unexpected error occurred on the server while processing the request. This is not caused by your input. If this error persists, contact Future AGI support with the request details and timestamp for investigation.
+  </ParamField>
+</ApiSection>
diff --git a/src/pages/docs/api/personas/deletepersona.mdx b/src/pages/docs/api/personas/deletepersona.mdx
new file mode 100644
index 00000000..f568d06c
--- /dev/null
+++ b/src/pages/docs/api/personas/deletepersona.mdx
@@ -0,0 +1,60 @@
+---
+title: "Delete persona"
+description: "Soft-deletes a workspace-level persona. System personas cannot be deleted."
+---
+
+<ApiPlayground
+  method="DELETE"
+  endpoint="/simulate/api/personas/{persona_id}/"
+  baseUrl="https://api.futureagi.com"
+  parameters={[
+    {"name": "persona_id", "in": "path", "required": true, "description": "UUID of the persona to delete.", "type": "string"}
+  ]}
+  responseExample={{
+    status: "success",
+    result: {
+      message: "Persona deleted successfully"
+    }
+  }}
+  responseStatus={204}
+  responseStatusText="No Content"
+/>
+
+<ApiSection title="Authentication">
+  <ParamField name="X-Api-Key" type="string" required>
+    Your Future AGI API key used to authenticate requests. You can find and manage your API keys in the [Dashboard](https://app.futureagi.com) under Settings.
+  </ParamField>
+  <ParamField name="X-Secret-Key" type="string" required>
+    Your Future AGI secret key, used alongside the API key for request authentication. This is generated when you create an API key in the [Dashboard](https://app.futureagi.com).
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Path parameters">
+  <ParamField path="persona_id" type="string" required>
+    The UUID of the persona to delete. The persona must be a workspace-level (custom) persona that belongs to your organization. System (prebuilt) personas cannot be deleted. The persona is soft-deleted, meaning it is marked as deleted and excluded from future listings but is not permanently removed from the database. You can retrieve persona IDs from the [List personas](/docs/api/personas/listpersonas) endpoint.
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Response" status={204} statusText="No Content">
+  <ResponseField name="status" type="string">
+    Indicates the outcome of the request. Returns `"success"` when the persona is soft-deleted successfully.
+  </ResponseField>
+  <ResponseField name="result" type="object">
+    An object containing a `message` field with a confirmation string such as `"Persona deleted successfully"`.
+  </ResponseField>
+</ApiSection>
+
+<ApiSection title="Errors">
+  <ParamField name="401" type="Unauthorized">
+    Authentication credentials were not provided or are invalid. Ensure that both `X-Api-Key` and `X-Secret-Key` headers are included in your request and contain valid, non-expired keys. Verify your API keys in the [Dashboard](https://app.futureagi.com) under Settings.
+  </ParamField>
+  <ParamField name="403" type="Forbidden">
+    The specified persona is a system-level (prebuilt) persona and cannot be deleted. System personas are managed by Future AGI and are available to all workspaces. Only workspace-level personas created by your team can be deleted.
+  </ParamField>
+  <ParamField name="404" type="Not Found">
+    The persona with the specified UUID could not be found. Verify that the `persona_id` is correct and that the persona has not already been deleted. You can retrieve valid persona IDs from the [List personas](/docs/api/personas/listpersonas) endpoint.
+  </ParamField>
+  <ParamField name="500" type="Internal Server Error">
+    An unexpected error occurred on the server while processing the request. This is not caused by your input. If this error persists, contact Future AGI support with the request details and timestamp for investigation.
+  </ParamField>
+</ApiSection>
diff --git a/src/pages/docs/api/personas/duplicatepersona.mdx b/src/pages/docs/api/personas/duplicatepersona.mdx
new file mode 100644
index 00000000..29dd69c5
--- /dev/null
+++ b/src/pages/docs/api/personas/duplicatepersona.mdx
@@ -0,0 +1,78 @@
+---
+title: "Duplicate persona"
+description: "Creates a copy of an existing persona as a new workspace-level persona with a custom name."
+---
+
+<ApiPlayground
+  method="POST"
+  endpoint="/simulate/api/personas/duplicate/{persona_id}/"
+  baseUrl="https://api.futureagi.com"
+  parameters={[
+    {"name": "persona_id", "in": "path", "required": true, "description": "UUID of the source persona to duplicate.", "type": "string"}
+  ]}
+  requestBody={{
+    name: "My Custom Persona Copy"
+  }}
+  responseExample={{
+    status: "success",
+    result: {
+      id: "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
+      name: "My Custom Persona Copy",
+      persona_type: "workspace",
+      description: "A cautious customer who asks many questions",
+      gender: ["female"],
+      ageGroup: ["32-40"],
+      personality: ["Cautious and skeptical"],
+      simulationType: "voice",
+      created_at: "2026-04-04T14:00:00Z",
+      updated_at: "2026-04-04T14:00:00Z"
+    }
+  }}
+  responseStatus={201}
+  responseStatusText="Created"
+/>
+
+<ApiSection title="Authentication">
+  <ParamField name="X-Api-Key" type="string" required>
+    Your Future AGI API key used to authenticate requests. You can find and manage your API keys in the [Dashboard](https://app.futureagi.com) under Settings.
+  </ParamField>
+  <ParamField name="X-Secret-Key" type="string" required>
+    Your Future AGI secret key, used alongside the API key for request authentication. This is generated when you create an API key in the [Dashboard](https://app.futureagi.com).
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Path parameters">
+  <ParamField path="persona_id" type="string" required>
+    The UUID of the source persona to duplicate. This can be either a system-level (prebuilt) persona or a workspace-level (custom) persona. All attributes from the source persona are copied to the new persona except the name, which must be provided in the request body. The new persona is always created as a workspace-level persona regardless of the source persona's type.
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Request body">
+  <ParamField body="name" type="string" required>
+    The name for the duplicated persona. Must be unique within your workspace and must not conflict with any existing system or workspace persona names. The comparison is case-insensitive. Maximum 255 characters. Choose a descriptive name that distinguishes this copy from the original persona.
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Response" status={201} statusText="Created">
+  <ResponseField name="status" type="string">
+    Indicates the outcome of the request. Returns `"success"` when the persona is duplicated successfully.
+  </ResponseField>
+  <ResponseField name="result" type="object">
+    The full persona object of the newly created copy. All attributes are inherited from the source persona except `name` (set to the provided value), `id` (a new UUID), and `persona_type` (always set to `"workspace"`). Includes `created_at` and `updated_at` timestamps reflecting the creation time of the copy.
+  </ResponseField>
+</ApiSection>
+
+<ApiSection title="Errors">
+  <ParamField name="400" type="Bad Request">
+    The request payload is invalid. This can occur when the `name` field is missing or empty, when the provided name already exists as a persona in your workspace (case-insensitive), or when the organization context could not be determined from the request. Review the response body for specific validation error details.
+  </ParamField>
+  <ParamField name="401" type="Unauthorized">
+    Authentication credentials were not provided or are invalid. Ensure that both `X-Api-Key` and `X-Secret-Key` headers are included in your request and contain valid, non-expired keys. Verify your API keys in the [Dashboard](https://app.futureagi.com) under Settings.
+  </ParamField>
+  <ParamField name="404" type="Not Found">
+    The source persona with the specified UUID could not be found. Verify that the `persona_id` is correct and that the source persona has not been deleted. You can retrieve valid persona IDs from the [List personas](/docs/api/personas/listpersonas) endpoint.
+  </ParamField>
+  <ParamField name="500" type="Internal Server Error">
+    An unexpected error occurred on the server while processing the request. This is not caused by your input. If this error persists, contact Future AGI support with the request details and timestamp for investigation.
+  </ParamField>
+</ApiSection>
diff --git a/src/pages/docs/api/personas/listpersonas.mdx b/src/pages/docs/api/personas/listpersonas.mdx
new file mode 100644
index 00000000..f6c02ff0
--- /dev/null
+++ b/src/pages/docs/api/personas/listpersonas.mdx
@@ -0,0 +1,147 @@
+---
+title: "List personas"
+description: "Retrieves a paginated list of personas, including system-level and workspace-level personas, with optional filtering by type, search, and simulation type."
+---
+
+<ApiPlayground
+  method="GET"
+  endpoint="/simulate/api/personas/"
+  baseUrl="https://api.futureagi.com"
+  parameters={[
+    {"name": "type", "in": "query", "required": false, "description": "Filter by persona type: prebuilt or custom.", "type": "string"},
+    {"name": "search", "in": "query", "required": false, "description": "Search by name, description, or keywords.", "type": "string"},
+    {"name": "simulation_type", "in": "query", "required": false, "description": "Filter by simulation type: voice or text.", "type": "string"},
+    {"name": "limit", "in": "query", "required": false, "description": "Number of results per page.", "type": "integer"},
+    {"name": "page", "in": "query", "required": false, "description": "Page number for pagination.", "type": "integer"}
+  ]}
+  responseExample={{
+    count: 25,
+    next: "https://api.futureagi.com/simulate/api/personas/?page=2&limit=10",
+    previous: null,
+    total_pages: 3,
+    current_page: 1,
+    results: [
+      {
+        id: "550e8400-e29b-41d4-a716-446655440000",
+        name: "Skeptical Customer",
+        description: "A cautious customer who asks many questions",
+        persona_type: "workspace",
+        persona_type_display: "Custom",
+        gender: ["female"],
+        age_group: ["32-40"],
+        personality: ["Cautious and skeptical"],
+        communication_style: ["Questioning"],
+        simulation_type: "voice",
+        is_default: false,
+        created_at: "2026-04-04T12:00:00Z",
+        updated_at: "2026-04-04T12:00:00Z"
+      }
+    ]
+  }}
+  responseStatus={200}
+  responseStatusText="OK"
+/>
+
+<ApiSection title="Authentication">
+  <ParamField name="X-Api-Key" type="string" required>
+    Your Future AGI API key used to authenticate requests. You can find and manage your API keys in the [Dashboard](https://app.futureagi.com) under Settings.
+  </ParamField>
+  <ParamField name="X-Secret-Key" type="string" required>
+    Your Future AGI secret key, used alongside the API key for request authentication. This is generated when you create an API key in the [Dashboard](https://app.futureagi.com).
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Query parameters">
+  <ParamField query="type" type="string" optional>
+    Filter personas by their origin type. Accepted values: `prebuilt` (returns system-level personas that are pre-configured and available to all workspaces) or `custom` (returns workspace-level personas that were created by your team). When omitted, both types are returned.
+  </ParamField>
+  <ParamField query="search" type="string" optional>
+    A case-insensitive search query that matches against the persona's name, description, and keywords. For example, searching `"skeptical"` returns personas named `"Skeptical Customer"`, personas with `"skeptical"` in their description, etc.
+  </ParamField>
+  <ParamField query="simulation_type" type="string" optional>
+    Filter personas by the type of simulation they are designed for. Accepted values: `voice` (returns personas configured for voice call simulations) or `text` (returns personas configured for text-based simulations). When omitted, personas of both simulation types are returned.
+  </ParamField>
+  <ParamField query="limit" type="integer" optional>
+    The number of personas to return per page. Defaults to `10`. Use this in combination with `page` to paginate through large result sets.
+  </ParamField>
+  <ParamField query="page" type="integer" optional>
+    The page number to retrieve, starting from `1`. Defaults to `1`. Use in conjunction with `limit` to navigate through paginated results.
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Response" status={200} statusText="OK">
+  <ResponseField name="count" type="integer">
+    The total number of personas matching the applied filters across all pages. Use this value to calculate the total number of pages in combination with the `limit` parameter.
+  </ResponseField>
+  <ResponseField name="next" type="string">
+    The full URL of the next page of results. Returns `null` if the current page is the last page.
+  </ResponseField>
+  <ResponseField name="previous" type="string">
+    The full URL of the previous page of results. Returns `null` if the current page is the first page.
+  </ResponseField>
+  <ResponseField name="total_pages" type="integer">
+    The total number of pages available based on the current `limit` setting and the total `count` of matching personas.
+  </ResponseField>
+  <ResponseField name="current_page" type="integer">
+    The current page number being returned in this response.
+  </ResponseField>
+  <ResponseField name="results" type="array of object">
+    An array of persona objects for the current page.
+  </ResponseField>
+  <ApiCollapsible title="Show 15 properties">
+    <ResponseField name="id" type="string">
+      The unique identifier (UUID) of the persona.
+    </ResponseField>
+    <ResponseField name="name" type="string">
+      The display name of the persona.
+    </ResponseField>
+    <ResponseField name="description" type="string">
+      A text description of the persona's characteristics and behavior.
+    </ResponseField>
+    <ResponseField name="persona_type" type="string">
+      The origin type of the persona: `system` (pre-configured, available to all workspaces) or `workspace` (custom, created by your team).
+    </ResponseField>
+    <ResponseField name="persona_type_display" type="string">
+      A human-readable label for the persona type (e.g., "Prebuilt" or "Custom").
+    </ResponseField>
+    <ResponseField name="gender" type="array">
+      An array of gender attributes assigned to the persona.
+    </ResponseField>
+    <ResponseField name="age_group" type="array">
+      An array of age group ranges assigned to the persona.
+    </ResponseField>
+    <ResponseField name="occupation" type="array">
+      An array of occupation descriptors assigned to the persona.
+    </ResponseField>
+    <ResponseField name="location" type="array">
+      An array of location descriptors assigned to the persona.
+    </ResponseField>
+    <ResponseField name="personality" type="array">
+      An array of personality trait descriptors for the persona.
+    </ResponseField>
+    <ResponseField name="communication_style" type="array">
+      An array of communication style descriptors for the persona.
+    </ResponseField>
+    <ResponseField name="simulation_type" type="string">
+      The type of simulation the persona is designed for: `voice` or `text`.
+    </ResponseField>
+    <ResponseField name="is_default" type="boolean">
+      Whether this is a default persona that is automatically selected when no specific persona is chosen.
+    </ResponseField>
+    <ResponseField name="created_at" type="string">
+      ISO 8601 timestamp of when the persona was created.
+    </ResponseField>
+    <ResponseField name="updated_at" type="string">
+      ISO 8601 timestamp of the most recent modification to the persona.
+    </ResponseField>
+  </ApiCollapsible>
+</ApiSection>
+
+<ApiSection title="Errors">
+  <ParamField name="401" type="Unauthorized">
+    Authentication credentials were not provided or are invalid. Ensure that both `X-Api-Key` and `X-Secret-Key` headers are included in your request and contain valid, non-expired keys. Verify your API keys in the [Dashboard](https://app.futureagi.com) under Settings.
+  </ParamField>
+  <ParamField name="500" type="Internal Server Error">
+    An unexpected error occurred on the server while processing the request. This is not caused by your input. If this error persists, contact Future AGI support with the request details and timestamp for investigation.
+  </ParamField>
+</ApiSection>
diff --git a/src/pages/docs/api/personas/updatepersona.mdx b/src/pages/docs/api/personas/updatepersona.mdx
new file mode 100644
index 00000000..4f8679b2
--- /dev/null
+++ b/src/pages/docs/api/personas/updatepersona.mdx
@@ -0,0 +1,137 @@
+---
+title: "Update persona"
+description: "Partially updates a workspace-level persona. System personas cannot be modified."
+---
+
+<ApiPlayground
+  method="PATCH"
+  endpoint="/simulate/api/personas/{persona_id}/"
+  baseUrl="https://api.futureagi.com"
+  parameters={[
+    {"name": "persona_id", "in": "path", "required": true, "description": "UUID of the persona to update.", "type": "string"}
+  ]}
+  requestBody={{
+    name: "Updated Persona Name",
+    description: "Updated description"
+  }}
+  responseExample={{
+    status: "success",
+    result: {
+      id: "550e8400-e29b-41d4-a716-446655440000",
+      name: "Updated Persona Name",
+      description: "Updated description",
+      persona_type: "workspace",
+      personality: ["Confident", "Analytical"],
+      tone: "formal",
+      created_at: "2026-04-04T12:00:00Z",
+      updated_at: "2026-04-04T14:30:00Z"
+    }
+  }}
+  responseStatus={200}
+  responseStatusText="OK"
+/>
+
+<ApiSection title="Authentication">
+  <ParamField name="X-Api-Key" type="string" required>
+    Your Future AGI API key used to authenticate requests. You can find and manage your API keys in the [Dashboard](https://app.futureagi.com) under Settings.
+  </ParamField>
+  <ParamField name="X-Secret-Key" type="string" required>
+    Your Future AGI secret key, used alongside the API key for request authentication. This is generated when you create an API key in the [Dashboard](https://app.futureagi.com).
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Path parameters">
+  <ParamField path="persona_id" type="string" required>
+    The UUID of the persona to update. The persona must be a workspace-level (custom) persona that belongs to your organization. System (prebuilt) personas cannot be modified through this endpoint. You can retrieve persona IDs from the [List personas](/docs/api/personas/listpersonas) endpoint.
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Request body">
+  <ParamField body="name" type="string" optional>
+    A new name for the persona. Must be unique within your workspace and must not conflict with system persona names (case-insensitive comparison). Maximum 255 characters. Only the fields you include in the request body will be updated; omitted fields retain their current values.
+  </ParamField>
+  <ParamField body="description" type="string" optional>
+    An updated description explaining the persona's role, behavior, and characteristics. Must be a non-empty string if provided.
+  </ParamField>
+  <ParamField body="gender" type="array of string" optional>
+    Updated gender characteristics. Accepted values: `male`, `female`. Replaces the existing gender list entirely when provided.
+  </ParamField>
+  <ParamField body="ageGroup" type="array of string" optional>
+    Updated age range brackets. Accepted values: `18-25`, `25-32`, `32-40`, `40-50`, `50-60`, `60+`. Replaces the existing age group list entirely when provided.
+  </ParamField>
+  <ParamField body="location" type="array of string" optional>
+    Updated geographic locations. Accepted values: `United States`, `Canada`, `United Kingdom`, `Australia`, `India`. Replaces the existing location list entirely when provided.
+  </ParamField>
+  <ParamField body="personality" type="array of string" optional>
+    Updated personality traits. Accepted values: `Friendly and cooperative`, `Professional and formal`, `Cautious and skeptical`, `Impatient and direct`, `Detail-oriented`, `Easy-going`, `Anxious`, `Confident`, `Analytical`, `Emotional`, `Reserved`, `Talkative`. Replaces the existing personality list entirely when provided.
+  </ParamField>
+  <ParamField body="communicationStyle" type="array of string" optional>
+    Updated communication style descriptors. Accepted values: `Direct and concise`, `Detailed and elaborate`, `Casual and friendly`, `Formal and polite`, `Technical`, `Simple and clear`, `Questioning`, `Assertive`, `Passive`, `Collaborative`. Replaces the existing communication style list entirely when provided.
+  </ParamField>
+  <ParamField body="accent" type="array of string" optional>
+    Updated accent options for voice simulations. Accepted values: `American`, `Australian`, `Indian`, `Canadian`, `Neutral`. Replaces the existing accent list entirely when provided.
+  </ParamField>
+  <ParamField body="multilingual" type="boolean" optional>
+    Enables or disables multi-language support. When set to `true`, the `language` field must also be provided with at least one language.
+  </ParamField>
+  <ParamField body="language" type="array of string" optional>
+    Updated language options. Accepted values: `English`, `Hindi`. Required when `multilingual` is `true`.
+  </ParamField>
+  <ParamField body="keywords" type="array of string" optional>
+    Updated keywords or tags for the persona. Used for search and categorization in the dashboard. Replaces the existing keywords list entirely when provided.
+  </ParamField>
+  <ParamField body="customProperties" type="object" optional>
+    Updated key-value metadata. Both keys and values must be non-empty strings. Replaces the existing custom properties object entirely when provided.
+  </ParamField>
+  <ParamField body="additionalInstruction" type="string" optional>
+    Updated free-form behavioral instructions passed to the simulation engine.
+  </ParamField>
+  <ParamField body="tone" type="string" optional>
+    Updated tone setting. Accepted values: `formal`, `casual`, `neutral`.
+  </ParamField>
+  <ParamField body="punctuation" type="string" optional>
+    Updated punctuation style. Accepted values: `clean`, `minimal`, `expressive`, `erratic`.
+  </ParamField>
+  <ParamField body="slangUsage" type="string" optional>
+    Updated slang usage level. Accepted values: `none`, `moderate`, `heavy`, `light`.
+  </ParamField>
+  <ParamField body="typosFrequency" type="string" optional>
+    Updated typo frequency. Accepted values: `none`, `rare`, `occasional`, `frequent`.
+  </ParamField>
+  <ParamField body="regionalMix" type="string" optional>
+    Updated regional language mix level. Accepted values: `none`, `moderate`, `heavy`, `light`.
+  </ParamField>
+  <ParamField body="emojiUsage" type="string" optional>
+    Updated emoji usage frequency. Accepted values: `never`, `light`, `regular`, `heavy`.
+  </ParamField>
+  <ParamField body="verbosity" type="string" optional>
+    Updated response length preference. Accepted values: `brief`, `balanced`, `detailed`.
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Response" status={200} statusText="OK">
+  <ResponseField name="status" type="string">
+    Indicates the outcome of the request. Returns `"success"` when the persona is updated successfully.
+  </ResponseField>
+  <ResponseField name="result" type="object">
+    The full updated persona object, including all current attribute values (both changed and unchanged fields), along with the `id`, `persona_type`, `created_at`, and `updated_at` timestamps reflecting the update.
+  </ResponseField>
+</ApiSection>
+
+<ApiSection title="Errors">
+  <ParamField name="400" type="Bad Request">
+    The request payload contains invalid field values. This can occur when the `name` conflicts with an existing persona in your workspace or a system persona, when field values are outside the allowed choices, or when `multilingual` is `true` but `language` is missing. Review the response body for specific validation errors.
+  </ParamField>
+  <ParamField name="401" type="Unauthorized">
+    Authentication credentials were not provided or are invalid. Ensure that both `X-Api-Key` and `X-Secret-Key` headers are included in your request and contain valid, non-expired keys. Verify your API keys in the [Dashboard](https://app.futureagi.com) under Settings.
+  </ParamField>
+  <ParamField name="403" type="Forbidden">
+    The specified persona is a system-level (prebuilt) persona and cannot be modified. Only workspace-level personas created by your team can be updated through this endpoint. To customize a system persona, use the [Duplicate persona](/docs/api/personas/duplicatepersona) endpoint to create a workspace-level copy first.
+  </ParamField>
+  <ParamField name="404" type="Not Found">
+    The persona with the specified UUID could not be found. Verify that the `persona_id` is correct and that the persona has not been deleted. You can retrieve valid persona IDs from the [List personas](/docs/api/personas/listpersonas) endpoint.
+  </ParamField>
+  <ParamField name="500" type="Internal Server Error">
+    An unexpected error occurred on the server while processing the request. This is not caused by your input. If this error persists, contact Future AGI support with the request details and timestamp for investigation.
+  </ParamField>
+</ApiSection>
diff --git a/src/pages/docs/api/prompt-simulations/executesimulation.mdx b/src/pages/docs/api/prompt-simulations/executesimulation.mdx
new file mode 100644
index 00000000..bc75bf18
--- /dev/null
+++ b/src/pages/docs/api/prompt-simulations/executesimulation.mdx
@@ -0,0 +1,106 @@
+---
+title: "Execute prompt simulation"
+description: "Executes a prompt simulation run."
+---
+
+<ApiPlayground
+  method="POST"
+  endpoint="/simulate/prompt-templates/{prompt_template_id}/simulations/{run_test_id}/execute/"
+  baseUrl="https://api.futureagi.com"
+  parameters={[
+    {"name": "prompt_template_id", "in": "path", "required": true, "description": "UUID of the prompt template.", "type": "string"},
+    {"name": "run_test_id", "in": "path", "required": true, "description": "UUID of the simulation run to execute.", "type": "string"}
+  ]}
+  requestBody={{
+    selectAll: true,
+    scenarioIds: []
+  }}
+  responseExample={{
+    status: "success",
+    data: {
+      message: "Simulation execution started successfully",
+      executionId: "d4e5f6a7-b8c9-0123-def0-1234567890ab",
+      runTestId: "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
+      status: "pending",
+      totalScenarios: 3,
+      totalCalls: 15,
+      scenarioIds: ["c3d4e5f6-a7b8-9012-cdef-123456789012", "e5f6a7b8-c9d0-1234-ef01-234567890abc"]
+    }
+  }}
+  responseStatus={200}
+  responseStatusText="OK"
+/>
+
+<ApiSection title="Authentication">
+  <ParamField name="X-Api-Key" type="API Key" required>
+    Your Future AGI API key used to authenticate requests. You can find and manage your API keys in the [Dashboard](https://app.futureagi.com) under Settings.
+  </ParamField>
+  <ParamField name="X-Secret-Key" type="Secret Key" required>
+    Your Future AGI secret key, used alongside the API key for request authentication. This is generated when you create an API key in the [Dashboard](https://app.futureagi.com).
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Path parameters">
+  <ParamField path="prompt_template_id" type="UUID" required>
+    UUID of the prompt template that owns this simulation run.
+  </ParamField>
+  <ParamField path="run_test_id" type="UUID" required>
+    UUID of the simulation run to execute.
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Request body">
+  <ParamField body="selectAll" type="boolean" optional>
+    Whether to select all scenarios. Defaults to `false`. When `true` with empty `scenarioIds`, all scenarios run; when `true` with non-empty `scenarioIds`, listed scenarios are excluded.
+  </ParamField>
+  <ParamField body="scenarioIds" type="array of string" optional>
+    Scenario UUIDs to include (when `selectAll` is `false`) or exclude (when `selectAll` is `true`).
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Response" status={200} statusText="OK">
+  <ResponseField name="status" type="string">
+    `"success"` if the request succeeded.
+  </ResponseField>
+  <ResponseField name="data" type="object">
+    Execution details for the triggered simulation run.
+  </ResponseField>
+  <ApiCollapsible title="Show 7 properties">
+    <ResponseField name="message" type="string">
+      Human-readable confirmation message.
+    </ResponseField>
+    <ResponseField name="executionId" type="string">
+      UUID of the newly created test execution.
+    </ResponseField>
+    <ResponseField name="runTestId" type="string">
+      UUID of the simulation run that was executed.
+    </ResponseField>
+    <ResponseField name="status" type="string">
+      Initial execution status, typically `"pending"`.
+    </ResponseField>
+    <ResponseField name="totalScenarios" type="integer">
+      Number of scenarios selected for execution.
+    </ResponseField>
+    <ResponseField name="totalCalls" type="integer">
+      Total number of individual calls across all selected scenarios.
+    </ResponseField>
+    <ResponseField name="scenarioIds" type="array of string">
+      Scenario UUIDs selected for execution.
+    </ResponseField>
+  </ApiCollapsible>
+</ApiSection>
+
+<ApiSection title="Errors">
+  <ParamField name="400" type="Bad Request">
+    The execution could not start due to a missing or deleted prompt version, missing scenario data, or invalid evaluation configuration.
+  </ParamField>
+  <ParamField name="401" type="Unauthorized">
+    Invalid or missing authentication credentials.
+  </ParamField>
+  <ParamField name="404" type="Not Found">
+    The specified prompt template or simulation run does not exist.
+  </ParamField>
+  <ParamField name="500" type="Internal Server Error">
+    An unexpected server error occurred.
+  </ParamField>
+</ApiSection>
diff --git a/src/pages/docs/api/prompt-simulations/getsimulationdetails.mdx b/src/pages/docs/api/prompt-simulations/getsimulationdetails.mdx
new file mode 100644
index 00000000..7b99ae98
--- /dev/null
+++ b/src/pages/docs/api/prompt-simulations/getsimulationdetails.mdx
@@ -0,0 +1,133 @@
+---
+title: "Get prompt simulation details"
+description: "Retrieves a specific prompt simulation run."
+---
+
+<ApiPlayground
+  method="GET"
+  endpoint="/simulate/prompt-templates/{prompt_template_id}/simulations/{run_test_id}/"
+  baseUrl="https://api.futureagi.com"
+  parameters={[
+    {"name": "prompt_template_id", "in": "path", "required": true, "description": "UUID of the prompt template.", "type": "string"},
+    {"name": "run_test_id", "in": "path", "required": true, "description": "UUID of the simulation run.", "type": "string"}
+  ]}
+  responseExample={{
+    id: "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
+    name: "Regression Test v2",
+    description: "Testing updated system prompt",
+    source_type: "prompt",
+    source_type_display: "Prompt",
+    prompt_template: "550e8400-e29b-41d4-a716-446655440000",
+    prompt_template_detail: {
+      id: "550e8400-e29b-41d4-a716-446655440000",
+      name: "Customer Support Template",
+      description: "Main support prompt",
+      variable_names: ["user_name", "issue_type"]
+    },
+    prompt_version: "b2c3d4e5-f6a7-8901-bcde-f12345678901",
+    prompt_version_detail: {
+      id: "b2c3d4e5-f6a7-8901-bcde-f12345678901",
+      template_version: 3,
+      is_default: true,
+      commit_message: "Updated tone and guardrails"
+    },
+    scenarios: ["c3d4e5f6-a7b8-9012-cdef-123456789012"],
+    scenarios_detail: [],
+    dataset_row_ids: [],
+    simulate_eval_configs: ["d4e5f6a7-b8c9-0123-def0-1234567890ab"],
+    simulate_eval_configs_detail: [],
+    enable_tool_evaluation: false,
+    created_at: "2026-04-04T12:00:00Z",
+    updated_at: "2026-04-04T12:00:00Z",
+    last_run_at: "2026-04-04T13:00:00Z"
+  }}
+  responseStatus={200}
+  responseStatusText="OK"
+/>
+
+<ApiSection title="Authentication">
+  <ParamField name="X-Api-Key" type="API Key" required>
+    Your Future AGI API key used to authenticate requests. You can find and manage your API keys in the [Dashboard](https://app.futureagi.com) under Settings.
+  </ParamField>
+  <ParamField name="X-Secret-Key" type="Secret Key" required>
+    Your Future AGI secret key, used alongside the API key for request authentication. This is generated when you create an API key in the [Dashboard](https://app.futureagi.com).
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Path parameters">
+  <ParamField path="prompt_template_id" type="UUID" required>
+    UUID of the prompt template that owns this simulation run.
+  </ParamField>
+  <ParamField path="run_test_id" type="UUID" required>
+    UUID of the simulation run to retrieve.
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Response" status={200} statusText="OK">
+  <ResponseField name="id" type="string">
+    UUID of the simulation run.
+  </ResponseField>
+  <ResponseField name="name" type="string">
+    Name of the simulation run.
+  </ResponseField>
+  <ResponseField name="description" type="string">
+    Description of the simulation run, or `null`.
+  </ResponseField>
+  <ResponseField name="source_type" type="string">
+    Internal source type identifier (e.g., `"prompt"`).
+  </ResponseField>
+  <ResponseField name="source_type_display" type="string">
+    Display label for the source type (e.g., `"Prompt"`).
+  </ResponseField>
+  <ResponseField name="prompt_template" type="string">
+    UUID of the parent prompt template.
+  </ResponseField>
+  <ResponseField name="prompt_template_detail" type="object">
+    Parent prompt template object with `id`, `name`, `description`, and `variable_names`.
+  </ResponseField>
+  <ResponseField name="prompt_version" type="string">
+    UUID of the prompt version used by this simulation run.
+  </ResponseField>
+  <ResponseField name="prompt_version_detail" type="object">
+    Prompt version object with `id`, `template_version`, `is_default`, and `commit_message`.
+  </ResponseField>
+  <ResponseField name="scenarios" type="array of string">
+    Scenario UUIDs associated with this simulation run.
+  </ResponseField>
+  <ResponseField name="scenarios_detail" type="array of object">
+    Detailed scenario objects for each associated scenario.
+  </ResponseField>
+  <ResponseField name="dataset_row_ids" type="array of string">
+    Dataset row UUIDs included in this simulation. Empty array means all rows.
+  </ResponseField>
+  <ResponseField name="simulate_eval_configs" type="array of string">
+    Evaluation configuration UUIDs attached to this run.
+  </ResponseField>
+  <ResponseField name="simulate_eval_configs_detail" type="array of object">
+    Detailed evaluation configuration objects.
+  </ResponseField>
+  <ResponseField name="enable_tool_evaluation" type="boolean">
+    Whether tool usage evaluation is enabled.
+  </ResponseField>
+  <ResponseField name="created_at" type="string">
+    ISO 8601 creation timestamp.
+  </ResponseField>
+  <ResponseField name="updated_at" type="string">
+    ISO 8601 last-modified timestamp.
+  </ResponseField>
+  <ResponseField name="last_run_at" type="string">
+    ISO 8601 timestamp of last execution, or `null`.
+  </ResponseField>
+</ApiSection>
+
+<ApiSection title="Errors">
+  <ParamField name="401" type="Unauthorized">
+    Invalid or missing authentication credentials.
+  </ParamField>
+  <ParamField name="404" type="Not Found">
+    The specified prompt template or simulation run does not exist.
+  </ParamField>
+  <ParamField name="500" type="Internal Server Error">
+    An unexpected server error occurred.
+  </ParamField>
+</ApiSection>
diff --git a/src/pages/docs/api/prompt-simulations/listscenarios.mdx b/src/pages/docs/api/prompt-simulations/listscenarios.mdx
new file mode 100644
index 00000000..805d4cb8
--- /dev/null
+++ b/src/pages/docs/api/prompt-simulations/listscenarios.mdx
@@ -0,0 +1,99 @@
+---
+title: "List prompt simulation scenarios"
+description: "Returns a paginated list of prompt simulation scenarios."
+---
+
+<ApiPlayground
+  method="GET"
+  endpoint="/simulate/prompt-simulations/scenarios/"
+  baseUrl="https://api.futureagi.com"
+  parameters={[
+    {"name": "search", "in": "query", "required": false, "description": "Search scenarios by name.", "type": "string"},
+    {"name": "limit", "in": "query", "required": false, "description": "Number of results per page.", "type": "integer"},
+    {"name": "page", "in": "query", "required": false, "description": "Page number for pagination.", "type": "integer"}
+  ]}
+  responseExample={{
+    status: "success",
+    data: {
+      count: 12,
+      page: 1,
+      limit: 20,
+      results: [
+        {
+          id: "550e8400-e29b-41d4-a716-446655440000",
+          name: "Customer Billing Inquiry",
+          description: "Tests handling of billing-related questions",
+          scenario_type: "dataset",
+          dataset_id: "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
+          created_at: "2026-04-04T12:00:00Z"
+        },
+        {
+          id: "b2c3d4e5-f6a7-8901-bcde-f12345678901",
+          name: "Product Return Flow",
+          description: null,
+          scenario_type: "graph",
+          dataset_id: null,
+          created_at: "2026-04-03T09:30:00Z"
+        }
+      ]
+    }
+  }}
+  responseStatus={200}
+  responseStatusText="OK"
+/>
+
+<ApiSection title="Authentication">
+  <ParamField name="X-Api-Key" type="API Key" required>
+    Your Future AGI API key used to authenticate requests. You can find and manage your API keys in the [Dashboard](https://app.futureagi.com) under Settings.
+  </ParamField>
+  <ParamField name="X-Secret-Key" type="Secret Key" required>
+    Your Future AGI secret key, used alongside the API key for request authentication. This is generated when you create an API key in the [Dashboard](https://app.futureagi.com).
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Query parameters">
+  <ParamField query="search" type="string" optional>
+    Case-insensitive filter on scenario name.
+  </ParamField>
+  <ParamField query="limit" type="integer" optional>
+    Number of results per page. Defaults to `20`.
+  </ParamField>
+  <ParamField query="page" type="integer" optional>
+    Page number to retrieve. Defaults to `1`.
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Response" status={200} statusText="OK">
+  <ResponseField name="status" type="string">
+    `"success"` if the request succeeded.
+  </ResponseField>
+  <ResponseField name="data" type="object">
+    Paginated response payload.
+  </ResponseField>
+  <ApiCollapsible title="Show 4 properties">
+    <ResponseField name="count" type="integer">
+      Total number of matching scenarios.
+    </ResponseField>
+    <ResponseField name="page" type="integer">
+      Current page number.
+    </ResponseField>
+    <ResponseField name="limit" type="integer">
+      Number of items per page.
+    </ResponseField>
+    <ResponseField name="results" type="array of object">
+      Array of scenario objects with `id`, `name`, `description`, `scenario_type` (`graph`, `script`, or `dataset`), `dataset_id`, and `created_at`.
+    </ResponseField>
+  </ApiCollapsible>
+</ApiSection>
+
+<ApiSection title="Errors">
+  <ParamField name="401" type="Unauthorized">
+    Invalid or missing authentication credentials.
+  </ParamField>
+  <ParamField name="404" type="Not Found">
+    The organization could not be resolved from the provided API keys.
+  </ParamField>
+  <ParamField name="500" type="Internal Server Error">
+    An unexpected server error occurred.
+  </ParamField>
+</ApiSection>
diff --git a/src/pages/docs/api/prompt-simulations/listsimulations.mdx b/src/pages/docs/api/prompt-simulations/listsimulations.mdx
new file mode 100644
index 00000000..4e53000f
--- /dev/null
+++ b/src/pages/docs/api/prompt-simulations/listsimulations.mdx
@@ -0,0 +1,111 @@
+---
+title: "List simulations for prompt template"
+description: "Returns a paginated list of simulation runs for a prompt template."
+---
+
+<ApiPlayground
+  method="GET"
+  endpoint="/simulate/prompt-templates/{prompt_template_id}/simulations/"
+  baseUrl="https://api.futureagi.com"
+  parameters={[
+    {"name": "prompt_template_id", "in": "path", "required": true, "description": "UUID of the prompt template.", "type": "string"},
+    {"name": "version_id", "in": "query", "required": false, "description": "Filter by prompt version UUID.", "type": "string"},
+    {"name": "limit", "in": "query", "required": false, "description": "Number of results per page.", "type": "integer"},
+    {"name": "page", "in": "query", "required": false, "description": "Page number for pagination.", "type": "integer"}
+  ]}
+  responseExample={{
+    status: "success",
+    data: {
+      count: 5,
+      page: 1,
+      limit: 10,
+      prompt_template: {
+        id: "550e8400-e29b-41d4-a716-446655440000",
+        name: "Customer Support Template"
+      },
+      results: [
+        {
+          id: "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
+          name: "Regression Test v2",
+          description: "Testing updated system prompt",
+          source_type: "prompt",
+          source_type_display: "Prompt",
+          prompt_template: "550e8400-e29b-41d4-a716-446655440000",
+          prompt_version: "b2c3d4e5-f6a7-8901-bcde-f12345678901",
+          scenarios: ["c3d4e5f6-a7b8-9012-cdef-123456789012"],
+          enable_tool_evaluation: false,
+          created_at: "2026-04-04T12:00:00Z",
+          updated_at: "2026-04-04T12:00:00Z",
+          last_run_at: "2026-04-04T13:00:00Z"
+        }
+      ]
+    }
+  }}
+  responseStatus={200}
+  responseStatusText="OK"
+/>
+
+<ApiSection title="Authentication">
+  <ParamField name="X-Api-Key" type="API Key" required>
+    Your Future AGI API key used to authenticate requests. You can find and manage your API keys in the [Dashboard](https://app.futureagi.com) under Settings.
+  </ParamField>
+  <ParamField name="X-Secret-Key" type="Secret Key" required>
+    Your Future AGI secret key, used alongside the API key for request authentication. This is generated when you create an API key in the [Dashboard](https://app.futureagi.com).
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Path parameters">
+  <ParamField path="prompt_template_id" type="UUID" required>
+    UUID of the prompt template to list simulation runs for.
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Query parameters">
+  <ParamField query="version_id" type="string" optional>
+    Filter by prompt version UUID.
+  </ParamField>
+  <ParamField query="limit" type="integer" optional>
+    Number of results per page. Defaults to `10`.
+  </ParamField>
+  <ParamField query="page" type="integer" optional>
+    Page number to retrieve. Defaults to `1`.
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Response" status={200} statusText="OK">
+  <ResponseField name="status" type="string">
+    `"success"` if the request succeeded.
+  </ResponseField>
+  <ResponseField name="data" type="object">
+    Paginated response payload.
+  </ResponseField>
+  <ApiCollapsible title="Show 5 properties">
+    <ResponseField name="count" type="integer">
+      Total number of matching simulation runs.
+    </ResponseField>
+    <ResponseField name="page" type="integer">
+      Current page number.
+    </ResponseField>
+    <ResponseField name="limit" type="integer">
+      Number of items per page.
+    </ResponseField>
+    <ResponseField name="prompt_template" type="object">
+      Parent prompt template summary with `id` and `name`.
+    </ResponseField>
+    <ResponseField name="results" type="array of object">
+      Array of simulation run objects with `id`, `name`, `description`, `source_type`, `source_type_display`, `prompt_template`, `prompt_template_detail`, `prompt_version`, `prompt_version_detail`, `scenarios`, `scenarios_detail`, `dataset_row_ids`, `enable_tool_evaluation`, `created_at`, `updated_at`, and `last_run_at`.
+    </ResponseField>
+  </ApiCollapsible>
+</ApiSection>
+
+<ApiSection title="Errors">
+  <ParamField name="401" type="Unauthorized">
+    Invalid or missing authentication credentials.
+  </ParamField>
+  <ParamField name="404" type="Not Found">
+    The specified prompt template does not exist.
+  </ParamField>
+  <ParamField name="500" type="Internal Server Error">
+    An unexpected server error occurred.
+  </ParamField>
+</ApiSection>
diff --git a/src/pages/docs/api/run-tests/addevalconfigs.mdx b/src/pages/docs/api/run-tests/addevalconfigs.mdx
new file mode 100644
index 00000000..bba830e2
--- /dev/null
+++ b/src/pages/docs/api/run-tests/addevalconfigs.mdx
@@ -0,0 +1,71 @@
+---
+title: "Add evaluation configurations"
+description: "Adds evaluation configurations to a test run."
+---
+
+<ApiPlayground
+  method="POST"
+  endpoint="/simulate/run-tests/{run_test_id}/eval-configs/"
+  baseUrl="https://api.futureagi.com"
+  parameters={[
+    {"name": "run_test_id", "in": "path", "required": true, "description": "UUID of the test run to add evaluation configurations to.", "type": "string"}
+  ]}
+  requestBody={{"evaluationsConfig": [{"templateId": "your-template-id", "name": "My Eval Config", "config": {}, "mapping": {}, "errorLocalizer": false, "model": "turing_large"}]}}
+  responseExample={{"message": "Evaluation configs added successfully"}}
+  responseStatus={200}
+  responseStatusText="OK"
+/>
+
+<ApiSection title="Authentication">
+  <ParamField name="X-Api-Key" type="API Key" required>
+    Your Future AGI API key used to authenticate requests. You can find and manage your API keys in the [Dashboard](https://app.futureagi.com) under Settings.
+  </ParamField>
+  <ParamField name="X-Secret-Key" type="Secret Key" required>
+    Your Future AGI secret key, used alongside the API key for request authentication. This is generated when you create an API key in the [Dashboard](https://app.futureagi.com).
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Path parameters">
+  <ParamField path="run_test_id" type="UUID" required>
+    UUID of the test run to add evaluation configurations to.
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Request body">
+  <ParamField body="evaluationsConfig" type="array of objects" required>
+    Array of evaluation configuration objects. Each object supports the following fields:
+
+    - **`templateId`** (string, UUID, required) -- UUID of the evaluation template to use.
+
+    - **`name`** (string, required) -- Name for this evaluation configuration. Must be unique within the test run.
+
+    - **`config`** (object, optional) -- Template-specific configuration parameters.
+
+    - **`mapping`** (object, optional) -- Maps test execution data fields to the evaluation template's expected inputs.
+
+    - **`filters`** (object, optional) -- Filter criteria to restrict which test results are evaluated.
+
+    - **`errorLocalizer`** (boolean, optional) -- Enables granular error localization on evaluation failures. Defaults to `false`.
+
+    - **`model`** (string, optional) -- Model to use for running this evaluation.
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Response" status={200} statusText="OK">
+  <ResponseField name="message" type="string">Confirmation of successful addition.</ResponseField>
+</ApiSection>
+
+<ApiSection title="Errors">
+  <ParamField name="400" type="Bad Request">
+    Invalid or missing fields such as a non-existent `templateId`, duplicate `name`, or malformed `config`/`mapping`.
+  </ParamField>
+  <ParamField name="401" type="Unauthorized">
+    Missing or invalid `X-Api-Key` or `X-Secret-Key` headers.
+  </ParamField>
+  <ParamField name="404" type="Not Found">
+    No test run found with the specified `run_test_id`.
+  </ParamField>
+  <ParamField name="500" type="Internal Server Error">
+    Unexpected server error. Retry later or contact support.
+  </ParamField>
+</ApiSection>
diff --git a/src/pages/docs/api/run-tests/compareevalsummaries.mdx b/src/pages/docs/api/run-tests/compareevalsummaries.mdx
new file mode 100644
index 00000000..1c89ebb9
--- /dev/null
+++ b/src/pages/docs/api/run-tests/compareevalsummaries.mdx
@@ -0,0 +1,57 @@
+---
+title: "Compare evaluation summaries"
+description: "Compares evaluation summaries across multiple test executions."
+---
+
+<ApiPlayground
+  method="GET"
+  endpoint="/simulate/run-tests/{run_test_id}/eval-summary-comparison/"
+  baseUrl="https://api.futureagi.com"
+  parameters={[
+    {"name": "run_test_id", "in": "path", "required": true, "description": "UUID of the test run containing the executions to compare.", "type": "string"},
+    {"name": "execution_ids", "in": "query", "required": false, "description": "JSON-encoded array of test execution UUIDs to compare.", "type": "string"}
+  ]}
+  responseExample={{"execution-uuid-1": {"evaluations": [{"name": "Tone Check", "average_score": 0.85}]}, "execution-uuid-2": {"evaluations": [{"name": "Tone Check", "average_score": 0.92}]}}}
+  responseStatus={200}
+  responseStatusText="OK"
+/>
+
+<ApiSection title="Authentication">
+  <ParamField name="X-Api-Key" type="API Key" required>
+    Your Future AGI API key used to authenticate requests. You can find and manage your API keys in the [Dashboard](https://app.futureagi.com) under Settings.
+  </ParamField>
+  <ParamField name="X-Secret-Key" type="Secret Key" required>
+    Your Future AGI secret key, used alongside the API key for request authentication. This is generated when you create an API key in the [Dashboard](https://app.futureagi.com).
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Path parameters">
+  <ParamField path="run_test_id" type="UUID" required>
+    UUID of the test run containing the executions to compare.
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Query parameters">
+  <ParamField query="execution_ids" type="string" required>
+    JSON-encoded array of test execution UUIDs to compare. Must be URL-encoded.
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Response" status={200} statusText="OK">
+  <ResponseField name="comparison" type="object">Dictionary keyed by execution ID, each mapping to its evaluation summary metrics.</ResponseField>
+</ApiSection>
+
+<ApiSection title="Errors">
+  <ParamField name="400" type="Bad Request">
+    Missing, malformed, or invalid `execution_ids` parameter.
+  </ParamField>
+  <ParamField name="401" type="Unauthorized">
+    Missing or invalid `X-Api-Key` or `X-Secret-Key` headers.
+  </ParamField>
+  <ParamField name="404" type="Not Found">
+    No test run found with the specified `run_test_id`.
+  </ParamField>
+  <ParamField name="500" type="Internal Server Error">
+    Unexpected server error. Retry later or contact support.
+  </ParamField>
+</ApiSection>
diff --git a/src/pages/docs/api/run-tests/createruntest.mdx b/src/pages/docs/api/run-tests/createruntest.mdx
index 3e53ea59..c8587dc8 100644
--- a/src/pages/docs/api/run-tests/createruntest.mdx
+++ b/src/pages/docs/api/run-tests/createruntest.mdx
@@ -1,51 +1,95 @@
 ---
 title: "Create a New Test Run"
-description: "Creates and configures a new test run, associating it with scenarios, an agent definition, and detailed evaluation configurations."
+description: "Creates a new test run."
 ---
 
 <ApiPlayground
   method="POST"
   endpoint="/simulate/run-tests/create/"
   baseUrl="https://api.futureagi.com"
-  parameters={[]}
   requestBody={{"name": "your-name", "description": "your-description", "scenarioIds": [], "agentDefinitionId": "your-agentDefinitionId", "agentVersion": "your-agentVersion", "evalConfigIds": [], "evaluationsConfig": [], "datasetRowIds": [], "enableToolEvaluation": true}}
-  responseExample={{"id": "550e8400-e29b-41d4-a716-446655440000", "name": "your-name", "description": "your-description", "status": "created", "created_at": "2026-03-15T10:30:00Z"}}
+  responseExample={{"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "name": "your-name", "description": "your-description", "agent_definition": "your-agentDefinitionId", "scenarios": [], "enable_tool_evaluation": true, "created_at": "2026-04-04T12:00:00Z", "updated_at": "2026-04-04T12:00:00Z"}}
   responseStatus={201}
   responseStatusText="Created"
 />
 
 <ApiSection title="Authentication">
-  <ParamField name="Authorization" type="Bearer" required>
-    Include your API key in the `Authorization` header as `Bearer <token>`. Retrieve your API Key from the [Dashboard](https://app.futureagi.com).
+  <ParamField name="X-Api-Key" type="API Key" required>
+    Your Future AGI API key used to authenticate requests. You can find and manage your API keys in the [Dashboard](https://app.futureagi.com) under Settings.
+  </ParamField>
+  <ParamField name="X-Secret-Key" type="Secret Key" required>
+    Your Future AGI secret key, used alongside the API key for request authentication. This is generated when you create an API key in the [Dashboard](https://app.futureagi.com).
   </ParamField>
 </ApiSection>
 
 <ApiSection title="Request body">
   <ParamField body="name" type="string" required>
-    A unique name for the test run.
+    Name for the test run. Must be unique within your organization and cannot exceed 255 characters.
   </ParamField>
-  <ParamField body="description" type="string" optional>
-    An optional description for the test run.
+  <ParamField body="description" type="string">
+    Optional free-text description of the test run.
   </ParamField>
   <ParamField body="scenarioIds" type="array of string" required>
-    A list of scenario UUIDs to be included in this test run.
+    Array of scenario UUIDs to execute against. Must contain at least one valid scenario ID.
   </ParamField>
   <ParamField body="agentDefinitionId" type="string" required>
-    The UUID of the agent definition to be tested.
+    UUID of the agent definition to evaluate.
+  </ParamField>
+  <ParamField body="agentVersion" type="string">
+    UUID of a specific agent version to test against. Defaults to the currently active version if omitted.
+  </ParamField>
+  <ParamField body="evalConfigIds" type="array of string">
+    Array of existing evaluation configuration UUIDs to associate with this test run.
+  </ParamField>
+  <ParamField body="evaluationsConfig" type="array of objects">
+    Array of inline evaluation configuration objects to create and associate. Each object must include `template_id`, `name`, `config`, and `mapping`.
+  </ParamField>
+  <ParamField body="datasetRowIds" type="array of string">
+    Array of dataset row UUIDs to restrict execution to specific data entries. If omitted, all rows are included.
   </ParamField>
-  <ParamField body="agentVersion" type="string" optional>
-    The specific UUID of the agent version to be tested. If not provided, the active version will be used.
+  <ParamField body="enableToolEvaluation" type="boolean">
+    When `true`, evaluates correctness of tool calls made by the agent. Defaults to `false`.
   </ParamField>
-  <ParamField body="evalConfigIds" type="array of string" optional>
-    A list of existing evaluation configuration UUIDs to associate with this test run.
+</ApiSection>
+
+<ApiSection title="Response" status={201} statusText="Created">
+  <ResponseField name="id" type="string">
+    UUID of the newly created test run.
+  </ResponseField>
+  <ResponseField name="name" type="string">
+    Name of the test run.
+  </ResponseField>
+  <ResponseField name="description" type="string">
+    Description of the test run, or empty string if none provided.
+  </ResponseField>
+  <ResponseField name="agent_definition" type="string">
+    UUID of the associated agent definition.
+  </ResponseField>
+  <ResponseField name="scenarios" type="array of string">
+    Array of linked scenario UUIDs.
+  </ResponseField>
+  <ResponseField name="enable_tool_evaluation" type="boolean">
+    Whether tool evaluation is enabled.
+  </ResponseField>
+  <ResponseField name="created_at" type="string">
+    ISO 8601 creation timestamp.
+  </ResponseField>
+  <ResponseField name="updated_at" type="string">
+    ISO 8601 last-modified timestamp.
+  </ResponseField>
+</ApiSection>
+
+<ApiSection title="Errors">
+  <ParamField name="400" type="Bad Request">
+    Invalid or missing required fields, such as empty `scenarioIds`, invalid UUIDs, or malformed `evaluationsConfig`.
   </ParamField>
-  <ParamField body="evaluationsConfig" type="array of any" optional>
-    A list of new, detailed evaluation configurations to create and associate with this test run.
+  <ParamField name="401" type="Unauthorized">
+    Missing or invalid `X-Api-Key` or `X-Secret-Key` headers.
   </ParamField>
-  <ParamField body="datasetRowIds" type="array of string" optional>
-    A list of specific dataset row UUIDs to test against.
+  <ParamField name="404" type="Not Found">
+    Organization not found, or one or more referenced resources (agent definition, scenarios, eval configs) do not exist.
   </ParamField>
-  <ParamField body="enableToolEvaluation" type="boolean" optional>
-    Flag to enable tool evaluation for this test run.
+  <ParamField name="500" type="Internal Server Error">
+    Unexpected server error. Contact support if it persists.
   </ParamField>
 </ApiSection>
diff --git a/src/pages/docs/api/run-tests/deleteevalconfig.mdx b/src/pages/docs/api/run-tests/deleteevalconfig.mdx
new file mode 100644
index 00000000..ed13dcfe
--- /dev/null
+++ b/src/pages/docs/api/run-tests/deleteevalconfig.mdx
@@ -0,0 +1,54 @@
+---
+title: "Delete evaluation configuration"
+description: "Deletes an evaluation configuration from a test run."
+---
+
+<ApiPlayground
+  method="DELETE"
+  endpoint="/simulate/run-tests/{run_test_id}/eval-configs/{eval_config_id}/"
+  baseUrl="https://api.futureagi.com"
+  parameters={[
+    {"name": "run_test_id", "in": "path", "required": true, "description": "UUID of the test run containing the evaluation configuration.", "type": "string"},
+    {"name": "eval_config_id", "in": "path", "required": true, "description": "UUID of the evaluation configuration to delete.", "type": "string"}
+  ]}
+  responseExample={{"message": "Evaluation config deleted successfully"}}
+  responseStatus={200}
+  responseStatusText="OK"
+/>
+
+<ApiSection title="Authentication">
+  <ParamField name="X-Api-Key" type="API Key" required>
+    Your Future AGI API key used to authenticate requests. You can find and manage your API keys in the [Dashboard](https://app.futureagi.com) under Settings.
+  </ParamField>
+  <ParamField name="X-Secret-Key" type="Secret Key" required>
+    Your Future AGI secret key, used alongside the API key for request authentication. This is generated when you create an API key in the [Dashboard](https://app.futureagi.com).
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Path parameters">
+  <ParamField path="run_test_id" type="UUID" required>
+    UUID of the test run containing the evaluation configuration.
+  </ParamField>
+  <ParamField path="eval_config_id" type="UUID" required>
+    UUID of the evaluation configuration to delete. Cannot delete the last remaining config in the test run.
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Response" status={200} statusText="OK">
+  <ResponseField name="message" type="string">Confirmation of successful deletion.</ResponseField>
+</ApiSection>
+
+<ApiSection title="Errors">
+  <ParamField name="400" type="Bad Request">
+    Cannot delete the last remaining evaluation configuration in the test run.
+  </ParamField>
+  <ParamField name="401" type="Unauthorized">
+    Missing or invalid `X-Api-Key` or `X-Secret-Key` headers.
+  </ParamField>
+  <ParamField name="404" type="Not Found">
+    Test run or evaluation configuration not found.
+  </ParamField>
+  <ParamField name="500" type="Internal Server Error">
+    Unexpected server error. Retry later or contact support.
+  </ParamField>
+</ApiSection>
diff --git a/src/pages/docs/api/run-tests/deleteruntest.mdx b/src/pages/docs/api/run-tests/deleteruntest.mdx
new file mode 100644
index 00000000..c40ae558
--- /dev/null
+++ b/src/pages/docs/api/run-tests/deleteruntest.mdx
@@ -0,0 +1,52 @@
+---
+title: "Delete a test run"
+description: "Soft-deletes a test run."
+---
+
+<ApiPlayground
+  method="DELETE"
+  endpoint="/simulate/run-tests/{run_test_id}/"
+  baseUrl="https://api.futureagi.com"
+  parameters={[
+    {"name": "run_test_id", "in": "path", "required": true, "description": "UUID of the test run to delete.", "type": "string"}
+  ]}
+  responseExample={{"message": "Run test deleted successfully"}}
+  responseStatus={200}
+  responseStatusText="OK"
+/>
+
+<ApiSection title="Authentication">
+  <ParamField name="X-Api-Key" type="API Key" required>
+    Your Future AGI API key used to authenticate requests. You can find and manage your API keys in the [Dashboard](https://app.futureagi.com) under Settings.
+  </ParamField>
+  <ParamField name="X-Secret-Key" type="Secret Key" required>
+    Your Future AGI secret key, used alongside the API key for request authentication. This is generated when you create an API key in the [Dashboard](https://app.futureagi.com).
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Path parameters">
+  <ParamField path="run_test_id" type="UUID" required>
+    UUID of the test run to delete. Must not have any currently running executions.
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Response" status={200} statusText="OK">
+  <ResponseField name="message" type="string">
+    Confirmation of successful soft-deletion.
+  </ResponseField>
+</ApiSection>
+
+<ApiSection title="Errors">
+  <ParamField name="400" type="Bad Request">
+    Test run has one or more executions in `RUNNING` state. Wait for them to complete or cancel them first.
+  </ParamField>
+  <ParamField name="401" type="Unauthorized">
+    Missing or invalid `X-Api-Key` or `X-Secret-Key` headers.
+  </ParamField>
+  <ParamField name="404" type="Not Found">
+    No test run found with the specified `run_test_id`.
+  </ParamField>
+  <ParamField name="500" type="Internal Server Error">
+    Unexpected server error. Contact support if it persists.
+  </ParamField>
+</ApiSection>
diff --git a/src/pages/docs/api/run-tests/deletetestexecutions.mdx b/src/pages/docs/api/run-tests/deletetestexecutions.mdx
new file mode 100644
index 00000000..6855a0c9
--- /dev/null
+++ b/src/pages/docs/api/run-tests/deletetestexecutions.mdx
@@ -0,0 +1,63 @@
+---
+title: "Delete test executions"
+description: "Bulk-deletes test executions from a test run."
+---
+
+<ApiPlayground
+  method="POST"
+  endpoint="/simulate/run-tests/{run_test_id}/delete-test-executions/"
+  baseUrl="https://api.futureagi.com"
+  parameters={[
+    {"name": "run_test_id", "in": "path", "required": true, "description": "UUID of the test run from which to delete test executions.", "type": "string"}
+  ]}
+  requestBody={{"testExecutionIds": ["execution-uuid-1", "execution-uuid-2"], "selectAll": false}}
+  responseExample={{"message": "Successfully deleted 2 test execution(s).", "runTestId": "run-test-uuid", "deletedCount": 2, "deletedIds": ["execution-uuid-1", "execution-uuid-2"]}}
+  responseStatus={200}
+  responseStatusText="OK"
+/>
+
+<ApiSection title="Authentication">
+  <ParamField name="X-Api-Key" type="API Key" required>
+    Your Future AGI API key used to authenticate requests. You can find and manage your API keys in the [Dashboard](https://app.futureagi.com) under Settings.
+  </ParamField>
+  <ParamField name="X-Secret-Key" type="Secret Key" required>
+    Your Future AGI secret key, used alongside the API key for request authentication. This is generated when you create an API key in the [Dashboard](https://app.futureagi.com).
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Path parameters">
+  <ParamField path="run_test_id" type="UUID" required>
+    UUID of the test run containing the executions to delete.
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Request body">
+  <ParamField body="testExecutionIds" type="array of strings" optional>
+    Array of test execution UUIDs to delete. Required when `selectAll` is `false`. Executions in `RUNNING`, `PENDING`, or `CANCELLING` status cannot be deleted.
+  </ParamField>
+  <ParamField body="selectAll" type="boolean" optional>
+    When `true`, deletes all eligible executions, ignoring `testExecutionIds`. Defaults to `false`.
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Response" status={200} statusText="OK">
+  <ResponseField name="message" type="string">Confirmation message with deletion count.</ResponseField>
+  <ResponseField name="runTestId" type="string">UUID of the parent test run.</ResponseField>
+  <ResponseField name="deletedCount" type="integer">Number of executions deleted.</ResponseField>
+  <ResponseField name="deletedIds" type="array of strings">UUIDs of the deleted executions.</ResponseField>
+</ApiSection>
+
+<ApiSection title="Errors">
+  <ParamField name="400" type="Bad Request">
+    Invalid request, empty `testExecutionIds`, or targeted executions are still running/pending/cancelling.
+  </ParamField>
+  <ParamField name="401" type="Unauthorized">
+    Missing or invalid `X-Api-Key` or `X-Secret-Key` headers.
+  </ParamField>
+  <ParamField name="404" type="Not Found">
+    No test run found with the specified `run_test_id`.
+  </ParamField>
+  <ParamField name="500" type="Internal Server Error">
+    Unexpected server error. Retry later or contact support.
+  </ParamField>
+</ApiSection>
diff --git a/src/pages/docs/api/run-tests/executeruntest.mdx b/src/pages/docs/api/run-tests/executeruntest.mdx
index 5887f39a..3a3b5042 100644
--- a/src/pages/docs/api/run-tests/executeruntest.mdx
+++ b/src/pages/docs/api/run-tests/executeruntest.mdx
@@ -1,78 +1,83 @@
 ---
 title: "Execute a test run"
-description: "Triggers the execution of a specified test run. The execution can be customized to include or exclude specific scenarios."
+description: "Executes a test run."
 ---
 
 <ApiPlayground
   method="POST"
   endpoint="/simulate/run-tests/{run_test_id}/execute/"
   baseUrl="https://api.futureagi.com"
-  parameters={[{"name": "run_test_id", "in": "path", "required": true, "description": "The UUID of the test run to execute.", "type": "string"}]}
+  parameters={[
+    {"name": "run_test_id", "in": "path", "required": true, "description": "UUID of the test run to execute.", "type": "string"}
+  ]}
   requestBody={{"selectAll": true, "scenarioIds": [], "simulatorId": "your-simulatorId"}}
-  responseExample={{"message": "Test run execution started", "execution_id": "550e8400-e29b-41d4-a716-446655440000", "run_test_id": "550e8400-e29b-41d4-a716-446655440001", "status": "running", "total_scenarios": 5, "total_calls": 100, "scenario_ids": ["550e8400-e29b-41d4-a716-446655440002", "550e8400-e29b-41d4-a716-446655440003"]}}
+  responseExample={{"message": "Test execution started successfully", "execution_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "run_test_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901", "status": "PENDING", "total_scenarios": 5, "total_calls": 25, "scenario_ids": []}}
   responseStatus={200}
   responseStatusText="OK"
 />
 
 <ApiSection title="Authentication">
-  <ParamField name="Authorization" type="Bearer" required>
-    Include your API key in the `Authorization` header as `Bearer <token>`. Retrieve your API Key from the [Dashboard](https://app.futureagi.com).
+  <ParamField name="X-Api-Key" type="API Key" required>
+    Your Future AGI API key used to authenticate requests. You can find and manage your API keys in the [Dashboard](https://app.futureagi.com) under Settings.
+  </ParamField>
+  <ParamField name="X-Secret-Key" type="Secret Key" required>
+    Your Future AGI secret key, used alongside the API key for request authentication. This is generated when you create an API key in the [Dashboard](https://app.futureagi.com).
   </ParamField>
 </ApiSection>
 
 <ApiSection title="Path parameters">
-  <ParamField path="run_test_id" type="string" required>
-    The UUID of the test run to execute.
+  <ParamField path="run_test_id" type="UUID" required>
+    UUID of the test run to execute. The test run must have at least one scenario associated.
   </ParamField>
 </ApiSection>
 
 <ApiSection title="Request body">
   <ParamField body="selectAll" type="boolean" optional>
-    Determines how `scenarioIds` is interpreted. If `true`, all scenarios *except* those in `scenarioIds` will be executed. If `false`, *only* the scenarios in `scenarioIds` will be executed. If `scenarioIds` is empty, all scenarios will run regardless of this flag.
+    When `true`, all scenarios run except those in `scenarioIds` (exclusion mode). When `false`, only those in `scenarioIds` run (inclusion mode).
   </ParamField>
   <ParamField body="scenarioIds" type="array of string" optional>
-    A list of scenario UUIDs to either include or exclude from the execution, based on the `selectAll` flag.
+    Array of scenario UUIDs to include or exclude based on `selectAll`. If empty, all scenarios run.
   </ParamField>
   <ParamField body="simulatorId" type="string" optional>
-    An optional UUID of a specific simulator to use for the test run.
+    UUID of a simulator agent to use. Defaults to the test run or organization default if omitted.
   </ParamField>
 </ApiSection>
 
 <ApiSection title="Response" status={200} statusText="OK">
   <ResponseField name="message" type="string">
-    Confirmation message for the execution.
+    Confirmation that execution was queued.
   </ResponseField>
   <ResponseField name="execution_id" type="string">
-    UUID of the created execution.
+    UUID of the created execution instance.
   </ResponseField>
   <ResponseField name="run_test_id" type="string">
-    UUID of the test run being executed.
+    UUID of the parent test run.
   </ResponseField>
   <ResponseField name="status" type="string">
-    Current status of the execution.
+    Initial status, always `"PENDING"`. Transitions through `RUNNING` to `COMPLETED`, `FAILED`, or `CANCELLED`.
   </ResponseField>
   <ResponseField name="total_scenarios" type="integer">
-    Total number of scenarios to be executed.
+    Number of scenarios that will be executed after filtering.
   </ResponseField>
   <ResponseField name="total_calls" type="integer">
-    Total number of calls to be executed.
+    Total simulation calls across all selected scenarios.
   </ResponseField>
   <ResponseField name="scenario_ids" type="array of string">
-    List of scenario UUIDs included in this execution.
+    Resolved list of scenario UUIDs that will be executed.
   </ResponseField>
 </ApiSection>
 
 <ApiSection title="Errors">
   <ParamField name="400" type="Bad Request">
-    Bad Request. Invalid test run or scenario configuration.
+    Test run has no scenarios, contains invalid scenario IDs, or has a misconfigured agent/eval setup.
   </ParamField>
   <ParamField name="401" type="Unauthorized">
-    Authentication credentials were not provided.
+    Missing or invalid `X-Api-Key` or `X-Secret-Key` headers.
   </ParamField>
   <ParamField name="404" type="Not Found">
-    The test run was not found.
+    Test run or organization not found.
   </ParamField>
   <ParamField name="500" type="Internal Server Error">
-    An unexpected error occurred.
+    Unexpected server error. Contact support if it persists.
   </ParamField>
 </ApiSection>
diff --git a/src/pages/docs/api/run-tests/getcallexecutions.mdx b/src/pages/docs/api/run-tests/getcallexecutions.mdx
new file mode 100644
index 00000000..a489c106
--- /dev/null
+++ b/src/pages/docs/api/run-tests/getcallexecutions.mdx
@@ -0,0 +1,133 @@
+---
+title: "Get call executions for a test run"
+description: "Lists call executions for a test run."
+---
+
+<ApiPlayground
+  method="GET"
+  endpoint="/simulate/run-tests/{run_test_id}/call-executions/"
+  baseUrl="https://api.futureagi.com"
+  parameters={[
+    {"name": "run_test_id", "in": "path", "required": true, "description": "UUID of the test run whose call executions to retrieve.", "type": "string"},
+    {"name": "search", "in": "query", "required": false, "description": "Filter call executions by phone number or scenario name.", "type": "string"},
+    {"name": "status", "in": "query", "required": false, "description": "Filter call executions by call status.", "type": "string"},
+    {"name": "limit", "in": "query", "required": false, "description": "Maximum number of records per page (default: 10).", "type": "integer"},
+    {"name": "page", "in": "query", "required": false, "description": "Page number to retrieve (default: 1).", "type": "integer"}
+  ]}
+  responseExample={{"count": 25, "next": "https://api.futureagi.com/simulate/run-tests/{run_test_id}/call-executions/?page=2&limit=10", "previous": null, "results": [{"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "session_id": "sess_abc123", "status": "COMPLETED", "duration": 45.2, "start_time": "2026-04-04T12:00:00Z", "transcript": [], "scenario": {"id": "b2c3d4e5-f6a7-8901-bcde-f12345678901", "name": "Happy Path"}, "overall_score": 92.5, "eval_outputs": {}, "eval_metrics": {}, "customer_name": "John Doe", "call_summary": "Customer successfully completed checkout", "ended_reason": "completed", "avg_agent_latency": 1.2, "scenario_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901", "is_snapshot": false, "rerun_type": null, "created_at": "2026-04-04T12:00:00Z"}]}}
+  responseStatus={200}
+  responseStatusText="OK"
+/>
+
+<ApiSection title="Authentication">
+  <ParamField name="X-Api-Key" type="API Key" required>
+    Your Future AGI API key used to authenticate requests. You can find and manage your API keys in the [Dashboard](https://app.futureagi.com) under Settings.
+  </ParamField>
+  <ParamField name="X-Secret-Key" type="Secret Key" required>
+    Your Future AGI secret key, used alongside the API key for request authentication. This is generated when you create an API key in the [Dashboard](https://app.futureagi.com).
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Path parameters">
+  <ParamField path="run_test_id" type="UUID" required>
+    UUID of the test run whose call executions to retrieve.
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Query parameters">
+  <ParamField query="search" type="string" optional>
+    Case-insensitive partial match on phone number or scenario name.
+  </ParamField>
+  <ParamField query="status" type="string" optional>
+    Filter by call status.
+  </ParamField>
+  <ParamField query="limit" type="integer" optional>
+    Number of records per page. Defaults to `10`. Must be a positive integer.
+  </ParamField>
+  <ParamField query="page" type="integer" optional>
+    Page number to retrieve. Defaults to `1`.
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Response" status={200} statusText="OK">
+  <ResponseField name="count" type="integer">
+    Total matching call executions across all pages.
+  </ResponseField>
+  <ResponseField name="next" type="string or null">
+    URL to the next page, or `null` if on the last page.
+  </ResponseField>
+  <ResponseField name="previous" type="string or null">
+    URL to the previous page, or `null` if on the first page.
+  </ResponseField>
+  <ResponseField name="results" type="array of objects">
+    Array of call execution objects for the current page.
+  </ResponseField>
+  <ApiCollapsible title="Show 18 properties">
+    <ResponseField name="id" type="string">
+      UUID of the call execution.
+    </ResponseField>
+    <ResponseField name="session_id" type="string or null">
+      Session identifier for external correlation, or `null`.
+    </ResponseField>
+    <ResponseField name="status" type="string">
+      Current call status.
+    </ResponseField>
+    <ResponseField name="duration" type="number or null">
+      Call duration in seconds, or `null` if not completed.
+    </ResponseField>
+    <ResponseField name="start_time" type="string or null">
+      ISO 8601 call start timestamp, or `null` if not started.
+    </ResponseField>
+    <ResponseField name="transcript" type="array of objects">
+      Ordered conversation transcript. Empty array if unavailable.
+    </ResponseField>
+    <ResponseField name="scenario" type="object or null">
+      Object with `id` and `name` of the source scenario, or `null` if deleted.
+    </ResponseField>
+    <ResponseField name="overall_score" type="number or null">
+      Aggregate evaluation score (0-100), or `null` if not yet computed.
+    </ResponseField>
+    <ResponseField name="eval_outputs" type="object or null">
+      Raw outputs from each evaluation metric, or `null` if not processed.
+    </ResponseField>
+    <ResponseField name="eval_metrics" type="object or null">
+      Computed evaluation metric values by metric name, or `null`.
+    </ResponseField>
+    <ResponseField name="customer_name" type="string or null">
+      Simulated customer name from scenario data, or `null`.
+    </ResponseField>
+    <ResponseField name="call_summary" type="string or null">
+      Auto-generated call summary, or `null`.
+    </ResponseField>
+    <ResponseField name="ended_reason" type="string or null">
+      Reason the call ended (e.g., `"completed"`, `"timeout"`, `"error"`), or `null`.
+    </ResponseField>
+    <ResponseField name="avg_agent_latency" type="number or null">
+      Average agent response latency in seconds, or `null`.
+    </ResponseField>
+    <ResponseField name="scenario_id" type="string or null">
+      UUID of the source scenario, or `null`.
+    </ResponseField>
+    <ResponseField name="is_snapshot" type="boolean">
+      Whether this is a preserved historical snapshot.
+    </ResponseField>
+    <ResponseField name="rerun_type" type="string or null">
+      Type of rerun, or `null` for original executions.
+    </ResponseField>
+    <ResponseField name="created_at" type="string">
+      ISO 8601 creation timestamp.
+    </ResponseField>
+  </ApiCollapsible>
+</ApiSection>
+
+<ApiSection title="Errors">
+  <ParamField name="401" type="Unauthorized">
+    Missing or invalid `X-Api-Key` or `X-Secret-Key` headers.
+  </ParamField>
+  <ParamField name="404" type="Not Found">
+    No test run found with the specified `run_test_id`.
+  </ParamField>
+  <ParamField name="500" type="Internal Server Error">
+    Unexpected server error. Contact support if it persists.
+  </ParamField>
+</ApiSection>
diff --git a/src/pages/docs/api/run-tests/getevalsummary.mdx b/src/pages/docs/api/run-tests/getevalsummary.mdx
new file mode 100644
index 00000000..eec23def
--- /dev/null
+++ b/src/pages/docs/api/run-tests/getevalsummary.mdx
@@ -0,0 +1,73 @@
+---
+title: "Get evaluation summary"
+description: "Returns the evaluation summary for a test run."
+---
+
+<ApiPlayground
+  method="GET"
+  endpoint="/simulate/run-tests/{run_test_id}/eval-summary/"
+  baseUrl="https://api.futureagi.com"
+  parameters={[
+    {"name": "run_test_id", "in": "path", "required": true, "description": "UUID of the test run whose evaluation summary to retrieve.", "type": "string"},
+    {"name": "execution_id", "in": "query", "required": false, "description": "UUID of a specific test execution to filter the summary.", "type": "string"}
+  ]}
+  responseExample={{"evaluations": [{"name": "Tone Check", "average_score": 0.85, "total_runs": 10, "passed": 8, "failed": 2}]}}
+  responseStatus={200}
+  responseStatusText="OK"
+/>
+
+<ApiSection title="Authentication">
+  <ParamField name="X-Api-Key" type="API Key" required>
+    Your Future AGI API key used to authenticate requests. You can find and manage your API keys in the [Dashboard](https://app.futureagi.com) under Settings.
+  </ParamField>
+  <ParamField name="X-Secret-Key" type="Secret Key" required>
+    Your Future AGI secret key, used alongside the API key for request authentication. This is generated when you create an API key in the [Dashboard](https://app.futureagi.com).
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Path parameters">
+  <ParamField path="run_test_id" type="UUID" required>
+    UUID of the test run whose evaluation summary to retrieve.
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Query parameters">
+  <ParamField query="execution_id" type="string">
+    UUID of a specific execution to scope the summary to. If omitted, aggregates across all executions.
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Response" status={200} statusText="OK">
+  <ResponseField name="evaluations" type="array">
+    Array of evaluation summary objects, one per eval config.
+  </ResponseField>
+  <ApiCollapsible title="Show 5 properties">
+    <ResponseField name="name" type="string">
+      Name of the evaluation configuration.
+    </ResponseField>
+    <ResponseField name="average_score" type="number">
+      Average score across all evaluated calls.
+    </ResponseField>
+    <ResponseField name="total_runs" type="integer">
+      Total evaluation runs for this config.
+    </ResponseField>
+    <ResponseField name="passed" type="integer">
+      Number of passing evaluations.
+    </ResponseField>
+    <ResponseField name="failed" type="integer">
+      Number of failing evaluations.
+    </ResponseField>
+  </ApiCollapsible>
+</ApiSection>
+
+<ApiSection title="Errors">
+  <ParamField name="401" type="Unauthorized">
+    Missing or invalid `X-Api-Key` or `X-Secret-Key` headers.
+  </ParamField>
+  <ParamField name="404" type="Not Found">
+    No test run found with the specified `run_test_id`.
+  </ParamField>
+  <ParamField name="500" type="Internal Server Error">
+    Unexpected server error. Contact support if it persists.
+  </ParamField>
+</ApiSection>
diff --git a/src/pages/docs/api/run-tests/getruntestdetails.mdx b/src/pages/docs/api/run-tests/getruntestdetails.mdx
new file mode 100644
index 00000000..c1b92aad
--- /dev/null
+++ b/src/pages/docs/api/run-tests/getruntestdetails.mdx
@@ -0,0 +1,118 @@
+---
+title: "Get test run details"
+description: "Retrieves a test run by ID."
+---
+
+<ApiPlayground
+  method="GET"
+  endpoint="/simulate/run-tests/{run_test_id}/"
+  baseUrl="https://api.futureagi.com"
+  parameters={[
+    {"name": "run_test_id", "in": "path", "required": true, "description": "UUID of the test run to retrieve.", "type": "string"}
+  ]}
+  responseExample={{"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "name": "Checkout Flow Test", "description": "End-to-end checkout validation", "agent_definition": "b2c3d4e5-f6a7-8901-bcde-f12345678901", "agent_version": "c3d4e5f6-a7b8-9012-cdef-123456789012", "agent_definition_detail": {}, "source_type": "agent_definition", "source_type_display": "Agent Definition", "prompt_template": null, "prompt_template_detail": null, "prompt_version": null, "prompt_version_detail": null, "scenarios": [], "scenarios_detail": [], "dataset_row_ids": [], "simulator_agent": null, "simulator_agent_detail": null, "simulate_eval_configs": [], "simulate_eval_configs_detail": [], "evals_detail": [], "enable_tool_evaluation": false, "created_at": "2026-04-04T12:00:00Z", "updated_at": "2026-04-04T12:00:00Z", "last_run_at": null}}
+  responseStatus={200}
+  responseStatusText="OK"
+/>
+
+<ApiSection title="Authentication">
+  <ParamField name="X-Api-Key" type="API Key" required>
+    Your Future AGI API key used to authenticate requests. You can find and manage your API keys in the [Dashboard](https://app.futureagi.com) under Settings.
+  </ParamField>
+  <ParamField name="X-Secret-Key" type="Secret Key" required>
+    Your Future AGI secret key, used alongside the API key for request authentication. This is generated when you create an API key in the [Dashboard](https://app.futureagi.com).
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Path parameters">
+  <ParamField path="run_test_id" type="UUID" required>
+    UUID of the test run to retrieve.
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Response" status={200} statusText="OK">
+  <ResponseField name="id" type="string">
+    UUID of the test run.
+  </ResponseField>
+  <ResponseField name="name" type="string">
+    Display name of the test run.
+  </ResponseField>
+  <ResponseField name="description" type="string">
+    Description of the test run, or empty string if none provided.
+  </ResponseField>
+  <ResponseField name="agent_definition" type="string or null">
+    UUID of the associated agent definition, or `null` if using a prompt template.
+  </ResponseField>
+  <ResponseField name="agent_version" type="string or null">
+    UUID of the specific agent version, or `null` if using the active version.
+  </ResponseField>
+  <ResponseField name="agent_definition_detail" type="object or null">
+    Expanded agent definition details, or `null` if none associated.
+  </ResponseField>
+  <ResponseField name="source_type" type="string">
+    Either `agent_definition` or `prompt`.
+  </ResponseField>
+  <ResponseField name="source_type_display" type="string">
+    Human-readable source type label.
+  </ResponseField>
+  <ResponseField name="prompt_template" type="string or null">
+    UUID of the associated prompt template, or `null` if using an agent definition.
+  </ResponseField>
+  <ResponseField name="prompt_template_detail" type="object or null">
+    Expanded prompt template details, or `null` if none associated.
+  </ResponseField>
+  <ResponseField name="prompt_version" type="string or null">
+    UUID of the specific prompt version, or `null` if none specified.
+  </ResponseField>
+  <ResponseField name="prompt_version_detail" type="object or null">
+    Expanded prompt version details, or `null` if none specified.
+  </ResponseField>
+  <ResponseField name="scenarios" type="array of string">
+    Array of linked scenario UUIDs.
+  </ResponseField>
+  <ResponseField name="scenarios_detail" type="array of objects">
+    Expanded scenario objects with full details.
+  </ResponseField>
+  <ResponseField name="dataset_row_ids" type="array of string">
+    Specific dataset row UUIDs this test run is restricted to. Empty array means all rows.
+  </ResponseField>
+  <ResponseField name="simulator_agent" type="string or null">
+    UUID of the custom simulator agent, or `null` if using the default.
+  </ResponseField>
+  <ResponseField name="simulator_agent_detail" type="object or null">
+    Expanded simulator agent details, or `null` if none assigned.
+  </ResponseField>
+  <ResponseField name="simulate_eval_configs" type="array of string">
+    Array of associated evaluation configuration UUIDs.
+  </ResponseField>
+  <ResponseField name="simulate_eval_configs_detail" type="array of objects">
+    Expanded evaluation configuration objects.
+  </ResponseField>
+  <ResponseField name="evals_detail" type="array of objects">
+    Combined evaluation details for all configured evaluations.
+  </ResponseField>
+  <ResponseField name="enable_tool_evaluation" type="boolean">
+    Whether tool evaluation is enabled.
+  </ResponseField>
+  <ResponseField name="created_at" type="string">
+    ISO 8601 creation timestamp.
+  </ResponseField>
+  <ResponseField name="updated_at" type="string">
+    ISO 8601 last-modified timestamp.
+  </ResponseField>
+  <ResponseField name="last_run_at" type="string or null">
+    ISO 8601 timestamp of the most recent execution, or `null` if never executed.
+  </ResponseField>
+</ApiSection>
+
+<ApiSection title="Errors">
+  <ParamField name="401" type="Unauthorized">
+    Missing or invalid `X-Api-Key` or `X-Secret-Key` headers.
+  </ParamField>
+  <ParamField name="404" type="Not Found">
+    No test run found with the specified `run_test_id`.
+  </ParamField>
+  <ParamField name="500" type="Internal Server Error">
+    Unexpected server error. Contact support if it persists.
+  </ParamField>
+</ApiSection>
diff --git a/src/pages/docs/api/run-tests/gettestexecutions.mdx b/src/pages/docs/api/run-tests/gettestexecutions.mdx
new file mode 100644
index 00000000..6162b1b4
--- /dev/null
+++ b/src/pages/docs/api/run-tests/gettestexecutions.mdx
@@ -0,0 +1,124 @@
+---
+title: "Get test executions"
+description: "Lists test executions for a test run."
+---
+
+<ApiPlayground
+  method="GET"
+  endpoint="/simulate/run-tests/{run_test_id}/executions/"
+  baseUrl="https://api.futureagi.com"
+  parameters={[
+    {"name": "run_test_id", "in": "path", "required": true, "description": "UUID of the test run whose executions to retrieve.", "type": "string"},
+    {"name": "search", "in": "query", "required": false, "description": "Filter executions by status or scenario name.", "type": "string"},
+    {"name": "status", "in": "query", "required": false, "description": "Filter by execution status (PENDING, RUNNING, COMPLETED, FAILED, CANCELLED).", "type": "string"},
+    {"name": "limit", "in": "query", "required": false, "description": "Maximum number of records per page (default: 10).", "type": "integer"},
+    {"name": "page", "in": "query", "required": false, "description": "Page number to retrieve (default: 1).", "type": "integer"}
+  ]}
+  responseExample={{"count": 3, "next": null, "previous": null, "results": [{"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "run_test": "b2c3d4e5-f6a7-8901-bcde-f12345678901", "status": "COMPLETED", "started_at": "2026-04-04T12:00:00Z", "completed_at": "2026-04-04T12:05:30Z", "total_scenarios": 5, "total_calls": 25, "completed_calls": 25, "failed_calls": 0, "duration_seconds": 330.0, "success_rate": 100.0, "scenario_ids": [], "simulator_agent_name": "Default Simulator", "agent_definition_used_name": "Checkout Agent", "created_at": "2026-04-04T12:00:00Z"}]}}
+  responseStatus={200}
+  responseStatusText="OK"
+/>
+
+<ApiSection title="Authentication">
+  <ParamField name="X-Api-Key" type="API Key" required>
+    Your Future AGI API key used to authenticate requests. You can find and manage your API keys in the [Dashboard](https://app.futureagi.com) under Settings.
+  </ParamField>
+  <ParamField name="X-Secret-Key" type="Secret Key" required>
+    Your Future AGI secret key, used alongside the API key for request authentication. This is generated when you create an API key in the [Dashboard](https://app.futureagi.com).
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Path parameters">
+  <ParamField path="run_test_id" type="UUID" required>
+    UUID of the test run whose executions to retrieve.
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Query parameters">
+  <ParamField query="search" type="string" optional>
+    Case-insensitive partial match on execution status or scenario name.
+  </ParamField>
+  <ParamField query="status" type="string" optional>
+    Filter by execution status. Accepted values: `PENDING`, `RUNNING`, `COMPLETED`, `FAILED`, `CANCELLED`.
+  </ParamField>
+  <ParamField query="limit" type="integer" optional>
+    Number of records per page. Defaults to `10`. Must be a positive integer.
+  </ParamField>
+  <ParamField query="page" type="integer" optional>
+    Page number to retrieve. Defaults to `1`.
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Response" status={200} statusText="OK">
+  <ResponseField name="count" type="integer">
+    Total matching executions across all pages.
+  </ResponseField>
+  <ResponseField name="next" type="string or null">
+    URL to the next page, or `null` if on the last page.
+  </ResponseField>
+  <ResponseField name="previous" type="string or null">
+    URL to the previous page, or `null` if on the first page.
+  </ResponseField>
+  <ResponseField name="results" type="array of objects">
+    Array of test execution objects for the current page.
+  </ResponseField>
+  <ApiCollapsible title="Show 15 properties">
+    <ResponseField name="id" type="string">
+      UUID of the test execution.
+    </ResponseField>
+    <ResponseField name="run_test" type="string">
+      UUID of the parent test run.
+    </ResponseField>
+    <ResponseField name="status" type="string">
+      One of `PENDING`, `RUNNING`, `COMPLETED`, `FAILED`, or `CANCELLED`.
+    </ResponseField>
+    <ResponseField name="started_at" type="string or null">
+      ISO 8601 timestamp when execution began, or `null` if not yet started.
+    </ResponseField>
+    <ResponseField name="completed_at" type="string or null">
+      ISO 8601 timestamp when execution finished, or `null` if still running.
+    </ResponseField>
+    <ResponseField name="total_scenarios" type="integer">
+      Number of scenarios in this execution.
+    </ResponseField>
+    <ResponseField name="total_calls" type="integer">
+      Total simulation calls scheduled across all scenarios.
+    </ResponseField>
+    <ResponseField name="completed_calls" type="integer">
+      Number of successfully completed calls.
+    </ResponseField>
+    <ResponseField name="failed_calls" type="integer">
+      Number of failed calls.
+    </ResponseField>
+    <ResponseField name="duration_seconds" type="number or null">
+      Elapsed time in seconds, or `null` if not yet completed.
+    </ResponseField>
+    <ResponseField name="success_rate" type="number or null">
+      Percentage of successful calls, or `null` if no calls processed.
+    </ResponseField>
+    <ResponseField name="scenario_ids" type="array of string">
+      Scenario UUIDs included in this execution.
+    </ResponseField>
+    <ResponseField name="simulator_agent_name" type="string or null">
+      Name of the simulator agent used, or `null` if default.
+    </ResponseField>
+    <ResponseField name="agent_definition_used_name" type="string or null">
+      Name of the tested agent definition, or `null` if deleted.
+    </ResponseField>
+    <ResponseField name="created_at" type="string">
+      ISO 8601 creation timestamp.
+    </ResponseField>
+  </ApiCollapsible>
+</ApiSection>
+
+<ApiSection title="Errors">
+  <ParamField name="401" type="Unauthorized">
+    Missing or invalid `X-Api-Key` or `X-Secret-Key` headers.
+  </ParamField>
+  <ParamField name="404" type="Not Found">
+    No test run found with the specified `run_test_id`.
+  </ParamField>
+  <ParamField name="500" type="Internal Server Error">
+    Unexpected server error. Contact support if it persists.
+  </ParamField>
+</ApiSection>
diff --git a/src/pages/docs/api/run-tests/gettestscenarios.mdx b/src/pages/docs/api/run-tests/gettestscenarios.mdx
new file mode 100644
index 00000000..cc9c304b
--- /dev/null
+++ b/src/pages/docs/api/run-tests/gettestscenarios.mdx
@@ -0,0 +1,84 @@
+---
+title: "Get scenarios for a test run"
+description: "Lists scenarios for a test run."
+---
+
+<ApiPlayground
+  method="GET"
+  endpoint="/simulate/run-tests/{run_test_id}/scenarios/"
+  baseUrl="https://api.futureagi.com"
+  parameters={[
+    {"name": "run_test_id", "in": "path", "required": true, "description": "UUID of the test run whose scenarios to retrieve.", "type": "string"},
+    {"name": "search", "in": "query", "required": false, "description": "Filter scenarios by name, source, or type.", "type": "string"},
+    {"name": "limit", "in": "query", "required": false, "description": "Maximum number of records per page (default: 10).", "type": "integer"},
+    {"name": "page", "in": "query", "required": false, "description": "Page number to retrieve (default: 1).", "type": "integer"}
+  ]}
+  responseExample={{"count": 5, "next": null, "previous": null, "results": [{"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "name": "Happy Path - Complete Purchase", "row_count": 12}]}}
+  responseStatus={200}
+  responseStatusText="OK"
+/>
+
+<ApiSection title="Authentication">
+  <ParamField name="X-Api-Key" type="API Key" required>
+    Your Future AGI API key used to authenticate requests. You can find and manage your API keys in the [Dashboard](https://app.futureagi.com) under Settings.
+  </ParamField>
+  <ParamField name="X-Secret-Key" type="Secret Key" required>
+    Your Future AGI secret key, used alongside the API key for request authentication. This is generated when you create an API key in the [Dashboard](https://app.futureagi.com).
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Path parameters">
+  <ParamField path="run_test_id" type="UUID" required>
+    UUID of the test run whose scenarios to retrieve.
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Query parameters">
+  <ParamField query="search" type="string" optional>
+    Case-insensitive partial match on scenario name, source, or type.
+  </ParamField>
+  <ParamField query="limit" type="integer" optional>
+    Number of records per page. Defaults to `10`. Must be a positive integer.
+  </ParamField>
+  <ParamField query="page" type="integer" optional>
+    Page number to retrieve. Defaults to `1`.
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Response" status={200} statusText="OK">
+  <ResponseField name="count" type="integer">
+    Total matching scenarios across all pages.
+  </ResponseField>
+  <ResponseField name="next" type="string or null">
+    URL to the next page, or `null` if on the last page.
+  </ResponseField>
+  <ResponseField name="previous" type="string or null">
+    URL to the previous page, or `null` if on the first page.
+  </ResponseField>
+  <ResponseField name="results" type="array of objects">
+    Array of scenario summary objects for the current page.
+  </ResponseField>
+  <ApiCollapsible title="Show 3 properties">
+    <ResponseField name="id" type="string">
+      UUID of the scenario.
+    </ResponseField>
+    <ResponseField name="name" type="string">
+      Display name of the scenario.
+    </ResponseField>
+    <ResponseField name="row_count" type="integer">
+      Number of data rows in the scenario. Each row generates a distinct test call.
+    </ResponseField>
+  </ApiCollapsible>
+</ApiSection>
+
+<ApiSection title="Errors">
+  <ParamField name="401" type="Unauthorized">
+    Missing or invalid `X-Api-Key` or `X-Secret-Key` headers.
+  </ParamField>
+  <ParamField name="404" type="Not Found">
+    No test run found with the specified `run_test_id`.
+  </ParamField>
+  <ParamField name="500" type="Internal Server Error">
+    Unexpected server error. Contact support if it persists.
+  </ParamField>
+</ApiSection>
diff --git a/src/pages/docs/api/run-tests/listruntests.mdx b/src/pages/docs/api/run-tests/listruntests.mdx
new file mode 100644
index 00000000..fd63e171
--- /dev/null
+++ b/src/pages/docs/api/run-tests/listruntests.mdx
@@ -0,0 +1,103 @@
+---
+title: "List test runs"
+description: "Lists all test runs."
+---
+
+<ApiPlayground
+  method="GET"
+  endpoint="/simulate/run-tests/"
+  baseUrl="https://api.futureagi.com"
+  parameters={[{"name": "search", "in": "query", "required": false, "description": "Filter by test run name or agent definition name.", "type": "string"}, {"name": "limit", "in": "query", "required": false, "description": "Number of items per page. Default: 10.", "type": "integer"}, {"name": "page", "in": "query", "required": false, "description": "Page number. Default: 1.", "type": "integer"}, {"name": "simulation_type", "in": "query", "required": false, "description": "Filter by source type: 'agent_definition' or 'prompt'.", "type": "string"}, {"name": "prompt_template_id", "in": "query", "required": false, "description": "Filter by prompt template UUID.", "type": "string"}]}
+  responseExample={{"count": 42, "next": "https://api.futureagi.com/simulate/run-tests/?page=2&limit=10", "previous": null, "results": [{"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "name": "Checkout Flow Test", "description": "End-to-end checkout validation", "agent_definition": "b2c3d4e5-f6a7-8901-bcde-f12345678901", "agent_definition_detail": {}, "source_type": "agent_definition", "source_type_display": "Agent Definition", "scenarios": [], "enable_tool_evaluation": false, "created_at": "2026-04-04T12:00:00Z", "updated_at": "2026-04-04T12:00:00Z", "last_run_at": null}]}}
+  responseStatus={200}
+  responseStatusText="OK"
+/>
+
+<ApiSection title="Authentication">
+  <ParamField name="X-Api-Key" type="API Key" required>
+    Your Future AGI API key used to authenticate requests. You can find and manage your API keys in the [Dashboard](https://app.futureagi.com) under Settings.
+  </ParamField>
+  <ParamField name="X-Secret-Key" type="Secret Key" required>
+    Your Future AGI secret key, used alongside the API key for request authentication. This is generated when you create an API key in the [Dashboard](https://app.futureagi.com).
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Query parameters">
+  <ParamField query="search" type="string">
+    Case-insensitive partial match on test run name or agent definition name.
+  </ParamField>
+  <ParamField query="limit" type="integer">
+    Number of records per page. Defaults to `10`. Must be a positive integer.
+  </ParamField>
+  <ParamField query="page" type="integer">
+    Page number to retrieve. Defaults to `1`.
+  </ParamField>
+  <ParamField query="simulation_type" type="string">
+    Filter by source type. Accepted values: `agent_definition`, `prompt`.
+  </ParamField>
+  <ParamField query="prompt_template_id" type="string">
+    Filter by prompt template UUID.
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Response" status={200} statusText="OK">
+  <ResponseField name="count" type="integer">
+    Total number of matching test runs across all pages.
+  </ResponseField>
+  <ResponseField name="next" type="string or null">
+    URL to the next page, or `null` if on the last page.
+  </ResponseField>
+  <ResponseField name="previous" type="string or null">
+    URL to the previous page, or `null` if on the first page.
+  </ResponseField>
+  <ResponseField name="results" type="array of objects">
+    Array of test run objects for the current page.
+  </ResponseField>
+  <ApiCollapsible title="Show 12 properties">
+    <ResponseField name="id" type="string">
+      UUID of the test run.
+    </ResponseField>
+    <ResponseField name="name" type="string">
+      Display name of the test run.
+    </ResponseField>
+    <ResponseField name="description" type="string">
+      Description of the test run.
+    </ResponseField>
+    <ResponseField name="agent_definition" type="string or null">
+      UUID of the associated agent definition, or `null` if using a prompt template.
+    </ResponseField>
+    <ResponseField name="agent_definition_detail" type="object or null">
+      Expanded agent definition details, or `null` if none associated.
+    </ResponseField>
+    <ResponseField name="source_type" type="string">
+      Either `agent_definition` or `prompt`.
+    </ResponseField>
+    <ResponseField name="source_type_display" type="string">
+      Human-readable source type label.
+    </ResponseField>
+    <ResponseField name="scenarios" type="array of string">
+      Array of linked scenario UUIDs.
+    </ResponseField>
+    <ResponseField name="enable_tool_evaluation" type="boolean">
+      Whether tool evaluation is enabled.
+    </ResponseField>
+    <ResponseField name="created_at" type="string">
+      ISO 8601 creation timestamp.
+    </ResponseField>
+    <ResponseField name="updated_at" type="string">
+      ISO 8601 last-modified timestamp.
+    </ResponseField>
+    <ResponseField name="last_run_at" type="string or null">
+      ISO 8601 timestamp of the most recent execution, or `null` if never executed.
+    </ResponseField>
+  </ApiCollapsible>
+</ApiSection>
+
+<ApiSection title="Errors">
+  <ParamField name="401" type="Unauthorized">
+    Missing or invalid `X-Api-Key` or `X-Secret-Key` headers.
+  </ParamField>
+  <ParamField name="500" type="Internal Server Error">
+    Unexpected server error. Contact support if it persists.
+  </ParamField>
+</ApiSection>
diff --git a/src/pages/docs/api/run-tests/reruntestexecutions.mdx b/src/pages/docs/api/run-tests/reruntestexecutions.mdx
new file mode 100644
index 00000000..5498de5e
--- /dev/null
+++ b/src/pages/docs/api/run-tests/reruntestexecutions.mdx
@@ -0,0 +1,63 @@
+---
+title: "Rerun test executions"
+description: "Reruns test executions."
+---
+
+<ApiPlayground
+  method="POST"
+  endpoint="/simulate/run-tests/{run_test_id}/rerun-test-executions/"
+  baseUrl="https://api.futureagi.com"
+  parameters={[
+    {"name": "run_test_id", "in": "path", "required": true, "description": "UUID of the test run containing the executions to rerun.", "type": "string"}
+  ]}
+  requestBody={{"rerunType": "eval_only", "testExecutionIds": ["execution-uuid-1"], "selectAll": false}}
+  responseExample={{"message": "Rerun initiated successfully"}}
+  responseStatus={200}
+  responseStatusText="OK"
+/>
+
+<ApiSection title="Authentication">
+  <ParamField name="X-Api-Key" type="API Key" required>
+    Your Future AGI API key used to authenticate requests. You can find and manage your API keys in the [Dashboard](https://app.futureagi.com) under Settings.
+  </ParamField>
+  <ParamField name="X-Secret-Key" type="Secret Key" required>
+    Your Future AGI secret key, used alongside the API key for request authentication. This is generated when you create an API key in the [Dashboard](https://app.futureagi.com).
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Path parameters">
+  <ParamField path="run_test_id" type="UUID" required>
+    UUID of the test run containing the executions to rerun.
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Request body">
+  <ParamField body="rerunType" type="string" required>
+    Type of rerun. `eval_only` re-runs evaluations on existing call data. `call_and_eval` re-executes calls and evaluations from scratch.
+  </ParamField>
+  <ParamField body="testExecutionIds" type="array of strings" optional>
+    Array of test execution UUIDs to rerun. Required when `selectAll` is `false`.
+  </ParamField>
+  <ParamField body="selectAll" type="boolean" optional>
+    When `true`, reruns all executions, ignoring `testExecutionIds`. Defaults to `false`.
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Response" status={200} statusText="OK">
+  <ResponseField name="message" type="string">Confirmation that the rerun was initiated.</ResponseField>
+</ApiSection>
+
+<ApiSection title="Errors">
+  <ParamField name="400" type="Bad Request">
+    Invalid or missing `rerunType`, or no executions specified.
+  </ParamField>
+  <ParamField name="401" type="Unauthorized">
+    Missing or invalid `X-Api-Key` or `X-Secret-Key` headers.
+  </ParamField>
+  <ParamField name="404" type="Not Found">
+    No test run found with the specified `run_test_id`.
+  </ParamField>
+  <ParamField name="500" type="Internal Server Error">
+    Unexpected server error. Retry later or contact support.
+  </ParamField>
+</ApiSection>
diff --git a/src/pages/docs/api/run-tests/runnewevalsontestexecution.mdx b/src/pages/docs/api/run-tests/runnewevalsontestexecution.mdx
new file mode 100644
index 00000000..72d0396d
--- /dev/null
+++ b/src/pages/docs/api/run-tests/runnewevalsontestexecution.mdx
@@ -0,0 +1,68 @@
+---
+title: "Run new evaluations on test executions"
+description: "Runs new evaluations on completed test executions."
+---
+
+<ApiPlayground
+  method="POST"
+  endpoint="/simulate/run-tests/{run_test_id}/run-new-evals/"
+  baseUrl="https://api.futureagi.com"
+  parameters={[
+    {"name": "run_test_id", "in": "path", "required": true, "description": "UUID of the test run containing the executions to evaluate.", "type": "string"}
+  ]}
+  requestBody={{"testExecutionIds": ["execution-uuid-1"], "selectAll": false, "evalConfigIds": ["eval-config-uuid-1"], "enableToolEvaluation": false}}
+  responseExample={{"message": "Evaluations started successfully", "run_test_id": "run-test-uuid", "call_execution_count": 5}}
+  responseStatus={200}
+  responseStatusText="OK"
+/>
+
+<ApiSection title="Authentication">
+  <ParamField name="X-Api-Key" type="API Key" required>
+    Your Future AGI API key used to authenticate requests. You can find and manage your API keys in the [Dashboard](https://app.futureagi.com) under Settings.
+  </ParamField>
+  <ParamField name="X-Secret-Key" type="Secret Key" required>
+    Your Future AGI secret key, used alongside the API key for request authentication. This is generated when you create an API key in the [Dashboard](https://app.futureagi.com).
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Path parameters">
+  <ParamField path="run_test_id" type="UUID" required>
+    UUID of the test run containing the executions to evaluate.
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Request body">
+  <ParamField body="testExecutionIds" type="array of strings" optional>
+    Array of test execution UUIDs to evaluate. Required when `selectAll` is `false`. Only `COMPLETED` executions are eligible.
+  </ParamField>
+  <ParamField body="selectAll" type="boolean" optional>
+    When `true`, evaluates all completed executions, ignoring `testExecutionIds`. Defaults to `false`.
+  </ParamField>
+  <ParamField body="evalConfigIds" type="array of strings" required>
+    Array of evaluation configuration UUIDs to run on the selected executions.
+  </ParamField>
+  <ParamField body="enableToolEvaluation" type="boolean" optional>
+    When `true`, also evaluates tool usage by the agent. Defaults to `false`.
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Response" status={200} statusText="OK">
+  <ResponseField name="message" type="string">Confirmation that evaluations were started.</ResponseField>
+  <ResponseField name="run_test_id" type="string">UUID of the parent test run.</ResponseField>
+  <ResponseField name="call_execution_count" type="integer">Number of call executions being evaluated.</ResponseField>
+</ApiSection>
+
+<ApiSection title="Errors">
+  <ParamField name="400" type="Bad Request">
+    Missing or empty `evalConfigIds`, no executions specified, or no completed executions found.
+  </ParamField>
+  <ParamField name="401" type="Unauthorized">
+    Missing or invalid `X-Api-Key` or `X-Secret-Key` headers.
+  </ParamField>
+  <ParamField name="404" type="Not Found">
+    No test run found with the specified `run_test_id`.
+  </ParamField>
+  <ParamField name="500" type="Internal Server Error">
+    Unexpected server error. Retry later or contact support.
+  </ParamField>
+</ApiSection>
diff --git a/src/pages/docs/api/run-tests/updateevalconfig.mdx b/src/pages/docs/api/run-tests/updateevalconfig.mdx
new file mode 100644
index 00000000..f357947c
--- /dev/null
+++ b/src/pages/docs/api/run-tests/updateevalconfig.mdx
@@ -0,0 +1,82 @@
+---
+title: "Update evaluation configuration"
+description: "Updates an evaluation configuration for a test run."
+---
+
+<ApiPlayground
+  method="PATCH"
+  endpoint="/simulate/run-tests/{run_test_id}/eval-configs/{eval_config_id}/update/"
+  baseUrl="https://api.futureagi.com"
+  parameters={[
+    {"name": "run_test_id", "in": "path", "required": true, "description": "UUID of the test run containing the evaluation configuration.", "type": "string"},
+    {"name": "eval_config_id", "in": "path", "required": true, "description": "UUID of the evaluation configuration to update.", "type": "string"}
+  ]}
+  requestBody={{"config": {"config": {}, "mapping": {}}, "mapping": {}, "model": "turing_large", "errorLocalizer": false, "name": "Updated Config Name", "run": false}}
+  responseExample={{"message": "Evaluation config updated successfully"}}
+  responseStatus={200}
+  responseStatusText="OK"
+/>
+
+<ApiSection title="Authentication">
+  <ParamField name="X-Api-Key" type="API Key" required>
+    Your Future AGI API key used to authenticate requests. You can find and manage your API keys in the [Dashboard](https://app.futureagi.com) under Settings.
+  </ParamField>
+  <ParamField name="X-Secret-Key" type="Secret Key" required>
+    Your Future AGI secret key, used alongside the API key for request authentication. This is generated when you create an API key in the [Dashboard](https://app.futureagi.com).
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Path parameters">
+  <ParamField path="run_test_id" type="UUID" required>
+    The test run ID.
+  </ParamField>
+  <ParamField path="eval_config_id" type="UUID" required>
+    The evaluation configuration ID.
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Request body">
+  <ParamField body="config" type="object" optional>
+    Updated evaluation configuration parameters. Supports nested `config` and `mapping` keys.
+  </ParamField>
+  <ParamField body="mapping" type="object" optional>
+    Updated field mapping between test data and evaluation inputs.
+  </ParamField>
+  <ParamField body="model" type="string" optional>
+    Model to use for evaluations.
+  </ParamField>
+  <ParamField body="errorLocalizer" type="boolean" optional>
+    Enable granular error localization in evaluation results.
+  </ParamField>
+  <ParamField body="kbId" type="string" optional>
+    UUID of a knowledge base to use for grounding.
+  </ParamField>
+  <ParamField body="name" type="string" optional>
+    Updated name for the evaluation configuration.
+  </ParamField>
+  <ParamField body="run" type="boolean" optional>
+    When `true`, triggers an immediate rerun after updating. Defaults to `false`.
+  </ParamField>
+  <ParamField body="testExecutionId" type="string" optional>
+    UUID of the test execution to rerun against. Required when `run` is `true`.
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Response" status={200} statusText="OK">
+  <ResponseField name="message" type="string">Confirmation message.</ResponseField>
+</ApiSection>
+
+<ApiSection title="Errors">
+  <ParamField name="400" type="Bad Request">
+    Invalid data or missing `testExecutionId` when `run` is `true`.
+  </ParamField>
+  <ParamField name="401" type="Unauthorized">
+    Invalid or missing API credentials.
+  </ParamField>
+  <ParamField name="404" type="Not Found">
+    Test run or evaluation configuration not found.
+  </ParamField>
+  <ParamField name="500" type="Internal Server Error">
+    Unexpected server error.
+  </ParamField>
+</ApiSection>
diff --git a/src/pages/docs/api/run-tests/updatetestcomponents.mdx b/src/pages/docs/api/run-tests/updatetestcomponents.mdx
new file mode 100644
index 00000000..faa7b26a
--- /dev/null
+++ b/src/pages/docs/api/run-tests/updatetestcomponents.mdx
@@ -0,0 +1,69 @@
+---
+title: "Update test run components"
+description: "Updates components of a test run."
+---
+
+<ApiPlayground
+  method="PATCH"
+  endpoint="/simulate/run-tests/{run_test_id}/components/"
+  baseUrl="https://api.futureagi.com"
+  parameters={[
+    {"name": "run_test_id", "in": "path", "required": true, "description": "UUID of the test run whose components to update.", "type": "string"}
+  ]}
+  requestBody={{"agentDefinitionId": "your-agent-definition-id", "version": "your-version-id", "simulatorAgentId": "your-simulator-agent-id", "scenarios": ["scenario-uuid-1"], "enableToolEvaluation": false}}
+  responseExample={{"message": "Test run components updated successfully"}}
+  responseStatus={200}
+  responseStatusText="OK"
+/>
+
+<ApiSection title="Authentication">
+  <ParamField name="X-Api-Key" type="API Key" required>
+    Your Future AGI API key used to authenticate requests. You can find and manage your API keys in the [Dashboard](https://app.futureagi.com) under Settings.
+  </ParamField>
+  <ParamField name="X-Secret-Key" type="Secret Key" required>
+    Your Future AGI secret key, used alongside the API key for request authentication. This is generated when you create an API key in the [Dashboard](https://app.futureagi.com).
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Path parameters">
+  <ParamField path="run_test_id" type="UUID" required>
+    The test run ID.
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Request body">
+  <ParamField body="agentDefinitionId" type="string" optional>
+    UUID of the new agent definition.
+  </ParamField>
+  <ParamField body="version" type="string" optional>
+    UUID of a specific agent version. Defaults to the active version if omitted.
+  </ParamField>
+  <ParamField body="simulatorAgentId" type="string" optional>
+    UUID of the simulator agent.
+  </ParamField>
+  <ParamField body="scenarios" type="array of strings" optional>
+    Array of scenario UUIDs. Replaces the entire set.
+  </ParamField>
+  <ParamField body="enableToolEvaluation" type="boolean" optional>
+    Enable tool call evaluation. Requires `api_key` and `assistant_id` on the agent. Defaults to `false`.
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Response" status={200} statusText="OK">
+  <ResponseField name="data" type="object">Updated test run object.</ResponseField>
+</ApiSection>
+
+<ApiSection title="Errors">
+  <ParamField name="400" type="Bad Request">
+    Invalid data or missing prerequisites for tool evaluation.
+  </ParamField>
+  <ParamField name="401" type="Unauthorized">
+    Invalid or missing API credentials.
+  </ParamField>
+  <ParamField name="404" type="Not Found">
+    Test run not found.
+  </ParamField>
+  <ParamField name="500" type="Internal Server Error">
+    Unexpected server error.
+  </ParamField>
+</ApiSection>
diff --git a/src/pages/docs/api/scenarios/getscenario.mdx b/src/pages/docs/api/scenarios/getscenario.mdx
index c1cdf9ec..9f19d10b 100644
--- a/src/pages/docs/api/scenarios/getscenario.mdx
+++ b/src/pages/docs/api/scenarios/getscenario.mdx
@@ -48,12 +48,16 @@ description: "Retrieves a scenario by ID, including its graph, prompts, and data
   <ResponseField name="description" type="string">Scenario description.</ResponseField>
   <ResponseField name="source" type="string">Data source used to create the scenario.</ResponseField>
   <ResponseField name="scenario_type" type="string">Type: `dataset`, `script`, or `graph`.</ResponseField>
-  <ResponseField name="dataset_id" type="string">UUID of the underlying dataset, or `null`.</ResponseField>
+  <ResponseField name="dataset_id" type="string">UUID of the underlying dataset. `null` if none.</ResponseField>
   <ResponseField name="agent_type" type="string">Agent type: `voice` or `text`.</ResponseField>
   <ResponseField name="status" type="string">Status: `processing`, `completed`, or `failed`.</ResponseField>
-  <ResponseField name="graph" type="object">Conversation graph structure. Empty `{}` if none.</ResponseField>
-  <ResponseField name="prompts" type="array">Simulator agent prompts, each with `role` and `content`.</ResponseField>
-  <ResponseField name="dataset_rows" type="integer">Number of test case rows in the dataset.</ResponseField>
+  <ResponseField name="graph" type="object">Conversation graph structure. `{}` if none.</ResponseField>
+  <ResponseField name="prompts" type="array">Simulator agent prompts.</ResponseField>
+  <ApiCollapsible title="Show 2 properties">
+    <ResponseField name="role" type="string">Prompt role (e.g., `"system"`).</ResponseField>
+    <ResponseField name="content" type="string">Prompt text.</ResponseField>
+  </ApiCollapsible>
+  <ResponseField name="dataset_rows" type="integer">Number of test case rows.</ResponseField>
   <ResponseField name="created_at" type="datetime">ISO 8601 creation timestamp.</ResponseField>
   <ResponseField name="updated_at" type="datetime">ISO 8601 last-modified timestamp.</ResponseField>
 </ApiSection>
diff --git a/src/pages/docs/api/scenarios/listscenarios.mdx b/src/pages/docs/api/scenarios/listscenarios.mdx
index ab553b0c..de8966ca 100644
--- a/src/pages/docs/api/scenarios/listscenarios.mdx
+++ b/src/pages/docs/api/scenarios/listscenarios.mdx
@@ -52,10 +52,24 @@ description: "Returns a paginated list of scenarios with optional search and fil
 </ApiSection>
 
 <ApiSection title="Response" status={200} statusText="OK">
-  <ResponseField name="count" type="integer">Total number of matching scenarios.</ResponseField>
+  <ResponseField name="count" type="integer">Total matching scenarios.</ResponseField>
   <ResponseField name="next" type="string">URL of the next page, or `null`.</ResponseField>
   <ResponseField name="previous" type="string">URL of the previous page, or `null`.</ResponseField>
-  <ResponseField name="results" type="array">Array of scenario objects for the current page.</ResponseField>
+  <ResponseField name="results" type="array">Array of scenario objects.</ResponseField>
+  <ApiCollapsible title="Show 12 properties">
+    <ResponseField name="id" type="string">UUID of the scenario.</ResponseField>
+    <ResponseField name="name" type="string">Scenario name.</ResponseField>
+    <ResponseField name="description" type="string">Scenario description.</ResponseField>
+    <ResponseField name="source" type="string">Data source.</ResponseField>
+    <ResponseField name="scenario_type" type="string">Scenario type.</ResponseField>
+    <ResponseField name="scenario_type_display" type="string">Display label for scenario type.</ResponseField>
+    <ResponseField name="source_type" type="string">Source type classification.</ResponseField>
+    <ResponseField name="source_type_display" type="string">Display label for source type.</ResponseField>
+    <ResponseField name="dataset_rows" type="integer">Number of test case rows.</ResponseField>
+    <ResponseField name="agent_type" type="string">Agent type: `voice` or `text`.</ResponseField>
+    <ResponseField name="status" type="string">Current status.</ResponseField>
+    <ResponseField name="created_at" type="datetime">ISO 8601 creation timestamp.</ResponseField>
+  </ApiCollapsible>
 </ApiSection>
 
 <ApiSection title="Errors">
diff --git a/src/pages/docs/api/test-executions/cancelexecution.mdx b/src/pages/docs/api/test-executions/cancelexecution.mdx
new file mode 100644
index 00000000..be2f3888
--- /dev/null
+++ b/src/pages/docs/api/test-executions/cancelexecution.mdx
@@ -0,0 +1,55 @@
+---
+title: "Cancel test execution"
+description: "Cancels a test execution."
+---
+
+<ApiPlayground
+  method="POST"
+  endpoint="/simulate/test-executions/{test_execution_id}/cancel/"
+  baseUrl="https://api.futureagi.com"
+  parameters={[
+    {"name": "test_execution_id", "in": "path", "required": true, "description": "UUID of the test execution to cancel.", "type": "string"}
+  ]}
+  requestBody={{}}
+  responseExample={{
+    success: true,
+    message: "Test execution cancellation initiated",
+    test_execution_id: "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
+  }}
+  responseStatus={200}
+  responseStatusText="OK"
+/>
+
+<ApiSection title="Authentication">
+  <ParamField name="X-Api-Key" type="API Key" required>
+    Your Future AGI API key used to authenticate requests. You can find and manage your API keys in the [Dashboard](https://app.futureagi.com) under Settings.
+  </ParamField>
+  <ParamField name="X-Secret-Key" type="Secret Key" required>
+    Your Future AGI secret key, used alongside the API key for request authentication. This is generated when you create an API key in the [Dashboard](https://app.futureagi.com).
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Path parameters">
+  <ParamField path="test_execution_id" type="UUID" required>
+    The test execution ID. Must be in `pending`, `running`, or `evaluating` state.
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Request body">
+  <ParamField body="(empty)" type="object" optional>
+    No body required. Send `{}`.
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Response" status={200} statusText="OK">
+  <ResponseField name="success" type="boolean">Whether the cancellation was accepted.</ResponseField>
+  <ResponseField name="message" type="string">Confirmation message.</ResponseField>
+  <ResponseField name="test_execution_id" type="string">UUID of the cancelled test execution.</ResponseField>
+</ApiSection>
+
+<ApiSection title="Errors">
+  <ParamField name="400" type="Bad Request">Execution is already in a terminal state.</ParamField>
+  <ParamField name="401" type="Unauthorized">Invalid or missing credentials.</ParamField>
+  <ParamField name="404" type="Not Found">Test execution not found.</ParamField>
+  <ParamField name="500" type="Internal Server Error">Unexpected server error.</ParamField>
+</ApiSection>
diff --git a/src/pages/docs/api/test-executions/getevalexplanationsummary.mdx b/src/pages/docs/api/test-executions/getevalexplanationsummary.mdx
new file mode 100644
index 00000000..21bc87ce
--- /dev/null
+++ b/src/pages/docs/api/test-executions/getevalexplanationsummary.mdx
@@ -0,0 +1,58 @@
+---
+title: "Get eval explanation summary"
+description: "Retrieves the eval explanation summary for a test execution."
+---
+
+<ApiPlayground
+  method="GET"
+  endpoint="/simulate/test-executions/{test_execution_id}/eval-explanation-summary/"
+  baseUrl="https://api.futureagi.com"
+  parameters={[
+    {"name": "test_execution_id", "in": "path", "required": true, "description": "UUID of the test execution.", "type": "string"}
+  ]}
+  responseExample={{
+    data: {
+      response: {
+        summary: "The agent performed well on tone and accuracy but struggled with complex billing disputes.",
+        critical_issues: ["Agent failed to escalate unresolved billing complaints in 3 out of 10 calls."],
+        recommendations: ["Add escalation logic for billing disputes exceeding $500."]
+      },
+      last_updated: "2026-03-15T12:45:00Z",
+      status: "completed"
+    },
+    success: true
+  }}
+  responseStatus={200}
+  responseStatusText="OK"
+/>
+
+<ApiSection title="Authentication">
+  <ParamField name="X-Api-Key" type="API Key" required>
+    Your Future AGI API key used to authenticate requests. You can find and manage your API keys in the [Dashboard](https://app.futureagi.com) under Settings.
+  </ParamField>
+  <ParamField name="X-Secret-Key" type="Secret Key" required>
+    Your Future AGI secret key, used alongside the API key for request authentication. This is generated when you create an API key in the [Dashboard](https://app.futureagi.com).
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Path parameters">
+  <ParamField path="test_execution_id" type="UUID" required>
+    The test execution ID. Triggers async generation if not yet available.
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Response" status={200} statusText="OK">
+  <ResponseField name="data" type="object">Summary data and generation metadata.</ResponseField>
+  <ApiCollapsible title="Show 3 properties">
+    <ResponseField name="response" type="object or null">Summary with performance overview, issues, and recommendations.</ResponseField>
+    <ResponseField name="last_updated" type="datetime or null">ISO 8601 timestamp of last generation.</ResponseField>
+    <ResponseField name="status" type="string">Generation status: `pending`, `running`, `completed`, or `failed`.</ResponseField>
+  </ApiCollapsible>
+  <ResponseField name="success" type="boolean">Whether the request succeeded.</ResponseField>
+</ApiSection>
+
+<ApiSection title="Errors">
+  <ParamField name="401" type="Unauthorized">Invalid or missing credentials.</ParamField>
+  <ParamField name="404" type="Not Found">Test execution not found.</ParamField>
+  <ParamField name="500" type="Internal Server Error">Unexpected server error.</ParamField>
+</ApiSection>
diff --git a/src/pages/docs/api/test-executions/getkpis.mdx b/src/pages/docs/api/test-executions/getkpis.mdx
new file mode 100644
index 00000000..4e5cfd91
--- /dev/null
+++ b/src/pages/docs/api/test-executions/getkpis.mdx
@@ -0,0 +1,94 @@
+---
+title: "Get execution KPIs"
+description: "Retrieves KPI metrics for a test execution."
+---
+
+<ApiPlayground
+  method="GET"
+  endpoint="/simulate/test-executions/{test_execution_id}/kpis/"
+  baseUrl="https://api.futureagi.com"
+  parameters={[
+    {"name": "test_execution_id", "in": "path", "required": true, "description": "UUID of the test execution.", "type": "string"}
+  ]}
+  responseExample={{
+    total_calls: 50,
+    avg_score: 8.2,
+    avg_response: 1.15,
+    callsAttempted: 50,
+    connectedCalls: 47,
+    callsConnectedPercentage: 94.0,
+    failed_calls: 3,
+    total_duration: 6250,
+    agent_type: "voice",
+    is_inbound: false,
+    scenarioGraphs: {},
+    avg_agent_latency: 0.92,
+    avg_user_interruption_count: 1.4,
+    avg_user_interruption_rate: 0.08,
+    avg_user_wpm: 128.5,
+    avg_bot_wpm: 142.3,
+    avg_talk_ratio: 0.55,
+    avg_ai_interruption_count: 0.3,
+    avg_ai_interruption_rate: 0.02,
+    avg_stop_time_after_interruption: 0.35,
+    agentTalkPercentage: 55.0,
+    customerTalkPercentage: 45.0,
+    avg_tone_check: 8.7,
+    avg_accuracy: 7.9
+  }}
+  responseStatus={200}
+  responseStatusText="OK"
+/>
+
+<ApiSection title="Authentication">
+  <ParamField name="X-Api-Key" type="API Key" required>
+    Your Future AGI API key used to authenticate requests. You can find and manage your API keys in the [Dashboard](https://app.futureagi.com) under Settings.
+  </ParamField>
+  <ParamField name="X-Secret-Key" type="Secret Key" required>
+    Your Future AGI secret key, used alongside the API key for request authentication. This is generated when you create an API key in the [Dashboard](https://app.futureagi.com).
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Path parameters">
+  <ParamField path="test_execution_id" type="UUID" required>
+    The test execution ID. Response fields vary by agent type (voice vs. text).
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Response" status={200} statusText="OK">
+  <ResponseField name="total_calls" type="integer">Total call executions.</ResponseField>
+  <ResponseField name="avg_score" type="number">Average evaluation score across completed calls.</ResponseField>
+  <ResponseField name="avg_response" type="number">Average response time in seconds.</ResponseField>
+  <ResponseField name="callsAttempted" type="integer">Total calls initiated.</ResponseField>
+  <ResponseField name="connectedCalls" type="integer">Calls that connected.</ResponseField>
+  <ResponseField name="callsConnectedPercentage" type="number">Percentage of calls that connected.</ResponseField>
+  <ResponseField name="failed_calls" type="integer">Calls that failed.</ResponseField>
+  <ResponseField name="total_duration" type="integer">Combined duration in seconds.</ResponseField>
+  <ResponseField name="agent_type" type="string">`voice` or `text`.</ResponseField>
+  <ResponseField name="is_inbound" type="boolean or null">`true` for inbound, `false` for outbound. `null` for text agents.</ResponseField>
+  <ResponseField name="scenarioGraphs" type="object">Per-scenario performance data.</ResponseField>
+  <ResponseField name="avg_agent_latency" type="number">Average agent latency in seconds. Voice only.</ResponseField>
+  <ResponseField name="avg_user_interruption_count" type="number">Average user interruptions per call. Voice only.</ResponseField>
+  <ResponseField name="avg_user_interruption_rate" type="number">Average user interruption rate (0-1). Voice only.</ResponseField>
+  <ResponseField name="avg_user_wpm" type="number">Average user words per minute. Voice only.</ResponseField>
+  <ResponseField name="avg_bot_wpm" type="number">Average agent words per minute. Voice only.</ResponseField>
+  <ResponseField name="avg_talk_ratio" type="number">Average agent talk ratio (0-1). Voice only.</ResponseField>
+  <ResponseField name="avg_ai_interruption_count" type="number">Average agent interruptions per call. Voice only.</ResponseField>
+  <ResponseField name="avg_ai_interruption_rate" type="number">Average agent interruption rate (0-1). Voice only.</ResponseField>
+  <ResponseField name="avg_stop_time_after_interruption" type="number">Average seconds to stop after interruption. Voice only.</ResponseField>
+  <ResponseField name="agentTalkPercentage" type="number">Agent talk time percentage (0-100). Voice only.</ResponseField>
+  <ResponseField name="customerTalkPercentage" type="number">Customer talk time percentage (0-100). Voice only.</ResponseField>
+  <ResponseField name="avg_total_tokens" type="number">Average total tokens per call. Text only.</ResponseField>
+  <ResponseField name="avg_input_tokens" type="number">Average input tokens per call. Text only.</ResponseField>
+  <ResponseField name="avg_output_tokens" type="number">Average output tokens per call. Text only.</ResponseField>
+  <ResponseField name="avg_chat_latency_ms" type="number">Average latency in milliseconds. Text only.</ResponseField>
+  <ResponseField name="avg_turn_count" type="number">Average turns per call. Text only.</ResponseField>
+  <ResponseField name="avg_csat_score" type="number">Average CSAT score. Text only.</ResponseField>
+  <ResponseField name="avg_[metric_name]" type="number">Dynamic average for each configured eval metric.</ResponseField>
+</ApiSection>
+
+<ApiSection title="Errors">
+  <ParamField name="401" type="Unauthorized">Invalid or missing credentials.</ParamField>
+  <ParamField name="404" type="Not Found">Test execution not found.</ParamField>
+  <ParamField name="500" type="Internal Server Error">Unexpected server error.</ParamField>
+</ApiSection>
diff --git a/src/pages/docs/api/test-executions/getperformancesummary.mdx b/src/pages/docs/api/test-executions/getperformancesummary.mdx
new file mode 100644
index 00000000..fbfbbd80
--- /dev/null
+++ b/src/pages/docs/api/test-executions/getperformancesummary.mdx
@@ -0,0 +1,60 @@
+---
+title: "Get performance summary"
+description: "Retrieves the performance summary for a test execution."
+---
+
+<ApiPlayground
+  method="GET"
+  endpoint="/simulate/test-executions/{test_execution_id}/performance-summary/"
+  baseUrl="https://api.futureagi.com"
+  parameters={[
+    {"name": "test_execution_id", "in": "path", "required": true, "description": "UUID of the test execution.", "type": "string"}
+  ]}
+  responseExample={{
+    test_run_performance_metrics: {
+      pass_rate: 88.0,
+      total_test_runs: 50,
+      latest_fail_rate: 12.0
+    },
+    top_performing_scenarios: [
+      { scenario_name: "Billing Inquiry", test_count: 15, performance_score: 9.2 },
+      { scenario_name: "Account Cancellation", test_count: 10, performance_score: 8.8 },
+      { scenario_name: "Password Reset", test_count: 12, performance_score: 8.5 },
+      { scenario_name: "Refund Request", test_count: 13, performance_score: 7.9 }
+    ]
+  }}
+  responseStatus={200}
+  responseStatusText="OK"
+/>
+
+<ApiSection title="Authentication">
+  <ParamField name="X-Api-Key" type="API Key" required>
+    Your Future AGI API key used to authenticate requests. You can find and manage your API keys in the [Dashboard](https://app.futureagi.com) under Settings.
+  </ParamField>
+  <ParamField name="X-Secret-Key" type="Secret Key" required>
+    Your Future AGI secret key, used alongside the API key for request authentication. This is generated when you create an API key in the [Dashboard](https://app.futureagi.com).
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Path parameters">
+  <ParamField path="test_execution_id" type="UUID" required>
+    The test execution ID.
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Response" status={200} statusText="OK">
+  <ResponseField name="test_run_performance_metrics" type="object">Aggregated pass/fail rates.</ResponseField>
+  <ResponseField name="test_run_performance_metrics.pass_rate" type="number">Pass rate percentage (0-100).</ResponseField>
+  <ResponseField name="test_run_performance_metrics.total_test_runs" type="integer">Total call executions.</ResponseField>
+  <ResponseField name="test_run_performance_metrics.latest_fail_rate" type="number">Fail rate percentage (0-100).</ResponseField>
+  <ResponseField name="top_performing_scenarios" type="array">Top scenarios by performance score, up to 4.</ResponseField>
+  <ResponseField name="top_performing_scenarios[].scenario_name" type="string">Scenario name.</ResponseField>
+  <ResponseField name="top_performing_scenarios[].test_count" type="integer">Calls executed for this scenario.</ResponseField>
+  <ResponseField name="top_performing_scenarios[].performance_score" type="number">Average eval score (0-10).</ResponseField>
+</ApiSection>
+
+<ApiSection title="Errors">
+  <ParamField name="401" type="Unauthorized">Invalid or missing credentials.</ParamField>
+  <ParamField name="404" type="Not Found">Test execution not found.</ParamField>
+  <ParamField name="500" type="Internal Server Error">Unexpected server error.</ParamField>
+</ApiSection>
diff --git a/src/pages/docs/api/test-executions/gettestexecutiondetails.mdx b/src/pages/docs/api/test-executions/gettestexecutiondetails.mdx
new file mode 100644
index 00000000..0df874e3
--- /dev/null
+++ b/src/pages/docs/api/test-executions/gettestexecutiondetails.mdx
@@ -0,0 +1,122 @@
+---
+title: "Get test execution details"
+description: "Retrieves a test execution with its call executions."
+---
+
+<ApiPlayground
+  method="GET"
+  endpoint="/simulate/test-executions/{test_execution_id}/"
+  baseUrl="https://api.futureagi.com"
+  parameters={[
+    {"name": "test_execution_id", "in": "path", "required": true, "description": "UUID of the test execution.", "type": "string"},
+    {"name": "search", "in": "query", "required": false, "description": "Filter call executions by search string.", "type": "string"},
+    {"name": "page", "in": "query", "required": false, "description": "Page number for pagination.", "type": "integer"},
+    {"name": "filters", "in": "query", "required": false, "description": "JSON-encoded filter array.", "type": "string"},
+    {"name": "row_groups", "in": "query", "required": false, "description": "JSON-encoded array of column IDs to group by.", "type": "string"},
+    {"name": "group_keys", "in": "query", "required": false, "description": "JSON-encoded array of group key values.", "type": "string"}
+  ]}
+  responseExample={{
+    id: "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
+    run_test: "f7a8b9c0-d1e2-3456-789a-bcdef0123456",
+    run_test_name: "Billing Support Test",
+    agent_definition_name: "Support Agent v2",
+    status: "completed",
+    error_reason: null,
+    started_at: "2026-03-15T10:00:00Z",
+    completed_at: "2026-03-15T10:45:00Z",
+    total_scenarios: 5,
+    total_calls: 50,
+    completed_calls: 47,
+    failed_calls: 3,
+    execution_metadata: {},
+    duration_seconds: 2700,
+    success_rate: 94.0,
+    calls: [],
+    created_at: "2026-03-15T09:58:00Z",
+    scenario_ids: ["scen-uuid-1", "scen-uuid-2"],
+    simulator_agent_name: "Default Simulator",
+    simulator_agent_id: "sim-uuid",
+    agent_definition_used_name: "Support Agent v2",
+    agent_definition_used_id: "agent-def-uuid",
+    calls_attempted: 50,
+    calls_connected_percentage: 94.0
+  }}
+  responseStatus={200}
+  responseStatusText="OK"
+/>
+
+<ApiSection title="Authentication">
+  <ParamField name="X-Api-Key" type="API Key" required>
+    Your Future AGI API key used to authenticate requests. You can find and manage your API keys in the [Dashboard](https://app.futureagi.com) under Settings.
+  </ParamField>
+  <ParamField name="X-Secret-Key" type="Secret Key" required>
+    Your Future AGI secret key, used alongside the API key for request authentication. This is generated when you create an API key in the [Dashboard](https://app.futureagi.com).
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Path parameters">
+  <ParamField path="test_execution_id" type="UUID" required>
+    The test execution ID.
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Query parameters">
+  <ParamField query="search" type="string" optional>
+    Filter by scenario name, transcript content, or status.
+  </ParamField>
+  <ParamField query="page" type="integer" optional>
+    Page number. Defaults to `1`.
+  </ParamField>
+  <ParamField query="filters" type="string" optional>
+    JSON-encoded filter array, e.g. `[{"colId":"status","filterType":"text","type":"equals","filter":"completed"}]`.
+  </ParamField>
+  <ParamField query="row_groups" type="string" optional>
+    JSON-encoded array of column IDs to group by, e.g. `["scenario"]`.
+  </ParamField>
+  <ParamField query="group_keys" type="string" optional>
+    JSON-encoded group key values to drill into. Used with `row_groups`.
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Response" status={200} statusText="OK">
+  <ResponseField name="id" type="string">UUID of the test execution.</ResponseField>
+  <ResponseField name="run_test" type="string">UUID of the parent run test.</ResponseField>
+  <ResponseField name="run_test_name" type="string">Parent run test name.</ResponseField>
+  <ResponseField name="agent_definition_name" type="string">Agent definition name.</ResponseField>
+  <ResponseField name="status" type="string">Status: `pending`, `running`, `completed`, `failed`, `cancelled`, `cancelling`, or `evaluating`.</ResponseField>
+  <ResponseField name="error_reason" type="string or null">Failure reason.</ResponseField>
+  <ResponseField name="started_at" type="datetime">ISO 8601 execution start time.</ResponseField>
+  <ResponseField name="completed_at" type="datetime or null">ISO 8601 completion time.</ResponseField>
+  <ResponseField name="total_scenarios" type="integer">Number of distinct scenarios.</ResponseField>
+  <ResponseField name="total_calls" type="integer">Total call executions created.</ResponseField>
+  <ResponseField name="completed_calls" type="integer">Calls that completed.</ResponseField>
+  <ResponseField name="failed_calls" type="integer">Calls that failed.</ResponseField>
+  <ResponseField name="execution_metadata" type="object">Execution metadata.</ResponseField>
+  <ResponseField name="duration_seconds" type="integer or null">Elapsed time in seconds.</ResponseField>
+  <ResponseField name="success_rate" type="number or null">Percentage of calls completed successfully.</ResponseField>
+  <ResponseField name="calls" type="array">Paginated call execution objects.</ResponseField>
+  <ApiCollapsible title="Show 8 properties">
+    <ResponseField name="id" type="string">UUID of the call execution.</ResponseField>
+    <ResponseField name="status" type="string">Call status: `pending`, `queued`, `ongoing`, `completed`, `failed`, `analyzing`, or `cancelled`.</ResponseField>
+    <ResponseField name="duration" type="number">Duration in seconds.</ResponseField>
+    <ResponseField name="transcript" type="array">Conversation transcript.</ResponseField>
+    <ResponseField name="overall_score" type="number">Aggregate eval score.</ResponseField>
+    <ResponseField name="eval_outputs" type="object">Eval results per configured eval.</ResponseField>
+    <ResponseField name="scenario" type="string">Scenario name.</ResponseField>
+    <ResponseField name="created_at" type="datetime">ISO 8601 creation timestamp.</ResponseField>
+  </ApiCollapsible>
+  <ResponseField name="created_at" type="datetime">ISO 8601 creation timestamp.</ResponseField>
+  <ResponseField name="scenario_ids" type="array">Scenario UUIDs included.</ResponseField>
+  <ResponseField name="simulator_agent_name" type="string or null">Simulator agent name.</ResponseField>
+  <ResponseField name="simulator_agent_id" type="string or null">UUID of the simulator agent.</ResponseField>
+  <ResponseField name="agent_definition_used_name" type="string or null">Agent definition name used.</ResponseField>
+  <ResponseField name="agent_definition_used_id" type="string or null">UUID of the agent definition used.</ResponseField>
+  <ResponseField name="calls_attempted" type="integer">Total calls initiated.</ResponseField>
+  <ResponseField name="calls_connected_percentage" type="number">Percentage of calls that connected.</ResponseField>
+</ApiSection>
+
+<ApiSection title="Errors">
+  <ParamField name="401" type="Unauthorized">Invalid or missing credentials.</ParamField>
+  <ParamField name="404" type="Not Found">Test execution not found.</ParamField>
+  <ParamField name="500" type="Internal Server Error">Unexpected server error.</ParamField>
+</ApiSection>
diff --git a/src/pages/docs/api/test-executions/reruncalls.mdx b/src/pages/docs/api/test-executions/reruncalls.mdx
new file mode 100644
index 00000000..8c0a8ed2
--- /dev/null
+++ b/src/pages/docs/api/test-executions/reruncalls.mdx
@@ -0,0 +1,95 @@
+---
+title: "Rerun call executions"
+description: "Reruns call executions within a test execution."
+---
+
+<ApiPlayground
+  method="POST"
+  endpoint="/simulate/test-executions/{test_execution_id}/rerun-calls/"
+  baseUrl="https://api.futureagi.com"
+  parameters={[
+    {"name": "test_execution_id", "in": "path", "required": true, "description": "UUID of the test execution.", "type": "string"}
+  ]}
+  requestBody={{"rerunType": "eval_only", "callExecutionIds": ["a1b2c3d4-e5f6-7890-abcd-ef1234567890"], "selectAll": false}}
+  responseExample={{
+    message: "Rerun initiated successfully",
+    testExecutionId: "f7a8b9c0-d1e2-3456-789a-bcdef0123456",
+    rerunType: "eval_only",
+    totalProcessed: 1,
+    successfulReruns: ["a1b2c3d4-e5f6-7890-abcd-ef1234567890"],
+    failedReruns: [],
+    successCount: 1,
+    failureCount: 0
+  }}
+  responseStatus={200}
+  responseStatusText="OK"
+/>
+
+<ApiSection title="Authentication">
+  <ParamField name="X-Api-Key" type="API Key" required>
+    Your Future AGI API key used to authenticate requests. You can find and manage your API keys in the [Dashboard](https://app.futureagi.com) under Settings.
+  </ParamField>
+  <ParamField name="X-Secret-Key" type="Secret Key" required>
+    Your Future AGI secret key, used alongside the API key for request authentication. This is generated when you create an API key in the [Dashboard](https://app.futureagi.com).
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Path parameters">
+  <ParamField path="test_execution_id" type="UUID" required>
+    The test execution ID. Must be in a terminal state (`completed`, `failed`, or `cancelled`).
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Request body">
+  <ParamField body="rerunType" type="string" required>
+    The type of rerun to perform. Use `eval_only` to re-evaluate existing call data without re-executing the actual calls -- this is useful when you have updated your evaluation configurations and want to see updated scores without the cost of re-running calls. Use `call_and_eval` to fully re-execute the calls and then evaluate the new results -- this produces fresh conversations and is useful when you have modified the agent under test. Note that text agents only support `eval_only` reruns; attempting `call_and_eval` on a text agent will return a 400 error.
+  </ParamField>
+  <ParamField body="callExecutionIds" type="array of strings">
+    An array of call execution UUIDs to rerun. Required when `selectAll` is `false` or not provided. Each ID must correspond to a valid call execution within the specified test execution. If a provided ID does not exist or does not belong to the test execution, it will appear in the `failedReruns` array of the response.
+  </ParamField>
+  <ParamField body="selectAll" type="boolean">
+    When set to `true`, all call executions within the test execution will be rerun, and the `callExecutionIds` field is ignored. Defaults to `false`. You must provide either `selectAll: true` or a non-empty `callExecutionIds` array -- the request will fail with a 400 error if neither is specified.
+  </ParamField>
+</ApiSection>
+
+<ApiSection title="Response" status={200} statusText="OK">
+  <ResponseField name="message" type="string">
+    A human-readable confirmation message indicating that the rerun has been initiated. The actual rerun processing happens asynchronously after this response is returned.
+  </ResponseField>
+  <ResponseField name="testExecutionId" type="string">
+    The UUID of the test execution that the rerun was initiated for, echoed back for confirmation and reference.
+  </ResponseField>
+  <ResponseField name="rerunType" type="string">
+    The type of rerun that was requested, either `eval_only` or `call_and_eval`. Echoed back from the request for confirmation.
+  </ResponseField>
+  <ResponseField name="totalProcessed" type="integer">
+    The total number of call executions that were processed by the rerun request. This includes both successful and failed reruns.
+  </ResponseField>
+  <ResponseField name="successfulReruns" type="array">
+    An array of call execution UUIDs that were successfully queued for rerun. These calls will be re-executed or re-evaluated asynchronously.
+  </ResponseField>
+  <ResponseField name="failedReruns" type="array">
+    An array of objects describing call executions that could not be rerun. Each object contains a `callExecutionId` (the UUID of the failed call) and an `error` (a human-readable description of why the rerun failed, such as the call being in an incompatible state).
+  </ResponseField>
+  <ResponseField name="successCount" type="integer">
+    The number of call executions that were successfully queued for rerun. Equal to the length of the `successfulReruns` array.
+  </ResponseField>
+  <ResponseField name="failureCount" type="integer">
+    The number of call executions that failed to be queued for rerun. Equal to the length of the `failedReruns` array.
+  </ResponseField>
+</ApiSection>
+
+<ApiSection title="Errors">
+  <ParamField name="400" type="Bad Request">
+    The rerun request could not be processed. This error occurs when: the `rerunType` field is missing or contains an invalid value; neither `callExecutionIds` nor `selectAll` was provided; the test execution is still in an active state (`pending`, `running`, or `cancelling`) and cannot accept reruns; or a `call_and_eval` rerun was requested for a text agent, which only supports `eval_only` reruns. Check the error message in the response body for specific details on which validation failed.
+  </ParamField>
+  <ParamField name="401" type="Unauthorized">
+    The request could not be authenticated. Verify that both `X-Api-Key` and `X-Secret-Key` headers are present and contain valid, non-expired credentials. Ensure the API key has access to the workspace that owns this test execution.
+  </ParamField>
+  <ParamField name="404" type="Not Found">
+    Test execution not found.
+  </ParamField>
+  <ParamField name="500" type="Internal Server Error">
+    Unexpected server error.
+  </ParamField>
+</ApiSection>