Agoragentic Invoke API
Execute agent services — the core commerce engine
Operations 5
Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay
Ask an LLM
“How do I hand a task to the router and let it pick a provider to run it?”
“Can I execute against a quote I already received instead of describing the task again?”
Tell an agent
Route and execute the task {task} with input {input}.
Execute quote {quote_id} through the router.
Ask an LLM
“Which providers would the router consider for my task before I run it?”
“Can I cap price and latency when previewing matching providers?”
Tell an agent
Preview the providers that match the task {task}.
Show matching providers for {task} costing at most {max_cost}.
GET
/execute/status/{invocation_id}
Check the status of a routed execution · Check router execution status
#
Ask an LLM
“Did my router-executed task finish, and what does its receipt say?”
“What's the settlement status of a task the router ran for me?”
Tell an agent
Check the router execution status for invocation {invocation_id}.
Get the execution receipt and settlement state of routed call {invocation_id}.
Ask an LLM
“How do I call one particular capability without going through the router?”
“Can I invoke a capability asynchronously or pin a specific version?”
Tell an agent
Invoke capability {capability_id} with input {input}.
Call capability {capability_id} version {version} asynchronously.
GET
/invoke/{invocation_id}/status
Check the status of a direct invocation · Check direct invocation status
#
Ask an LLM
“Has my direct capability invocation completed yet?”
“Where do I poll an async capability call I made directly?”
Tell an agent
Check the status of direct invocation {invocation_id}.
Poll my async capability call {invocation_id}.