---
title: "Semantic search"
method: POST
path: "/v1/recall"
tags: ["Kairos passthrough"]
---

# Semantic search

`POST /v1/recall`

## Request

- Base URL: `https://api.infolang.ai`
- URL: `https://api.infolang.ai/v1/recall`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Proxied verbatim to Kairos. The gateway applies NO authentication of its own here — /v1 and /mcp sit outside the /v2 middleware, so the Authorization header is forwarded untouched and Kairos is the sole authority. In practice that means either `il_*` credential is accepted (an API key, or an `il_oauth_` token — the latter is how an MCP client reaches /mcp); a Supabase session JWT is NOT, since Kairos cannot verify one. Response shapes are owned by Kairos. The gateway forwards ALL methods under /v1/* and /mcp — the operations listed here are the primary surface, not an exhaustive proxy inventory.

## Request body

- object
  - `query` string, required
  - `top_k` integer
  - `namespace` string
  - `verbose` boolean
  - `properties` object
  - `golden` boolean
  - `adaptive` boolean
  - `format` 'full' | 'lossless' | 'exact' | 'snippet' | 'meta'
  - `snippet_chars` integer
  - `margin` number
  - `queries` string[]

## Response `200`

Hits with similarity scores

---

[API](https://skmtc.dev/infolang/apis/infolang-api.md) · [All operations](https://skmtc.dev/infolang/apis/infolang-api/llms.txt) · [OpenAPI document](https://skmtc.dev/infolang/apis/infolang-api/revisions/d04bf6de72c8?raw)