v3
latestOpenAPI 3.1.02026-08-08123192255.1 KBexternal-v2-deals
Insert Deal Index Facts
Insert one or many metric values into a deal index.
This is the default write path for user-supplied metric values on entities that already exist on the deal, even when the client is replacing an existing value. The insert flow creates or reuses a user-input observation and promotes it as the current SOT when supported by lev-ai-backend.
Prefer entity_ref from GET /index/entities to target an existing entity. This endpoint does not create entities: to add a new property, call POST /deals (properties) or PATCH /deals/<id> (add_properties) — an address is the minimum required field — then insert metric values against the resulting entity_ref.
post/api/external/v2/deals/{deal_id}/index/facts
Path parameters
deal_idinteger required
Request body
Response
Successful Response