POST
Run Tool

Authorizations

Authorization
string
header
required

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

Path Parameters

tool_id
string<uuid>
required

Body

application/json
arguments
Arguments · object
timezone
string
default:UTC

The IANA timezone {{system_vars.now}}, {{system_vars.date}} and {{system_vars.time}} resolve against for this run. On a real call this comes from the agent.

userdata
Userdata · object
vars
Vars · object

Values for {{vars.name}} in this run. On a real session these come from the agent's declared defaults with the starting request's values merged over them; here there is no agent, so what you send is the whole bag.

Response

Successful Response

duration_ms
integer
required
ok
boolean
required
ended_call
boolean
default:false
error
string | null
error_type
string | null
handed_off
boolean
default:false
llm_response
string | null
responses
Responses · object[]
steps
RunStepResponse · object[]
tooldata
Tooldata · object
userdata
Userdata · object