Run query | Instabase AI Hub Documentation

Send an asynchronous query to the source app. Use this operation to query chatbots or query multiple documents in a conversation. Each request returns a query_id used to check the query status and get the response.

To query a single document in a conversation or to use the standard or advanced model in your query, use the Converse with a document operation.

Send an asynchronous query to the source app. Use this operation to query chatbots or query multiple documents in a conversation. Each request returns a `query_id` used to [check the query status and get the response](/api-sdk/api-reference/queries/get-query-status/). <Tip>To query a single document in a conversation or to use the standard or advanced model in your query, use the [Converse with a document](/api-sdk/api-reference/conversations/converse) operation.</Tip>

Authentication

AuthorizationBearer

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

Headers

IB-ContextstringOptional

Specify whether to use your community account or organization account to complete the request. To use your community account, define as your user ID. To use your organization account, define as your organization ID. If unspecified, defaults to community account context. See Authorization and context identification for details.

Specify whether to use your community account or organization account to complete the request. To use your community account, define as your user ID. To use your organization account, define as your organization ID. If unspecified, defaults to community account context. See [Authorization and context identification](/api-sdk/authorization#ib-context-header) for details.

Request

This endpoint expects an object.

querystringRequired

Your query to source app.

Queries made by API are also visible in your query history when accessing the source app from the AI Hub user interface.

Your query to source app. <Info> Queries made by API are also visible in your query history when accessing the source app from the AI Hub user interface.</Info>

source_appobjectRequired

Information about the source app (chatbot or conversation).

model_nameenumOptionalDefaults to multistep-lite

The model to use to answer the query. Supports the multistep model (multistep-lite) and research mode (multistep), a more powerful but slower variant of the multistep model that’s suited to complex reasoning queries. See Choosing a model for details.

Allowed values:

include_source_infobooleanOptionalDefaults to false

Set to true to return information about the source documents referenced when generating the query response.

The multistep model (model set to multistep-lite) supports document-level source information. Research mode (model set to multistep) supports page-level source information.

Set to `true` to return information about the source documents referenced when generating the query response. <Note> The multistep model (`model` set to `multistep-lite`) supports document-level source information. Research mode (`model` set to `multistep`) supports page-level source information.</Note>

filtersobjectOptional

Filters to apply to the query. Filters narrow the scope of the query to specific documents.

Filters are only supported for converse. For chatbot, queries run on all documents.

Filters to apply to the query. Filters narrow the scope of the query to specific documents. <Note>Filters are only supported for converse. For chatbot, queries run on all documents.</Note>

Response

Query request accepted.

query_idstring

The unique identifier of the query.

1	curl "${API_ROOT}/v2/queries" \
2	-H "Authorization: Bearer ${API_TOKEN}" \
3	-H "IB-Context: ${IB_CONTEXT}"\
4	-H "Content-Type: application/json" \
5	-d '{
6	"query": "When was the mail sent out?",
7	"model": "multistep",
8	"include_source_info": true,
9	"source_app":
10	{
11	"type": "CHATBOT",
12	"id": "<CHATBOT-ID>"
13	}
14	}'