diff --git a/modules/API/pages/built-in-endpoints.adoc b/modules/API/pages/built-in-endpoints.adoc index 65ae258a..cdd791c1 100644 --- a/modules/API/pages/built-in-endpoints.adoc +++ b/modules/API/pages/built-in-endpoints.adoc @@ -2531,9 +2531,20 @@ If you install all queries and receive a state of `SUCCESS` for one or more quer `+GET /restpp/query/{graph_name}/{query_name}+` Each time a new TigerGraph query is installed, a dynamic endpoint is generated. -This new endpoint enables the user to run the new TigerGraph query through HTTP requests and giving the parameters in URL or in a data payload. +This endpoint enables users to run an installed TigerGraph query through HTTP requests by providing parameters in the URL or request payload. In the case of a `GET` request, parameters should be passed in through the query string. +[NOTE] +==== +TigerGraph provides both RESTPP and GSQL endpoints for running installed queries. + +This RESTPP endpoint executes installed queries directly. The GSQL xref:api:gsql-endpoints.adoc#_run_query[Run query endpoint] internally forwards requests to this endpoint as part of the standardized GSQL API introduced in TigerGraph 4.1. + +If your application does not require the standardized GSQL API, TigerGraph recommends using this RESTPP endpoint because it executes the query directly without the additional request forwarding. + +For a comparison of the RESTPP and GSQL endpoints, including differences in parameter formats and request processing, see xref:api:gsql-endpoints.adoc#_comparing_the_restpp_and_gsql_query_endpoints[Comparing the RESTPP and GSQL query endpoints]. +==== + ==== Parameters: [%autowidth] diff --git a/modules/API/pages/gsql-endpoints.adoc b/modules/API/pages/gsql-endpoints.adoc index 791b682e..244a9d80 100644 --- a/modules/API/pages/gsql-endpoints.adoc +++ b/modules/API/pages/gsql-endpoints.adoc @@ -3212,6 +3212,15 @@ Sample Response:: The endpoint is used to run a query by its name. +[NOTE] +==== +This endpoint provides a standardized GSQL API for running installed queries. Internally, it forwards requests to the RESTPP endpoint `GET /restpp/query/{graph_name}/{query_name}` to execute the query. + +Use this endpoint if you are working with the standardized GSQL API or want consistency with other GSQL endpoints. If your application does not require the standardized GSQL API, consider using the xref:api:built-in-endpoints.adoc#_run_an_installed_query_get[RESTPP endpoint], which executes installed queries directly without the additional request forwarding. + +For a comparison of the RESTPP and GSQL endpoints, including differences in parameter formats and request processing, see xref:#_comparing_the_restpp_and_gsql_query_endpoints[Comparing the RESTPP and GSQL query endpoints]. +==== + ==== Endpoint Parameters: [%autowidth] diff --git a/modules/cluster-and-ha-management/pages/node-replacement-v2.adoc b/modules/cluster-and-ha-management/pages/node-replacement-v2.adoc index e26be736..8b8322bf 100644 --- a/modules/cluster-and-ha-management/pages/node-replacement-v2.adoc +++ b/modules/cluster-and-ha-management/pages/node-replacement-v2.adoc @@ -255,4 +255,4 @@ Ensure the data volume is mounted under `/data`, the RESTPP port matches the tar * *DNS does not update* + -Check the TTL value on the Route 53 record, verify the correct hostname was updated (UPSERT), and confirm the change with `nslookup`. +Check the TTL value on the Route 53 record, verify the correct hostname was updated (UPSERT), and confirm the change with `nslookup`. \ No newline at end of file