From 237efbcfce037926a1138f5d3b91af93d8cc7f42 Mon Sep 17 00:00:00 2001 From: jsteemann Date: Mon, 9 Oct 2023 13:43:58 +0200 Subject: [PATCH 1/2] documentation about `warnings` attribute change --- .../release-notes/version-3.12/api-changes-in-3-12.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/site/content/3.12/release-notes/version-3.12/api-changes-in-3-12.md b/site/content/3.12/release-notes/version-3.12/api-changes-in-3-12.md index 0316f2c29d..7beeff2a39 100644 --- a/site/content/3.12/release-notes/version-3.12/api-changes-in-3-12.md +++ b/site/content/3.12/release-notes/version-3.12/api-changes-in-3-12.md @@ -89,6 +89,14 @@ for details. The `GET /_api/query/rules` endpoint now includes a `description` attribute for every optimizer rule that briefly explains what it does. +#### AQL Query Parse API + +The `POST /_api/query/parse` endpoint for parsing AQL queries now unconditionally +returns the `warnings` attribute, even if no warnings were produced while parsing +the query. In that case, `warnings` will contain an empty array. +In previous versions, no `warnings` attribute was returned when parsing a query +produced no warnings. + ### Endpoints moved From 0d2024eae4cd869212808ef5cefe27eb61727b66 Mon Sep 17 00:00:00 2001 From: Simran Spiller Date: Tue, 10 Oct 2023 18:18:55 +0200 Subject: [PATCH 2/2] Review --- .../3.12/release-notes/version-3.12/api-changes-in-3-12.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/site/content/3.12/release-notes/version-3.12/api-changes-in-3-12.md b/site/content/3.12/release-notes/version-3.12/api-changes-in-3-12.md index 7beeff2a39..4e84b3bed6 100644 --- a/site/content/3.12/release-notes/version-3.12/api-changes-in-3-12.md +++ b/site/content/3.12/release-notes/version-3.12/api-changes-in-3-12.md @@ -89,11 +89,11 @@ for details. The `GET /_api/query/rules` endpoint now includes a `description` attribute for every optimizer rule that briefly explains what it does. -#### AQL Query Parse API +#### Query parsing API -The `POST /_api/query/parse` endpoint for parsing AQL queries now unconditionally +The `POST /_api/query` endpoint for parsing AQL queries now unconditionally returns the `warnings` attribute, even if no warnings were produced while parsing -the query. In that case, `warnings` will contain an empty array. +the query. In that case, `warnings` contains an empty array. In previous versions, no `warnings` attribute was returned when parsing a query produced no warnings.