retrieve

Look up cited passages

Ranked passage retrieval over public datasets. No auth required; send a ksk_live_ bearer key to also search private datasets you own. Rate limit: 30 requests per minute per IP.

post/api/v1/retrieve

Request

  • Base URL: https://koskamo.com
  • URL: https://koskamo.com/api/v1/retrieve
  • Auth: one of:
    • none
    • HTTP bearer

Request body

querystring required

The question or search string

datasetstring

Optional dataset id or slug; defaults to all public datasets

top_kinteger

Response

Candidate passages; inspect assessment and guidance before answering

querystring required
assessment'candidates' | 'no_matches' required

Candidate availability only; does not assess whether the question is answered

guidancestring required

Evidence checking and abstention instructions for the consuming agent

Changes

No recorded changes to this operation across all 1 revision of this API.