Skip to main content
POST
/
api
/
v1
/
chat
Chat with documents
import requests

url = "https://api.memic.ai/api/v1/chat"

payload = {
    "question": "<string>",
    "project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "file_ids": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
    "connector_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "force_route": "structured",
    "top_k": 5,
    "min_score": 0.2
}
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)
{
  "question": "<string>",
  "answer": "<string>",
  "search_time_ms": 123,
  "generation_time_ms": 123,
  "model": "<string>",
  "citations": [],
  "total_chunks_used": 0,
  "routing": {
    "route": "<string>",
    "reasoning": "<string>",
    "connector_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "connector_name": "<string>",
    "sql_generated": "<string>",
    "sql_explanation": "<string>"
  },
  "results": {
    "semantic": [],
    "structured": {
      "columns": [],
      "rows": []
    }
  }
}

Authorizations

X-API-Key
string
header
required

Memic API key. Every key is bound to exactly one environment — get one from the Memic dashboard under API Keys.

Body

application/json

Request for chat/answer generation with intelligent routing.

question
string
required

User question

Required string length: 1 - 1000
project_id
string<uuid> | null

Optional project filter for semantic search

file_ids
string<uuid>[] | null

Optional file filter for semantic search

connector_id
string<uuid> | null

Optional connector ID for structured queries

force_route
enum<string> | null

Force a specific route (structured/semantic/hybrid)

Available options:
structured,
semantic,
hybrid
top_k
integer
default:5

Number of chunks to retrieve

Required range: 1 <= x <= 20
min_score
number
default:0.2

Minimum similarity score

Required range: 0 <= x <= 1

Response

Successful Response

Response with LLM-generated answer, citations, and routing info.

question
string
required
answer
string
required
search_time_ms
number
required
generation_time_ms
number
required
model
string
required
citations
Citation · object[]
total_chunks_used
integer
default:0
routing
RoutingInfo · object

How the query was routed

results
SearchResults · object

Search results (semantic and/or structured) - same structure as SearchResponse