Skip to main content
POST
Generate Plan

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

A query against a DocSet. Contains either a natural language string or a query plan.

docset_id
string | null

The docset against which to run the query

query
string | null

The natural language query to run. if specified, plan must not be set.

plan
LogicalPlan · object | null

The logical query plan to run. If specified, query must not be set.

stream
boolean
default:false

If true, query results will be streamed back to the client as they are generated. Applies only when calling the query api.

summarize_result
boolean
default:false

If true, an english summary of the result in context of the original query will be returned. Applies only when calling the query API and only available when stream=True

rag_mode
boolean
default:false

If true, the query will only run a RAG query plan.

Response

Successful Response

A logical query plan used to evaluate a query.

query
string
required

The query that the plan is for.

nodes
Nodes · object
required

A mapping of node IDs to nodes in the query plan.

result_node
integer
required

The ID of the node that is the result of the query.

llm_prompt
any | null

The LLM prompt that was used to generate this query plan.

llm_plan
string | null

The result generated by the LLM.