List outstanding client tool calls for an agent session

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

Lists the client tool calls the session is waiting for 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. The response returns secret-derived values unmasked because the caller needs them to execute the tool. For this reason, this endpoint is restricted to the same roles permitted to submit input to the session.

Returns an empty list when the session is not waiting on a client tool. The corresponding client_tool_pending event appears only on the live event stream. The listAgentEvents endpoint does not return it. Use this endpoint 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.