Retrieve immutable source chunks from active corpus generations
POST /v1/retrieval/search
POST
/v1/retrieval/search
Authorizations
Section titled “Authorizations ”Request Body required
Section titled “Request Body required ”object
query
required
string
document_types
Array<string>
limit
integer
mode
string
allow_lexical_fallback
Permit an explicitly degraded lexical result when query embedding fails.
boolean
Responses
Section titled “ Responses ”Ranked chunks with immutable citation coordinates and explicit degradation status
object
hits
required
Array<object>
object
chunk_id
required
string
document_id
required
string
canonical_key
required
string
document_type
required
string
source_version_id
required
string
source_sha256
required
string
source_uri
required
string
generation_id
required
string
chunk_number
required
integer
content
required
string
score
required
Reciprocal-rank score; not a probability or calibrated relevance score.
number format: double
engine
required
string
degraded
required
boolean
degradation_reason
string
result_sha256
required
Fingerprint of returned citation coordinates and content, not a persisted search snapshot.
string
Invalid request
object
type
required
string format: uri
Example
https://kesita.ai/problems/bad-request title
required
string
status
required
integer
detail
string
instance
string
request_id
string
Missing or invalid API key
object
type
required
string format: uri
Example
https://kesita.ai/problems/bad-request title
required
string
status
required
integer
detail
string
instance
string
request_id
string
Dependency unavailable
object
type
required
string format: uri
Example
https://kesita.ai/problems/bad-request title
required
string
status
required
integer
detail
string
instance
string
request_id
string