Skip to content

Resolve Intent

POST
/v1/resolve

Resolve a natural-language query to a tool call using registered toolsets. Supports semantic caching for repeat queries.

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>
context

Optional context string to guide resolution

string
history

Optional conversation history (max 5 entries)

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

Resolved tool call

object
resolved
required
object
tool
required
string
parameters
required
object
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 (cache optimization)

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