@talonic/docs 0.16.0 → 0.17.0

package/dist/index.js

@@ -568,7 +568,16 @@ var NAV_SECTIONS = [
     label: "Cases",
     children: [
       { id: "list-cases", label: "List Cases" },
-      { id: "get-case", label: "Get Case" }
+      { id: "get-case", label: "Get Case" },
+      { id: "update-case-status", label: "Update Status" },
+      { id: "case-edges", label: "Edges" },
+      { id: "confirm-case-edge", label: "Confirm Edge" },
+      { id: "reject-case-edge", label: "Reject Edge" },
+      { id: "split-case", label: "Split Case" },
+      { id: "merge-cases", label: "Merge Cases" },
+      { id: "case-completeness", label: "Completeness" },
+      { id: "pin-case-document", label: "Pin Documents" },
+      { id: "unpin-case-document", label: "Remove Documents" }
     ]
   },
   {
@@ -614,15 +623,20 @@ var NAV_SECTIONS = [
     children: [
       { id: "list-review", label: "List Queue" },
       { id: "review-action", label: "Take Action" },
-      { id: "review-batch", label: "Batch Action" }
+      { id: "review-batch", label: "Batch Action" },
+      { id: "review-stats", label: "Stats" },
+      { id: "review-assign", label: "Assign" }
     ]
   },
   {
     id: "quality",
     label: "Quality",
     children: [
-      { id: "list-ground-truth", label: "Ground Truth" },
-      { id: "list-benchmarks", label: "Benchmarks" }
+      { id: "list-quality-ground-truth", label: "Ground Truth" },
+      { id: "list-benchmarks", label: "Benchmarks" },
+      { id: "add-ground-truth-entry", label: "Add Ground-Truth Entry" },
+      { id: "delete-ground-truth-entry", label: "Delete Ground-Truth Entry" },
+      { id: "benchmark-results", label: "Benchmark Results" }
     ]
   },
   {
@@ -635,7 +649,15 @@ var NAV_SECTIONS = [
       { id: "delete-matching-config", label: "Delete Config" },
       { id: "run-matching", label: "Run Matching" },
       { id: "list-matching-runs", label: "List Runs" },
-      { id: "cancel-matching-run", label: "Cancel Run" }
+      { id: "cancel-matching-run", label: "Cancel Run" },
+      { id: "smart-run", label: "Smart Run" },
+      { id: "ai-resolve", label: "AI Resolve" },
+      { id: "generate-strategy", label: "Create Strategy" },
+      { id: "get-strategy", label: "Get Strategy" },
+      { id: "update-strategy", label: "Update Strategy" },
+      { id: "match-results", label: "Run Results" },
+      { id: "match-progress", label: "Run Progress" },
+      { id: "review-match", label: "Submit Review" }
     ]
   },
   {
@@ -643,7 +665,9 @@ var NAV_SECTIONS = [
     label: "Batches",
     children: [
       { id: "list-batches", label: "List Batches" },
-      { id: "get-batch", label: "Get Batch" }
+      { id: "get-batch", label: "Get Batch" },
+      { id: "batch-sync", label: "Sync Status" },
+      { id: "batch-cancel", label: "Cancel Batch" }
     ]
   },
   {
@@ -685,6 +709,109 @@ var NAV_SECTIONS = [
       { id: "webhook-retries", label: "Retry Policy" }
     ]
   },
+  {
+    id: "resolutions",
+    label: "Resolutions",
+    children: [
+      { id: "list-resolutions", label: "List Resolutions" },
+      { id: "create-resolution", label: "Create Resolution" },
+      { id: "get-resolution", label: "Get Resolution" },
+      { id: "get-resolution-results", label: "Get Results" },
+      { id: "execute-resolution", label: "Execute Resolution" },
+      { id: "delete-resolution", label: "Delete Resolution" }
+    ]
+  },
+  {
+    id: "linking",
+    label: "Linking",
+    children: [
+      { id: "list-link-keys", label: "Link Keys" },
+      { id: "get-document-links", label: "Document Links" },
+      { id: "get-linking-graph", label: "Full Graph" },
+      { id: "get-document-graph", label: "Document Graph" },
+      { id: "classify-link-keys", label: "Classify" },
+      { id: "backfill-linking", label: "Backfill" },
+      { id: "backfill-progress", label: "Backfill Progress" },
+      { id: "document-case-map", label: "Document-Case Map" }
+    ]
+  },
+  {
+    id: "nshot",
+    label: "N-Shot",
+    children: [
+      { id: "nshot-summary", label: "Summary" },
+      { id: "nshot-comparisons", label: "Comparisons" },
+      { id: "nshot-comparison", label: "Single Comparison" },
+      { id: "nshot-override", label: "Override" },
+      { id: "nshot-judge-decision", label: "Judge Decision" }
+    ]
+  },
+  {
+    id: "schema-graph",
+    label: "Schema Graph",
+    children: [
+      { id: "list-schema-graph-classes", label: "List Classes" },
+      { id: "get-schema-graph-class", label: "Get Class" },
+      { id: "list-class-versions", label: "List Versions" },
+      { id: "get-class-version", label: "Get Version" },
+      { id: "list-schema-graph-diffs", label: "List Diffs" },
+      { id: "approve-diff", label: "Approve Diff" },
+      { id: "reject-diff", label: "Reject Diff" },
+      { id: "list-schema-graph-edges", label: "Edges" },
+      { id: "list-schema-graph-aliases", label: "Aliases" },
+      { id: "visualize-schema-graph", label: "Visualize" }
+    ]
+  },
+  {
+    id: "structuring",
+    label: "Structuring",
+    children: [
+      { id: "list-structuring-checks", label: "List Checks" },
+      { id: "create-structuring-check", label: "Create Check" },
+      { id: "get-structuring-check", label: "Get / Update / Delete Check" },
+      { id: "list-structuring-gates", label: "List Gates" },
+      { id: "create-structuring-gate", label: "Create Gate" },
+      { id: "get-structuring-gate", label: "Get / Update / Delete Gate" },
+      { id: "gate-rules", label: "Gate Rules" },
+      { id: "result-checks", label: "Result Checks" },
+      { id: "pending-approvals", label: "Pending Approvals" },
+      { id: "approve-reject-result", label: "Approve / Reject Result" },
+      { id: "trigger-delivery", label: "Trigger Delivery" }
+    ]
+  },
+  {
+    id: "telemetry",
+    label: "Telemetry",
+    children: [
+      { id: "schema-telemetry-summary", label: "Schema Summary" },
+      { id: "schema-telemetry-trend", label: "Schema Trend" },
+      { id: "schema-telemetry-fields", label: "Schema Fields" },
+      { id: "run-telemetry-summary", label: "Run Summary" }
+    ]
+  },
+  {
+    id: "validation",
+    label: "Validation",
+    children: [
+      { id: "list-ground-truth", label: "List Ground-Truth Datasets" },
+      { id: "get-ground-truth", label: "Get / Delete Ground-Truth Dataset" },
+      { id: "list-validation-runs", label: "List Validation Runs" },
+      { id: "create-validation-run", label: "Create Validation Run" },
+      { id: "get-validation-run", label: "Get / Delete Validation Run" },
+      { id: "get-validation-results", label: "Validation Results" }
+    ]
+  },
+  {
+    id: "credits",
+    label: "Credits",
+    children: [
+      { id: "credits-balance", label: "Balance" },
+      { id: "credits-history", label: "History" },
+      { id: "credits-usage", label: "Usage Summary" },
+      { id: "credits-usage-daily", label: "Daily Usage" },
+      { id: "credits-usage-log", label: "Usage Log" }
+    ]
+  },
   {
     id: "agent",
     label: "Agent",
@@ -2209,6 +2336,168 @@ function ApiReference({ LinkComponent }) {
 }` })
         }
       ) }),
+      /* @__PURE__ */ jsx5("div", { id: "update-case-status", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
+        EndpointBlock,
+        {
+          method: "PATCH",
+          path: "/v1/cases/{key}/status",
+          summary: "Update case status.",
+          children: /* @__PURE__ */ jsx5(
+            ParamTable,
+            {
+              title: "Body parameters",
+              params: [
+                { name: "status", type: "string", required: true, description: "New status (e.g. open, in_review, resolved, archived)." }
+              ]
+            }
+          )
+        }
+      ) }),
+      /* @__PURE__ */ jsx5("div", { id: "case-edges", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
+        EndpointBlock,
+        {
+          method: "GET",
+          path: "/v1/cases/{key}/edges",
+          summary: "Get case edges.",
+          description: "Returns the entity edges (evidence chain) connecting documents within the case.",
+          children: /* @__PURE__ */ jsx5(CodeBlock, { title: "Response", children: `{
+  "data": [
+    {
+      "source_document_id": "uuid",
+      "target_document_id": "uuid",
+      "entity_value": "string",
+      "entity_type": "string",
+      "confidence": 0.92
+    }
+  ]
+}` })
+        }
+      ) }),
+      /* @__PURE__ */ jsx5("div", { id: "confirm-case-edge", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
+        EndpointBlock,
+        {
+          method: "POST",
+          path: "/v1/cases/{key}/edges/{edgeId}/confirm",
+          summary: "Confirm a case edge.",
+          description: "Confirm a proposed entity edge between documents in this case. No request body \u2014 both identifiers come from the path.",
+          children: /* @__PURE__ */ jsx5(
+            ParamTable,
+            {
+              title: "Path parameters",
+              params: [
+                { name: "key", type: "string", required: true, description: "Case key." },
+                { name: "edgeId", type: "uuid", required: true, description: "Edge identifier from the case edges list." }
+              ]
+            }
+          )
+        }
+      ) }),
+      /* @__PURE__ */ jsx5("div", { id: "reject-case-edge", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
+        EndpointBlock,
+        {
+          method: "POST",
+          path: "/v1/cases/{key}/edges/{edgeId}/reject",
+          summary: "Reject a case edge.",
+          description: "Reject a proposed entity edge between documents in this case. No request body \u2014 both identifiers come from the path.",
+          children: /* @__PURE__ */ jsx5(
+            ParamTable,
+            {
+              title: "Path parameters",
+              params: [
+                { name: "key", type: "string", required: true, description: "Case key." },
+                { name: "edgeId", type: "uuid", required: true, description: "Edge identifier from the case edges list." }
+              ]
+            }
+          )
+        }
+      ) }),
+      /* @__PURE__ */ jsx5("div", { id: "split-case", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
+        EndpointBlock,
+        {
+          method: "POST",
+          path: "/v1/cases/{key}/split",
+          summary: "Split a case into two separate cases by partitioning its documents into two groups.",
+          children: /* @__PURE__ */ jsx5(
+            ParamTable,
+            {
+              title: "Body parameters",
+              params: [
+                { name: "partition_a", type: "uuid[]", required: true, description: "Document IDs that stay in the original case." },
+                { name: "partition_b", type: "uuid[]", required: true, description: "Document IDs that move to the newly-created case." }
+              ]
+            }
+          )
+        }
+      ) }),
+      /* @__PURE__ */ jsx5("div", { id: "merge-cases", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
+        EndpointBlock,
+        {
+          method: "POST",
+          path: "/v1/cases/merge",
+          summary: "Merge two cases by passing both case keys in the request body.",
+          children: /* @__PURE__ */ jsx5(
+            ParamTable,
+            {
+              title: "Body parameters",
+              params: [
+                { name: "case_key_a", type: "string", required: true, description: "First case key \u2014 receives the merged documents." },
+                { name: "case_key_b", type: "string", required: true, description: "Second case key \u2014 its documents are folded into case A." }
+              ]
+            }
+          )
+        }
+      ) }),
+      /* @__PURE__ */ jsx5("div", { id: "case-completeness", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
+        EndpointBlock,
+        {
+          method: "GET",
+          path: "/v1/cases/{key}/completeness",
+          summary: "Get case completeness.",
+          description: "Returns a completeness assessment for the case (expected vs. present document types, missing fields).",
+          children: /* @__PURE__ */ jsx5(CodeBlock, { title: "Response", children: `{
+  "completeness_score": 0.83,
+  "expected_document_types": ["invoice", "purchase_order", "receipt"],
+  "present_document_types": ["invoice", "purchase_order"],
+  "missing_document_types": ["receipt"]
+}` })
+        }
+      ) }),
+      /* @__PURE__ */ jsx5("div", { id: "pin-case-document", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
+        EndpointBlock,
+        {
+          method: "POST",
+          path: "/v1/cases/{key}/documents/{docId}/pin",
+          summary: "Manually pin a document to a case so it persists across re-clustering.",
+          children: /* @__PURE__ */ jsx5(
+            ParamTable,
+            {
+              title: "Path parameters",
+              params: [
+                { name: "key", type: "string", required: true, description: "Case key." },
+                { name: "docId", type: "uuid", required: true, description: "Document identifier to pin." }
+              ]
+            }
+          )
+        }
+      ) }),
+      /* @__PURE__ */ jsx5("div", { id: "unpin-case-document", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
+        EndpointBlock,
+        {
+          method: "DELETE",
+          path: "/v1/cases/{key}/documents/{docId}",
+          summary: "Remove a manually-pinned document from a case.",
+          children: /* @__PURE__ */ jsx5(
+            ParamTable,
+            {
+              title: "Path parameters",
+              params: [
+                { name: "key", type: "string", required: true, description: "Case key." },
+                { name: "docId", type: "uuid", required: true, description: "Document identifier to remove." }
+              ]
+            }
+          )
+        }
+      ) }),
       /* @__PURE__ */ jsx5(SectionHeading, { id: "fields", children: "Fields" }),
       /* @__PURE__ */ jsx5("p", { className: "text-[15px] text-void-text-secondary leading-relaxed mb-6", children: "The field registry is the knowledge graph of all discovered fields. Fields are semantically clustered and promoted through tiers as they appear across documents." }),
       /* @__PURE__ */ jsx5("div", { id: "list-fields", className: "scroll-mt-6", children: /* @__PURE__ */ jsxs5(
@@ -2685,9 +2974,53 @@ function ApiReference({ LinkComponent }) {
           ]
         }
       ) }),
+      /* @__PURE__ */ jsx5("div", { id: "review-stats", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
+        EndpointBlock,
+        {
+          method: "GET",
+          path: "/v1/review/stats",
+          summary: "Get review queue statistics.",
+          description: "Returns aggregate statistics about the review queue (pending, approved, rejected counts).",
+          children: /* @__PURE__ */ jsx5(CodeBlock, { title: "Response", children: `{
+  "pending": 23,
+  "approved": 142,
+  "rejected": 8,
+  "total": 173
+}` })
+        }
+      ) }),
+      /* @__PURE__ */ jsx5("div", { id: "review-assign", className: "scroll-mt-6", children: /* @__PURE__ */ jsxs5(
+        EndpointBlock,
+        {
+          method: "POST",
+          path: "/v1/review/{id}/assign",
+          summary: "Assign a review record to a user (or unassign with null).",
+          description: "Set the assignee on a single review record. Pass user_id: null to unassign.",
+          children: [
+            /* @__PURE__ */ jsx5(
+              ParamTable,
+              {
+                title: "Path parameters",
+                params: [
+                  { name: "id", type: "uuid", required: true, description: "Review record identifier." }
+                ]
+              }
+            ),
+            /* @__PURE__ */ jsx5(
+              ParamTable,
+              {
+                title: "Body parameters",
+                params: [
+                  { name: "user_id", type: "uuid | null", required: true, description: "User ID of the assignee, or null to unassign." }
+                ]
+              }
+            )
+          ]
+        }
+      ) }),
       /* @__PURE__ */ jsx5(SectionHeading, { id: "quality", children: "Quality" }),
       /* @__PURE__ */ jsx5("p", { className: "text-[15px] text-void-text-secondary leading-relaxed mb-6", children: "Manage ground truth datasets and benchmark extraction quality over time." }),
-      /* @__PURE__ */ jsx5("div", { id: "list-ground-truth", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
+      /* @__PURE__ */ jsx5("div", { id: "list-quality-ground-truth", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
         EndpointBlock,
         {
           method: "GET",
@@ -2724,6 +3057,63 @@ function ApiReference({ LinkComponent }) {
       "run_at": "2024-09-10T00:00:00Z"
     }
   ]
+}` })
+        }
+      ) }),
+      /* @__PURE__ */ jsx5("div", { id: "add-ground-truth-entry", className: "scroll-mt-6", children: /* @__PURE__ */ jsxs5(
+        EndpointBlock,
+        {
+          method: "POST",
+          path: "/v1/quality/ground-truth/{datasetId}/entries",
+          summary: "Add an entry to a ground truth dataset.",
+          children: [
+            /* @__PURE__ */ jsx5(
+              ParamTable,
+              {
+                title: "Body parameters",
+                params: [
+                  { name: "document_id", type: "uuid", description: "Optional document associated with the entry." },
+                  { name: "expected_data", type: "object", required: true, description: "The known-correct field values for this document." },
+                  { name: "notes", type: "string", description: "Optional reviewer notes." }
+                ]
+              }
+            ),
+            /* @__PURE__ */ jsx5(CodeBlock, { title: "Response (201)", children: `{
+  "id": "uuid",
+  "document_id": "uuid",
+  "expected_data": { "vendor_name": "Acme Corp", "total": 1234.56 },
+  "notes": null,
+  "created_at": "2024-09-14T10:32:00Z"
+}` })
+          ]
+        }
+      ) }),
+      /* @__PURE__ */ jsx5("div", { id: "delete-ground-truth-entry", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
+        EndpointBlock,
+        {
+          method: "DELETE",
+          path: "/v1/quality/ground-truth/{datasetId}/entries/{entryId}",
+          summary: "Delete a ground truth entry."
+        }
+      ) }),
+      /* @__PURE__ */ jsx5("div", { id: "benchmark-results", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
+        EndpointBlock,
+        {
+          method: "GET",
+          path: "/v1/quality/benchmarks/{id}/results",
+          summary: "Get benchmark results.",
+          description: "Returns per-document accuracy results for a benchmark run.",
+          children: /* @__PURE__ */ jsx5(CodeBlock, { title: "Response", children: `{
+  "data": [
+    {
+      "id": "uuid",
+      "document_id": "uuid",
+      "ground_truth_entry_id": "uuid",
+      "accuracy": 0.94,
+      "field_results": { "vendor_name": "pass", "total": "fail" },
+      "created_at": "2024-09-10T00:00:00Z"
+    }
+  ]
 }` })
         }
       ) }),
@@ -2874,55 +3264,219 @@ function ApiReference({ LinkComponent }) {
 }` })
         }
       ) }),
-      /* @__PURE__ */ jsx5(SectionHeading, { id: "batches", children: "Batches" }),
-      /* @__PURE__ */ jsxs5("p", { className: "text-[15px] text-void-text-secondary leading-relaxed mb-6", children: [
-        "Batch inference processes documents at 50% cost with up to 48-hour delivery. Upload documents with ",
-        /* @__PURE__ */ jsx5(InlineCode, { children: "processing_mode=batch" }),
-        " to use batch extraction."
-      ] }),
-      /* @__PURE__ */ jsx5("div", { id: "list-batches", className: "scroll-mt-6", children: /* @__PURE__ */ jsxs5(
+      /* @__PURE__ */ jsx5("div", { id: "smart-run", className: "scroll-mt-6", children: /* @__PURE__ */ jsxs5(
         EndpointBlock,
         {
-          method: "GET",
-          path: "/v1/batches",
-          summary: "List extraction batches.",
+          method: "POST",
+          path: "/v1/matching/configs/{id}/smart-run",
+          summary: "Run a generated AI strategy against a matching config.",
+          description: "Execute a previously-generated strategy on the documents scoped by the matching config. The strategy is generated separately via /v1/matching/strategies/generate.",
           children: [
             /* @__PURE__ */ jsx5(
               ParamTable,
               {
-                title: "Query parameters",
+                title: "Path parameters",
                 params: [
-                  { name: "status", type: "string", description: "Filter: accumulating, submitted, processing, completed, failed." },
-                  { name: "page", type: "integer", default: "1", description: "Page number." },
-                  { name: "per_page", type: "integer", default: "50", description: "Results per page." }
+                  { name: "id", type: "uuid", required: true, description: "Matching configuration identifier." }
+                ]
+              }
+            ),
+            /* @__PURE__ */ jsx5(
+              ParamTable,
+              {
+                title: "Body parameters",
+                params: [
+                  { name: "strategy_id", type: "uuid", required: true, description: "Generated strategy to execute against this config." }
+                ]
+              }
+            )
+          ]
+        }
+      ) }),
+      /* @__PURE__ */ jsx5("div", { id: "ai-resolve", className: "scroll-mt-6", children: /* @__PURE__ */ jsxs5(
+        EndpointBlock,
+        {
+          method: "POST",
+          path: "/v1/matching/runs/{id}/ai-resolve",
+          summary: "AI-resolve a matching run's review band.",
+          description: "Triggers AI-driven resolution on a completed run's review-band candidates. The run must already have an associated strategy; no request body.",
+          children: [
+            /* @__PURE__ */ jsx5(
+              ParamTable,
+              {
+                title: "Path parameters",
+                params: [
+                  { name: "id", type: "uuid", required: true, description: "Matching run identifier." }
                 ]
               }
             ),
             /* @__PURE__ */ jsx5(CodeBlock, { title: "Response", children: `{
-  "data": [
-    {
-      "id": "batch_7n3k9m",
-      "status": "processing",
-      "item_count": 150,
-      "completed_count": 87,
-      "submitted_at": "2024-09-14T08:00:00Z"
-    }
-  ],
-  "pagination": { "page": 1, "per_page": 50, "total": 5 }
+  "id": "uuid",
+  "status": "ai_resolving",
+  "message": "AI resolution started."
 }` })
           ]
         }
       ) }),
-      /* @__PURE__ */ jsx5("div", { id: "get-batch", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
+      /* @__PURE__ */ jsx5("div", { id: "generate-strategy", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
         EndpointBlock,
         {
-          method: "GET",
-          path: "/v1/batches/:id",
-          summary: "Get batch detail with item-level status.",
-          children: /* @__PURE__ */ jsx5(CodeBlock, { title: "Response", children: `{
-  "id": "batch_7n3k9m",
-  "status": "processing",
-  "item_count": 150,
+          method: "POST",
+          path: "/v1/matching/strategies/generate",
+          summary: "Generate a matching strategy from reference data and a target descriptor.",
+          description: "Synthesize a draft matching strategy by analysing the reference dataset shape and the supplied target descriptor. The returned strategy is then executed against a config via /v1/matching/configs/{id}/smart-run.",
+          children: /* @__PURE__ */ jsx5(
+            ParamTable,
+            {
+              title: "Body parameters",
+              params: [
+                { name: "reference_data_id", type: "uuid", required: true, description: "Reference dataset to use as the source of truth." },
+                { name: "target_type", type: "string", required: true, description: 'Target scope type \u2014 typically "run", "schema", or "document_filter".' },
+                { name: "target_value", type: "object", description: "Target descriptor payload \u2014 shape depends on target_type." },
+                { name: "user_prompt", type: "string", description: "Optional natural-language guidance to steer strategy synthesis." }
+              ]
+            }
+          )
+        }
+      ) }),
+      /* @__PURE__ */ jsx5("div", { id: "get-strategy", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
+        EndpointBlock,
+        {
+          method: "GET",
+          path: "/v1/matching/strategies/{id}",
+          summary: "Get a matching strategy."
+        }
+      ) }),
+      /* @__PURE__ */ jsx5("div", { id: "update-strategy", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
+        EndpointBlock,
+        {
+          method: "PATCH",
+          path: "/v1/matching/strategies/{id}",
+          summary: "Update a matching strategy.",
+          description: "Patch an existing strategy. Every property is optional; only the keys present on the body are merged into the strategy.",
+          children: /* @__PURE__ */ jsx5(
+            ParamTable,
+            {
+              title: "Body parameters",
+              params: [
+                { name: "reasoning_summary", type: "string", description: "Updated synthesis rationale." },
+                { name: "cardinality", type: "object", description: "Updated cardinality descriptor." },
+                { name: "data_quality_notes", type: "string[]", description: "Updated note list." },
+                { name: "blocking_keys", type: "object[]", description: "Updated blocking-key set." },
+                { name: "blocking_strategy", type: "string", description: 'Either "parallel" or "ordered_fallback".' },
+                { name: "hard_filters", type: "object[]", description: "Updated hard-filter list." },
+                { name: "field_rules", type: "object[]", description: "Updated field-rule list." },
+                { name: "thresholds", type: "object", description: "Updated confidence thresholds." },
+                { name: "edge_cases", type: "object[]", description: "Updated edge-case list." }
+              ]
+            }
+          )
+        }
+      ) }),
+      /* @__PURE__ */ jsx5("div", { id: "match-results", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
+        EndpointBlock,
+        {
+          method: "GET",
+          path: "/v1/matching/runs/{id}/results",
+          summary: "Get matching run results.",
+          description: "Returns per-document match results with top candidates and field-level evidence."
+        }
+      ) }),
+      /* @__PURE__ */ jsx5("div", { id: "match-progress", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
+        EndpointBlock,
+        {
+          method: "GET",
+          path: "/v1/matching/runs/{id}/progress",
+          summary: "Get matching run progress.",
+          description: "Returns the processing progress for an in-flight matching run.",
+          children: /* @__PURE__ */ jsx5(CodeBlock, { title: "Response", children: `{
+  "status": "running",
+  "processed": 87,
+  "total": 150,
+  "percentage": 58.0
+}` })
+        }
+      ) }),
+      /* @__PURE__ */ jsx5("div", { id: "review-match", className: "scroll-mt-6", children: /* @__PURE__ */ jsxs5(
+        EndpointBlock,
+        {
+          method: "POST",
+          path: "/v1/matching/runs/{runId}/results/{resultId}/review",
+          summary: "Review a single match result.",
+          description: "Apply an approve/reject decision (or attach reviewer notes) to a single match result within a matching run.",
+          children: [
+            /* @__PURE__ */ jsx5(
+              ParamTable,
+              {
+                title: "Path parameters",
+                params: [
+                  { name: "runId", type: "uuid", required: true, description: "Matching run identifier." },
+                  { name: "resultId", type: "uuid", required: true, description: "Match result identifier within the run." }
+                ]
+              }
+            ),
+            /* @__PURE__ */ jsx5(
+              ParamTable,
+              {
+                title: "Body parameters",
+                params: [
+                  { name: "status", type: "string", required: true, description: 'Reviewer decision \u2014 typically "approved" or "rejected".' },
+                  { name: "notes", type: "string", description: "Optional reviewer note attached to the decision." }
+                ]
+              }
+            )
+          ]
+        }
+      ) }),
+      /* @__PURE__ */ jsx5(SectionHeading, { id: "batches", children: "Batches" }),
+      /* @__PURE__ */ jsxs5("p", { className: "text-[15px] text-void-text-secondary leading-relaxed mb-6", children: [
+        "Batch inference processes documents at 50% cost with up to 48-hour delivery. Upload documents with ",
+        /* @__PURE__ */ jsx5(InlineCode, { children: "processing_mode=batch" }),
+        " to use batch extraction."
+      ] }),
+      /* @__PURE__ */ jsx5("div", { id: "list-batches", className: "scroll-mt-6", children: /* @__PURE__ */ jsxs5(
+        EndpointBlock,
+        {
+          method: "GET",
+          path: "/v1/batches",
+          summary: "List extraction batches.",
+          children: [
+            /* @__PURE__ */ jsx5(
+              ParamTable,
+              {
+                title: "Query parameters",
+                params: [
+                  { name: "status", type: "string", description: "Filter: accumulating, submitted, processing, completed, failed." },
+                  { name: "page", type: "integer", default: "1", description: "Page number." },
+                  { name: "per_page", type: "integer", default: "50", description: "Results per page." }
+                ]
+              }
+            ),
+            /* @__PURE__ */ jsx5(CodeBlock, { title: "Response", children: `{
+  "data": [
+    {
+      "id": "batch_7n3k9m",
+      "status": "processing",
+      "item_count": 150,
+      "completed_count": 87,
+      "submitted_at": "2024-09-14T08:00:00Z"
+    }
+  ],
+  "pagination": { "page": 1, "per_page": 50, "total": 5 }
+}` })
+          ]
+        }
+      ) }),
+      /* @__PURE__ */ jsx5("div", { id: "get-batch", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
+        EndpointBlock,
+        {
+          method: "GET",
+          path: "/v1/batches/:id",
+          summary: "Get batch detail with item-level status.",
+          children: /* @__PURE__ */ jsx5(CodeBlock, { title: "Response", children: `{
+  "id": "batch_7n3k9m",
+  "status": "processing",
+  "item_count": 150,
   "completed_count": 87,
   "items": [
     { "document_id": "doc_3j7x9p2q", "status": "completed" },
@@ -2932,6 +3486,24 @@ function ApiReference({ LinkComponent }) {
 }` })
         }
       ) }),
+      /* @__PURE__ */ jsx5("div", { id: "batch-sync", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
+        EndpointBlock,
+        {
+          method: "POST",
+          path: "/v1/batches/{id}/sync",
+          summary: "Sync batch status with provider.",
+          description: "Force a status sync with the batch inference provider (Anthropic or Bedrock)."
+        }
+      ) }),
+      /* @__PURE__ */ jsx5("div", { id: "batch-cancel", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
+        EndpointBlock,
+        {
+          method: "POST",
+          path: "/v1/batches/{id}/cancel",
+          summary: "Cancel a batch inference run.",
+          description: "Cancel an in-flight batch. Only batches in accumulating or submitted status can be cancelled."
+        }
+      ) }),
       /* @__PURE__ */ jsx5(SectionHeading, { id: "usage", children: "Usage" }),
       /* @__PURE__ */ jsx5("p", { className: "text-[15px] text-void-text-secondary leading-relaxed mb-6", children: "Track API usage, document processing costs, and token consumption." }),
       /* @__PURE__ */ jsx5("div", { id: "get-usage", className: "scroll-mt-6", children: /* @__PURE__ */ jsxs5(
@@ -3316,29 +3888,72 @@ function verifyWebhook(payload, signature, secret) {
       /* @__PURE__ */ jsx5("p", { className: "text-[14px] text-void-text-muted leading-relaxed", children: "After 4 failed attempts, the delivery is marked as failed. You can check delivery status and replay events from the dashboard." }),
       /* @__PURE__ */ jsx5(SectionHeading, { id: "resolutions", children: "Resolutions" }),
       /* @__PURE__ */ jsx5("p", { className: "text-[15px] text-void-text-secondary leading-relaxed mb-6", children: "Resolution runs apply field normalization, lookup cascades, and value transforms to extracted data. Create a resolution from a completed job run to standardise field values against reference data." }),
-      /* @__PURE__ */ jsx5("div", { id: "list-resolutions", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
+      /* @__PURE__ */ jsx5("div", { id: "list-resolutions", className: "scroll-mt-6", children: /* @__PURE__ */ jsxs5(
         EndpointBlock,
         {
           method: "GET",
           path: "/v1/resolutions",
           summary: "List resolution runs, optionally filtered by status or source run.",
           description: "Requires read scope.",
-          children: /* @__PURE__ */ jsx5(ParamTable, { params: [
-            { name: "status", type: "string", required: false, description: "Filter by run status." },
-            { name: "source_run_id", type: "uuid", required: false, description: "Filter by originating job run." }
-          ] })
+          children: [
+            /* @__PURE__ */ jsx5(
+              ParamTable,
+              {
+                title: "Query parameters",
+                params: [
+                  { name: "limit", type: "integer", default: "20", description: "Maximum number of items to return (1\u2013100)." },
+                  { name: "cursor", type: "string", description: "Opaque pagination cursor." },
+                  { name: "order", type: "string", default: "desc", description: "Sort order by creation date (asc | desc)." },
+                  { name: "status", type: "string", required: false, description: "Filter by run status." },
+                  { name: "source_run_id", type: "uuid", required: false, description: "Filter by originating job run." }
+                ]
+              }
+            ),
+            /* @__PURE__ */ jsx5(CodeBlock, { title: "Response", children: `{
+  "data": [
+    {
+      "id": "uuid",
+      "source_run_id": "uuid",
+      "status": "completed",
+      "documents_processed": 142,
+      "created_at": "2024-09-14T10:32:00Z",
+      "completed_at": "2024-09-14T10:35:42Z",
+      "links": { "self": "/v1/resolutions/uuid", "results": "/v1/resolutions/uuid/results" }
+    }
+  ],
+  "pagination": { "next_cursor": null }
+}` })
+          ]
         }
       ) }),
-      /* @__PURE__ */ jsx5("div", { id: "create-resolution", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
+      /* @__PURE__ */ jsx5("div", { id: "create-resolution", className: "scroll-mt-6", children: /* @__PURE__ */ jsxs5(
         EndpointBlock,
         {
           method: "POST",
           path: "/v1/resolutions",
           summary: "Create a resolution run from a completed job.",
-          description: "Requires write scope. Provide the source_run_id to resolve.",
-          children: /* @__PURE__ */ jsx5(CodeBlock, { title: "Request body", children: `{
+          description: "Requires write scope. Start a new resolution run targeting documents from a specific source run.",
+          children: [
+            /* @__PURE__ */ jsx5(
+              ParamTable,
+              {
+                title: "Body parameters",
+                params: [
+                  { name: "source_run_id", type: "uuid", required: true, description: "ID of the source run to resolve against." }
+                ]
+              }
+            ),
+            /* @__PURE__ */ jsx5(CodeBlock, { title: "Request body", children: `{
   "source_run_id": "run_abc123"
+}` }),
+            /* @__PURE__ */ jsx5(CodeBlock, { title: "Response (201)", children: `{
+  "id": "uuid",
+  "source_run_id": "uuid",
+  "status": "pending",
+  "created_at": "2024-09-14T10:32:00Z",
+  "links": { "self": "/v1/resolutions/uuid", "results": "/v1/resolutions/uuid/results" }
 }` })
+          ]
         }
       ) }),
       /* @__PURE__ */ jsx5("div", { id: "get-resolution", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
@@ -3356,7 +3971,7 @@ function verifyWebhook(payload, signature, secret) {
           method: "GET",
           path: "/v1/resolutions/{id}/results",
           summary: "Get per-field resolution results showing original and resolved values.",
-          description: "Requires read scope.",
+          description: "Requires read scope. Returns the resolved data for all documents in the resolution run.",
           children: /* @__PURE__ */ jsx5(CodeBlock, { title: "Response", children: `{
   "data": [
     {
@@ -3390,14 +4005,14 @@ function verifyWebhook(payload, signature, secret) {
         }
       ) }),
       /* @__PURE__ */ jsx5(SectionHeading, { id: "linking", children: "Linking" }),
-      /* @__PURE__ */ jsx5("p", { className: "text-[15px] text-void-text-secondary leading-relaxed mb-6", children: "The linking graph connects documents through shared entity values \u2014 an invoice and a contract sharing the same customer ID are linked. Links are discovered automatically during extraction and can be classified into categories (identity, transaction, reference) via AI." }),
+      /* @__PURE__ */ jsx5("p", { className: "text-[15px] text-void-text-secondary leading-relaxed mb-6", children: "The linking graph connects documents through shared entity values \u2014 an invoice and a contract sharing the same customer ID are linked. The API exposes the bipartite document-entity graph: link keys (field-level entity identifiers), document-level links, the full graph, document-centric subgraphs, classification (identity, transaction, reference), backfill, and document-to-case mapping." }),
       /* @__PURE__ */ jsx5("div", { id: "list-link-keys", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
         EndpointBlock,
         {
           method: "GET",
           path: "/v1/linking/link-keys",
           summary: "List all discovered link keys with their classification category and frequency.",
-          description: "Requires read scope.",
+          description: "Requires read scope. Returns all configured link keys (field-level entity identifiers used for document linking).",
           children: /* @__PURE__ */ jsx5(CodeBlock, { title: "Response", children: `{
   "data": [
     {
@@ -3416,7 +4031,17 @@ function verifyWebhook(payload, signature, secret) {
           method: "GET",
           path: "/v1/linking/documents/{id}/links",
           summary: "Get all links for a specific document.",
-          description: "Requires read scope."
+          description: "Requires read scope. Returns all entity links discovered for a specific document.",
+          children: /* @__PURE__ */ jsx5(CodeBlock, { title: "Response", children: `{
+  "data": [
+    {
+      "entity_value": "Acme Corp",
+      "entity_type": "vendor",
+      "link_key": "vendor_name",
+      "linked_document_ids": ["uuid", "uuid"]
+    }
+  ]
+}` })
         }
       ) }),
       /* @__PURE__ */ jsx5("div", { id: "get-linking-graph", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
@@ -3425,7 +4050,11 @@ function verifyWebhook(payload, signature, secret) {
           method: "GET",
           path: "/v1/linking/graph",
           summary: "Get the full document linking graph as nodes and edges.",
-          description: "Requires read scope. Can be large for workspaces with many documents."
+          description: "Requires read scope. Returns the bipartite document-entity graph for the customer. Can be large for workspaces with many documents.",
+          children: /* @__PURE__ */ jsx5(CodeBlock, { title: "Response", children: `{
+  "nodes": [...],
+  "edges": [...]
+}` })
         }
       ) }),
       /* @__PURE__ */ jsx5("div", { id: "get-document-graph", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
@@ -3434,7 +4063,7 @@ function verifyWebhook(payload, signature, secret) {
           method: "GET",
           path: "/v1/linking/graph/documents/{id}",
           summary: "Get the graph neighbourhood for a single document.",
-          description: "Requires read scope.",
+          description: "Requires read scope. Returns the subgraph of entities and linked documents for a specific document.",
           children: /* @__PURE__ */ jsx5(ParamTable, { params: [
             { name: "depth", type: "integer", required: false, description: "Graph traversal depth (default 2)." }
           ] })
@@ -3446,7 +4075,11 @@ function verifyWebhook(payload, signature, secret) {
           method: "POST",
           path: "/v1/linking/classify",
           summary: "Classify link keys into categories using AI.",
-          description: "Requires write scope. Runs asynchronously."
+          description: "Requires write scope. Runs AI classification on ambiguous fields to determine their link key category (identity, transaction, reference). Runs asynchronously.",
+          children: /* @__PURE__ */ jsx5(CodeBlock, { title: "Response", children: `{
+  "classified": 12,
+  "results": [...]
+}` })
         }
       ) }),
       /* @__PURE__ */ jsx5("div", { id: "backfill-linking", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
@@ -3455,7 +4088,11 @@ function verifyWebhook(payload, signature, secret) {
           method: "POST",
           path: "/v1/linking/backfill",
           summary: "Backfill link values across all documents.",
-          description: "Requires write scope. Returns 202 \u2014 poll progress via the backfill progress endpoint."
+          description: "Requires write scope. Triggers a backfill of the linking graph for all documents \u2014 useful after link key configuration changes. Returns 202; poll progress via the backfill progress endpoint.",
+          children: /* @__PURE__ */ jsx5(CodeBlock, { title: "Response (202)", children: `{
+  "status": "started",
+  "message": "Backfill queued."
+}` })
         }
       ) }),
       /* @__PURE__ */ jsx5("div", { id: "backfill-progress", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
@@ -3464,7 +4101,13 @@ function verifyWebhook(payload, signature, secret) {
           method: "GET",
           path: "/v1/linking/backfill/progress",
           summary: "Get backfill progress.",
-          description: "Requires read scope."
+          description: "Requires read scope. Returns the current progress of an in-flight backfill operation.",
+          children: /* @__PURE__ */ jsx5(CodeBlock, { title: "Response", children: `{
+  "status": "running",
+  "processed": 187,
+  "total": 540,
+  "started_at": "2024-09-14T10:32:00Z"
+}` })
         }
       ) }),
       /* @__PURE__ */ jsx5("div", { id: "document-case-map", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
@@ -3473,18 +4116,32 @@ function verifyWebhook(payload, signature, secret) {
           method: "GET",
           path: "/v1/linking/document-case-map",
           summary: "Get the mapping of documents to their resolved cases.",
-          description: "Requires read scope."
+          description: "Requires read scope. Returns a mapping of document IDs to their assigned case keys.",
+          children: /* @__PURE__ */ jsx5(CodeBlock, { title: "Response", children: `{
+  "data": {
+    "doc_uuid_1": "case_x7k9m2",
+    "doc_uuid_2": "case_x7k9m2"
+  }
+}` })
         }
       ) }),
       /* @__PURE__ */ jsx5(SectionHeading, { id: "nshot", children: "N-Shot" }),
-      /* @__PURE__ */ jsx5("p", { className: "text-[15px] text-void-text-secondary leading-relaxed mb-6", children: "N-Shot endpoints provide field-level comparisons between job runs \u2014 useful for evaluating extraction quality across schema versions. Submit judge decisions (human or AI) to record which run produced the better result." }),
+      /* @__PURE__ */ jsxs5("p", { className: "text-[15px] text-void-text-secondary leading-relaxed mb-6", children: [
+        "N-Shot endpoints provide field-level comparisons between job runs \u2014 useful for evaluating extraction quality across schema versions. Submit judge decisions (human or AI) to record which run produced the better result. All routes are nested under ",
+        /* @__PURE__ */ jsxs5(InlineCode, { children: [
+          "/v1/jobs/runs/",
+          "{runId}",
+          "/nshot/..."
+        ] }),
+        "."
+      ] }),
       /* @__PURE__ */ jsx5("div", { id: "nshot-summary", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
         EndpointBlock,
         {
           method: "GET",
           path: "/v1/jobs/runs/{runId}/nshot/summary",
           summary: "Get an aggregate N-Shot summary for a run.",
-          description: "Requires read scope."
+          description: "Requires read scope. Returns an aggregate summary of N-Shot comparisons for a job run."
         }
       ) }),
       /* @__PURE__ */ jsx5("div", { id: "nshot-comparisons", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
@@ -3493,7 +4150,7 @@ function verifyWebhook(payload, signature, secret) {
           method: "GET",
           path: "/v1/jobs/runs/{runId}/nshot/comparisons",
           summary: "List per-document field comparisons.",
-          description: "Requires read scope."
+          description: "Requires read scope. Returns all N-Shot comparisons for a job run."
         }
       ) }),
       /* @__PURE__ */ jsx5("div", { id: "nshot-comparison", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
@@ -3502,7 +4159,17 @@ function verifyWebhook(payload, signature, secret) {
           method: "GET",
           path: "/v1/jobs/runs/{runId}/nshot/comparison",
           summary: "Get a specific field comparison.",
-          description: "Requires read scope."
+          description: "Requires read scope. Returns a single N-Shot comparison filtered by document and field.",
+          children: /* @__PURE__ */ jsx5(
+            ParamTable,
+            {
+              title: "Query parameters",
+              params: [
+                { name: "document_id", type: "uuid", required: true, description: "Document ID to compare." },
+                { name: "field_name", type: "string", required: true, description: "Field name to compare." }
+              ]
+            }
+          )
         }
       ) }),
       /* @__PURE__ */ jsx5("div", { id: "nshot-override", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
@@ -3511,7 +4178,18 @@ function verifyWebhook(payload, signature, secret) {
           method: "POST",
           path: "/v1/jobs/runs/{runId}/nshot/override",
           summary: "Override an N-Shot value for a specific field.",
-          description: "Requires write scope."
+          description: "Requires write scope. Manually override the N-Shot selected value for a document-field pair.",
+          children: /* @__PURE__ */ jsx5(
+            ParamTable,
+            {
+              title: "Body parameters",
+              params: [
+                { name: "document_id", type: "uuid", required: true, description: "Document ID." },
+                { name: "field_name", type: "string", required: true, description: "Field name." },
+                { name: "value", type: "any", required: true, description: "The override value to apply." }
+              ]
+            }
+          )
         }
       ) }),
       /* @__PURE__ */ jsx5("div", { id: "nshot-judge-decision", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
@@ -3520,18 +4198,43 @@ function verifyWebhook(payload, signature, secret) {
           method: "POST",
           path: "/v1/jobs/runs/{runId}/nshot/judge-decision",
           summary: "Submit a judge decision (human or AI) for an N-Shot comparison.",
-          description: "Requires write scope."
+          description: "Requires write scope. Records which N-Shot candidate is correct.",
+          children: /* @__PURE__ */ jsx5(
+            ParamTable,
+            {
+              title: "Body parameters",
+              params: [
+                { name: "document_id", type: "uuid", required: true, description: "Document ID." },
+                { name: "field_name", type: "string", required: true, description: "Field name." },
+                { name: "decision", type: "string", required: true, description: "The judge's selected value or verdict." }
+              ]
+            }
+          )
         }
       ) }),
       /* @__PURE__ */ jsx5(SectionHeading, { id: "schema-graph", children: "Schema Graph" }),
-      /* @__PURE__ */ jsx5("p", { className: "text-[15px] text-void-text-secondary leading-relaxed mb-6", children: "The schema graph is a versioned ontology of document classes discovered across your workspace. Each class captures a document type's canonical fields. Diffs are generated when the system proposes changes and require approval before they take effect." }),
+      /* @__PURE__ */ jsx5("p", { className: "text-[15px] text-void-text-secondary leading-relaxed mb-6", children: "The schema graph is a versioned ontology of document classes discovered across your workspace. Each class captures a document type's canonical fields. The API exposes versioned classes, diffs proposed between versions (with approve/reject workflow), inter-class edges, aliases, and a D3-compatible visualization payload." }),
       /* @__PURE__ */ jsx5("div", { id: "list-schema-graph-classes", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
         EndpointBlock,
         {
           method: "GET",
           path: "/v1/schema-graph/classes",
           summary: "List all schema graph classes.",
-          description: "Requires read scope."
+          description: "Requires read scope. Returns all classes in the schema graph ontology.",
+          children: /* @__PURE__ */ jsx5(CodeBlock, { title: "Response", children: `{
+  "data": [
+    {
+      "id": "uuid",
+      "name": "Invoice",
+      "description": "Standard invoice schema",
+      "version": 3,
+      "field_count": 12,
+      "created_at": "2024-08-01T00:00:00Z",
+      "updated_at": "2024-09-14T00:00:00Z",
+      "links": { "self": "/v1/schema-graph/classes/uuid", "versions": "/v1/schema-graph/classes/uuid/versions" }
+    }
+  ]
+}` })
         }
       ) }),
       /* @__PURE__ */ jsx5("div", { id: "get-schema-graph-class", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
@@ -3549,7 +4252,16 @@ function verifyWebhook(payload, signature, secret) {
           method: "GET",
           path: "/v1/schema-graph/classes/{id}/versions",
           summary: "List all versions of a schema graph class.",
-          description: "Requires read scope."
+          description: "Requires read scope. Returns all published versions of a class, ordered by version number descending.",
+          children: /* @__PURE__ */ jsx5(CodeBlock, { title: "Response", children: `{
+  "data": [
+    {
+      "version": 3,
+      "fields": [...],
+      "created_at": "2024-09-01T00:00:00Z"
+    }
+  ]
+}` })
         }
       ) }),
       /* @__PURE__ */ jsx5("div", { id: "get-class-version", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
@@ -3567,25 +4279,39 @@ function verifyWebhook(payload, signature, secret) {
           method: "GET",
           path: "/v1/schema-graph/diffs",
           summary: "List pending, approved, and rejected diffs.",
-          description: "Requires read scope."
+          description: "Requires read scope. Returns pending and processed diffs between class versions.",
+          children: /* @__PURE__ */ jsx5(CodeBlock, { title: "Response", children: `{
+  "data": [
+    {
+      "id": "uuid",
+      "class_id": "uuid",
+      "from_version": 2,
+      "to_version": 3,
+      "status": "pending",
+      "changes": [...],
+      "created_at": "2024-09-14T10:00:00Z",
+      "decided_at": null
+    }
+  ]
+}` })
         }
       ) }),
-      /* @__PURE__ */ jsx5("div", { id: "approve-schema-graph-diff", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
+      /* @__PURE__ */ jsx5("div", { id: "approve-diff", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
         EndpointBlock,
         {
           method: "POST",
           path: "/v1/schema-graph/diffs/{id}/approve",
           summary: "Approve a pending diff, promoting it to the next class version.",
-          description: "Requires write scope."
+          description: "Requires write scope. Promotes the changes to the live class version."
         }
       ) }),
-      /* @__PURE__ */ jsx5("div", { id: "reject-schema-graph-diff", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
+      /* @__PURE__ */ jsx5("div", { id: "reject-diff", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
         EndpointBlock,
         {
           method: "POST",
           path: "/v1/schema-graph/diffs/{id}/reject",
           summary: "Reject a pending diff.",
-          description: "Requires write scope."
+          description: "Requires write scope. Discards the proposed changes."
         }
       ) }),
       /* @__PURE__ */ jsx5("div", { id: "list-schema-graph-edges", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
@@ -3594,7 +4320,17 @@ function verifyWebhook(payload, signature, secret) {
           method: "GET",
           path: "/v1/schema-graph/edges",
           summary: "List inter-class edges in the schema graph.",
-          description: "Requires read scope."
+          description: "Requires read scope. Returns all edges (relationships) between schema graph classes.",
+          children: /* @__PURE__ */ jsx5(CodeBlock, { title: "Response", children: `{
+  "data": [
+    {
+      "source_class_id": "uuid",
+      "target_class_id": "uuid",
+      "relationship": "references",
+      "weight": 0.87
+    }
+  ]
+}` })
         }
       ) }),
       /* @__PURE__ */ jsx5("div", { id: "list-schema-graph-aliases", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
@@ -3603,7 +4339,12 @@ function verifyWebhook(payload, signature, secret) {
           method: "GET",
           path: "/v1/schema-graph/aliases",
           summary: "List schema graph class aliases.",
-          description: "Requires read scope."
+          description: "Requires read scope. Returns all class aliases (alternative names mapping to canonical class IDs).",
+          children: /* @__PURE__ */ jsx5(CodeBlock, { title: "Response", children: `{
+  "data": [
+    { "alias": "Bill", "class_id": "uuid", "class_name": "Invoice" }
+  ]
+}` })
         }
       ) }),
       /* @__PURE__ */ jsx5("div", { id: "visualize-schema-graph", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
@@ -3612,11 +4353,11 @@ function verifyWebhook(payload, signature, secret) {
           method: "GET",
           path: "/v1/schema-graph/visualize",
           summary: "Get D3-compatible visualization data for the schema graph.",
-          description: "Requires read scope."
+          description: "Requires read scope. Returns nodes and edges formatted for graph visualization."
         }
       ) }),
       /* @__PURE__ */ jsx5(SectionHeading, { id: "structuring", children: "Structuring" }),
-      /* @__PURE__ */ jsx5("p", { className: "text-[15px] text-void-text-secondary leading-relaxed mb-6", children: "The structuring pipeline validates extracted data through configurable checks and approval gates. Checks define validation rules; gates aggregate checks and determine whether records require manual approval before delivery." }),
+      /* @__PURE__ */ jsx5("p", { className: "text-[15px] text-void-text-secondary leading-relaxed mb-6", children: "The structuring pipeline validates extracted data through configurable checks and approval gates. Checks define validation rules; gates aggregate checks and determine whether records require manual approval before delivery. Also exposes per-result check outcomes, the pending-approvals queue, approve/reject actions, and the manual delivery trigger for an approved run." }),
       /* @__PURE__ */ jsx5(SubHeading, { id: "structuring-checks", children: "Checks" }),
       /* @__PURE__ */ jsx5("div", { id: "list-structuring-checks", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
         EndpointBlock,
@@ -3624,17 +4365,42 @@ function verifyWebhook(payload, signature, secret) {
           method: "GET",
           path: "/v1/structuring/checks",
           summary: "List validation checks.",
-          description: "Requires read scope."
+          description: "Requires read scope. Returns all configured validation checks for the customer.",
+          children: /* @__PURE__ */ jsx5(
+            ParamTable,
+            {
+              title: "Query parameters",
+              params: [
+                { name: "limit", type: "integer", default: "20", description: "Maximum number of items to return (1\u2013100)." },
+                { name: "cursor", type: "string", description: "Opaque pagination cursor." },
+                { name: "order", type: "string", default: "desc", description: "Sort order by creation date (asc | desc)." }
+              ]
+            }
+          )
         }
       ) }),
-      /* @__PURE__ */ jsx5("div", { id: "create-structuring-check", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
+      /* @__PURE__ */ jsx5("div", { id: "create-structuring-check", className: "scroll-mt-6", children: /* @__PURE__ */ jsxs5(
         EndpointBlock,
         {
           method: "POST",
           path: "/v1/structuring/checks",
           summary: "Create a validation check.",
           description: "Requires write scope.",
-          children: /* @__PURE__ */ jsx5(CodeBlock, { title: "Request body", children: `{
+          children: [
+            /* @__PURE__ */ jsx5(
+              ParamTable,
+              {
+                title: "Body parameters",
+                params: [
+                  { name: "name", type: "string", required: true, description: "Check name." },
+                  { name: "description", type: "string", description: "Optional description." },
+                  { name: "type", type: "string", required: true, description: "Check type: field_format, value_range, cross_field, ai_coherence." },
+                  { name: "config", type: "object", description: "Type-specific configuration." },
+                  { name: "enabled", type: "boolean", default: "true", description: "Whether the check runs against new results." }
+                ]
+              }
+            ),
+            /* @__PURE__ */ jsx5(CodeBlock, { title: "Request body", children: `{
   "name": "Amount range check",
   "type": "value_range",
   "config": {
@@ -3643,6 +4409,7 @@ function verifyWebhook(payload, signature, secret) {
     "max": 1000000
   }
 }` })
+          ]
         }
       ) }),
       /* @__PURE__ */ jsx5("div", { id: "get-structuring-check", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
@@ -3650,26 +4417,8 @@ function verifyWebhook(payload, signature, secret) {
         {
           method: "GET",
           path: "/v1/structuring/checks/{id}",
-          summary: "Get a validation check.",
-          description: "Requires read scope."
-        }
-      ) }),
-      /* @__PURE__ */ jsx5("div", { id: "update-structuring-check", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
-        EndpointBlock,
-        {
-          method: "PUT",
-          path: "/v1/structuring/checks/{id}",
-          summary: "Update a validation check.",
-          description: "Requires write scope."
-        }
-      ) }),
-      /* @__PURE__ */ jsx5("div", { id: "delete-structuring-check", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
-        EndpointBlock,
-        {
-          method: "DELETE",
-          path: "/v1/structuring/checks/{id}",
-          summary: "Delete a validation check.",
-          description: "Requires write scope."
+          summary: "Get / update / delete a structuring check.",
+          description: "Same path supports GET (detail, requires read scope), PUT (update \u2014 same body shape as create, requires write scope), and DELETE (requires write scope)."
         }
       ) }),
       /* @__PURE__ */ jsx5(SubHeading, { id: "structuring-gates", children: "Approval Gates" }),
@@ -3679,7 +4428,7 @@ function verifyWebhook(payload, signature, secret) {
           method: "GET",
           path: "/v1/structuring/gates",
           summary: "List approval gates.",
-          description: "Requires read scope."
+          description: "Requires read scope. Returns all configured approval gates for the customer."
         }
       ) }),
       /* @__PURE__ */ jsx5("div", { id: "create-structuring-gate", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
@@ -3688,7 +4437,18 @@ function verifyWebhook(payload, signature, secret) {
           method: "POST",
           path: "/v1/structuring/gates",
           summary: "Create an approval gate.",
-          description: "Requires write scope."
+          description: "Requires write scope.",
+          children: /* @__PURE__ */ jsx5(
+            ParamTable,
+            {
+              title: "Body parameters",
+              params: [
+                { name: "name", type: "string", required: true, description: "Gate name." },
+                { name: "description", type: "string", description: "Optional description." },
+                { name: "schema_id", type: "uuid", description: "Optional schema scope for the gate." }
+              ]
+            }
+          )
         }
       ) }),
       /* @__PURE__ */ jsx5("div", { id: "get-structuring-gate", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
@@ -3696,94 +4456,169 @@ function verifyWebhook(payload, signature, secret) {
         {
           method: "GET",
           path: "/v1/structuring/gates/{id}",
-          summary: "Get an approval gate with its rules.",
-          description: "Requires read scope."
+          summary: "Get / update / delete an approval gate.",
+          description: "Same path supports GET (detail with rules, requires read scope), PUT (update, requires write scope), and DELETE (requires write scope)."
         }
       ) }),
-      /* @__PURE__ */ jsx5("div", { id: "update-structuring-gate", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
+      /* @__PURE__ */ jsxs5("div", { id: "gate-rules", className: "scroll-mt-6", children: [
+        /* @__PURE__ */ jsx5(
+          EndpointBlock,
+          {
+            method: "POST",
+            path: "/v1/structuring/gates/{id}/rules",
+            summary: "Add a rule to an approval gate.",
+            description: "Requires write scope.",
+            children: /* @__PURE__ */ jsx5(
+              ParamTable,
+              {
+                title: "Body parameters",
+                params: [
+                  { name: "type", type: "string", required: true, description: "Rule type (e.g. min_confidence, validation_pass_rate, field_coverage)." },
+                  { name: "threshold", type: "number", required: true, description: "Numeric threshold value." }
+                ]
+              }
+            )
+          }
+        ),
+        /* @__PURE__ */ jsx5(
+          EndpointBlock,
+          {
+            method: "DELETE",
+            path: "/v1/structuring/gates/{gateId}/rules/{ruleId}",
+            summary: "Remove a rule from an approval gate.",
+            description: "Requires write scope. Soft-deletes a rule. Both identifiers come from the path; no request body.",
+            children: /* @__PURE__ */ jsx5(
+              ParamTable,
+              {
+                title: "Path parameters",
+                params: [
+                  { name: "gateId", type: "uuid", required: true, description: "Parent approval gate identifier." },
+                  { name: "ruleId", type: "uuid", required: true, description: "Rule identifier to remove." }
+                ]
+              }
+            )
+          }
+        )
+      ] }),
+      /* @__PURE__ */ jsx5("div", { id: "result-checks", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
         EndpointBlock,
         {
-          method: "PUT",
-          path: "/v1/structuring/gates/{id}",
-          summary: "Update an approval gate.",
-          description: "Requires write scope."
+          method: "GET",
+          path: "/v1/structuring/results/{id}/checks",
+          summary: "Get check results for a structuring result.",
+          description: "Requires read scope. Returns the validation check outcomes for a specific structuring result.",
+          children: /* @__PURE__ */ jsx5(CodeBlock, { title: "Response", children: `{
+  "data": [
+    {
+      "check_id": "uuid",
+      "check_name": "vendor_present",
+      "passed": true,
+      "message": null
+    }
+  ]
+}` })
         }
       ) }),
-      /* @__PURE__ */ jsx5("div", { id: "delete-structuring-gate", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
+      /* @__PURE__ */ jsx5("div", { id: "pending-approvals", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
         EndpointBlock,
         {
-          method: "DELETE",
-          path: "/v1/structuring/gates/{id}",
-          summary: "Delete an approval gate.",
-          description: "Requires write scope."
+          method: "GET",
+          path: "/v1/structuring/approvals/pending",
+          summary: "List pending approvals.",
+          description: "Requires read scope. Returns structuring results awaiting manual approval."
+        }
+      ) }),
+      /* @__PURE__ */ jsx5("div", { id: "approve-reject-result", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
+        EndpointBlock,
+        {
+          method: "POST",
+          path: "/v1/structuring/approvals/{id}/approve",
+          summary: "Approve / reject a structuring result.",
+          description: "Requires write scope. POST /approve approves the result; POST /reject rejects it. Both return { id, status }."
+        }
+      ) }),
+      /* @__PURE__ */ jsx5("div", { id: "trigger-delivery", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
+        EndpointBlock,
+        {
+          method: "POST",
+          path: "/v1/structuring/delivery/{runId}",
+          summary: "Trigger delivery for a structuring run.",
+          description: "Requires write scope. Emit delivery signals for all approved results in the run.",
+          children: /* @__PURE__ */ jsx5(CodeBlock, { title: "Response", children: `{
+  "delivered": 142,
+  "skipped": 8
+}` })
         }
       ) }),
       /* @__PURE__ */ jsx5(SectionHeading, { id: "telemetry", children: "Telemetry" }),
-      /* @__PURE__ */ jsx5("p", { className: "text-[15px] text-void-text-secondary leading-relaxed mb-6", children: "Aggregate structuring metrics \u2014 capture hit rate, synthesize rate, strategy distribution, and tier funnel breakdowns per schema or run." }),
-      /* @__PURE__ */ jsx5("div", { id: "telemetry-schema-summary", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
+      /* @__PURE__ */ jsx5("p", { className: "text-[15px] text-void-text-secondary leading-relaxed mb-6", children: "Telemetry endpoints aggregate structuring metrics (capture hit rate, synthesize rate, strategy distribution, tier funnel) per schema or per run." }),
+      /* @__PURE__ */ jsx5("div", { id: "schema-telemetry-summary", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
         EndpointBlock,
         {
           method: "GET",
           path: "/v1/telemetry/schemas/{id}/summary",
           summary: "Get aggregate metrics for a schema across all runs.",
-          description: "Requires read scope."
+          description: "Requires read scope. Aggregate structuring metrics for a schema \u2014 capture hit rate, synthesize rate, strategy distribution, tier funnel."
         }
       ) }),
-      /* @__PURE__ */ jsx5("div", { id: "telemetry-schema-trend", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
+      /* @__PURE__ */ jsx5("div", { id: "schema-telemetry-trend", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
         EndpointBlock,
         {
           method: "GET",
           path: "/v1/telemetry/schemas/{id}/trend",
           summary: "Get metric trends over time for a schema.",
-          description: "Requires read scope."
+          description: "Requires read scope. Time-series telemetry data for a schema over recent runs."
         }
       ) }),
-      /* @__PURE__ */ jsx5("div", { id: "telemetry-schema-fields", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
+      /* @__PURE__ */ jsx5("div", { id: "schema-telemetry-fields", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
         EndpointBlock,
         {
           method: "GET",
           path: "/v1/telemetry/schemas/{id}/fields",
           summary: "Get per-field structuring metrics for a schema.",
-          description: "Requires read scope."
+          description: "Requires read scope. Field-level structuring metrics \u2014 per-field state distribution, capture rates, and strategy breakdown."
         }
       ) }),
-      /* @__PURE__ */ jsx5("div", { id: "telemetry-run-summary", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
+      /* @__PURE__ */ jsx5("div", { id: "run-telemetry-summary", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
         EndpointBlock,
         {
           method: "GET",
           path: "/v1/telemetry/runs/{id}/summary",
           summary: "Get structuring metrics for a single run.",
-          description: "Requires read scope."
+          description: "Requires read scope. Aggregate structuring metrics for a specific job run."
         }
       ) }),
       /* @__PURE__ */ jsx5(SectionHeading, { id: "validation", children: "Validation" }),
-      /* @__PURE__ */ jsx5("p", { className: "text-[15px] text-void-text-secondary leading-relaxed mb-6", children: "Golden sample management and validation runs for measuring extraction accuracy against ground truth datasets. Create a golden sample set, then run validations to compare extracted values against expected values." }),
-      /* @__PURE__ */ jsx5(SubHeading, { id: "golden-samples", children: "Golden Samples" }),
-      /* @__PURE__ */ jsx5("div", { id: "list-golden-samples", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
+      /* @__PURE__ */ jsx5("p", { className: "text-[15px] text-void-text-secondary leading-relaxed mb-6", children: "Validation runs measure extraction accuracy against ground-truth datasets. Manage datasets and runs, and retrieve per-document and per-field accuracy results. Create a ground-truth set, then run validations to compare extracted values against expected values." }),
+      /* @__PURE__ */ jsx5(SubHeading, { id: "ground-truth-datasets", children: "Ground-Truth Datasets" }),
+      /* @__PURE__ */ jsx5("div", { id: "list-ground-truth", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
         EndpointBlock,
         {
           method: "GET",
           path: "/v1/validation/ground-truth",
-          summary: "List golden sample sets.",
-          description: "Requires read scope."
+          summary: "List ground-truth datasets.",
+          description: "Requires read scope. Returns all ground-truth datasets for the customer.",
+          children: /* @__PURE__ */ jsx5(CodeBlock, { title: "Response", children: `{
+  "data": [
+    {
+      "id": "uuid",
+      "name": "Invoice Validation Set",
+      "description": "50 manually verified invoices",
+      "sample_count": 50,
+      "created_at": "2024-08-01T00:00:00Z",
+      "links": { "self": "/v1/validation/ground-truth/uuid" }
+    }
+  ]
+}` })
         }
       ) }),
-      /* @__PURE__ */ jsx5("div", { id: "get-golden-sample", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
+      /* @__PURE__ */ jsx5("div", { id: "get-ground-truth", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
         EndpointBlock,
         {
           method: "GET",
           path: "/v1/validation/ground-truth/{id}",
-          summary: "Get a golden sample set with its expected values.",
-          description: "Requires read scope."
-        }
-      ) }),
-      /* @__PURE__ */ jsx5("div", { id: "delete-golden-sample", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
-        EndpointBlock,
-        {
-          method: "DELETE",
-          path: "/v1/validation/ground-truth/{id}",
-          summary: "Delete a golden sample set.",
-          description: "Requires write scope."
+          summary: "Get / delete a ground-truth dataset.",
+          description: "Same path supports GET (detail with expected values, requires read scope) and DELETE (requires write scope)."
         }
       ) }),
       /* @__PURE__ */ jsx5(SubHeading, { id: "validation-runs", children: "Validation Runs" }),
@@ -3796,18 +4631,40 @@ function verifyWebhook(payload, signature, secret) {
           description: "Requires read scope."
         }
       ) }),
-      /* @__PURE__ */ jsx5("div", { id: "create-validation-run", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
+      /* @__PURE__ */ jsx5("div", { id: "create-validation-run", className: "scroll-mt-6", children: /* @__PURE__ */ jsxs5(
         EndpointBlock,
         {
           method: "POST",
           path: "/v1/validation/runs",
-          summary: "Create a validation run comparing a job against a golden sample.",
-          description: "Requires write scope.",
-          children: /* @__PURE__ */ jsx5(CodeBlock, { title: "Request body", children: `{
+          summary: "Create a validation run comparing a job against a ground-truth dataset.",
+          description: "Requires write scope. Starts a new validation run against a ground-truth dataset.",
+          children: [
+            /* @__PURE__ */ jsx5(
+              ParamTable,
+              {
+                title: "Body parameters",
+                params: [
+                  { name: "golden_sample_id", type: "uuid", required: true, description: "Ground-truth dataset to validate against (column name retained for backwards compatibility)." },
+                  { name: "dataspace_run_id", type: "uuid", description: "Optional job run to validate." },
+                  { name: "schema_id", type: "uuid", description: "Optional schema to scope the validation." },
+                  { name: "name", type: "string", description: "Optional human-readable name." }
+                ]
+              }
+            ),
+            /* @__PURE__ */ jsx5(CodeBlock, { title: "Request body", children: `{
   "dataspace_run_id": "run_abc123",
   "golden_sample_id": "gs_xyz789",
   "name": "Q1 Invoice accuracy check"
+}` }),
+            /* @__PURE__ */ jsx5(CodeBlock, { title: "Response (201)", children: `{
+  "id": "uuid",
+  "golden_sample_id": "uuid",
+  "schema_id": "uuid",
+  "status": "pending",
+  "created_at": "2024-09-14T10:32:00Z",
+  "links": { "self": "/v1/validation/runs/uuid", "results": "/v1/validation/runs/uuid/results" }
 }` })
+          ]
         }
       ) }),
       /* @__PURE__ */ jsx5("div", { id: "get-validation-run", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
@@ -3815,8 +4672,8 @@ function verifyWebhook(payload, signature, secret) {
         {
           method: "GET",
           path: "/v1/validation/runs/{id}",
-          summary: "Get a validation run with accuracy summary.",
-          description: "Requires read scope."
+          summary: "Get / delete a validation run.",
+          description: "Same path supports GET (detail with accuracy summary, requires read scope) and DELETE (requires write scope)."
         }
       ) }),
       /* @__PURE__ */ jsx5("div", { id: "get-validation-results", className: "scroll-mt-6", children: /* @__PURE__ */ jsxs5(
@@ -3825,13 +4682,15 @@ function verifyWebhook(payload, signature, secret) {
           method: "GET",
           path: "/v1/validation/runs/{id}/results",
           summary: "Get per-field validation results.",
-          description: "Requires read scope.",
+          description: "Requires read scope. Returns per-document and per-field accuracy results for the validation run.",
           children: [
             /* @__PURE__ */ jsx5(ParamTable, { params: [
               { name: "judged_only", type: "string", required: false, description: 'Set to "true" to return only judged results.' }
             ] }),
             /* @__PURE__ */ jsx5(CodeBlock, { title: "Response", children: `{
-  "data": [
+  "accuracy_overall": 0.94,
+  "accuracy_by_field": { "vendor_name": 0.98, "total": 0.91 },
+  "results": [
     {
       "document_id": "doc_abc123",
       "field_name": "invoice_number",
@@ -3846,24 +4705,15 @@ function verifyWebhook(payload, signature, secret) {
           ]
         }
       ) }),
-      /* @__PURE__ */ jsx5("div", { id: "delete-validation-run", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
-        EndpointBlock,
-        {
-          method: "DELETE",
-          path: "/v1/validation/runs/{id}",
-          summary: "Delete a validation run.",
-          description: "Requires write scope."
-        }
-      ) }),
       /* @__PURE__ */ jsx5(SectionHeading, { id: "credits", children: "Credits" }),
-      /* @__PURE__ */ jsx5("p", { className: "text-[15px] text-void-text-secondary leading-relaxed mb-6", children: "Track credit balance, transaction history, and usage breakdowns by operation type and time period." }),
+      /* @__PURE__ */ jsx5("p", { className: "text-[15px] text-void-text-secondary leading-relaxed mb-6", children: "Credit endpoints expose the current balance, transaction history, aggregate usage summaries, daily usage, and a per-request usage log with model and token counts. Track credit balance and usage breakdowns by operation type and time period." }),
       /* @__PURE__ */ jsx5("div", { id: "credits-balance", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
         EndpointBlock,
         {
           method: "GET",
           path: "/v1/credits/balance",
           summary: "Get current credit balance.",
-          description: "Requires read scope.",
+          description: "Requires read scope. Returns the current credit balance for the authenticated customer.",
           children: /* @__PURE__ */ jsx5(CodeBlock, { title: "Response", children: `{
   "balance": 4250.00,
   "currency": "USD",
@@ -3871,52 +4721,126 @@ function verifyWebhook(payload, signature, secret) {
 }` })
         }
       ) }),
-      /* @__PURE__ */ jsx5("div", { id: "credits-history", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
+      /* @__PURE__ */ jsx5("div", { id: "credits-history", className: "scroll-mt-6", children: /* @__PURE__ */ jsxs5(
         EndpointBlock,
         {
           method: "GET",
           path: "/v1/credits/history",
           summary: "Get credit transaction history.",
-          description: "Requires read scope.",
-          children: /* @__PURE__ */ jsx5(ParamTable, { params: [
-            { name: "limit", type: "integer", required: false, description: "Max items to return (default 20)." },
-            { name: "cursor", type: "string", required: false, description: "Pagination cursor." }
-          ] })
+          description: "Requires read scope. Returns credit transaction history (purchases, deductions, adjustments).",
+          children: [
+            /* @__PURE__ */ jsx5(
+              ParamTable,
+              {
+                title: "Query parameters",
+                params: [
+                  { name: "limit", type: "integer", required: false, description: "Max items to return (default 20)." },
+                  { name: "cursor", type: "string", required: false, description: "Pagination cursor." }
+                ]
+              }
+            ),
+            /* @__PURE__ */ jsx5(CodeBlock, { title: "Response", children: `{
+  "data": [
+    {
+      "id": "uuid",
+      "type": "deduction",
+      "amount": -0.18,
+      "description": "Extraction: doc_3j7x9p2q",
+      "created_at": "2024-09-14T10:32:00Z"
+    }
+  ],
+  "pagination": { "next_cursor": null }
+}` })
+          ]
         }
       ) }),
-      /* @__PURE__ */ jsx5("div", { id: "credits-usage-summary", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
+      /* @__PURE__ */ jsx5("div", { id: "credits-usage", className: "scroll-mt-6", children: /* @__PURE__ */ jsxs5(
         EndpointBlock,
         {
           method: "GET",
-          path: "/v1/credits/usage-summary",
-          summary: "Get aggregate usage summary by operation type.",
-          description: "Requires read scope.",
-          children: /* @__PURE__ */ jsx5(ParamTable, { params: [
-            { name: "from", type: "date-time", required: false, description: "Start of period (default 30 days ago)." },
-            { name: "to", type: "date-time", required: false, description: "End of period (default now)." }
-          ] })
+          path: "/v1/credits/usage",
+          summary: "Get aggregate credit usage summary by feature.",
+          description: "Requires read scope. Returns aggregate credit usage broken down by feature.",
+          children: [
+            /* @__PURE__ */ jsx5(
+              ParamTable,
+              {
+                title: "Query parameters",
+                params: [
+                  { name: "from", type: "string", description: "Start of the period (ISO 8601, default 30 days ago)." },
+                  { name: "to", type: "string", description: "End of the period (ISO 8601, default now)." }
+                ]
+              }
+            ),
+            /* @__PURE__ */ jsx5(CodeBlock, { title: "Response", children: `{
+  "total_used": 18.42,
+  "breakdown": [
+    { "feature": "extraction", "credits_used": 12.30, "call_count": 1842 },
+    { "feature": "matching", "credits_used": 6.12, "call_count": 920 }
+  ]
+}` })
+          ]
         }
       ) }),
-      /* @__PURE__ */ jsx5("div", { id: "credits-daily-usage", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
+      /* @__PURE__ */ jsx5("div", { id: "credits-usage-daily", className: "scroll-mt-6", children: /* @__PURE__ */ jsxs5(
         EndpointBlock,
         {
           method: "GET",
-          path: "/v1/credits/daily-usage",
-          summary: "Get daily usage breakdown.",
-          description: "Requires read scope."
+          path: "/v1/credits/usage/daily",
+          summary: "Get daily credit usage breakdown.",
+          description: "Requires read scope. Returns per-day credit usage for the specified period (default last 30 days).",
+          children: [
+            /* @__PURE__ */ jsx5(
+              ParamTable,
+              {
+                title: "Query parameters",
+                params: [
+                  { name: "from", type: "string", description: "Start of the period (ISO 8601)." },
+                  { name: "to", type: "string", description: "End of the period (ISO 8601)." }
+                ]
+              }
+            ),
+            /* @__PURE__ */ jsx5(CodeBlock, { title: "Response", children: `{
+  "data": [
+    { "date": "2024-09-14", "credits_used": 0.62, "call_count": 87 }
+  ]
+}` })
+          ]
         }
       ) }),
-      /* @__PURE__ */ jsx5("div", { id: "credits-usage-log", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
+      /* @__PURE__ */ jsx5("div", { id: "credits-usage-log", className: "scroll-mt-6", children: /* @__PURE__ */ jsxs5(
         EndpointBlock,
         {
           method: "GET",
-          path: "/v1/credits/usage-log",
+          path: "/v1/credits/usage/log",
           summary: "Get per-request usage log with token counts and cost estimates.",
-          description: "Requires read scope.",
-          children: /* @__PURE__ */ jsx5(ParamTable, { params: [
-            { name: "limit", type: "integer", required: false, description: "Max items to return (default 50)." },
-            { name: "cursor", type: "string", required: false, description: "Pagination cursor." }
-          ] })
+          description: "Requires read scope. Returns a detailed per-request usage log with model, tokens, and cost.",
+          children: [
+            /* @__PURE__ */ jsx5(
+              ParamTable,
+              {
+                title: "Query parameters",
+                params: [
+                  { name: "limit", type: "integer", required: false, description: "Max items to return (default 50)." },
+                  { name: "cursor", type: "string", required: false, description: "Pagination cursor." }
+                ]
+              }
+            ),
+            /* @__PURE__ */ jsx5(CodeBlock, { title: "Response", children: `{
+  "data": [
+    {
+      "id": "uuid",
+      "operation_type": "extraction",
+      "model": "claude-sonnet",
+      "input_tokens": 4280,
+      "output_tokens": 612,
+      "cost_credits": 0.012,
+      "created_at": "2024-09-14T10:32:00Z"
+    }
+  ],
+  "pagination": { "next_cursor": null }
+}` })
+          ]
         }
       ) }),
       /* @__PURE__ */ jsx5(SectionHeading, { id: "agent", children: "Agent" }),
@@ -5485,49 +6409,44 @@ var API_NAV_SECTIONS = [
     { id: "list-class-versions", label: "List Versions" },
     { id: "get-class-version", label: "Get Version" },
     { id: "list-schema-graph-diffs", label: "List Diffs" },
-    { id: "approve-schema-graph-diff", label: "Approve Diff" },
-    { id: "reject-schema-graph-diff", label: "Reject Diff" },
+    { id: "approve-diff", label: "Approve Diff" },
+    { id: "reject-diff", label: "Reject Diff" },
     { id: "list-schema-graph-edges", label: "Edges" },
     { id: "list-schema-graph-aliases", label: "Aliases" },
     { id: "visualize-schema-graph", label: "Visualize" }
   ] },
   { id: "structuring", label: "Structuring", children: [
-    { id: "structuring-checks", label: "Checks" },
     { id: "list-structuring-checks", label: "List Checks" },
     { id: "create-structuring-check", label: "Create Check" },
-    { id: "get-structuring-check", label: "Get Check" },
-    { id: "update-structuring-check", label: "Update Check" },
-    { id: "delete-structuring-check", label: "Delete Check" },
-    { id: "structuring-gates", label: "Approval Gates" },
+    { id: "get-structuring-check", label: "Get / Update / Delete Check" },
     { id: "list-structuring-gates", label: "List Gates" },
     { id: "create-structuring-gate", label: "Create Gate" },
-    { id: "get-structuring-gate", label: "Get Gate" },
-    { id: "update-structuring-gate", label: "Update Gate" },
-    { id: "delete-structuring-gate", label: "Delete Gate" }
+    { id: "get-structuring-gate", label: "Get / Update / Delete Gate" },
+    { id: "gate-rules", label: "Gate Rules" },
+    { id: "result-checks", label: "Result Checks" },
+    { id: "pending-approvals", label: "Pending Approvals" },
+    { id: "approve-reject-result", label: "Approve / Reject Result" },
+    { id: "trigger-delivery", label: "Trigger Delivery" }
   ] },
   { id: "telemetry", label: "Telemetry", children: [
-    { id: "telemetry-schema-summary", label: "Schema Summary" },
-    { id: "telemetry-schema-trend", label: "Schema Trend" },
-    { id: "telemetry-schema-fields", label: "Schema Fields" },
-    { id: "telemetry-run-summary", label: "Run Summary" }
+    { id: "schema-telemetry-summary", label: "Schema Summary" },
+    { id: "schema-telemetry-trend", label: "Schema Trend" },
+    { id: "schema-telemetry-fields", label: "Schema Fields" },
+    { id: "run-telemetry-summary", label: "Run Summary" }
   ] },
   { id: "validation", label: "Validation", children: [
-    { id: "golden-samples", label: "Golden Samples" },
-    { id: "list-golden-samples", label: "List Golden Samples" },
-    { id: "get-golden-sample", label: "Get Golden Sample" },
-    { id: "delete-golden-sample", label: "Delete Golden Sample" },
-    { id: "validation-runs", label: "Validation Runs" },
-    { id: "list-validation-runs", label: "List Runs" },
-    { id: "create-validation-run", label: "Create Run" },
-    { id: "get-validation-run", label: "Get Run" },
-    { id: "get-validation-results", label: "Results" },
-    { id: "delete-validation-run", label: "Delete Run" }
+    { id: "list-ground-truth", label: "List Ground-Truth Datasets" },
+    { id: "get-ground-truth", label: "Get / Delete Ground-Truth Dataset" },
+    { id: "list-validation-runs", label: "List Validation Runs" },
+    { id: "create-validation-run", label: "Create Validation Run" },
+    { id: "get-validation-run", label: "Get / Delete Validation Run" },
+    { id: "get-validation-results", label: "Validation Results" }
   ] },
   { id: "credits", label: "Credits", children: [
     { id: "credits-balance", label: "Balance" },
     { id: "credits-history", label: "History" },
-    { id: "credits-usage-summary", label: "Usage Summary" },
-    { id: "credits-daily-usage", label: "Daily Usage" },
+    { id: "credits-usage", label: "Usage Summary" },
+    { id: "credits-usage-daily", label: "Daily Usage" },
     { id: "credits-usage-log", label: "Usage Log" }
   ] },
   { id: "agent", label: "Agent", children: [