Skip to content

Resolve with Natural Language Response

POST
/v1/resolve-respond

Resolve a query to a tool call and generate a natural language response. Combines intent resolution with conversational output. Costs 2 requests per call.

object
query
required
string
toolsets
required

Array of toolset signatures registered to the app

Array<string>
<= 10 items
banks

Optional bank IDs for additional context

Array<string>
persona

Optional persona name from app config (defaults to “default”)

string
context

Optional context string to guide resolution and response

string
history

Optional conversation history (max 5 entries)

Array<object>
<= 5 items
object
tool
required
string
query
required
string

Resolved tool call with natural language response

object
resolved
required
object
tool
required
string
parameters
required
object
response
required
object
text
required

Natural language response with parameters substituted

string
metadata
required
object
source
required
string
Allowed values: cache compute
used_banks
required
Array<string>
latency_ms
required
integer
requests_used
required
integer
requests_remaining
required
integer
defaults_applied

Parameter names that were filled from default values

Array<string>

Invalid request

object
error
required
string
message
required
string
code
required
integer

Unauthorized

object
error
required
string
message
required
string
code
required
integer

Insufficient balance

object
error
required
string
message
required
string
code
required
integer

Rate limited

object
error
required
string
message
required
string
code
required
integer

LLM processing error

object
error
required
string
message
required
string
code
required
integer

Service temporarily unavailable

object
error
required
string
message
required
string
code
required
integer