From 1ba6c53641caaa98869a2d223b49926792edc560 Mon Sep 17 00:00:00 2001 From: K Heiner Date: Wed, 15 Jul 2026 17:33:56 -0700 Subject: [PATCH 1/5] docs: add Meta query parameter section --- content/guides/04.connect/3.query-parameters.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/content/guides/04.connect/3.query-parameters.md b/content/guides/04.connect/3.query-parameters.md index 7ee7b17e..6be56922 100644 --- a/content/guides/04.connect/3.query-parameters.md +++ b/content/guides/04.connect/3.query-parameters.md @@ -784,3 +784,12 @@ The articles collection consists of a many-to-one relation to Users called `auth ``` :: + +## Meta + +Returns metadata about the result set alongside the requested data. Accepts `total_count`, `filter_count`, a comma-separated combination of the two, or `*` for both. + +| Value | Description | +| -------------- | --------------------------------------------------------- | +| `total_count` | Total number of items in the collection, ignoring filters | +| `filter_count` | Number of items matching the current filter/search | From 43f8079f1430528aeaea09e34751dc01f2744302 Mon Sep 17 00:00:00 2001 From: K Heiner Date: Wed, 15 Jul 2026 17:35:57 -0700 Subject: [PATCH 2/5] docs: add Meta query parameter examples --- .../guides/04.connect/3.query-parameters.md | 22 +++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/content/guides/04.connect/3.query-parameters.md b/content/guides/04.connect/3.query-parameters.md index 6be56922..3456e18c 100644 --- a/content/guides/04.connect/3.query-parameters.md +++ b/content/guides/04.connect/3.query-parameters.md @@ -793,3 +793,25 @@ Returns metadata about the result set alongside the requested data. Accepts `tot | -------------- | --------------------------------------------------------- | | `total_count` | Total number of items in the collection, ignoring filters | | `filter_count` | Number of items matching the current filter/search | + +::code-group + +```http [REST] +GET /items/posts + ?meta=total_count,filter_count +``` + +```graphql [GraphQL] +# Not available. Use the collection's aggregated query instead: +query { + posts_aggregated { + countAll + } +} +``` + +```js [SDK] +// Not yet supported by the SDK: https://github.com/directus/directus/issues/22640 +``` + +:: From 39ce35420c57356fc1d7a0acc8b72ae2208c8d7e Mon Sep 17 00:00:00 2001 From: K Heiner Date: Wed, 15 Jul 2026 17:36:23 -0700 Subject: [PATCH 3/5] docs: update query parameters frontmatter description --- content/guides/04.connect/3.query-parameters.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/guides/04.connect/3.query-parameters.md b/content/guides/04.connect/3.query-parameters.md index 3456e18c..fd2558fa 100644 --- a/content/guides/04.connect/3.query-parameters.md +++ b/content/guides/04.connect/3.query-parameters.md @@ -1,7 +1,7 @@ --- stableId: 2627d8eb-784f-4197-8d66-f180347d1b4d title: Query Parameters -description: Learn about Directus query parameters - fields, filter, search, sort, limit, offset, page, aggregate, groupBy, deep, alias, and export. Understand how to customize your API requests and retrieve specific data from your collections. +description: Learn about Directus query parameters - fields, filter, search, sort, limit, offset, page, aggregate, groupBy, deep, alias, export, version, versionRaw, backlink, and meta. Understand how to customize your API requests and retrieve specific data from your collections. --- Most Directus API endpoints can use global query parameters to alter the data that is returned. From cc4925c23f428222f4485e59414cfd2179d43102 Mon Sep 17 00:00:00 2001 From: K Heiner Date: Wed, 15 Jul 2026 17:39:31 -0700 Subject: [PATCH 4/5] docs: fix inconsistent REST tab label in Version section --- content/guides/04.connect/3.query-parameters.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/content/guides/04.connect/3.query-parameters.md b/content/guides/04.connect/3.query-parameters.md index fd2558fa..caae68cb 100644 --- a/content/guides/04.connect/3.query-parameters.md +++ b/content/guides/04.connect/3.query-parameters.md @@ -569,8 +569,9 @@ The keys `published` and `draft` are reserved. Use `published` (or `main` for ba ::code-group -```http [GET /items/posts/1] -?version=v1 +```http [REST] +GET /items/posts/1 + ?version=v1 ``` ```graphql [GraphQL] From 259d90d87d8cbef6acef35bbec7374d5185e287f Mon Sep 17 00:00:00 2001 From: K Heiner Date: Wed, 15 Jul 2026 17:40:08 -0700 Subject: [PATCH 5/5] docs: fix inconsistent REST tab label in Export section --- content/guides/04.connect/3.query-parameters.md | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/content/guides/04.connect/3.query-parameters.md b/content/guides/04.connect/3.query-parameters.md index caae68cb..b8914e5a 100644 --- a/content/guides/04.connect/3.query-parameters.md +++ b/content/guides/04.connect/3.query-parameters.md @@ -554,10 +554,15 @@ Note that it is not possible to use aliases on relational fields e.g. `alias[aut Saves the API response to a file. Valid values are `csv`, `json`, `xml`, `yaml`. -```http [GET /items/posts] -?export=type +::code-group + +```http [REST] +GET /items/posts + ?export=csv ``` +:: + ## Version Queries a version of a record by version key when [content versioning](/guides/content/content-versioning) is enabled on a collection. Applies only to single item retrieval.