Beta Managed Agents User Tool Confirmation Event

• BetaManagedAgentsUserToolConfirmationEvent object

  A tool confirmation event that approves or denies a pending tool execution.

  • type: "user.tool_confirmation"

  • id: string

    Unique identifier for this event.

  • result: "allow" or "deny"

    UserToolConfirmationResult enum

    • "allow"

    • "deny"

  • tool_use_id: string

    The id of the agent.tool_use or agent.mcp_tool_use event this result corresponds to, which can be found in the last session.status_idle event's stop_reason.event_ids field.

  • deny_message: optional string or null

    Optional message providing context for a 'deny' decision. Only allowed when result is 'deny'.

    maxLength: 10000

  • processed_at: optional string or null

    A timestamp in RFC 3339 format

    format: date-time

  • session_thread_id: optional string or null

    When set, the confirmation routes to this subagent's thread rather than the primary. Echo this from the session_thread_id on the agent.tool_use or agent.mcp_tool_use event that prompted the approval.