Method: extensions.query

Full name: projects.locations.extensions.query

Queries an extension with a default controller.

Endpoint

posthttps://{service-endpoint}/v1beta1/{name}:query

Where{service-endpoint} is one of thesupported service endpoints.

Path parameters

namestring

Required. name (identifier) of the extension; Format:projects/{project}/locations/{location}/extensions/{extension}

Request body

The request body contains data with the following structure:

Fields
contents[]object (Content)

Required. The content of the current conversation with the model.

For single-turn queries, this is a single instance. For multi-turn queries, this is a repeated field that contains conversation history + latest request.

Response body

Response message forExtensionExecutionService.QueryExtension.

If successful, the response body contains data with the following structure:

Fields
steps[]object (Content)

Steps of extension or LLM interaction, can contain function call, function response, or text response. The last step contains the final response to the query.

failureMessagestring

Failure message if any.

JSON representation
{"steps":[{object (Content)}],"failureMessage":string}

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-06-27 UTC.