Beta Managed Agents User Custom Tool Result Event Params

• BetaManagedAgentsUserCustomToolResultEventParams object

  Parameters for providing the result of a custom tool execution.

  • type: "user.custom_tool_result"

  • custom_tool_use_id: string

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

    minLength: 1, maxLength: 128

  • content: optional array of BetaManagedAgentsTextBlock or BetaManagedAgentsImageBlock or BetaManagedAgentsDocumentBlock or BetaManagedAgentsSearchResultBlock

    The result content returned by the tool.

    • BetaManagedAgentsTextBlock object

      Regular text content.

      • type: "text"

      • text: string

        The text content.

        minLength: 1

    • BetaManagedAgentsImageBlock object

      Image content specified directly as base64 data or as a reference via a URL.

      • type: "image"

      • source: BetaManagedAgentsBase64ImageSource or BetaManagedAgentsURLImageSource or BetaManagedAgentsFileImageSource

        Union type for image source variants.

        • BetaManagedAgentsBase64ImageSource object

          Base64-encoded image data.

          • type: "base64"

          • data: string

            Base64-encoded image data.

            minLength: 1

          • media_type: string

            MIME type of the image (e.g., "image/png", "image/jpeg", "image/gif", "image/webp").

            minLength: 1

        • BetaManagedAgentsURLImageSource object

          Image referenced by URL.

          • type: "url"

          • url: string

            URL of the image to fetch.

            minLength: 1

        • BetaManagedAgentsFileImageSource object

          Image referenced by file ID.

          • type: "file"

          • file_id: string

            ID of a previously uploaded file.

            minLength: 1

    • BetaManagedAgentsDocumentBlock object

      Document content, either specified directly as base64 data, as text, or as a reference via a URL.

      • type: "document"

      • source: BetaManagedAgentsBase64DocumentSource or BetaManagedAgentsPlainTextDocumentSource or BetaManagedAgentsURLDocumentSource or BetaManagedAgentsFileDocumentSource

        Union type for document source variants.

        • BetaManagedAgentsBase64DocumentSource object

          Base64-encoded document data.

          • type: "base64"

          • data: string

            Base64-encoded document data.

            minLength: 1

          • media_type: string

            MIME type of the document (e.g., "application/pdf").

            minLength: 1

        • BetaManagedAgentsPlainTextDocumentSource object

          Plain text document content.

          • type: "text"

          • data: string

            The plain text content.

            minLength: 1

          • media_type: "text/plain"

            MIME type of the text content. Must be "text/plain".

        • BetaManagedAgentsURLDocumentSource object

          Document referenced by URL.

          • type: "url"

          • url: string

            URL of the document to fetch.

            minLength: 1

        • BetaManagedAgentsFileDocumentSource object

          Document referenced by file ID.

          • type: "file"

          • file_id: string

            ID of a previously uploaded file.

            minLength: 1

      • context: optional string or null

        Additional context about the document for the model.

      • title: optional string or null

        The title of the document.

    • BetaManagedAgentsSearchResultBlock object

      A block containing a web search result.

      • type: "search_result"

      • citations: BetaManagedAgentsSearchResultCitations

        Citation settings for a search result.

        • enabled: boolean

          Whether citations are enabled for this search result.

      • content: array of BetaManagedAgentsSearchResultContent

        Array of text content blocks from the search result.

        • type: "text"

        • text: string

          The text content.

          minLength: 1

      • source: string

        The URL source of the search result.

        minLength: 1

      • title: string

        The title of the search result.

        minLength: 1

  • is_error: optional boolean or null

    Whether the tool execution resulted in an error.