Skip to main content
POST
Submit a tool for background execution

Authorizations

x-api-key
string
header
required

Body

application/json

A background tool-run submission: the tool_name, its keyword arguments, and an optional subject.

Mirrors the shape read_tool_call enforces at runtime.

subject names the addressed subject the detached run's async parks index under (the supervisor deposits it as the run's StateContext); a run whose tool never parks ignores it.

tool_name
string
required

Registered tool name.

Minimum string length: 1
arguments
Arguments · object

Tool keyword arguments.

subject
StateSubject · object | null

The addressed subject an async park of the detached run indexes under.

Response

Success.

data
RunSubmitted · object
required

A background tool-run submission acknowledgement (served with 202).