/v1/accounting/deal-costs/{id}/paidMark a deal cost paid
Marks a cost paid and stamps the moment. No body. Every net-basis stake on that deal moves with it, because a cost reduces net revenue and the availability view reads costs live. To take a cost out of the books instead of settling it, post_accounting_deal-costs_id_void. Takes the brokerage's books: an owner or admin, or a seat holding an accounting grant (get_accounting_me_access); anyone else is refused with 403.
Access class: workspace:books.
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": {
"amountMinor": 1,
"category": "string",
"createdAt": "2026-01-01T00:00:00Z",
"currency": "string",
"dealId": 1,
"description": "string",
"detail": {},
"id": 1,
"paidAt": "2026-01-01T00:00:00Z",
"status": "string",
"updatedAt": "2026-01-01T00:00:00Z",
"vendor": "string",
"voidReason": "string",
"voidedAt": "2026-01-01T00:00:00Z"
}
}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"
}