@talonic/docs 0.10.0 → 0.12.0

package/openapi.json

@@ -3,7 +3,7 @@
   "info": {
     "title": "Talonic API",
     "version": "1.0.0",
-    "description": "Structure any document into schema-validated data.\n\nThe Talonic API lets you extract structured data from documents (PDFs, images,\nDOCX, CSV, plain text), manage reusable extraction schemas, track async jobs,\nand organise documents through sources.\n\n## Authentication\n\nAll requests require a Bearer token in the `Authorization` header.\nAPI keys are prefixed with `tlnc_` and scoped per customer.\n\n```\nAuthorization: Bearer tlnc_live_abc123...\n```\n\n## Rate Limits\n\nRequests are metered per calendar day (UTC). Limits depend on your plan tier:\n\n| Tier       | Extract | Platform | Ingest |\n|------------|---------|----------|--------|\n| Free       | 50/day  | 500/day  | 50/day |\n| Pro        | 2,000   | 10,000   | 2,000  |\n| Enterprise | Unlimited | Unlimited | Unlimited |\n\nEvery response includes rate-limit headers:\n- `X-RateLimit-Limit` — daily cap for the namespace\n- `X-RateLimit-Remaining` — requests left today\n- `X-RateLimit-Reset` — ISO 8601 timestamp when the window resets (midnight UTC)\n\n## Pagination\n\nList endpoints use cursor-based pagination. Pass `limit` (1–100, default 20),\n`cursor` (opaque token from `pagination.next_cursor`), and `order` (`asc` or `desc`, default `desc`).\n\n## Errors\n\nAll errors return a JSON body with `error` (machine-readable code) and `message`\n(human-readable explanation). Additional fields vary by error type.\n",
+    "description": "Structure any document into schema-validated data.\n\nThe Talonic API lets you extract structured data from documents (PDFs, images,\nDOCX, CSV, plain text), manage reusable extraction schemas, track async jobs,\nand organise documents through sources.\n\n## Authentication\n\nAll requests require a Bearer token in the `Authorization` header.\nAPI keys are prefixed with `tlnc_` and scoped per customer.\n\n```\nAuthorization: Bearer tlnc_live_abc123...\n```\n\n## Async Extraction Pattern\n\nSmall documents (≤5 pages) are processed synchronously and return a `200`\nwith the extracted data immediately. Larger documents return a `202 Accepted`\nwith a `poll_url` — poll `GET /v1/documents/{id}` until `status` transitions\nto `completed`, then fetch results via `GET /v1/documents/{id}/extractions`.\n\nYou can force async processing by passing `options: {\"async\": true}` on\nany extraction request. Combine with webhooks for a fully event-driven flow:\nconfigure a webhook destination under Delivery and listen for the\n`extraction.complete` event.\n\n**Job status lifecycle:** `pending` → `processing` → `complete` | `failed`\n\n## Rate Limits\n\nRequests are metered per calendar day (UTC). Limits depend on your plan tier:\n\n| Tier       | Extract | Platform | Ingest |\n|------------|---------|----------|--------|\n| Free       | 50/day  | 500/day  | 50/day |\n| Pro        | 2,000   | 10,000   | 2,000  |\n| Enterprise | Unlimited | Unlimited | Unlimited |\n\nEvery response includes rate-limit headers:\n- `X-RateLimit-Limit` — daily cap for the namespace\n- `X-RateLimit-Remaining` — requests left today\n- `X-RateLimit-Reset` — ISO 8601 timestamp when the window resets (midnight UTC)\n\n## Pagination\n\nList endpoints use cursor-based pagination. Pass `limit` (1–100, default 20),\n`cursor` (opaque token from `pagination.next_cursor`), and `order` (`asc` or `desc`, default `desc`).\n\n## Errors\n\nAll errors return a JSON body with `error` (machine-readable code) and `message`\n(human-readable explanation). Additional fields vary by error type.\n\n| Code | Error              | Description                              |\n|------|--------------------|------------------------------------------|\n| 400  | validation_error   | Request body is malformed or invalid     |\n| 401  | unauthorized       | Missing or invalid API key               |\n| 403  | insufficient_scope | API key lacks the required scope         |\n| 404  | not_found          | Resource does not exist                  |\n| 409  | conflict           | Resource state conflict                  |\n| 413  | payload_too_large  | File exceeds 500 MB limit                |\n| 422  | extraction_failed  | Document could not be processed          |\n| 429  | rate_limit_exceeded| Daily rate limit reached                 |\n| 500  | internal_error     | Unexpected server error (retryable)      |\n\nEvery error response follows this envelope:\n\n```json\n{\n  \"statusCode\": 400,\n  \"code\": \"VALIDATION_ERROR\",\n  \"error\": \"Bad Request\",\n  \"message\": \"name is required.\",\n  \"retryable\": false,\n  \"timestamp\": \"2026-04-25T14:30:00.000Z\",\n  \"path\": \"/v1/schemas\"\n}\n```\n\nThe `code` field is one of: `VALIDATION_ERROR`, `AUTH_REQUIRED`, `TOKEN_EXPIRED`,\n`INSUFFICIENT_PERMISSIONS`, `RESOURCE_NOT_FOUND`, `QUOTA_EXCEEDED`,\n`INSUFFICIENT_CREDITS`, `LLM_RATE_LIMITED`, `LLM_TIMEOUT`, `LLM_UNAVAILABLE`,\n`OCR_FAILED`, `EXTRACTION_FAILED`, `EXTRACTION_TIMEOUT`, `FILE_TOO_LARGE`,\n`DUPLICATE_RESOURCE`, `DATASPACE_RUN_FAILED`, `INTERNAL_ERROR`.\n\n## Async Extraction Lifecycle\n\nEnd-to-end async flow:\n\n**Step 1 — Submit extraction with `async: true`:**\n```\nPOST /v1/extract\nContent-Type: multipart/form-data\nAuthorization: Bearer tlnc_live_abc123\n\nfile=@contract.pdf\noptions={\"async\": true}\n```\nResponse `202 Accepted`:\n```json\n{\n  \"request_id\": \"req_x7y8z9a0\",\n  \"status\": \"processing\",\n  \"document\": { \"id\": \"f0e1d2c3-...\" },\n  \"poll_url\": \"/v1/documents/f0e1d2c3-...\"\n}\n```\n\n**Step 2 — Poll for completion:**\n```\nGET /v1/documents/f0e1d2c3-...\n```\nResponse `200` (when done): `\"status\": \"completed\"`\n\n**Step 3 — Retrieve results:**\n```\nGET /v1/documents/f0e1d2c3-.../extractions\n```\n\n**Alternative — Webhooks:** Configure a delivery destination and binding\nto receive `document.extracted` events via POST callback. See the\nDelivery tag for setup details.\n\n**Job status state machine:**\n`pending` → `queued` → `processing` → `complete` | `failed`\n\nCancelled jobs transition directly to `failed` from `pending` or `processing`.\n\n## Operational Details\n\n**Uptime SLA:**\n- Free: best effort\n- Pro: 99.5%\n- Enterprise: 99.9% (custom SLA available)\n\n**Timeouts:** Synchronous extractions time out after 120 seconds. For\ndocuments that may take longer, use `async: true`. Async jobs have no\ntimeout — they run to completion or failure.\n\n**Payload limits:**\n- File upload (extract, ingest): 500 MB\n- JSON request bodies (schemas, jobs): 1 MB\n- PATCH corrections: 1 MB\n\n**Idempotency keys:** Pass an `Idempotency-Key` header on POST requests.\nKeys are valid for 24 hours. A duplicate request returns the cached\nresponse with `cached: true` in the body. Keys are scoped per API key.\n",
     "contact": {
       "name": "Talonic Support",
       "email": "support@talonic.ai",
@@ -67,7 +67,7 @@
     },
     {
       "name": "Delivery",
-      "description": "Outbound delivery. Configure destinations (seven live connectors: webhook, sftp,\ns3, azure_blob, google_drive, onedrive, google_sheets), create bindings that join\nsignal filters to deliverable types + destinations + serializers, and inspect the\nhistory/DLQ/events log. Every delivery is at-least-once with an idempotency key\non the wire.\n"
+      "description": "Outbound delivery. Configure destinations (webhook, sftp, s3, azure_blob,\ngoogle_drive, onedrive, google_sheets), create bindings that join signal\nfilters to deliverable types + serializers, and inspect delivery history.\n\n## Webhook Delivery Contract\n\n**Payload envelope:**\n```json\n{\n  \"event\": {\n    \"event_type\": \"document.extracted\",\n    \"event_id\": \"42\",\n    \"binding_id\": \"uuid\",\n    \"idempotency_key\": \"a1b2c3...32-char-hex\",\n    \"attempt\": 1,\n    \"delivered_at\": \"2026-04-25T14:30:00.000Z\"\n  },\n  \"payload\": { \"...serialized data...\" }\n}\n```\n\n**Headers:** `X-Talonic-Event`, `X-Talonic-Delivery`, `X-Talonic-Signature`,\n`X-Talonic-Attempt`, `X-Talonic-Idempotency-Key`.\n\n**Signature verification (HMAC-SHA256):**\n```\nX-Talonic-Signature: t=1714060200000,v1=abc123...\nsigned = HMAC-SHA256(signing_secret, \"${timestamp}.${body}\")\n```\n\n**Event types:** `document.extracted`, `document.extraction_failed`,\n`run.dataspace.completed`, `run.dataspace.failed`,\n`result.dataspace.completed`, `result.approved`, `result.rejected`,\n`delivery.item.completed`, `delivery.item.failed` (17 total).\n\n**Retry policy:** Up to 7 attempts with exponential backoff:\n0s → 30s → 2m → 8m → 30m → 2h → 8h (~10.5h total).\nHTTP 429 and 5xx are retryable. HTTP 4xx (except 408) goes to DLQ immediately.\n\n**Dead-letter queue:** Failed deliveries land in the DLQ. Replay via\n`POST /v1/delivery/dlq/{id}/replay` which re-enqueues with attempt=1\nand the same idempotency key.\n"
     },
     {
       "name": "Filter",
@@ -142,6 +142,61 @@
       "description": "Workspace context snapshot and tool discovery for the embedded AI agent."
     }
   ],
+  "x-tagGroups": [
+    {
+      "name": "Getting Started",
+      "tags": [
+        "Extract"
+      ]
+    },
+    {
+      "name": "Core Resources",
+      "tags": [
+        "Documents",
+        "Extractions",
+        "Schemas",
+        "Jobs"
+      ]
+    },
+    {
+      "name": "Data Pipeline",
+      "tags": [
+        "Sources",
+        "Batches",
+        "Routing",
+        "Delivery",
+        "Filter",
+        "Review"
+      ]
+    },
+    {
+      "name": "Intelligence",
+      "tags": [
+        "Matching",
+        "Cases",
+        "Linking",
+        "Fields",
+        "Reference Data",
+        "Dialects",
+        "Document Types",
+        "Schema Graph",
+        "N-Shot",
+        "Resolutions"
+      ]
+    },
+    {
+      "name": "Platform",
+      "tags": [
+        "Usage",
+        "Credits",
+        "Quality",
+        "Telemetry",
+        "Validation",
+        "Structuring",
+        "Agent"
+      ]
+    }
+  ],
   "paths": {
     "/v1/extract": {
       "post": {
@@ -171,6 +226,7 @@
                   "document_id": {
                     "type": "string",
                     "format": "uuid",
+                    "example": "f0e1d2c3-b4a5-9687-8765-432109876543",
                     "description": "ID of an already-uploaded document to re-extract."
                   },
                   "schema": {
@@ -180,6 +236,7 @@
                   "schema_id": {
                     "type": "string",
                     "format": "uuid",
+                    "example": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
                     "description": "ID of a saved schema to use for extraction."
                   },
                   "instructions": {
@@ -232,6 +289,77 @@
               "application/json": {
                 "schema": {
                   "$ref": "#/components/schemas/ExtractSyncResponse"
+                },
+                "example": {
+                  "extraction_id": "d1a2b3c4-5678-9abc-def0-1234567890ab",
+                  "request_id": "req_x7y8z9a0b1c2d3e4",
+                  "status": "complete",
+                  "document": {
+                    "id": "f0e1d2c3-b4a5-9687-8765-432109876543",
+                    "filename": "invoice-042.pdf",
+                    "pages": 3,
+                    "size_bytes": 245760,
+                    "type_detected": "Invoice",
+                    "language_detected": "en"
+                  },
+                  "data": {
+                    "invoice_number": "INV-2024-0042",
+                    "invoice_date": "2024-03-15",
+                    "vendor_name": "Acme Corp",
+                    "total_amount": 1250,
+                    "currency": "EUR",
+                    "line_items": [
+                      {
+                        "description": "Consulting services",
+                        "quantity": 10,
+                        "unit_price": 100,
+                        "amount": 1000
+                      },
+                      {
+                        "description": "Expenses",
+                        "quantity": 1,
+                        "unit_price": 250,
+                        "amount": 250
+                      }
+                    ]
+                  },
+                  "schema": {
+                    "source": "inferred",
+                    "id": null,
+                    "definition": {
+                      "type": "object",
+                      "properties": {
+                        "invoice_number": {
+                          "type": "string"
+                        },
+                        "total_amount": {
+                          "type": "number"
+                        }
+                      }
+                    },
+                    "save_url": "https://app.talonic.com/schemas/save?from=d1a2b3c4-5678-9abc-def0-1234567890ab"
+                  },
+                  "confidence": {
+                    "overall": 0.94,
+                    "fields": {
+                      "invoice_number": 0.99,
+                      "invoice_date": 0.97,
+                      "vendor_name": 0.88,
+                      "total_amount": 0.98,
+                      "currency": 0.95,
+                      "line_items": 0.85
+                    }
+                  },
+                  "processing": {
+                    "duration_ms": 3420,
+                    "pages_processed": 3,
+                    "region": "eu-west"
+                  },
+                  "links": {
+                    "self": "/v1/extractions/d1a2b3c4-5678-9abc-def0-1234567890ab",
+                    "document": "/v1/documents/f0e1d2c3-b4a5-9687-8765-432109876543",
+                    "dashboard": "https://app.talonic.com/extractions/d1a2b3c4-5678-9abc-def0-1234567890ab"
+                  }
                 }
               }
             }
@@ -317,7 +445,8 @@
             "in": "query",
             "schema": {
               "type": "string",
-              "format": "uuid"
+              "format": "uuid",
+              "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
             },
             "description": "Filter by source connection ID."
           },
@@ -403,6 +532,50 @@
                       }
                     }
                   ]
+                },
+                "example": {
+                  "data": [
+                    {
+                      "id": "f0e1d2c3-b4a5-9687-8765-432109876543",
+                      "filename": "contract-2024.pdf",
+                      "pages": 12,
+                      "size_bytes": 1048576,
+                      "mime_type": "application/pdf",
+                      "type_detected": "Service Contract",
+                      "language_detected": "en",
+                      "status": "completed",
+                      "source": {
+                        "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
+                        "type": "api"
+                      },
+                      "triage": {
+                        "sensitivity": "confidential",
+                        "department": "Legal",
+                        "jurisdiction": "EU",
+                        "pii_detected": true,
+                        "pii_categories": [
+                          "name",
+                          "address"
+                        ],
+                        "regulated_data": false,
+                        "confidentiality_marking": "internal"
+                      },
+                      "extraction_count": 1,
+                      "latest_extraction_id": "d1a2b3c4-5678-9abc-def0-1234567890ab",
+                      "created_at": "2026-04-25T14:30:00.000Z",
+                      "links": {
+                        "self": "/v1/documents/f0e1d2c3-b4a5-9687-8765-432109876543",
+                        "extractions": "/v1/documents/f0e1d2c3-b4a5-9687-8765-432109876543/extractions",
+                        "dashboard": "https://app.talonic.com/documents/f0e1d2c3-b4a5-9687-8765-432109876543"
+                      }
+                    }
+                  ],
+                  "pagination": {
+                    "total": 142,
+                    "limit": 20,
+                    "has_more": true,
+                    "next_cursor": "ZDFhMmIzYzR8MjAyNi0wNC0yNVQxNDozMDowMC4wMDBa"
+                  }
                 }
               }
             }
@@ -576,16 +749,19 @@
                   "properties": {
                     "id": {
                       "type": "string",
-                      "format": "uuid"
+                      "format": "uuid",
+                      "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                     },
                     "status": {
                       "type": "string",
+                      "example": "completed",
                       "enum": [
                         "processing"
                       ]
                     },
                     "message": {
-                      "type": "string"
+                      "type": "string",
+                      "example": "Re-extraction started."
                     },
                     "links": {
                       "type": "object",
@@ -646,10 +822,12 @@
                     "document_id": {
                       "type": "string",
                       "format": "uuid",
+                      "example": "f0e1d2c3-b4a5-9687-8765-432109876543",
                       "description": "ID of the document the markdown was produced from."
                     },
                     "markdown": {
                       "type": "string",
+                      "example": "# Invoice INV-2024-0042\nVendor: Acme Corp...",
                       "description": "Full OCR-converted markdown body."
                     }
                   }
@@ -691,7 +869,8 @@
             "in": "query",
             "schema": {
               "type": "string",
-              "format": "uuid"
+              "format": "uuid",
+              "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
             },
             "description": "Filter by document ID."
           },
@@ -845,8 +1024,15 @@
                   "description": "Key-value pairs of extracted field names and values.",
                   "example": {
                     "invoice_number": "INV-2024-0042",
+                    "invoice_date": "2024-03-15",
+                    "vendor_name": "Acme Corp",
+                    "vendor_address": "123 Main St, Berlin, DE",
                     "total_amount": 1250,
-                    "vendor_name": "Acme Corp"
+                    "currency": "EUR",
+                    "tax_rate": 19,
+                    "tax_amount": 199.58,
+                    "payment_terms": "Net 30",
+                    "due_date": "2024-04-14"
                   }
                 }
               },
@@ -921,6 +1107,45 @@
               "application/json": {
                 "schema": {
                   "$ref": "#/components/schemas/ExtractionResponse"
+                },
+                "example": {
+                  "id": "d1a2b3c4-5678-9abc-def0-1234567890ab",
+                  "status": "complete",
+                  "document": {
+                    "id": "f0e1d2c3-b4a5-9687-8765-432109876543",
+                    "filename": "invoice-042.pdf",
+                    "pages": 3,
+                    "type_detected": "Invoice"
+                  },
+                  "data": {
+                    "vendor_name": "Acme Corporation Ltd.",
+                    "total_amount": 1275.5,
+                    "invoice_number": "INV-2024-0042"
+                  },
+                  "confidence": {
+                    "overall": 0.96,
+                    "fields": {
+                      "vendor_name": 1,
+                      "total_amount": 1,
+                      "invoice_number": 0.99
+                    }
+                  },
+                  "locked_fields": [
+                    "vendor_name",
+                    "total_amount"
+                  ],
+                  "processing": {
+                    "duration_ms": 3420,
+                    "pages_processed": 3,
+                    "region": "eu-west"
+                  },
+                  "created_at": "2026-04-25T14:30:00.000Z",
+                  "links": {
+                    "self": "/v1/extractions/d1a2b3c4-5678-9abc-def0-1234567890ab",
+                    "data": "/v1/extractions/d1a2b3c4-5678-9abc-def0-1234567890ab/data",
+                    "document": "/v1/documents/f0e1d2c3-b4a5-9687-8765-432109876543",
+                    "dashboard": "https://app.talonic.com/extractions/d1a2b3c4-5678-9abc-def0-1234567890ab"
+                  }
                 }
               }
             }
@@ -1024,6 +1249,36 @@
             "application/json": {
               "schema": {
                 "$ref": "#/components/schemas/SchemaCreateRequest"
+              },
+              "example": {
+                "name": "Invoice Schema",
+                "description": "Standard invoice fields for AP processing.",
+                "definition": {
+                  "properties": {
+                    "invoice_number": {
+                      "type": "string",
+                      "title": "Invoice Number",
+                      "description": "Unique identifier on the invoice."
+                    },
+                    "vendor_name": {
+                      "type": "string",
+                      "title": "Vendor Name"
+                    },
+                    "total_amount": {
+                      "type": "number",
+                      "title": "Total Amount",
+                      "description": "Total invoice amount including tax."
+                    },
+                    "invoice_date": {
+                      "type": "string",
+                      "title": "Invoice Date"
+                    }
+                  },
+                  "required": [
+                    "invoice_number",
+                    "total_amount"
+                  ]
+                }
               }
             }
           }
@@ -1035,6 +1290,47 @@
               "application/json": {
                 "schema": {
                   "$ref": "#/components/schemas/SchemaResponse"
+                },
+                "example": {
+                  "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
+                  "name": "Invoice Schema",
+                  "description": "Standard invoice fields for AP processing.",
+                  "definition": {
+                    "type": "object",
+                    "properties": {
+                      "invoice_number": {
+                        "type": "string",
+                        "title": "Invoice Number",
+                        "description": "Unique identifier on the invoice."
+                      },
+                      "vendor_name": {
+                        "type": "string",
+                        "title": "Vendor Name"
+                      },
+                      "total_amount": {
+                        "type": "number",
+                        "title": "Total Amount",
+                        "description": "Total invoice amount including tax."
+                      },
+                      "invoice_date": {
+                        "type": "string",
+                        "title": "Invoice Date"
+                      }
+                    },
+                    "required": [
+                      "invoice_number",
+                      "total_amount"
+                    ]
+                  },
+                  "field_count": 4,
+                  "version": 1,
+                  "created_at": "2026-04-25T14:30:00.000Z",
+                  "updated_at": "2026-04-25T14:30:00.000Z",
+                  "links": {
+                    "self": "/v1/schemas/b2c3d4e5-f6a7-8901-bcde-f12345678901",
+                    "extractions": "/v1/extractions?schema_id=b2c3d4e5-f6a7-8901-bcde-f12345678901",
+                    "dashboard": "https://app.talonic.com/schemas/b2c3d4e5-f6a7-8901-bcde-f12345678901"
+                  }
                 }
               }
             }
@@ -1371,6 +1667,34 @@
               "application/json": {
                 "schema": {
                   "$ref": "#/components/schemas/JobResponse"
+                },
+                "example": {
+                  "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
+                  "name": "Q1 Invoice Processing",
+                  "status": "processing",
+                  "progress": 45,
+                  "estimated_seconds_remaining": null,
+                  "schema": {
+                    "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
+                    "name": "Invoice Schema"
+                  },
+                  "document_count": 150,
+                  "completed_documents": 67,
+                  "grid_stats": {
+                    "total_cells": 8850,
+                    "filled": 6200,
+                    "empty": 2650,
+                    "fill_rate": 0.7
+                  },
+                  "current_phase": "phase_2_execute",
+                  "created_at": "2026-04-25T14:30:00.000Z",
+                  "started_at": "2026-04-25T14:30:05.000Z",
+                  "completed_at": null,
+                  "links": {
+                    "self": "/v1/jobs/c3d4e5f6-a7b8-9012-cdef-123456789012",
+                    "cancel": "/v1/jobs/c3d4e5f6-a7b8-9012-cdef-123456789012/cancel",
+                    "dashboard": "https://app.talonic.com/jobs/c3d4e5f6-a7b8-9012-cdef-123456789012"
+                  }
                 }
               }
             }
@@ -1523,6 +1847,10 @@
             "application/json": {
               "schema": {
                 "$ref": "#/components/schemas/SourceCreateRequest"
+              },
+              "example": {
+                "name": "Invoice Pipeline",
+                "default_schema_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901"
               }
             }
           }
@@ -1548,6 +1876,24 @@
                       }
                     }
                   ]
+                },
+                "example": {
+                  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
+                  "name": "Invoice Pipeline",
+                  "type": "api",
+                  "status": "active",
+                  "document_count": 0,
+                  "default_schema": {
+                    "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901"
+                  },
+                  "endpoint": "/v1/sources/a1b2c3d4-e5f6-7890-abcd-ef1234567890/documents",
+                  "api_key": "tlnc_live_src_k8m2n4p6q9r1s3t5",
+                  "created_at": "2026-04-25T14:30:00.000Z",
+                  "links": {
+                    "self": "/v1/sources/a1b2c3d4-e5f6-7890-abcd-ef1234567890",
+                    "documents": "/v1/sources/a1b2c3d4-e5f6-7890-abcd-ef1234567890/documents",
+                    "dashboard": "https://app.talonic.com/sources/a1b2c3d4-e5f6-7890-abcd-ef1234567890"
+                  }
                 }
               }
             }
@@ -1733,6 +2079,17 @@
               "application/json": {
                 "schema": {
                   "$ref": "#/components/schemas/IngestDocumentResponse"
+                },
+                "example": {
+                  "document_id": "f0e1d2c3-b4a5-9687-8765-432109876543",
+                  "filename": "receipt-march.pdf",
+                  "status": "queued",
+                  "processing_mode": "realtime",
+                  "source_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
+                  "links": {
+                    "document": "/v1/documents/f0e1d2c3-b4a5-9687-8765-432109876543",
+                    "source": "/v1/sources/a1b2c3d4-e5f6-7890-abcd-ef1234567890"
+                  }
                 }
               }
             }
@@ -2329,7 +2686,8 @@
             "in": "query",
             "schema": {
               "type": "string",
-              "format": "uuid"
+              "format": "uuid",
+              "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
             },
             "description": "Filter to runs that belong to a specific matching configuration."
           }
@@ -4861,7 +5219,8 @@
             "in": "query",
             "schema": {
               "type": "string",
-              "format": "uuid"
+              "format": "uuid",
+              "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
             },
             "description": "Filter by cluster."
           }
@@ -5007,10 +5366,12 @@
                         "properties": {
                           "id": {
                             "type": "string",
-                            "format": "uuid"
+                            "format": "uuid",
+                            "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                           },
                           "canonical_name": {
-                            "type": "string"
+                            "type": "string",
+                            "example": "invoice_number"
                           },
                           "similarity": {
                             "type": "number",
@@ -5031,6 +5392,7 @@
                     },
                     "message": {
                       "type": "string",
+                      "example": "Re-extraction started.",
                       "description": "Present when the field has no embedding."
                     }
                   }
@@ -5394,6 +5756,7 @@
                   "source_run_id": {
                     "type": "string",
                     "format": "uuid",
+                    "example": "f2a3b4c5-d6e7-8901-fabc-012345678901",
                     "description": "ID of the source run to resolve against."
                   }
                 }
@@ -5648,7 +6011,8 @@
                             "type": "array",
                             "items": {
                               "type": "string",
-                              "format": "uuid"
+                              "format": "uuid",
+                              "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                             }
                           }
                         }
@@ -5824,10 +6188,12 @@
                   "type": "object",
                   "properties": {
                     "status": {
-                      "type": "string"
+                      "type": "string",
+                      "example": "completed"
                     },
                     "message": {
-                      "type": "string"
+                      "type": "string",
+                      "example": "Re-extraction started."
                     }
                   }
                 }
@@ -5860,7 +6226,8 @@
                   "type": "object",
                   "properties": {
                     "status": {
-                      "type": "string"
+                      "type": "string",
+                      "example": "completed"
                     },
                     "processed": {
                       "type": "integer"
@@ -5870,7 +6237,8 @@
                     },
                     "started_at": {
                       "type": "string",
-                      "format": "date-time"
+                      "format": "date-time",
+                      "example": "2026-04-25T14:30:00.000Z"
                     }
                   }
                 }
@@ -5938,7 +6306,8 @@
             "required": true,
             "schema": {
               "type": "string",
-              "format": "uuid"
+              "format": "uuid",
+              "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
             },
             "description": "Job run ID."
           }
@@ -5982,7 +6351,8 @@
             "required": true,
             "schema": {
               "type": "string",
-              "format": "uuid"
+              "format": "uuid",
+              "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
             },
             "description": "Job run ID."
           }
@@ -6034,7 +6404,8 @@
             "required": true,
             "schema": {
               "type": "string",
-              "format": "uuid"
+              "format": "uuid",
+              "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
             },
             "description": "Job run ID."
           },
@@ -6044,7 +6415,8 @@
             "required": true,
             "schema": {
               "type": "string",
-              "format": "uuid"
+              "format": "uuid",
+              "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
             },
             "description": "Document ID to compare."
           },
@@ -6097,7 +6469,8 @@
             "required": true,
             "schema": {
               "type": "string",
-              "format": "uuid"
+              "format": "uuid",
+              "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
             },
             "description": "Job run ID."
           }
@@ -6116,10 +6489,12 @@
                 "properties": {
                   "document_id": {
                     "type": "string",
-                    "format": "uuid"
+                    "format": "uuid",
+                    "example": "f0e1d2c3-b4a5-9687-8765-432109876543"
                   },
                   "field_name": {
-                    "type": "string"
+                    "type": "string",
+                    "example": "invoice_number"
                   },
                   "value": {
                     "description": "The override value to apply."
@@ -6175,7 +6550,8 @@
             "required": true,
             "schema": {
               "type": "string",
-              "format": "uuid"
+              "format": "uuid",
+              "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
             },
             "description": "Job run ID."
           }
@@ -6194,10 +6570,12 @@
                 "properties": {
                   "document_id": {
                     "type": "string",
-                    "format": "uuid"
+                    "format": "uuid",
+                    "example": "f0e1d2c3-b4a5-9687-8765-432109876543"
                   },
                   "field_name": {
-                    "type": "string"
+                    "type": "string",
+                    "example": "invoice_number"
                   },
                   "decision": {
                     "type": "string",
@@ -6348,7 +6726,8 @@
                           },
                           "created_at": {
                             "type": "string",
-                            "format": "date-time"
+                            "format": "date-time",
+                            "example": "2026-04-25T14:30:00.000Z"
                           }
                         }
                       }
@@ -6411,7 +6790,8 @@
                     },
                     "created_at": {
                       "type": "string",
-                      "format": "date-time"
+                      "format": "date-time",
+                      "example": "2026-04-25T14:30:00.000Z"
                     }
                   }
                 }
@@ -6561,11 +6941,13 @@
                         "properties": {
                           "source_class_id": {
                             "type": "string",
-                            "format": "uuid"
+                            "format": "uuid",
+                            "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                           },
                           "target_class_id": {
                             "type": "string",
-                            "format": "uuid"
+                            "format": "uuid",
+                            "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                           },
                           "relationship": {
                             "type": "string"
@@ -6617,7 +6999,8 @@
                           },
                           "class_id": {
                             "type": "string",
-                            "format": "uuid"
+                            "format": "uuid",
+                            "example": "a7b8c9d0-e1f2-3456-abcd-567890123456"
                           },
                           "class_name": {
                             "type": "string"
@@ -7180,7 +7563,8 @@
                 "properties": {
                   "rule_id": {
                     "type": "string",
-                    "format": "uuid"
+                    "format": "uuid",
+                    "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                   }
                 }
               }
@@ -7238,7 +7622,8 @@
                         "properties": {
                           "check_id": {
                             "type": "string",
-                            "format": "uuid"
+                            "format": "uuid",
+                            "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                           },
                           "check_name": {
                             "type": "string"
@@ -7346,10 +7731,12 @@
                   "properties": {
                     "id": {
                       "type": "string",
-                      "format": "uuid"
+                      "format": "uuid",
+                      "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                     },
                     "status": {
-                      "type": "string"
+                      "type": "string",
+                      "example": "completed"
                     }
                   }
                 }
@@ -7390,10 +7777,12 @@
                   "properties": {
                     "id": {
                       "type": "string",
-                      "format": "uuid"
+                      "format": "uuid",
+                      "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                     },
                     "status": {
-                      "type": "string"
+                      "type": "string",
+                      "example": "completed"
                     }
                   }
                 }
@@ -7427,7 +7816,8 @@
             "required": true,
             "schema": {
               "type": "string",
-              "format": "uuid"
+              "format": "uuid",
+              "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
             },
             "description": "Structuring run ID."
           }
@@ -7821,11 +8211,13 @@
                   "golden_sample_id": {
                     "type": "string",
                     "format": "uuid",
+                    "example": "e5f6a7b8-c9d0-1234-efab-345678901234",
                     "description": "Golden sample dataset to validate against."
                   },
                   "schema_id": {
                     "type": "string",
                     "format": "uuid",
+                    "example": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
                     "description": "Optional schema to scope the validation."
                   }
                 }
@@ -8005,11 +8397,13 @@
                       "format": "float"
                     },
                     "currency": {
-                      "type": "string"
+                      "type": "string",
+                      "example": "USD"
                     },
                     "updated_at": {
                       "type": "string",
-                      "format": "date-time"
+                      "format": "date-time",
+                      "example": "2026-04-25T14:30:00.000Z"
                     }
                   }
                 }
@@ -8064,7 +8458,8 @@
                             "properties": {
                               "id": {
                                 "type": "string",
-                                "format": "uuid"
+                                "format": "uuid",
+                                "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                               },
                               "type": {
                                 "type": "string",
@@ -8082,7 +8477,8 @@
                               },
                               "created_at": {
                                 "type": "string",
-                                "format": "date-time"
+                                "format": "date-time",
+                                "example": "2026-04-25T14:30:00.000Z"
                               }
                             }
                           }
@@ -8302,7 +8698,8 @@
                               },
                               "created_at": {
                                 "type": "string",
-                                "format": "date-time"
+                                "format": "date-time",
+                                "example": "2026-04-25T14:30:00.000Z"
                               }
                             }
                           }
@@ -8353,6 +8750,7 @@
                 "properties": {
                   "status": {
                     "type": "string",
+                    "example": "completed",
                     "description": "New status (e.g. open, in_review, resolved, archived)."
                   }
                 }
@@ -8420,11 +8818,13 @@
                         "properties": {
                           "source_document_id": {
                             "type": "string",
-                            "format": "uuid"
+                            "format": "uuid",
+                            "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                           },
                           "target_document_id": {
                             "type": "string",
-                            "format": "uuid"
+                            "format": "uuid",
+                            "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                           },
                           "entity_value": {
                             "type": "string"
@@ -8478,11 +8878,13 @@
                 "properties": {
                   "source_document_id": {
                     "type": "string",
-                    "format": "uuid"
+                    "format": "uuid",
+                    "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                   },
                   "target_document_id": {
                     "type": "string",
-                    "format": "uuid"
+                    "format": "uuid",
+                    "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                   },
                   "entity_value": {
                     "type": "string"
@@ -8542,11 +8944,13 @@
                 "properties": {
                   "source_document_id": {
                     "type": "string",
-                    "format": "uuid"
+                    "format": "uuid",
+                    "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                   },
                   "target_document_id": {
                     "type": "string",
-                    "format": "uuid"
+                    "format": "uuid",
+                    "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                   },
                   "entity_value": {
                     "type": "string"
@@ -8617,7 +9021,8 @@
                     "type": "array",
                     "items": {
                       "type": "string",
-                      "format": "uuid"
+                      "format": "uuid",
+                      "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                     },
                     "description": "Document IDs to move to the new case."
                   }
@@ -8823,7 +9228,8 @@
                     "type": "array",
                     "items": {
                       "type": "string",
-                      "format": "uuid"
+                      "format": "uuid",
+                      "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                     }
                   }
                 }
@@ -8890,7 +9296,8 @@
                     "type": "array",
                     "items": {
                       "type": "string",
-                      "format": "uuid"
+                      "format": "uuid",
+                      "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                     }
                   }
                 }
@@ -9020,6 +9427,7 @@
                   "config_id": {
                     "type": "string",
                     "format": "uuid",
+                    "example": "c9d0e1f2-a3b4-5678-cdef-789012345678",
                     "description": "Matching configuration ID."
                   }
                 }
@@ -9074,6 +9482,7 @@
                   "run_id": {
                     "type": "string",
                     "format": "uuid",
+                    "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
                     "description": "Matching run ID to resolve."
                   }
                 }
@@ -9138,7 +9547,8 @@
                         "properties": {
                           "id": {
                             "type": "string",
-                            "format": "uuid"
+                            "format": "uuid",
+                            "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                           },
                           "name": {
                             "type": "string"
@@ -9416,7 +9826,8 @@
                   "type": "object",
                   "properties": {
                     "status": {
-                      "type": "string"
+                      "type": "string",
+                      "example": "completed"
                     },
                     "processed": {
                       "type": "integer"
@@ -9475,7 +9886,8 @@
                       "properties": {
                         "document_id": {
                           "type": "string",
-                          "format": "uuid"
+                          "format": "uuid",
+                          "example": "f0e1d2c3-b4a5-9687-8765-432109876543"
                         },
                         "reference_id": {
                           "type": "string"
@@ -9549,12 +9961,14 @@
                     "type": "array",
                     "items": {
                       "type": "string",
-                      "format": "uuid"
+                      "format": "uuid",
+                      "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                     }
                   },
                   "assignee_id": {
                     "type": "string",
                     "format": "uuid",
+                    "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
                     "description": "User ID of the assignee."
                   }
                 }
@@ -9710,14 +10124,16 @@
                 "properties": {
                   "document_id": {
                     "type": "string",
-                    "format": "uuid"
+                    "format": "uuid",
+                    "example": "f0e1d2c3-b4a5-9687-8765-432109876543"
                   },
                   "expected_data": {
                     "type": "object",
                     "additionalProperties": true
                   },
                   "notes": {
-                    "type": "string"
+                    "type": "string",
+                    "example": "Reviewed and confirmed."
                   }
                 }
               }
@@ -9767,7 +10183,8 @@
             "required": true,
             "schema": {
               "type": "string",
-              "format": "uuid"
+              "format": "uuid",
+              "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
             },
             "description": "Entry ID."
           }
@@ -9784,7 +10201,8 @@
                     "additionalProperties": true
                   },
                   "notes": {
-                    "type": "string"
+                    "type": "string",
+                    "example": "Reviewed and confirmed."
                   }
                 }
               }
@@ -9829,7 +10247,8 @@
             "required": true,
             "schema": {
               "type": "string",
-              "format": "uuid"
+              "format": "uuid",
+              "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
             },
             "description": "Entry ID."
           }
@@ -9919,7 +10338,8 @@
             "required": true,
             "schema": {
               "type": "string",
-              "format": "uuid"
+              "format": "uuid",
+              "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
             },
             "description": "ID of the benchmark run to compare against."
           }
@@ -10172,7 +10592,8 @@
         "required": true,
         "schema": {
           "type": "string",
-          "format": "uuid"
+          "format": "uuid",
+          "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
         },
         "description": "Resource UUID."
       },
@@ -10247,8 +10668,13 @@
               "$ref": "#/components/schemas/ErrorResponse"
             },
             "example": {
-              "error": "validation_error",
-              "message": "name is required."
+              "statusCode": 400,
+              "code": "VALIDATION_ERROR",
+              "error": "Bad Request",
+              "message": "name is required.",
+              "retryable": false,
+              "timestamp": "2026-04-25T14:30:00.000Z",
+              "path": "/v1/schemas"
             }
           }
         }
@@ -10261,8 +10687,13 @@
               "$ref": "#/components/schemas/ErrorResponse"
             },
             "example": {
-              "error": "unauthorized",
-              "message": "Invalid or missing API key."
+              "statusCode": 401,
+              "code": "AUTH_REQUIRED",
+              "error": "Unauthorized",
+              "message": "Invalid or missing API key.",
+              "retryable": false,
+              "timestamp": "2026-04-25T14:30:00.000Z",
+              "path": "/v1/extract"
             }
           }
         }
@@ -10275,8 +10706,13 @@
               "$ref": "#/components/schemas/ErrorResponse"
             },
             "example": {
-              "error": "insufficient_scope",
-              "message": "This key does not have the 'write' scope."
+              "statusCode": 403,
+              "code": "INSUFFICIENT_PERMISSIONS",
+              "error": "Forbidden",
+              "message": "This key does not have the 'write' scope.",
+              "retryable": false,
+              "timestamp": "2026-04-25T14:30:00.000Z",
+              "path": "/v1/schemas"
             }
           }
         }
@@ -10289,8 +10725,13 @@
               "$ref": "#/components/schemas/ErrorResponse"
             },
             "example": {
-              "error": "not_found",
-              "message": "Document 'abc-123' not found."
+              "statusCode": 404,
+              "code": "RESOURCE_NOT_FOUND",
+              "error": "Not Found",
+              "message": "Document 'f0e1d2c3-b4a5-9687-8765-432109876543' not found.",
+              "retryable": false,
+              "timestamp": "2026-04-25T14:30:00.000Z",
+              "path": "/v1/documents/f0e1d2c3-b4a5-9687-8765-432109876543"
             }
           }
         }
@@ -10303,8 +10744,13 @@
               "$ref": "#/components/schemas/ErrorResponse"
             },
             "example": {
-              "error": "conflict",
-              "message": "Job is already completed. Cannot cancel."
+              "statusCode": 409,
+              "code": "VALIDATION_ERROR",
+              "error": "Conflict",
+              "message": "Job is already completed. Cannot cancel.",
+              "retryable": false,
+              "timestamp": "2026-04-25T14:30:00.000Z",
+              "path": "/v1/jobs/c3d4e5f6-a7b8-9012-cdef-123456789012/cancel"
             }
           }
         }
@@ -10317,8 +10763,13 @@
               "$ref": "#/components/schemas/ErrorResponse"
             },
             "example": {
-              "error": "payload_too_large",
-              "message": "File exceeds the 500 MB limit."
+              "statusCode": 413,
+              "code": "FILE_TOO_LARGE",
+              "error": "Payload Too Large",
+              "message": "File exceeds the 500 MB limit.",
+              "retryable": false,
+              "timestamp": "2026-04-25T14:30:00.000Z",
+              "path": "/v1/extract"
             }
           }
         }
@@ -10331,9 +10782,13 @@
               "$ref": "#/components/schemas/ErrorResponse"
             },
             "example": {
-              "error": "extraction_failed",
+              "statusCode": 422,
+              "code": "EXTRACTION_FAILED",
+              "error": "Unprocessable Entity",
               "message": "Unable to extract fields from the provided document.",
-              "request_id": "req_abc123",
+              "retryable": false,
+              "timestamp": "2026-04-25T14:30:00.000Z",
+              "path": "/v1/extract",
               "links": {
                 "dashboard": "https://app.talonic.com/documents/abc-123"
               }
@@ -10360,11 +10815,13 @@
               "$ref": "#/components/schemas/ErrorResponse"
             },
             "example": {
-              "error": "rate_limit_exceeded",
+              "statusCode": 429,
+              "code": "QUOTA_EXCEEDED",
+              "error": "Too Many Requests",
               "message": "Daily extract request limit (50) reached. Resets at midnight UTC.",
-              "limit": 50,
-              "used": 50,
-              "reset_at": "2026-04-05T00:00:00.000Z"
+              "retryable": true,
+              "timestamp": "2026-04-25T23:45:00.000Z",
+              "path": "/v1/extract"
             }
           }
         }
@@ -10377,9 +10834,13 @@
               "$ref": "#/components/schemas/ErrorResponse"
             },
             "example": {
-              "error": "internal_error",
+              "statusCode": 500,
+              "code": "INTERNAL_ERROR",
+              "error": "Internal Server Error",
               "message": "An unexpected error occurred. Please try again or contact support.",
-              "request_id": "req_xyz789"
+              "retryable": true,
+              "timestamp": "2026-04-25T14:30:00.000Z",
+              "path": "/v1/extract"
             }
           }
         }
@@ -10389,28 +10850,50 @@
       "ErrorResponse": {
         "type": "object",
         "required": [
+          "statusCode",
+          "code",
           "error",
-          "message"
+          "message",
+          "retryable",
+          "timestamp",
+          "path"
         ],
         "properties": {
+          "statusCode": {
+            "type": "integer",
+            "description": "HTTP status code.",
+            "example": 400
+          },
+          "code": {
+            "type": "string",
+            "description": "Machine-readable error discriminant. One of: VALIDATION_ERROR,\nAUTH_REQUIRED, TOKEN_EXPIRED, INSUFFICIENT_PERMISSIONS,\nRESOURCE_NOT_FOUND, QUOTA_EXCEEDED, INSUFFICIENT_CREDITS,\nLLM_RATE_LIMITED, LLM_TIMEOUT, LLM_UNAVAILABLE, OCR_FAILED,\nEXTRACTION_FAILED, EXTRACTION_TIMEOUT, FILE_TOO_LARGE,\nDUPLICATE_RESOURCE, DATASPACE_RUN_FAILED, INTERNAL_ERROR.\n",
+            "example": "VALIDATION_ERROR"
+          },
           "error": {
             "type": "string",
-            "description": "Machine-readable error code."
+            "description": "HTTP status name.",
+            "example": "Bad Request"
           },
           "message": {
             "type": "string",
-            "description": "Human-readable error description."
+            "description": "Human-readable error description.",
+            "example": "name is required."
           },
-          "request_id": {
+          "retryable": {
+            "type": "boolean",
+            "description": "Whether the client should retry the request.",
+            "example": false
+          },
+          "timestamp": {
             "type": "string",
-            "description": "Request ID for support reference."
+            "format": "date-time",
+            "description": "ISO 8601 timestamp when the error occurred.",
+            "example": "2026-04-25T14:30:00.000Z"
           },
-          "links": {
-            "type": "object",
-            "additionalProperties": {
-              "type": "string"
-            },
-            "description": "Related resource links."
+          "path": {
+            "type": "string",
+            "description": "Request path that failed.",
+            "example": "/v1/schemas"
           }
         }
       },
@@ -10470,7 +10953,8 @@
           },
           "id": {
             "type": "string",
-            "format": "uuid"
+            "format": "uuid",
+            "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
           }
         }
       },
@@ -10486,17 +10970,19 @@
         "properties": {
           "extraction_id": {
             "type": "string",
-            "format": "uuid"
+            "format": "uuid",
+            "example": "d1a2b3c4-5678-9abc-def0-1234567890ab"
           },
           "request_id": {
             "type": "string",
-            "format": "uuid"
+            "example": "req_x7y8z9a0b1c2d3e4"
           },
           "status": {
             "type": "string",
             "enum": [
               "complete"
-            ]
+            ],
+            "example": "complete"
           },
           "document": {
             "$ref": "#/components/schemas/ExtractDocumentSummary"
@@ -10523,7 +11009,8 @@
                   "string",
                   "null"
                 ],
-                "format": "uuid"
+                "format": "uuid",
+                "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
               },
               "definition": {
                 "type": "object",
@@ -10608,10 +11095,12 @@
         "properties": {
           "request_id": {
             "type": "string",
-            "format": "uuid"
+            "format": "uuid",
+            "example": "req_x7y8z9a0b1c2d3e4"
           },
           "status": {
             "type": "string",
+            "example": "completed",
             "enum": [
               "processing"
             ]
@@ -10626,10 +11115,12 @@
             "properties": {
               "id": {
                 "type": "string",
-                "format": "uuid"
+                "format": "uuid",
+                "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
               },
               "status": {
                 "type": "string",
+                "example": "completed",
                 "enum": [
                   "queued"
                 ]
@@ -10651,10 +11142,12 @@
             "properties": {
               "id": {
                 "type": "string",
-                "format": "uuid"
+                "format": "uuid",
+                "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
               },
               "filename": {
-                "type": "string"
+                "type": "string",
+                "example": "invoice-042.pdf"
               },
               "pages": {
                 "type": "integer"
@@ -10677,7 +11170,8 @@
         "properties": {
           "id": {
             "type": "string",
-            "format": "uuid"
+            "format": "uuid",
+            "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
           },
           "filename": {
             "type": "string",
@@ -10719,7 +11213,8 @@
         "properties": {
           "id": {
             "type": "string",
-            "format": "uuid"
+            "format": "uuid",
+            "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
           },
           "filename": {
             "type": "string",
@@ -10753,6 +11248,7 @@
           },
           "status": {
             "type": "string",
+            "example": "completed",
             "enum": [
               "pending",
               "processing",
@@ -10768,7 +11264,8 @@
                   "string",
                   "null"
                 ],
-                "format": "uuid"
+                "format": "uuid",
+                "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
               },
               "type": {
                 "type": "string",
@@ -10785,11 +11282,13 @@
               "string",
               "null"
             ],
-            "format": "uuid"
+            "format": "uuid",
+            "example": "d1a2b3c4-5678-9abc-def0-1234567890ab"
           },
           "created_at": {
             "type": "string",
-            "format": "date-time"
+            "format": "date-time",
+            "example": "2026-04-25T14:30:00.000Z"
           },
           "links": {
             "type": "object",
@@ -10813,10 +11312,12 @@
         "properties": {
           "id": {
             "type": "string",
-            "format": "uuid"
+            "format": "uuid",
+            "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
           },
           "status": {
             "type": "string",
+            "example": "completed",
             "enum": [
               "complete",
               "failed",
@@ -10825,10 +11326,12 @@
           },
           "document_id": {
             "type": "string",
-            "format": "uuid"
+            "format": "uuid",
+            "example": "f0e1d2c3-b4a5-9687-8765-432109876543"
           },
           "document_filename": {
-            "type": "string"
+            "type": "string",
+            "example": "invoice-042.pdf"
           },
           "confidence_overall": {
             "type": "number",
@@ -10836,7 +11339,8 @@
           },
           "created_at": {
             "type": "string",
-            "format": "date-time"
+            "format": "date-time",
+            "example": "2026-04-25T14:30:00.000Z"
           },
           "links": {
             "type": "object",
@@ -10863,10 +11367,12 @@
         "properties": {
           "id": {
             "type": "string",
-            "format": "uuid"
+            "format": "uuid",
+            "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
           },
           "status": {
             "type": "string",
+            "example": "completed",
             "enum": [
               "complete",
               "failed",
@@ -10878,10 +11384,12 @@
             "properties": {
               "id": {
                 "type": "string",
-                "format": "uuid"
+                "format": "uuid",
+                "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
               },
               "filename": {
-                "type": "string"
+                "type": "string",
+                "example": "invoice-042.pdf"
               },
               "pages": {
                 "type": "integer"
@@ -10934,13 +11442,15 @@
                 "type": "integer"
               },
               "region": {
-                "type": "string"
+                "type": "string",
+                "example": "eu-west"
               }
             }
           },
           "created_at": {
             "type": "string",
-            "format": "date-time"
+            "format": "date-time",
+            "example": "2026-04-25T14:30:00.000Z"
           },
           "links": {
             "type": "object",
@@ -10972,7 +11482,8 @@
         "properties": {
           "id": {
             "type": "string",
-            "format": "uuid"
+            "format": "uuid",
+            "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
           },
           "name": {
             "type": "string",
@@ -11045,11 +11556,13 @@
           },
           "created_at": {
             "type": "string",
-            "format": "date-time"
+            "format": "date-time",
+            "example": "2026-04-25T14:30:00.000Z"
           },
           "updated_at": {
             "type": "string",
-            "format": "date-time"
+            "format": "date-time",
+            "example": "2026-04-25T14:30:00.000Z"
           },
           "links": {
             "type": "object",
@@ -11126,13 +11639,16 @@
               ],
               "properties": {
                 "field_name": {
-                  "type": "string"
+                  "type": "string",
+                  "example": "invoice_number"
                 },
                 "display_name": {
-                  "type": "string"
+                  "type": "string",
+                  "example": "Invoice Number"
                 },
                 "data_type": {
-                  "type": "string"
+                  "type": "string",
+                  "example": "string"
                 },
                 "description": {
                   "type": "string"
@@ -11196,13 +11712,16 @@
               ],
               "properties": {
                 "field_name": {
-                  "type": "string"
+                  "type": "string",
+                  "example": "invoice_number"
                 },
                 "display_name": {
-                  "type": "string"
+                  "type": "string",
+                  "example": "Invoice Number"
                 },
                 "data_type": {
-                  "type": "string"
+                  "type": "string",
+                  "example": "string"
                 },
                 "description": {
                   "type": "string"
@@ -11224,7 +11743,8 @@
         "properties": {
           "id": {
             "type": "string",
-            "format": "uuid"
+            "format": "uuid",
+            "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
           },
           "name": {
             "type": [
@@ -11235,6 +11755,7 @@
           },
           "status": {
             "type": "string",
+            "example": "completed",
             "enum": [
               "pending",
               "queued",
@@ -11265,7 +11786,8 @@
             "properties": {
               "id": {
                 "type": "string",
-                "format": "uuid"
+                "format": "uuid",
+                "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
               },
               "name": {
                 "type": "string"
@@ -11336,27 +11858,31 @@
                 "type": "string"
               },
               "message": {
-                "type": "string"
+                "type": "string",
+                "example": "Re-extraction started."
               }
             }
           },
           "created_at": {
             "type": "string",
-            "format": "date-time"
+            "format": "date-time",
+            "example": "2026-04-25T14:30:00.000Z"
           },
           "started_at": {
             "type": [
               "string",
               "null"
             ],
-            "format": "date-time"
+            "format": "date-time",
+            "example": "2026-04-25T14:30:00.000Z"
           },
           "completed_at": {
             "type": [
               "string",
               "null"
             ],
-            "format": "date-time"
+            "format": "date-time",
+            "example": "2026-04-25T14:30:00.000Z"
           },
           "links": {
             "type": "object",
@@ -11387,7 +11913,8 @@
         "properties": {
           "id": {
             "type": "string",
-            "format": "uuid"
+            "format": "uuid",
+            "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
           },
           "name": {
             "type": "string",
@@ -11399,12 +11926,12 @@
           },
           "status": {
             "type": "string",
+            "example": "completed",
             "enum": [
               "active",
               "syncing",
               "error"
-            ],
-            "example": "active"
+            ]
           },
           "document_count": {
             "type": "integer",
@@ -11418,7 +11945,8 @@
             "properties": {
               "id": {
                 "type": "string",
-                "format": "uuid"
+                "format": "uuid",
+                "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
               }
             }
           },
@@ -11429,7 +11957,8 @@
           },
           "created_at": {
             "type": "string",
-            "format": "date-time"
+            "format": "date-time",
+            "example": "2026-04-25T14:30:00.000Z"
           },
           "links": {
             "type": "object",
@@ -11462,6 +11991,7 @@
           "default_schema_id": {
             "type": "string",
             "format": "uuid",
+            "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
             "description": "Optional schema ID to apply by default to documents in this source."
           }
         }
@@ -11478,6 +12008,7 @@
               "null"
             ],
             "format": "uuid",
+            "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
             "description": "Set to null to remove the default schema."
           }
         }
@@ -11488,13 +12019,16 @@
           "document_id": {
             "type": "string",
             "format": "uuid",
+            "example": "f0e1d2c3-b4a5-9687-8765-432109876543",
             "description": "ID of the created document (absent if duplicate)."
           },
           "filename": {
-            "type": "string"
+            "type": "string",
+            "example": "invoice-042.pdf"
           },
           "status": {
             "type": "string",
+            "example": "completed",
             "enum": [
               "queued",
               "duplicate"
@@ -11503,10 +12037,12 @@
           },
           "source_id": {
             "type": "string",
-            "format": "uuid"
+            "format": "uuid",
+            "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
           },
           "message": {
             "type": "string",
+            "example": "Re-extraction started.",
             "description": "Present when status is `duplicate`."
           },
           "existing_document_id": {
@@ -11515,6 +12051,7 @@
               "null"
             ],
             "format": "uuid",
+            "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
             "description": "Present when status is `duplicate`."
           },
           "links": {
@@ -11535,13 +12072,16 @@
         "properties": {
           "id": {
             "type": "string",
-            "format": "uuid"
+            "format": "uuid",
+            "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
           },
           "filename": {
-            "type": "string"
+            "type": "string",
+            "example": "invoice-042.pdf"
           },
           "status": {
             "type": "string",
+            "example": "completed",
             "enum": [
               "pending",
               "processing",
@@ -11560,7 +12100,8 @@
           },
           "created_at": {
             "type": "string",
-            "format": "date-time"
+            "format": "date-time",
+            "example": "2026-04-25T14:30:00.000Z"
           },
           "links": {
             "type": "object",
@@ -11581,15 +12122,16 @@
           "schema_id": {
             "type": "string",
             "format": "uuid",
-            "description": "User schema UUID to run this job against.",
-            "example": "ae4b0e25-12c4-4db0-9d21-f2d6c9c2d4c1"
+            "example": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
+            "description": "User schema UUID to run this job against."
           },
           "document_ids": {
             "type": "array",
             "description": "Optional list of document UUIDs to process. If omitted or empty, all\ncompleted documents for the authenticated customer are used.\n",
             "items": {
               "type": "string",
-              "format": "uuid"
+              "format": "uuid",
+              "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
             }
           },
           "name": {
@@ -11614,10 +12156,12 @@
           "id": {
             "type": "string",
             "format": "uuid",
+            "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
             "description": "The newly created job's UUID."
           },
           "status": {
             "type": "string",
+            "example": "completed",
             "enum": [
               "pending"
             ],
@@ -11653,7 +12197,8 @@
         "properties": {
           "job_id": {
             "type": "string",
-            "format": "uuid"
+            "format": "uuid",
+            "example": "c3d4e5f6-a7b8-9012-cdef-123456789012"
           },
           "job_status": {
             "type": "string",
@@ -11674,7 +12219,8 @@
             "properties": {
               "id": {
                 "type": "string",
-                "format": "uuid"
+                "format": "uuid",
+                "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
               },
               "name": {
                 "type": "string"
@@ -11695,17 +12241,21 @@
                 "id": {
                   "type": "string",
                   "format": "uuid",
+                  "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
                   "description": "The result row's UUID."
                 },
                 "document_id": {
                   "type": "string",
-                  "format": "uuid"
+                  "format": "uuid",
+                  "example": "f0e1d2c3-b4a5-9687-8765-432109876543"
                 },
                 "filename": {
-                  "type": "string"
+                  "type": "string",
+                  "example": "invoice-042.pdf"
                 },
                 "status": {
                   "type": "string",
+                  "example": "completed",
                   "description": "Per-row status (e.g. `complete`, `partial`, `failed`)."
                 },
                 "values": {
@@ -11754,7 +12304,8 @@
         "properties": {
           "id": {
             "type": "string",
-            "format": "uuid"
+            "format": "uuid",
+            "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
           },
           "name": {
             "type": "string",
@@ -11770,14 +12321,16 @@
           },
           "created_at": {
             "type": "string",
-            "format": "date-time"
+            "format": "date-time",
+            "example": "2026-04-25T14:30:00.000Z"
           },
           "updated_at": {
             "type": [
               "string",
               "null"
             ],
-            "format": "date-time"
+            "format": "date-time",
+            "example": "2026-04-25T14:30:00.000Z"
           },
           "links": {
             "type": "object",
@@ -11928,14 +12481,14 @@
           },
           "match_type": {
             "type": "string",
+            "example": "exact",
             "enum": [
               "exact",
               "fuzzy",
               "date_range",
               "numeric_range"
             ],
-            "description": "Matching strategy applied to this pair.",
-            "example": "fuzzy"
+            "description": "Matching strategy applied to this pair."
           },
           "weight": {
             "type": "number",
@@ -11958,7 +12511,8 @@
         "properties": {
           "id": {
             "type": "string",
-            "format": "uuid"
+            "format": "uuid",
+            "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
           },
           "name": {
             "type": "string",
@@ -11966,7 +12520,8 @@
           },
           "reference_data_id": {
             "type": "string",
-            "format": "uuid"
+            "format": "uuid",
+            "example": "b8c9d0e1-f2a3-4567-bcde-678901234567"
           },
           "target_type": {
             "type": "string",
@@ -11998,14 +12553,16 @@
           },
           "created_at": {
             "type": "string",
-            "format": "date-time"
+            "format": "date-time",
+            "example": "2026-04-25T14:30:00.000Z"
           },
           "updated_at": {
             "type": [
               "string",
               "null"
             ],
-            "format": "date-time"
+            "format": "date-time",
+            "example": "2026-04-25T14:30:00.000Z"
           },
           "links": {
             "type": "object",
@@ -12035,6 +12592,7 @@
           "reference_data_id": {
             "type": "string",
             "format": "uuid",
+            "example": "b8c9d0e1-f2a3-4567-bcde-678901234567",
             "description": "UUID of the reference dataset to match against."
           },
           "field_mappings": {
@@ -12112,14 +12670,17 @@
         "properties": {
           "id": {
             "type": "string",
-            "format": "uuid"
+            "format": "uuid",
+            "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
           },
           "matching_config_id": {
             "type": "string",
-            "format": "uuid"
+            "format": "uuid",
+            "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
           },
           "status": {
             "type": "string",
+            "example": "completed",
             "enum": [
               "queued",
               "running",
@@ -12156,14 +12717,16 @@
               "string",
               "null"
             ],
-            "format": "date-time"
+            "format": "date-time",
+            "example": "2026-04-25T14:30:00.000Z"
           },
           "completed_at": {
             "type": [
               "string",
               "null"
             ],
-            "format": "date-time"
+            "format": "date-time",
+            "example": "2026-04-25T14:30:00.000Z"
           },
           "error": {
             "type": [
@@ -12173,7 +12736,8 @@
           },
           "created_at": {
             "type": "string",
-            "format": "date-time"
+            "format": "date-time",
+            "example": "2026-04-25T14:30:00.000Z"
           },
           "links": {
             "type": "object",
@@ -12212,11 +12776,13 @@
         "properties": {
           "id": {
             "type": "string",
-            "format": "uuid"
+            "format": "uuid",
+            "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
           },
           "document_id": {
             "type": "string",
-            "format": "uuid"
+            "format": "uuid",
+            "example": "f0e1d2c3-b4a5-9687-8765-432109876543"
           },
           "document_filename": {
             "type": [
@@ -12229,7 +12795,8 @@
               "string",
               "null"
             ],
-            "format": "uuid"
+            "format": "uuid",
+            "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
           },
           "confidence": {
             "type": "number",
@@ -12239,6 +12806,7 @@
           },
           "status": {
             "type": "string",
+            "example": "completed",
             "description": "Per-result status (e.g. `auto_accepted`, `needs_review`, `no_match`)."
           },
           "evidence": {
@@ -12261,15 +12829,16 @@
         "properties": {
           "id": {
             "type": "string",
-            "format": "uuid"
+            "format": "uuid",
+            "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
           },
           "name": {
             "type": "string"
           },
           "trigger_type": {
             "type": "string",
-            "description": "Trigger kind. Always `document_classified` for rules created via this API.",
-            "example": "document_classified"
+            "example": "document_classified",
+            "description": "Trigger kind. Always `document_classified` for rules created via this API."
           },
           "conditions": {
             "type": "object",
@@ -12278,8 +12847,8 @@
           },
           "action_type": {
             "type": "string",
-            "description": "Resolved action kind. Defaults to `route_to_schema` when not specified on the request body.",
-            "example": "route_to_schema"
+            "example": "route_to_schema",
+            "description": "Resolved action kind. Defaults to `route_to_schema` when not specified on the request body."
           },
           "actions": {
             "type": "object",
@@ -12305,18 +12874,21 @@
               "string",
               "null"
             ],
-            "format": "uuid"
+            "format": "uuid",
+            "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
           },
           "created_at": {
             "type": "string",
-            "format": "date-time"
+            "format": "date-time",
+            "example": "2026-04-25T14:30:00.000Z"
           },
           "updated_at": {
             "type": [
               "string",
               "null"
             ],
-            "format": "date-time"
+            "format": "date-time",
+            "example": "2026-04-25T14:30:00.000Z"
           },
           "links": {
             "type": "object",
@@ -12403,11 +12975,13 @@
         "properties": {
           "id": {
             "type": "string",
-            "format": "uuid"
+            "format": "uuid",
+            "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
           },
           "customer_id": {
             "type": "string",
-            "format": "uuid"
+            "format": "uuid",
+            "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
           },
           "name": {
             "type": "string",
@@ -12446,7 +13020,8 @@
               "string",
               "null"
             ],
-            "format": "date-time"
+            "format": "date-time",
+            "example": "2026-04-25T14:30:00.000Z"
           },
           "last_delivery_status": {
             "type": [
@@ -12456,11 +13031,13 @@
           },
           "created_at": {
             "type": "string",
-            "format": "date-time"
+            "format": "date-time",
+            "example": "2026-04-25T14:30:00.000Z"
           },
           "updated_at": {
             "type": "string",
-            "format": "date-time"
+            "format": "date-time",
+            "example": "2026-04-25T14:30:00.000Z"
           }
         }
       },
@@ -12687,11 +13264,13 @@
         "properties": {
           "id": {
             "type": "string",
-            "format": "uuid"
+            "format": "uuid",
+            "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
           },
           "customer_id": {
             "type": "string",
-            "format": "uuid"
+            "format": "uuid",
+            "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
           },
           "name": {
             "type": "string"
@@ -12705,7 +13284,8 @@
           },
           "destination_id": {
             "type": "string",
-            "format": "uuid"
+            "format": "uuid",
+            "example": "e1f2a3b4-c5d6-7890-efab-901234567890"
           },
           "field_map": {
             "$ref": "#/components/schemas/FieldMap"
@@ -12732,11 +13312,13 @@
           },
           "created_at": {
             "type": "string",
-            "format": "date-time"
+            "format": "date-time",
+            "example": "2026-04-25T14:30:00.000Z"
           },
           "updated_at": {
             "type": "string",
-            "format": "date-time"
+            "format": "date-time",
+            "example": "2026-04-25T14:30:00.000Z"
           }
         }
       },
@@ -12761,7 +13343,8 @@
           },
           "destination_id": {
             "type": "string",
-            "format": "uuid"
+            "format": "uuid",
+            "example": "e1f2a3b4-c5d6-7890-efab-901234567890"
           },
           "field_map": {
             "$ref": "#/components/schemas/FieldMap"
@@ -12796,7 +13379,8 @@
           },
           "destination_id": {
             "type": "string",
-            "format": "uuid"
+            "format": "uuid",
+            "example": "e1f2a3b4-c5d6-7890-efab-901234567890"
           },
           "field_map": {
             "$ref": "#/components/schemas/FieldMap"
@@ -12832,15 +13416,18 @@
         "properties": {
           "id": {
             "type": "string",
-            "format": "uuid"
+            "format": "uuid",
+            "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
           },
           "customer_id": {
             "type": "string",
-            "format": "uuid"
+            "format": "uuid",
+            "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
           },
           "binding_id": {
             "type": "string",
-            "format": "uuid"
+            "format": "uuid",
+            "example": "d0e1f2a3-b4c5-6789-defa-890123456789"
           },
           "event_id": {
             "type": "string",
@@ -12852,6 +13439,7 @@
           },
           "status": {
             "type": "string",
+            "example": "completed",
             "enum": [
               "in_flight",
               "succeeded",
@@ -12903,11 +13491,13 @@
               "string",
               "null"
             ],
-            "format": "date-time"
+            "format": "date-time",
+            "example": "2026-04-25T14:30:00.000Z"
           },
           "created_at": {
             "type": "string",
-            "format": "date-time"
+            "format": "date-time",
+            "example": "2026-04-25T14:30:00.000Z"
           }
         }
       },
@@ -12926,15 +13516,18 @@
         "properties": {
           "id": {
             "type": "string",
-            "format": "uuid"
+            "format": "uuid",
+            "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
           },
           "customer_id": {
             "type": "string",
-            "format": "uuid"
+            "format": "uuid",
+            "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
           },
           "binding_id": {
             "type": "string",
-            "format": "uuid"
+            "format": "uuid",
+            "example": "d0e1f2a3-b4c5-6789-defa-890123456789"
           },
           "event_id": {
             "type": "string",
@@ -12946,10 +13539,12 @@
               "null"
             ],
             "format": "uuid",
+            "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
             "description": "FK to the last DeliveryItem attempt (nullable — `ON DELETE SET NULL`)."
           },
           "error_code": {
-            "type": "string"
+            "type": "string",
+            "example": "delivery_timeout"
           },
           "error_message": {
             "type": [
@@ -12962,7 +13557,8 @@
           },
           "created_at": {
             "type": "string",
-            "format": "date-time"
+            "format": "date-time",
+            "example": "2026-04-25T14:30:00.000Z"
           }
         }
       },
@@ -12984,7 +13580,8 @@
           },
           "customer_id": {
             "type": "string",
-            "format": "uuid"
+            "format": "uuid",
+            "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
           },
           "event_type": {
             "type": "string"
@@ -13002,14 +13599,16 @@
           },
           "created_at": {
             "type": "string",
-            "format": "date-time"
+            "format": "date-time",
+            "example": "2026-04-25T14:30:00.000Z"
           },
           "processed_at": {
             "type": [
               "string",
               "null"
             ],
-            "format": "date-time"
+            "format": "date-time",
+            "example": "2026-04-25T14:30:00.000Z"
           },
           "processing_attempts": {
             "type": "integer"
@@ -13046,6 +13645,7 @@
           },
           "label": {
             "type": "string",
+            "example": "Customer Onboarding",
             "description": "Short human-readable label, e.g. \"Document markdown content\". Falls back to `type` if unknown."
           },
           "description": {
@@ -13852,6 +14452,7 @@
           "source_id": {
             "type": "string",
             "format": "uuid",
+            "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
             "description": "Optional source connection UUID to narrow the result set."
           },
           "conditions": {
@@ -13960,31 +14561,36 @@
         "properties": {
           "id": {
             "type": "string",
-            "format": "uuid"
+            "format": "uuid",
+            "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
           },
           "run_id": {
             "type": [
               "string",
               "null"
             ],
-            "format": "uuid"
+            "format": "uuid",
+            "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
           },
           "document_id": {
             "type": [
               "string",
               "null"
             ],
-            "format": "uuid"
+            "format": "uuid",
+            "example": "f0e1d2c3-b4a5-9687-8765-432109876543"
           },
           "schema_id": {
             "type": [
               "string",
               "null"
             ],
-            "format": "uuid"
+            "format": "uuid",
+            "example": "b2c3d4e5-f6a7-8901-bcde-f12345678901"
           },
           "status": {
             "type": "string",
+            "example": "completed",
             "description": "Review status (e.g. `pending`, `approved`, `rejected`)."
           },
           "overall_confidence": {
@@ -14013,11 +14619,13 @@
               "string",
               "null"
             ],
-            "format": "date-time"
+            "format": "date-time",
+            "example": "2026-04-25T14:30:00.000Z"
           },
           "created_at": {
             "type": "string",
-            "format": "date-time"
+            "format": "date-time",
+            "example": "2026-04-25T14:30:00.000Z"
           },
           "links": {
             "type": "object",
@@ -14095,7 +14703,8 @@
             "description": "Non-empty list of validation-record UUIDs.",
             "items": {
               "type": "string",
-              "format": "uuid"
+              "format": "uuid",
+              "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
             }
           },
           "action": {
@@ -14135,10 +14744,12 @@
               "properties": {
                 "id": {
                   "type": "string",
-                  "format": "uuid"
+                  "format": "uuid",
+                  "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                 },
                 "status": {
                   "type": "string",
+                  "example": "completed",
                   "description": "Per-record outcome (`approved`, `rejected`, or `error`)."
                 },
                 "error": {
@@ -14159,7 +14770,8 @@
         "properties": {
           "id": {
             "type": "string",
-            "format": "uuid"
+            "format": "uuid",
+            "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
           },
           "name": {
             "type": "string"
@@ -14175,7 +14787,8 @@
               "string",
               "null"
             ],
-            "format": "uuid"
+            "format": "uuid",
+            "example": "b2c3d4e5-f6a7-8901-bcde-f12345678901"
           },
           "document_count": {
             "type": [
@@ -14185,7 +14798,8 @@
           },
           "created_at": {
             "type": "string",
-            "format": "date-time"
+            "format": "date-time",
+            "example": "2026-04-25T14:30:00.000Z"
           },
           "links": {
             "type": "object",
@@ -14236,14 +14850,16 @@
         "properties": {
           "id": {
             "type": "string",
-            "format": "uuid"
+            "format": "uuid",
+            "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
           },
           "document_id": {
             "type": [
               "string",
               "null"
             ],
-            "format": "uuid"
+            "format": "uuid",
+            "example": "f0e1d2c3-b4a5-9687-8765-432109876543"
           },
           "expected_data": {
             "type": "object",
@@ -14258,7 +14874,8 @@
           },
           "created_at": {
             "type": "string",
-            "format": "date-time"
+            "format": "date-time",
+            "example": "2026-04-25T14:30:00.000Z"
           }
         }
       },
@@ -14271,7 +14888,8 @@
         "properties": {
           "id": {
             "type": "string",
-            "format": "uuid"
+            "format": "uuid",
+            "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
           },
           "name": {
             "type": [
@@ -14284,17 +14902,20 @@
               "string",
               "null"
             ],
-            "format": "uuid"
+            "format": "uuid",
+            "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
           },
           "user_schema_id": {
             "type": [
               "string",
               "null"
             ],
-            "format": "uuid"
+            "format": "uuid",
+            "example": "b2c3d4e5-f6a7-8901-bcde-f12345678901"
           },
           "status": {
             "type": "string",
+            "example": "completed",
             "description": "Benchmark run status."
           },
           "accuracy_overall": {
@@ -14347,18 +14968,21 @@
               "string",
               "null"
             ],
-            "format": "uuid"
+            "format": "uuid",
+            "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
           },
           "created_at": {
             "type": "string",
-            "format": "date-time"
+            "format": "date-time",
+            "example": "2026-04-25T14:30:00.000Z"
           },
           "completed_at": {
             "type": [
               "string",
               "null"
             ],
-            "format": "date-time"
+            "format": "date-time",
+            "example": "2026-04-25T14:30:00.000Z"
           },
           "links": {
             "type": "object",
@@ -14396,21 +15020,24 @@
         "properties": {
           "id": {
             "type": "string",
-            "format": "uuid"
+            "format": "uuid",
+            "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
           },
           "document_id": {
             "type": [
               "string",
               "null"
             ],
-            "format": "uuid"
+            "format": "uuid",
+            "example": "f0e1d2c3-b4a5-9687-8765-432109876543"
           },
           "ground_truth_entry_id": {
             "type": [
               "string",
               "null"
             ],
-            "format": "uuid"
+            "format": "uuid",
+            "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
           },
           "accuracy": {
             "type": [
@@ -14428,7 +15055,8 @@
           },
           "created_at": {
             "type": "string",
-            "format": "date-time"
+            "format": "date-time",
+            "example": "2026-04-25T14:30:00.000Z"
           }
         }
       },
@@ -14448,10 +15076,12 @@
         "properties": {
           "id": {
             "type": "string",
-            "format": "uuid"
+            "format": "uuid",
+            "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
           },
           "status": {
             "type": "string",
+            "example": "completed",
             "enum": [
               "accumulating",
               "submitted",
@@ -14463,6 +15093,7 @@
           },
           "provider": {
             "type": "string",
+            "example": "anthropic",
             "enum": [
               "anthropic",
               "bedrock"
@@ -14485,14 +15116,16 @@
               "string",
               "null"
             ],
-            "format": "date-time"
+            "format": "date-time",
+            "example": "2026-04-25T14:30:00.000Z"
           },
           "completed_at": {
             "type": [
               "string",
               "null"
             ],
-            "format": "date-time"
+            "format": "date-time",
+            "example": "2026-04-25T14:30:00.000Z"
           },
           "error_message": {
             "type": [
@@ -14502,11 +15135,13 @@
           },
           "created_at": {
             "type": "string",
-            "format": "date-time"
+            "format": "date-time",
+            "example": "2026-04-25T14:30:00.000Z"
           },
           "updated_at": {
             "type": "string",
-            "format": "date-time"
+            "format": "date-time",
+            "example": "2026-04-25T14:30:00.000Z"
           },
           "links": {
             "type": "object",
@@ -14539,11 +15174,13 @@
                   "properties": {
                     "id": {
                       "type": "string",
-                      "format": "uuid"
+                      "format": "uuid",
+                      "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                     },
                     "document_id": {
                       "type": "string",
-                      "format": "uuid"
+                      "format": "uuid",
+                      "example": "f0e1d2c3-b4a5-9687-8765-432109876543"
                     },
                     "document_filename": {
                       "type": [
@@ -14558,7 +15195,8 @@
                       ]
                     },
                     "status": {
-                      "type": "string"
+                      "type": "string",
+                      "example": "completed"
                     },
                     "error_message": {
                       "type": [
@@ -14568,14 +15206,16 @@
                     },
                     "created_at": {
                       "type": "string",
-                      "format": "date-time"
+                      "format": "date-time",
+                      "example": "2026-04-25T14:30:00.000Z"
                     },
                     "processed_at": {
                       "type": [
                         "string",
                         "null"
                       ],
-                      "format": "date-time"
+                      "format": "date-time",
+                      "example": "2026-04-25T14:30:00.000Z"
                     }
                   }
                 }
@@ -14600,6 +15240,7 @@
           },
           "case_key": {
             "type": "string",
+            "example": "7a3f2b1c",
             "pattern": "^[a-fA-F0-9]{8,64}$"
           },
           "label": {
@@ -14616,7 +15257,8 @@
               "string",
               "null"
             ],
-            "format": "date-time"
+            "format": "date-time",
+            "example": "2026-04-25T14:30:00.000Z"
           },
           "links": {
             "type": "object",
@@ -14642,7 +15284,8 @@
             "type": "string"
           },
           "case_key": {
-            "type": "string"
+            "type": "string",
+            "example": "7a3f2b1c"
           },
           "label": {
             "type": [
@@ -14663,10 +15306,12 @@
               "properties": {
                 "id": {
                   "type": "string",
-                  "format": "uuid"
+                  "format": "uuid",
+                  "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                 },
                 "filename": {
-                  "type": "string"
+                  "type": "string",
+                  "example": "invoice-042.pdf"
                 },
                 "document_type": {
                   "type": [
@@ -14679,7 +15324,8 @@
                     "string",
                     "null"
                   ],
-                  "format": "date-time"
+                  "format": "date-time",
+                  "example": "2026-04-25T14:30:00.000Z"
                 }
               }
             }
@@ -14692,7 +15338,8 @@
               "string",
               "null"
             ],
-            "format": "date-time"
+            "format": "date-time",
+            "example": "2026-04-25T14:30:00.000Z"
           },
           "links": {
             "type": "object",
@@ -14718,7 +15365,8 @@
         "properties": {
           "id": {
             "type": "string",
-            "format": "uuid"
+            "format": "uuid",
+            "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
           },
           "name": {
             "type": "string"
@@ -14762,10 +15410,12 @@
         "properties": {
           "id": {
             "type": "string",
-            "format": "uuid"
+            "format": "uuid",
+            "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
           },
           "canonical_name": {
-            "type": "string"
+            "type": "string",
+            "example": "invoice_number"
           },
           "display_name": {
             "type": [
@@ -14774,7 +15424,8 @@
             ]
           },
           "data_type": {
-            "type": "string"
+            "type": "string",
+            "example": "string"
           },
           "tier": {
             "type": "integer"
@@ -14796,11 +15447,13 @@
           },
           "created_at": {
             "type": "string",
-            "format": "date-time"
+            "format": "date-time",
+            "example": "2026-04-25T14:30:00.000Z"
           },
           "updated_at": {
             "type": "string",
-            "format": "date-time"
+            "format": "date-time",
+            "example": "2026-04-25T14:30:00.000Z"
           },
           "links": {
             "type": "object",
@@ -14831,11 +15484,13 @@
                   "properties": {
                     "id": {
                       "type": "string",
-                      "format": "uuid"
+                      "format": "uuid",
+                      "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                     },
                     "document_id": {
                       "type": "string",
-                      "format": "uuid"
+                      "format": "uuid",
+                      "example": "f0e1d2c3-b4a5-9687-8765-432109876543"
                     },
                     "document_filename": {
                       "type": [
@@ -14854,7 +15509,8 @@
                     },
                     "created_at": {
                       "type": "string",
-                      "format": "date-time"
+                      "format": "date-time",
+                      "example": "2026-04-25T14:30:00.000Z"
                     }
                   }
                 }
@@ -14878,10 +15534,12 @@
         "properties": {
           "id": {
             "type": "string",
-            "format": "uuid"
+            "format": "uuid",
+            "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
           },
           "canonical_name": {
-            "type": "string"
+            "type": "string",
+            "example": "invoice_number"
           },
           "display_name": {
             "type": [
@@ -14890,7 +15548,8 @@
             ]
           },
           "data_type": {
-            "type": "string"
+            "type": "string",
+            "example": "string"
           },
           "tier": {
             "type": "integer"
@@ -14937,7 +15596,8 @@
         "properties": {
           "id": {
             "type": "string",
-            "format": "uuid"
+            "format": "uuid",
+            "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
           },
           "name": {
             "type": "string"
@@ -14954,7 +15614,8 @@
           },
           "created_at": {
             "type": "string",
-            "format": "date-time"
+            "format": "date-time",
+            "example": "2026-04-25T14:30:00.000Z"
           },
           "links": {
             "type": "object",
@@ -14987,11 +15648,13 @@
             "properties": {
               "from": {
                 "type": "string",
-                "format": "date-time"
+                "format": "date-time",
+                "example": "2026-04-25T14:30:00.000Z"
               },
               "to": {
                 "type": "string",
-                "format": "date-time"
+                "format": "date-time",
+                "example": "2026-04-25T14:30:00.000Z"
               }
             }
           },
@@ -15065,7 +15728,8 @@
         "properties": {
           "document_id": {
             "type": "string",
-            "format": "uuid"
+            "format": "uuid",
+            "example": "f0e1d2c3-b4a5-9687-8765-432109876543"
           },
           "totals": {
             "type": "object",
@@ -15131,7 +15795,8 @@
                 },
                 "created_at": {
                   "type": "string",
-                  "format": "date-time"
+                  "format": "date-time",
+                  "example": "2026-04-25T14:30:00.000Z"
                 }
               }
             }
@@ -15160,14 +15825,17 @@
         "properties": {
           "id": {
             "type": "string",
-            "format": "uuid"
+            "format": "uuid",
+            "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
           },
           "source_run_id": {
             "type": "string",
-            "format": "uuid"
+            "format": "uuid",
+            "example": "f2a3b4c5-d6e7-8901-fabc-012345678901"
           },
           "status": {
             "type": "string",
+            "example": "completed",
             "enum": [
               "pending",
               "running",
@@ -15183,14 +15851,16 @@
           },
           "created_at": {
             "type": "string",
-            "format": "date-time"
+            "format": "date-time",
+            "example": "2026-04-25T14:30:00.000Z"
           },
           "completed_at": {
             "type": [
               "string",
               "null"
             ],
-            "format": "date-time"
+            "format": "date-time",
+            "example": "2026-04-25T14:30:00.000Z"
           },
           "links": {
             "type": "object",
@@ -15213,10 +15883,12 @@
         ],
         "properties": {
           "field_name": {
-            "type": "string"
+            "type": "string",
+            "example": "invoice_number"
           },
           "category": {
             "type": "string",
+            "example": "identity",
             "enum": [
               "identity",
               "transaction",
@@ -15248,7 +15920,8 @@
         "properties": {
           "id": {
             "type": "string",
-            "format": "uuid"
+            "format": "uuid",
+            "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
           },
           "name": {
             "type": "string"
@@ -15267,11 +15940,13 @@
           },
           "created_at": {
             "type": "string",
-            "format": "date-time"
+            "format": "date-time",
+            "example": "2026-04-25T14:30:00.000Z"
           },
           "updated_at": {
             "type": "string",
-            "format": "date-time"
+            "format": "date-time",
+            "example": "2026-04-25T14:30:00.000Z"
           },
           "links": {
             "type": "object",
@@ -15297,11 +15972,13 @@
         "properties": {
           "id": {
             "type": "string",
-            "format": "uuid"
+            "format": "uuid",
+            "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
           },
           "class_id": {
             "type": "string",
-            "format": "uuid"
+            "format": "uuid",
+            "example": "a7b8c9d0-e1f2-3456-abcd-567890123456"
           },
           "from_version": {
             "type": [
@@ -15317,6 +15994,7 @@
           },
           "status": {
             "type": "string",
+            "example": "completed",
             "enum": [
               "pending",
               "approved",
@@ -15333,14 +16011,16 @@
           },
           "created_at": {
             "type": "string",
-            "format": "date-time"
+            "format": "date-time",
+            "example": "2026-04-25T14:30:00.000Z"
           },
           "decided_at": {
             "type": [
               "string",
               "null"
             ],
-            "format": "date-time"
+            "format": "date-time",
+            "example": "2026-04-25T14:30:00.000Z"
           }
         }
       },
@@ -15355,7 +16035,8 @@
         "properties": {
           "id": {
             "type": "string",
-            "format": "uuid"
+            "format": "uuid",
+            "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
           },
           "name": {
             "type": "string"
@@ -15379,11 +16060,13 @@
           },
           "created_at": {
             "type": "string",
-            "format": "date-time"
+            "format": "date-time",
+            "example": "2026-04-25T14:30:00.000Z"
           },
           "updated_at": {
             "type": "string",
-            "format": "date-time"
+            "format": "date-time",
+            "example": "2026-04-25T14:30:00.000Z"
           }
         }
       },
@@ -15425,7 +16108,8 @@
         "properties": {
           "id": {
             "type": "string",
-            "format": "uuid"
+            "format": "uuid",
+            "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
           },
           "name": {
             "type": "string"
@@ -15441,7 +16125,8 @@
               "string",
               "null"
             ],
-            "format": "uuid"
+            "format": "uuid",
+            "example": "b2c3d4e5-f6a7-8901-bcde-f12345678901"
           },
           "rules": {
             "type": "array",
@@ -15450,7 +16135,8 @@
               "properties": {
                 "id": {
                   "type": "string",
-                  "format": "uuid"
+                  "format": "uuid",
+                  "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                 },
                 "type": {
                   "type": "string"
@@ -15464,11 +16150,13 @@
           },
           "created_at": {
             "type": "string",
-            "format": "date-time"
+            "format": "date-time",
+            "example": "2026-04-25T14:30:00.000Z"
           },
           "updated_at": {
             "type": "string",
-            "format": "date-time"
+            "format": "date-time",
+            "example": "2026-04-25T14:30:00.000Z"
           }
         }
       },
@@ -15486,7 +16174,8 @@
           },
           "schema_id": {
             "type": "string",
-            "format": "uuid"
+            "format": "uuid",
+            "example": "b2c3d4e5-f6a7-8901-bcde-f12345678901"
           }
         }
       },
@@ -15500,7 +16189,8 @@
         "properties": {
           "id": {
             "type": "string",
-            "format": "uuid"
+            "format": "uuid",
+            "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
           },
           "name": {
             "type": "string"
@@ -15519,7 +16209,8 @@
           },
           "created_at": {
             "type": "string",
-            "format": "date-time"
+            "format": "date-time",
+            "example": "2026-04-25T14:30:00.000Z"
           },
           "links": {
             "type": "object",
@@ -15541,21 +16232,25 @@
         "properties": {
           "id": {
             "type": "string",
-            "format": "uuid"
+            "format": "uuid",
+            "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
           },
           "golden_sample_id": {
             "type": "string",
-            "format": "uuid"
+            "format": "uuid",
+            "example": "e5f6a7b8-c9d0-1234-efab-345678901234"
           },
           "schema_id": {
             "type": [
               "string",
               "null"
             ],
-            "format": "uuid"
+            "format": "uuid",
+            "example": "b2c3d4e5-f6a7-8901-bcde-f12345678901"
           },
           "status": {
             "type": "string",
+            "example": "completed",
             "enum": [
               "pending",
               "running",
@@ -15578,14 +16273,16 @@
           },
           "created_at": {
             "type": "string",
-            "format": "date-time"
+            "format": "date-time",
+            "example": "2026-04-25T14:30:00.000Z"
           },
           "completed_at": {
             "type": [
               "string",
               "null"
             ],
-            "format": "date-time"
+            "format": "date-time",
+            "example": "2026-04-25T14:30:00.000Z"
           },
           "links": {
             "type": "object",