/v1/ingest/rows/{rowId}/filesAdd a file to a deal
Scope rows:write. Answers the file and its upload URL.
Send request
Use the documented inputs to call this endpoint directly.
Parameters
Values are applied to the request and the example on the right.
The deal's row id.
Request body
application/jsonrequiredBlank is application/octet-stream. The upload must send the same type.
More than 0 for a job; 0 or more for a deal's file.
What it is, if known.
Values: "bank_statement" · "tax_return" · "application" · "credit_report" · "voided_check" · "drivers_license" · "id" · "contract" · "agreement" · "offer_letter" · "payoff_letter" · "invoice" · "statement_analysis" · "stip" · "signed_application" · "merchant_questionnaire" · "plaid_report" · "financials" · "profit_and_loss" · "balance_sheet" · "ucc_filing" · "business_license" · "articles_of_incorporation" · "insurance" · "lease" · "ar_report" · "other"
Responses
Declared.
{
"data": {
"id": "",
"name": "string",
"contentType": "string",
"sizeBytes": 1,
"documentType": "string",
"periodStart": "string",
"periodEnd": "string",
"createdAt": "2026-01-01T00:00:00Z",
"source": "string"
},
"uploadUrl": "string"
}A file needs a name and a non-negative sizeBytes.
{
"error": {
"message": "string"
}
}No key, or an unknown or revoked one.
{
"error": {
"message": "string"
}
}A key issued from Settings → Developer, on a workspace without the Enterprise plan.
{
"error": {
"message": "string"
}
}The key was not given rows:write, or is a board key.
{
"error": {
"message": "string"
}
}No job or deal with that id that this key can reach.
{
"error": {
"message": "string"
}
}Over 120 requests a minute; wait Retry-After seconds.
{
"error": {
"message": "string"
}
}File storage is not configured.
{
"error": {
"message": "string"
}
}