List outstanding client tool calls for an agent session

GET 
/v2/agents/:agent_key/sessions/:session_key/outstanding_client_tool_calls

List the client tool calls the session is currently waiting on the caller to fulfill. Each entry carries the originating tool_input event ID, the tool name, and the fully materialized arguments to invoke the tool with. Secret-derived values are returned unmasked because the caller needs them to execute the tool, so this endpoint is restricted to the same roles permitted to submit input to the session.

Returns an empty list when the session is not parked on a client tool. The corresponding client_tool_pending event is delivered only on the live event stream and is not returned by listAgentEvents; this endpoint is the durable way to recover the pending calls after a reconnect. Submit one tool_output per returned event_id (via the create-input endpoint) to resume the session.

Request

Responses

200

The client tool calls the session is waiting on, one entry per outstanding call.

403

Permissions do not allow reading this session.

404

Agent or session not found.