Skip to main content
POST
Query the brain (user)

Authorizations

Authorization
string
header
required

Workspace API key. Create one via the dashboard or POST /v1/auth/keys.

Headers

X-Naive-Project-Id
string<uuid>

Act inside this project. The header form of the /v1/projects/{project_id}/... prefix, for clients that cannot rewrite their base path. Lower precedence than the path, higher than the key's pinned project; omitted resolves to the organization's default project.

Path Parameters

user_id
string
required

Tenant user UUID, or default / me for the account's default agentProfile.

Body

application/json
question
string
required

Question to answer.

Required string length: 1 - 4000
knowledge_base_id
string<uuid>

Knowledge base to search; defaults to the tenant default.

session_id
string

Conversation thread id.

Maximum string length: 128
filters
object

Retrieval filters.

Response

Grounded answer.

answer
string
citations
object[]
knowledge_base_id
string
answer_mode
enum<string>
Available options:
grounded,
synthesized
session_id
string

Echo it back to continue the thread.