external-v2-deals

Search Deal Index

Changed on

Search canonical indexed deal facts, or look them up by prefixed sot id.

Context search embeds the query. When sot_ids is set the lookup is exact: embeddings are skipped and min_score is forced to 0, matching GraphQL searchSotByEmbeddings(dealId, sotIds, minScore: 0).

post/api/external/v2/deals/{deal_id}/index/search

Request

  • Base URL
    https://api.lev.com (the document declares no server; this is the origin it was published from)
  • URL
    https://api.lev.com/api/external/v2/deals/{deal_id}/index/search
  • Auth
    none declared

Path parameters

deal_idinteger required

Request body

contextstring nullable

Natural-language deal-data search context. Required when sot_ids is omitted.

sot_idsstring[] nullable

Prefixed SOT ids for an exact lookup (e.g. 'd:123', 'a:17544:property:2561'). When set, embeddings are skipped.

min_scorenumber

Minimum cosine similarity threshold (0-1). Ignored when sot_ids is set.

limitinteger

Maximum ranked facts to return (1-200, clamped).

include_signed_urlsboolean

When true, include time-limited signed URLs for document-backed source attachments.

Response

Successful Response

request_idstring required
timestampstring required
paginationunknown required

Changes

  • 4cfc778338ceRevision changes
    • info

      added the optional property // to the response with the status

  • 04c60da269dcRevision changes
    • info

      added the new optional request property

    • info

      the request property became optional

    • info

      request property list-of-types was widened by adding types null to media type application/json

    • info

      the request property's minLength was decreased from 1 to 0