@model-match/api 3.46.0 → 3.47.0

package/openapi.json

@@ -18908,6 +18908,97 @@
         ],
         "type": "object"
       },
+      "CrmImportCheck": {
+        "properties": {
+          "data": {
+            "properties": {
+              "failed": {
+                "type": "number"
+              },
+              "fileRows": {
+                "nullable": true,
+                "type": "number"
+              },
+              "imported": {
+                "type": "number"
+              },
+              "inCrm": {
+                "type": "number"
+              },
+              "lists": {
+                "items": {
+                  "properties": {
+                    "deleted": {
+                      "type": "boolean"
+                    },
+                    "imported": {
+                      "type": "number"
+                    },
+                    "inList": {
+                      "type": "number"
+                    },
+                    "listId": {
+                      "type": "string"
+                    },
+                    "name": {
+                      "type": "string"
+                    },
+                    "rows": {
+                      "type": "number"
+                    }
+                  },
+                  "required": [
+                    "listId",
+                    "name",
+                    "deleted",
+                    "rows",
+                    "imported",
+                    "inList"
+                  ],
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "notes": {
+                "properties": {
+                  "inFile": {
+                    "type": "number"
+                  },
+                  "onFailedRows": {
+                    "type": "number"
+                  },
+                  "present": {
+                    "type": "number"
+                  }
+                },
+                "required": [
+                  "inFile",
+                  "onFailedRows",
+                  "present"
+                ],
+                "type": "object"
+              },
+              "rows": {
+                "type": "number"
+              }
+            },
+            "required": [
+              "fileRows",
+              "rows",
+              "imported",
+              "failed",
+              "inCrm",
+              "lists",
+              "notes"
+            ],
+            "type": "object"
+          }
+        },
+        "required": [
+          "data"
+        ],
+        "type": "object"
+      },
       "CrmImportErrorCode": {
         "description": "Failure reason on a failed row; drives friendly client copy. Absent on success.",
         "enum": [
@@ -18916,6 +19007,7 @@
           "WRONG_OBJECT_TYPE",
           "NO_ACCESS",
           "UNKNOWN_FIELD",
+          "EXTERNAL_ID_CONFLICT",
           "INVALID",
           "INTERNAL"
         ],
@@ -19043,6 +19135,11 @@
             "description": "Set to update an existing record; omit to create one.",
             "type": "string"
           },
+          "externalId": {
+            "description": "The record's id in the source system (unique per org + batch externalSource). A known id updates that record; an unknown one is stamped on the created record, so re-running an import never duplicates. A record holds at most one id — a different one fails the row with EXTERNAL_ID_CONFLICT.",
+            "maxLength": 256,
+            "type": "string"
+          },
           "facebook": {
             "type": "string"
           },
@@ -19062,6 +19159,21 @@
           "linkedin": {
             "type": "string"
           },
+          "listStatus": {
+            "description": "Status (id or label) within the row's first list; becomes the record's status. Fails the row when it isn't one of that list's.",
+            "maxLength": 120,
+            "type": "string"
+          },
+          "lists": {
+            "description": "Lists this row's record joins, by name (case/space-insensitive), among the list owner's lists — the batch ownerUserId, else the caller. A name with no match fails the row unless the batch sets createMissingLists.",
+            "items": {
+              "maxLength": 200,
+              "minLength": 1,
+              "type": "string"
+            },
+            "maxItems": 20,
+            "type": "array"
+          },
           "location": {
             "type": "string"
           },
@@ -19094,6 +19206,17 @@
           "realtor": {
             "type": "string"
           },
+          "rejectReason": {
+            "description": "The client already failed this row (e.g. an undialable phone): it is logged as failed with this reason and never written.",
+            "maxLength": 500,
+            "minLength": 1,
+            "type": "string"
+          },
+          "sourceLine": {
+            "description": "The row's line in the source file; kept in import history so the download points back at the file.",
+            "minimum": 1,
+            "type": "integer"
+          },
           "state": {
             "type": "string"
           },
@@ -19103,6 +19226,34 @@
           "subtitle": {
             "type": "string"
           },
+          "timelineNotes": {
+            "description": "Dated note history (e.g. a legacy notes export), appended as plain notes authored by the record's owner. Keyed: a note the record already has (deleted ones included) is skipped, so re-runs never double it. Distinct from `note`, which is append-only.",
+            "items": {
+              "properties": {
+                "body": {
+                  "maxLength": 10000,
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "key": {
+                  "description": "Stable id from the source system; absent ⇒ a hash of date + text.",
+                  "maxLength": 256,
+                  "type": "string"
+                },
+                "occurredAt": {
+                  "description": "ISO date-time the note was written (the timeline backdates to it); an unreadable date fails the row.",
+                  "maxLength": 64,
+                  "type": "string"
+                }
+              },
+              "required": [
+                "body"
+              ],
+              "type": "object"
+            },
+            "maxItems": 200,
+            "type": "array"
+          },
           "title": {
             "description": "Role title override for people rows (the record's Title field, column and filter) — distinct from `subtitle`, the display line under the name. Trimmed; blank reads as absent. Overwrites on update rows. Ignored on companies imports.",
             "type": "string"
@@ -19154,17 +19305,410 @@
         ],
         "type": "object"
       },
+      "CrmImportRows": {
+        "properties": {
+          "data": {
+            "properties": {
+              "next": {
+                "nullable": true,
+                "type": "number"
+              },
+              "rows": {
+                "items": {
+                  "properties": {
+                    "code": {
+                      "nullable": true,
+                      "type": "string"
+                    },
+                    "email": {
+                      "nullable": true,
+                      "type": "string"
+                    },
+                    "entityId": {
+                      "nullable": true,
+                      "type": "string"
+                    },
+                    "error": {
+                      "nullable": true,
+                      "type": "string"
+                    },
+                    "externalId": {
+                      "nullable": true,
+                      "type": "string"
+                    },
+                    "inCrm": {
+                      "type": "boolean"
+                    },
+                    "inListIds": {
+                      "items": {
+                        "type": "string"
+                      },
+                      "type": "array"
+                    },
+                    "listIds": {
+                      "items": {
+                        "type": "string"
+                      },
+                      "type": "array"
+                    },
+                    "name": {
+                      "nullable": true,
+                      "type": "string"
+                    },
+                    "notesInFile": {
+                      "type": "number"
+                    },
+                    "notesPresent": {
+                      "type": "number"
+                    },
+                    "outcome": {
+                      "enum": [
+                        "created",
+                        "updated",
+                        "failed"
+                      ],
+                      "type": "string"
+                    },
+                    "phone": {
+                      "nullable": true,
+                      "type": "string"
+                    },
+                    "seq": {
+                      "type": "number"
+                    },
+                    "sourceLine": {
+                      "nullable": true,
+                      "type": "number"
+                    }
+                  },
+                  "required": [
+                    "seq",
+                    "outcome",
+                    "entityId",
+                    "name",
+                    "externalId",
+                    "email",
+                    "phone",
+                    "code",
+                    "error",
+                    "sourceLine",
+                    "listIds",
+                    "inListIds",
+                    "inCrm",
+                    "notesInFile",
+                    "notesPresent"
+                  ],
+                  "type": "object"
+                },
+                "type": "array"
+              }
+            },
+            "required": [
+              "rows",
+              "next"
+            ],
+            "type": "object"
+          }
+        },
+        "required": [
+          "data"
+        ],
+        "type": "object"
+      },
+      "CrmImportRun": {
+        "properties": {
+          "data": {
+            "properties": {
+              "canUndo": {
+                "type": "boolean"
+              },
+              "completedAt": {
+                "nullable": true,
+                "type": "string"
+              },
+              "created": {
+                "type": "number"
+              },
+              "createdAt": {
+                "type": "string"
+              },
+              "createdByUserId": {
+                "type": "string"
+              },
+              "externalSource": {
+                "nullable": true,
+                "type": "string"
+              },
+              "failed": {
+                "type": "number"
+              },
+              "fileName": {
+                "nullable": true,
+                "type": "string"
+              },
+              "fileRows": {
+                "nullable": true,
+                "type": "number"
+              },
+              "id": {
+                "type": "string"
+              },
+              "lastUndoAt": {
+                "nullable": true,
+                "type": "string"
+              },
+              "lists": {
+                "items": {
+                  "properties": {
+                    "created": {
+                      "type": "boolean"
+                    },
+                    "deleted": {
+                      "type": "boolean"
+                    },
+                    "listId": {
+                      "type": "string"
+                    },
+                    "name": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "listId",
+                    "name",
+                    "created",
+                    "deleted"
+                  ],
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "objectType": {
+                "type": "string"
+              },
+              "ownerUserId": {
+                "nullable": true,
+                "type": "string"
+              },
+              "scoped": {
+                "type": "boolean"
+              },
+              "total": {
+                "type": "number"
+              },
+              "undoRemoved": {
+                "nullable": true,
+                "type": "number"
+              },
+              "undoneAt": {
+                "nullable": true,
+                "type": "string"
+              },
+              "undoneByUserId": {
+                "nullable": true,
+                "type": "string"
+              },
+              "updated": {
+                "type": "number"
+              }
+            },
+            "required": [
+              "id",
+              "createdByUserId",
+              "ownerUserId",
+              "objectType",
+              "externalSource",
+              "fileName",
+              "fileRows",
+              "total",
+              "created",
+              "updated",
+              "failed",
+              "lists",
+              "createdAt",
+              "completedAt",
+              "undoneAt",
+              "undoneByUserId",
+              "undoRemoved",
+              "lastUndoAt",
+              "scoped",
+              "canUndo"
+            ],
+            "type": "object"
+          }
+        },
+        "required": [
+          "data"
+        ],
+        "type": "object"
+      },
+      "CrmImportRuns": {
+        "properties": {
+          "data": {
+            "items": {
+              "properties": {
+                "canUndo": {
+                  "type": "boolean"
+                },
+                "completedAt": {
+                  "nullable": true,
+                  "type": "string"
+                },
+                "created": {
+                  "type": "number"
+                },
+                "createdAt": {
+                  "type": "string"
+                },
+                "createdByUserId": {
+                  "type": "string"
+                },
+                "externalSource": {
+                  "nullable": true,
+                  "type": "string"
+                },
+                "failed": {
+                  "type": "number"
+                },
+                "fileName": {
+                  "nullable": true,
+                  "type": "string"
+                },
+                "fileRows": {
+                  "nullable": true,
+                  "type": "number"
+                },
+                "id": {
+                  "type": "string"
+                },
+                "lastUndoAt": {
+                  "nullable": true,
+                  "type": "string"
+                },
+                "lists": {
+                  "items": {
+                    "properties": {
+                      "created": {
+                        "type": "boolean"
+                      },
+                      "deleted": {
+                        "type": "boolean"
+                      },
+                      "listId": {
+                        "type": "string"
+                      },
+                      "name": {
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "listId",
+                      "name",
+                      "created",
+                      "deleted"
+                    ],
+                    "type": "object"
+                  },
+                  "type": "array"
+                },
+                "objectType": {
+                  "type": "string"
+                },
+                "ownerUserId": {
+                  "nullable": true,
+                  "type": "string"
+                },
+                "scoped": {
+                  "type": "boolean"
+                },
+                "total": {
+                  "type": "number"
+                },
+                "undoRemoved": {
+                  "nullable": true,
+                  "type": "number"
+                },
+                "undoneAt": {
+                  "nullable": true,
+                  "type": "string"
+                },
+                "undoneByUserId": {
+                  "nullable": true,
+                  "type": "string"
+                },
+                "updated": {
+                  "type": "number"
+                }
+              },
+              "required": [
+                "id",
+                "createdByUserId",
+                "ownerUserId",
+                "objectType",
+                "externalSource",
+                "fileName",
+                "fileRows",
+                "total",
+                "created",
+                "updated",
+                "failed",
+                "lists",
+                "createdAt",
+                "completedAt",
+                "undoneAt",
+                "undoneByUserId",
+                "undoRemoved",
+                "lastUndoAt",
+                "scoped",
+                "canUndo"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          }
+        },
+        "required": [
+          "data"
+        ],
+        "type": "object"
+      },
       "CrmImportSummary": {
         "properties": {
           "created": {
             "type": "number"
           },
+          "dryRun": {
+            "type": "boolean"
+          },
           "enrichJobId": {
             "type": "string"
           },
           "failed": {
             "type": "number"
           },
+          "lists": {
+            "description": "Lists the rows named (row `lists`), and which this batch created.",
+            "items": {
+              "properties": {
+                "created": {
+                  "type": "boolean"
+                },
+                "listId": {
+                  "type": "string"
+                },
+                "name": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "name",
+                "listId",
+                "created"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
           "results": {
             "items": {
               "$ref": "#/components/schemas/CrmImportRowResult"
@@ -19187,6 +19731,40 @@
         ],
         "type": "object"
       },
+      "CrmImportUndo": {
+        "properties": {
+          "data": {
+            "properties": {
+              "keptChanged": {
+                "type": "number"
+              },
+              "keptNoAccess": {
+                "type": "number"
+              },
+              "listsRemoved": {
+                "items": {
+                  "type": "string"
+                },
+                "type": "array"
+              },
+              "removed": {
+                "type": "number"
+              }
+            },
+            "required": [
+              "removed",
+              "keptChanged",
+              "keptNoAccess",
+              "listsRemoved"
+            ],
+            "type": "object"
+          }
+        },
+        "required": [
+          "data"
+        ],
+        "type": "object"
+      },
       "CrmLenderChannels": {
         "properties": {
           "data": {
@@ -42324,7 +42902,7 @@
   "info": {
     "description": "ModelMatch API — mortgage and real-estate market data.\n\n## Bulk delivery limits\n\nThe `POST /{entity}/bulk-delivery` endpoints export a full result set to\nS3 as NDJSON, JSON, CSV, or Parquet.\n\n- **Up to 5,000 rows per delivery: no entitlement required.** Available to\n  every authenticated caller.\n- **Above 5,000 rows: requires the entity's `bulk-delivery.{entity}`\n  entitlement** (e.g. `bulk-delivery.loans`). The grant's scope sets your\n  row ceiling and may also restrict which rows and fields you receive.\n\nA delivery that would exceed the limit available to you is rejected with\n`403 entitlement_missing`, reporting the matched row count and the ceiling\nthat applied. To stay under the limit, pass `limit` — the job then delivers\n(and bills for) only the first `limit` rows of a broader query.\n\n**Need a higher limit?** Email support@modelmatch.com to request the\nentitlement. Limits are raised per organization and per entity.\n\nBulk delivery is billed at 1 credit per delivered row whether or not\nan entitlement is held.\n\nInstead of a download, a delivery can be sent to a push target configured\non your workspace: pass `destination: { type: \"push-target\", targetId }`.\nThe same limits and billing apply.",
     "title": "ModelMatch API",
-    "version": "3.107.0"
+    "version": "3.108.0"
   },
   "openapi": "3.1.0",
   "paths": {
@@ -56682,6 +57260,14 @@
             "application/json": {
               "schema": {
                 "properties": {
+                  "createMissingLists": {
+                    "description": "Create lists rows name that the list owner doesn't have yet, owned by ownerUserId (else the caller).",
+                    "type": "boolean"
+                  },
+                  "dryRun": {
+                    "description": "Plan only: return what the import WOULD do (per-row created / updated / failed, lists it would find or create) without writing anything. Always synchronous.",
+                    "type": "boolean"
+                  },
                   "entityType": {
                     "allOf": [
                       {
@@ -56692,10 +57278,50 @@
                       }
                     ]
                   },
+                  "externalSource": {
+                    "description": "Source system the rows' externalIds belong to (e.g. \"legacy-mm\"). Defaults to \"import\".",
+                    "pattern": "^[a-z0-9][a-z0-9-]{0,63}$",
+                    "type": "string"
+                  },
+                  "fileName": {
+                    "description": "Source file name, shown in import history.",
+                    "maxLength": 255,
+                    "type": "string"
+                  },
+                  "fileRows": {
+                    "description": "Data rows in the source file (the client's count, including rows it rejected before sending) — the check report's file rows.",
+                    "minimum": 0,
+                    "type": "integer"
+                  },
+                  "importBatchKey": {
+                    "description": "This batch's key within its run (e.g. \"2/5\"). A batch resent under a key the run already recorded is refused (409).",
+                    "maxLength": 40,
+                    "minLength": 1,
+                    "type": "string"
+                  },
+                  "importRunId": {
+                    "description": "Import history run id, minted by the client per run and sent with every batch of it — the batches become one history entry.",
+                    "maxLength": 100,
+                    "minLength": 1,
+                    "type": "string"
+                  },
                   "listId": {
                     "nullable": true,
                     "type": "string"
                   },
+                  "listStatuses": {
+                    "additionalProperties": {
+                      "items": {
+                        "maxLength": 120,
+                        "minLength": 1,
+                        "type": "string"
+                      },
+                      "maxItems": 50,
+                      "type": "array"
+                    },
+                    "description": "Status labels, in order, per list name — the status vocabulary of lists this batch creates (else the default statuses).",
+                    "type": "object"
+                  },
                   "objectType": {
                     "$ref": "#/components/schemas/CrmObjectType"
                   },
@@ -56780,6 +57406,16 @@
             },
             "description": "Not found"
           },
+          "409": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "This batch's `importBatchKey` was already recorded on the run — a resend, refused."
+          },
           "413": {
             "content": {
               "application/json": {
@@ -56910,6 +57546,531 @@
         ]
       }
     },
+    "/v1/crm/imports": {
+      "get": {
+        "operationId": "listCrmImports",
+        "parameters": [
+          {
+            "in": "query",
+            "name": "limit",
+            "required": false,
+            "schema": {
+              "maximum": 500,
+              "minimum": 1,
+              "type": "integer"
+            }
+          },
+          {
+            "description": "Only runs that touched this list (list settings).",
+            "in": "query",
+            "name": "listId",
+            "required": false,
+            "schema": {
+              "description": "Only runs that touched this list (list settings).",
+              "minLength": 1,
+              "type": "string"
+            }
+          },
+          {
+            "description": "Page back: runs created before this (the last run's `createdAt`).",
+            "in": "query",
+            "name": "before",
+            "required": false,
+            "schema": {
+              "description": "Page back: runs created before this (the last run's `createdAt`).",
+              "format": "date-time",
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/CrmImportRuns"
+                }
+              }
+            },
+            "description": "Import runs."
+          },
+          "400": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "Validation error"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "403": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "Forbidden (authenticated, but missing required context — e.g. no active organization)"
+          },
+          "404": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "Not found"
+          },
+          "413": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/PayloadTooLarge"
+                }
+              }
+            },
+            "description": "Response payload too large — detail endpoint capped to fit Lambda response limits"
+          },
+          "503": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/SearchUnavailable"
+                }
+              }
+            },
+            "description": "Search timed out or the cluster is overloaded — retry after `Retry-After` seconds."
+          }
+        },
+        "summary": "List import runs (own + into your lists; all for admins), newest first",
+        "tags": [
+          "CRM"
+        ]
+      }
+    },
+    "/v1/crm/imports/{id}": {
+      "get": {
+        "operationId": "getCrmImport",
+        "parameters": [
+          {
+            "description": "Import run id.",
+            "in": "path",
+            "name": "id",
+            "required": true,
+            "schema": {
+              "description": "Import run id.",
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/CrmImportRun"
+                }
+              }
+            },
+            "description": "The import run."
+          },
+          "400": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "Validation error"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "403": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "Forbidden (authenticated, but missing required context — e.g. no active organization)"
+          },
+          "404": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "Not found"
+          },
+          "413": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/PayloadTooLarge"
+                }
+              }
+            },
+            "description": "Response payload too large — detail endpoint capped to fit Lambda response limits"
+          },
+          "503": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/SearchUnavailable"
+                }
+              }
+            },
+            "description": "Search timed out or the cluster is overloaded — retry after `Retry-After` seconds."
+          }
+        },
+        "summary": "Get one import run",
+        "tags": [
+          "CRM"
+        ]
+      }
+    },
+    "/v1/crm/imports/{id}/check": {
+      "get": {
+        "operationId": "checkCrmImport",
+        "parameters": [
+          {
+            "description": "Import run id.",
+            "in": "path",
+            "name": "id",
+            "required": true,
+            "schema": {
+              "description": "Import run id.",
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/CrmImportCheck"
+                }
+              }
+            },
+            "description": "The run checked against the CRM now."
+          },
+          "400": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "Validation error"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "403": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "Forbidden (authenticated, but missing required context — e.g. no active organization)"
+          },
+          "404": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "Not found"
+          },
+          "413": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/PayloadTooLarge"
+                }
+              }
+            },
+            "description": "Response payload too large — detail endpoint capped to fit Lambda response limits"
+          },
+          "503": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/SearchUnavailable"
+                }
+              }
+            },
+            "description": "Search timed out or the cluster is overloaded — retry after `Retry-After` seconds."
+          }
+        },
+        "summary": "Check report for an import run (rows, records, lists, notes)",
+        "tags": [
+          "CRM"
+        ]
+      }
+    },
+    "/v1/crm/imports/{id}/rows": {
+      "get": {
+        "operationId": "listCrmImportRows",
+        "parameters": [
+          {
+            "description": "Import run id.",
+            "in": "path",
+            "name": "id",
+            "required": true,
+            "schema": {
+              "description": "Import run id.",
+              "type": "string"
+            }
+          },
+          {
+            "description": "Cursor: return rows after this `seq` (from `next`).",
+            "in": "query",
+            "name": "after",
+            "required": false,
+            "schema": {
+              "description": "Cursor: return rows after this `seq` (from `next`).",
+              "minimum": -1,
+              "nullable": true,
+              "type": "integer"
+            }
+          },
+          {
+            "in": "query",
+            "name": "limit",
+            "required": false,
+            "schema": {
+              "maximum": 5000,
+              "minimum": 1,
+              "type": "integer"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/CrmImportRows"
+                }
+              }
+            },
+            "description": "A page of the run's rows."
+          },
+          "400": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "Validation error"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "403": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "Forbidden (authenticated, but missing required context — e.g. no active organization)"
+          },
+          "404": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "Not found"
+          },
+          "413": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/PayloadTooLarge"
+                }
+              }
+            },
+            "description": "Response payload too large — detail endpoint capped to fit Lambda response limits"
+          },
+          "503": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/SearchUnavailable"
+                }
+              }
+            },
+            "description": "Search timed out or the cluster is overloaded — retry after `Retry-After` seconds."
+          }
+        },
+        "summary": "Every row of an import run with its outcome, in file order",
+        "tags": [
+          "CRM"
+        ]
+      }
+    },
+    "/v1/crm/imports/{id}/undo": {
+      "post": {
+        "operationId": "undoCrmImport",
+        "parameters": [
+          {
+            "description": "Import run id.",
+            "in": "path",
+            "name": "id",
+            "required": true,
+            "schema": {
+              "description": "Import run id.",
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "properties": {
+                  "dryRun": {
+                    "description": "Count what would be removed; change nothing.",
+                    "type": "boolean"
+                  }
+                },
+                "type": "object"
+              }
+            }
+          },
+          "required": false
+        },
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/CrmImportUndo"
+                }
+              }
+            },
+            "description": "What was (or, on a dry run, would be) removed and kept."
+          },
+          "400": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "Validation error"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "403": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "Forbidden (authenticated, but missing required context — e.g. no active organization)"
+          },
+          "404": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "Not found"
+          },
+          "413": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/PayloadTooLarge"
+                }
+              }
+            },
+            "description": "Response payload too large — detail endpoint capped to fit Lambda response limits"
+          },
+          "503": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/SearchUnavailable"
+                }
+              }
+            },
+            "description": "Search timed out or the cluster is overloaded — retry after `Retry-After` seconds."
+          }
+        },
+        "summary": "Undo an import run (removes untouched records it created)",
+        "tags": [
+          "CRM"
+        ]
+      }
+    },
     "/v1/crm/lender-channels": {
       "post": {
         "operationId": "crmLenderChannels",