Skip to main content
POST
Ask a question about a project
Ask answers “what does this project say about X?” by searching across all project content (blocks, features, files), then generating a concise answer grounded in the retrieved context. Ask is synchronous and returns results immediately (not an async job).

How It Works

  1. Your question is used to run a hybrid search (semantic + keyword) across the project
  2. The top results are assembled into a context window
  3. An LLM generates a 2-4 sentence answer citing the source material
  4. Up to 5 source references are returned with relevance scores

Example Questions

Sources

Each source in the response includes:

Authorizations

Authorization
string
header
required

API key prefixed with sk_. Example: Authorization: Bearer sk_xxx

Headers

X-API-Version
string
default:2026-01-01

API version

Path Parameters

project_id
string
required

Project ID

Body

application/json
question
string
required

Response

Generated answer with sources.

answer
string

Generated answer to the question

sources
object[]