Skip to main content
POST
/
agent
/
{agent_id}
/
tool
/
{tool_name}
Execute Tool
curl --request POST \
  --url https://api.example.com/agent/{agent_id}/tool/{tool_name}
Run a tool outside of an agent execution loop.

​
Path Parameters

ParameterTypeDescription
agent_idstringThe agent that owns the tool
tool_namestringThe tool’s name

​
Request Body

{
  "x": 10,
  "y": 5,
  "operation": "+"
}
The body should match the tool’s parameter schema.

​
Response

{
  "result": 15,
  "call_id": "call_xyz",
  "execution_time_ms": 12
}