Agents
List end user outstanding client tool calls for alias
GET/v2/agent_aliases/:alias_key/end_user_sessions/:session_key/outstanding_client_tool_calls
Lists the client tool calls that a session the caller owns is waiting on, addressed by the alias it was created through.
Use it to recover waiting calls after a reconnect or reload, because the client_tool_pending event is not in the session's history. Submit each call's output as a tool_output input.
Each entry carries the call's arguments, including argument override values, with secrets unmasked.
The list is empty when the session is not waiting on a client tool. Returns 403 if the session belongs to a different principal.
Anonymous widget visitors authenticate by presenting X-Visitor-Id instead of an Authorization credential; the platform mints an identity holding agent_end_user on the addressed alias, which satisfies this operation's role requirement.
Request
Responses
- 200
- 401
- 403
- 404
The client tool calls the session is waiting on, one entry per outstanding call.
The request carries no valid credential — no Authorization, and for anonymous callers a missing, malformed, or badly signed X-Visitor-Id.
The session does not belong to the caller, or permissions do not allow access. For an anonymous visitor, also returned when the session's connector no longer admits anonymous visitors. Also returned when the request Origin is not in the connector's allowed_origins. Origin checks apply only while the connector remains enabled; disabling or deleting it preserves the other admission and ownership checks.
Alias or session not found.