/v1/definitions/{key}/rows/{rowId}/ai/researchRun business research on a deal
Opens a business-research file on the company behind the deal and files it as an ordinary business_research credit record, so GET .../credit-records/business_research lists it immediately. The model has no ability to look anything up, so what it writes is a FIRST PASS over the deal's own material with every unsupported field left empty — the row is filed as working, never done, and the notes say what still has to be checked. Spends the workspace's OpenAI budget; refuses with a sentence when there is no key, and answers 409 when the deal names no business.
Access class: def:read.
Send request
Use the documented inputs to call this endpoint directly.
Parameters
Values are applied to the request and the example on the right.
Request body
application/jsonrequiredResponses
the action's answer
{
"data": {
"activeStatus": "string",
"companyPhone": "string",
"companyWebsite": "string",
"courtRecords": "string",
"createdAt": "string",
"dealRowId": "",
"fullAddress": "string",
"generatedBy": "string",
"goodStanding": "string",
"id": 1,
"initialFilingDate": "string",
"legalActions": "string",
"name": "string",
"ownerCourtRecords": "string",
"ownerLegalIssues": "string",
"ownerName": "string",
"researchNotes": "string",
"researchedBy": 1,
"sources": [
"string"
],
"state": "string",
"status": "string",
"updatedAt": "string"
}
}a refusal: {"error": "<what a person needs to read>"}. 401 no credential, 402 the plan does not include this, 403 the seat does not, 404 the thing does not exist or is not yours to see.
{
"error": "string"
}