Search

query is required. limit defaults to 5 and cannot exceed 20. Each item includes id, title, summary, a short snippet, pillarId, category, topic, tags, and score. The snippet is not the full write-up. Read the entry by id when you need the whole card.

Sample cards and deprecated entries are left out. An entry with indexed: false can be missing here even though list returns it.

curl -sS -X POST https://api.thealtermeai.com/api/v1/knowledge/search \
  -H "Authorization: Bearer emk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"pricing objection","limit":5}'

An empty result is 200 with items: [] and a reason:

• no_entries — this workspace has no entries to search
• not_indexed — entries exist, and none are indexed yet
• no_match — indexed entries exist, and none answered the question

A dry token balance is 402 INSUFFICIENT_AI_TOKENS. Top up AI tokens and search again. The entries themselves are still available through list and read.