stac-utils · jonhealy1 · Apr 2, 2026 · Apr 2, 2026 · Apr 2, 2026 · Apr 3, 2026
diff --git a/CHANGES.md b/CHANGES.md
@@ -2,6 +2,10 @@
 
 ## [Unreleased]
 
+### Changed
+
+- removed the third party and core extensions folders and moved all of the extensions to root. Ensured backwards compatibility and added a deprecation warning. ([#899](https://github.com/stac-utils/stac-fastapi/pull/899))
+
 ### Fixed
 
 - fix mypy type errors in transaction extension for Python 3.14 compatibility (mypy 1.20.0) ([#895](https://github.com/stac-utils/stac-fastapi/pull/895))

diff --git a/docs/mkdocs.yml b/docs/mkdocs.yml
@@ -32,49 +32,47 @@ nav:
           - routes: api/stac_fastapi/api/routes.md
       - stac_fastapi.extensions:
           - module: api/stac_fastapi/extensions/index.md
-          - core:
-              - module: api/stac_fastapi/extensions/core/index.md
-              - aggregation:
-                - module: api/stac_fastapi/extensions/core/aggregation/index.md
-                - aggregation: api/stac_fastapi/extensions/core/aggregation/aggregation.md
-                - client: api/stac_fastapi/extensions/core/aggregation/client.md
-                - request: api/stac_fastapi/extensions/core/aggregation/request.md
-                - types: api/stac_fastapi/extensions/core/aggregation/types.md
-              - collection_search:
-                - module: api/stac_fastapi/extensions/core/collection_search/index.md
-                - collection_search: api/stac_fastapi/extensions/core/collection_search/collection_search.md
-                - client: api/stac_fastapi/extensions/core/collection_search/client.md
-                - request: api/stac_fastapi/extensions/core/collection_search/request.md
-              - fields:
-                  - module: api/stac_fastapi/extensions/core/fields/index.md
-                  - fields: api/stac_fastapi/extensions/core/fields/fields.md
-                  - request: api/stac_fastapi/extensions/core/fields/request.md
-              - filter:
-                  - module: api/stac_fastapi/extensions/core/filter/index.md
-                  - filter: api/stac_fastapi/extensions/core/filter/filter.md
-                  - request: api/stac_fastapi/extensions/core/filter/request.md
-              - free_text:
-                - module: api/stac_fastapi/extensions/core/free_text/index.md
-                - free_text: api/stac_fastapi/extensions/core/free_text/free_text.md
-                - request: api/stac_fastapi/extensions/core/free_text/request.md
-              - pagination:
-                  - module: api/stac_fastapi/extensions/core/pagination/index.md
-                  - pagination: api/stac_fastapi/extensions/core/pagination/pagination.md
-                  - offset_pagination: api/stac_fastapi/extensions/core/pagination/offset_pagination.md
-                  - token_pagination: api/stac_fastapi/extensions/core/pagination/token_pagination.md
-                  - request: api/stac_fastapi/extensions/core/pagination/request.md
-              - query:
-                  - module: api/stac_fastapi/extensions/core/query/index.md
-                  - query: api/stac_fastapi/extensions/core/query/query.md
-                  - request: api/stac_fastapi/extensions/core/query/request.md
-              - sort:
-                  - module: api/stac_fastapi/extensions/core/sort/index.md
-                  - request: api/stac_fastapi/extensions/core/sort/request.md
-                  - sort: api/stac_fastapi/extensions/core/sort/sort.md
-              - transaction: api/stac_fastapi/extensions/core/transaction.md
-          - third_party:
-              - module: api/stac_fastapi/extensions/third_party/index.md
-              - bulk_transactions: api/stac_fastapi/extensions/third_party/bulk_transactions.md
+          - aggregation:
+            - module: api/stac_fastapi/extensions/aggregation/index.md
+            - aggregation: api/stac_fastapi/extensions/aggregation/aggregation.md
+            - client: api/stac_fastapi/extensions/aggregation/client.md
+            - request: api/stac_fastapi/extensions/aggregation/request.md
+            - types: api/stac_fastapi/extensions/aggregation/types.md
+          - bulk_transactions:
+            - module: api/stac_fastapi/extensions/bulk_transactions/index.md
+            - bulk_transactions: api/stac_fastapi/extensions/bulk_transactions/bulk_transactions.md
+          - collection_search:
+            - module: api/stac_fastapi/extensions/collection_search/index.md
+            - collection_search: api/stac_fastapi/extensions/collection_search/collection_search.md
+            - client: api/stac_fastapi/extensions/collection_search/client.md
+            - request: api/stac_fastapi/extensions/collection_search/request.md
+          - fields:
+              - module: api/stac_fastapi/extensions/fields/index.md
+              - fields: api/stac_fastapi/extensions/fields/fields.md
+              - request: api/stac_fastapi/extensions/fields/request.md
+          - filter:
+              - module: api/stac_fastapi/extensions/filter/index.md
+              - filter: api/stac_fastapi/extensions/filter/filter.md
+              - request: api/stac_fastapi/extensions/filter/request.md
+          - free_text:
+            - module: api/stac_fastapi/extensions/free_text/index.md
+            - free_text: api/stac_fastapi/extensions/free_text/free_text.md
+            - request: api/stac_fastapi/extensions/free_text/request.md
+          - pagination:
+              - module: api/stac_fastapi/extensions/pagination/index.md
+              - pagination: api/stac_fastapi/extensions/pagination/pagination.md
+              - offset_pagination: api/stac_fastapi/extensions/pagination/offset_pagination.md
+              - token_pagination: api/stac_fastapi/extensions/pagination/token_pagination.md
+              - request: api/stac_fastapi/extensions/pagination/request.md
+          - query:
+              - module: api/stac_fastapi/extensions/query/index.md
+              - query: api/stac_fastapi/extensions/query/query.md
+              - request: api/stac_fastapi/extensions/query/request.md
+          - sort:
+              - module: api/stac_fastapi/extensions/sort/index.md
+              - request: api/stac_fastapi/extensions/sort/request.md
+              - sort: api/stac_fastapi/extensions/sort/sort.md
+          - transaction: api/stac_fastapi/extensions/transaction.md
       - stac_fastapi.types:
           - module: api/stac_fastapi/types/index.md
           - config: api/stac_fastapi/types/config.md

diff --git a/docs/src/api/stac_fastapi/extensions/aggregation/aggregation.md b/docs/src/api/stac_fastapi/extensions/aggregation/aggregation.md
@@ -0,0 +1,3 @@
+::: stac_fastapi.extensions.aggregation.aggregation
+    options:
+      show_source: true
diff --git a/docs/src/api/stac_fastapi/extensions/aggregation/client.md b/docs/src/api/stac_fastapi/extensions/aggregation/client.md
@@ -0,0 +1,3 @@
+::: stac_fastapi.extensions.aggregation.client
+    options:
+      show_source: true
diff --git a/docs/src/api/stac_fastapi/extensions/aggregation/index.md b/docs/src/api/stac_fastapi/extensions/aggregation/index.md
@@ -0,0 +1,10 @@
+# Module stac_fastapi.extensions.aggregation
+
+Aggregation Extensions submodule.
+
+## Sub-modules
+
+* [stac_fastapi.extensions.aggregation.aggregation](aggregation.md)
+* [stac_fastapi.extensions.aggregation.client](client.md)
+* [stac_fastapi.extensions.aggregation.request](request.md)
+* [stac_fastapi.extensions.aggregation.types](types.md)
diff --git a/docs/src/api/stac_fastapi/extensions/aggregation/request.md b/docs/src/api/stac_fastapi/extensions/aggregation/request.md
@@ -0,0 +1,3 @@
+::: stac_fastapi.extensions.aggregation.request
+    options:
+      show_source: true
diff --git a/docs/src/api/stac_fastapi/extensions/aggregation/types.md b/docs/src/api/stac_fastapi/extensions/aggregation/types.md
@@ -0,0 +1,3 @@
+::: stac_fastapi.extensions.aggregation.types
+    options:
+      show_source: true
diff --git a/docs/src/api/stac_fastapi/extensions/bulk_transactions/bulk_transactions.md b/docs/src/api/stac_fastapi/extensions/bulk_transactions/bulk_transactions.md
@@ -0,0 +1,3 @@
+::: stac_fastapi.extensions.bulk_transactions
+    options:
+      show_source: true
diff --git a/docs/src/api/stac_fastapi/extensions/bulk_transactions/index.md b/docs/src/api/stac_fastapi/extensions/bulk_transactions/index.md
@@ -0,0 +1,7 @@
+# Module stac_fastapi.extensions
+
+Third Party Extensions submodule.
+
+## Sub-modules
+
+* [stac_fastapi.extensions.bulk_transactions](bulk_transactions.md)
diff --git a/docs/src/api/stac_fastapi/extensions/collection_search/client.md b/docs/src/api/stac_fastapi/extensions/collection_search/client.md
@@ -0,0 +1,4 @@
+
+::: stac_fastapi.extensions.collection_search.client
+    options:
+      show_source: true
diff --git a/docs/src/api/stac_fastapi/extensions/collection_search/collection_search.md b/docs/src/api/stac_fastapi/extensions/collection_search/collection_search.md
@@ -0,0 +1,5 @@
+
+
+::: stac_fastapi.extensions.collection_search.collection_search
+    options:
+      show_source: true
diff --git a/docs/src/api/stac_fastapi/extensions/collection_search/index.md b/docs/src/api/stac_fastapi/extensions/collection_search/index.md
@@ -0,0 +1,9 @@
+# Module stac_fastapi.extensions.collection_search
+
+Collection-Search Extensions submodule.
+
+## Sub-modules
+
+* [stac_fastapi.extensions.collection_search.collection_search](collection_search.md)
+* [stac_fastapi.extensions.collection_search.client](client.md)
+* [stac_fastapi.extensions.collection_search.request](request.md)
diff --git a/docs/src/api/stac_fastapi/extensions/collection_search/request.md b/docs/src/api/stac_fastapi/extensions/collection_search/request.md
@@ -0,0 +1,6 @@
+
+
+
+::: stac_fastapi.extensions.collection_search.request
+    options:
+      show_source: true
diff --git a/docs/src/api/stac_fastapi/extensions/core/aggregation/aggregation.md b/docs/src/api/stac_fastapi/extensions/core/aggregation/aggregation.md
diff --git a/docs/src/api/stac_fastapi/extensions/core/aggregation/client.md b/docs/src/api/stac_fastapi/extensions/core/aggregation/client.md
diff --git a/docs/src/api/stac_fastapi/extensions/core/aggregation/index.md b/docs/src/api/stac_fastapi/extensions/core/aggregation/index.md
diff --git a/docs/src/api/stac_fastapi/extensions/core/aggregation/request.md b/docs/src/api/stac_fastapi/extensions/core/aggregation/request.md
diff --git a/docs/src/api/stac_fastapi/extensions/core/aggregation/types.md b/docs/src/api/stac_fastapi/extensions/core/aggregation/types.md
diff --git a/docs/src/api/stac_fastapi/extensions/core/collection_search/client.md b/docs/src/api/stac_fastapi/extensions/core/collection_search/client.md
diff --git a/docs/src/api/stac_fastapi/extensions/core/collection_search/collection_search.md b/docs/src/api/stac_fastapi/extensions/core/collection_search/collection_search.md
diff --git a/docs/src/api/stac_fastapi/extensions/core/collection_search/index.md b/docs/src/api/stac_fastapi/extensions/core/collection_search/index.md
diff --git a/docs/src/api/stac_fastapi/extensions/core/collection_search/request.md b/docs/src/api/stac_fastapi/extensions/core/collection_search/request.md
diff --git a/docs/src/api/stac_fastapi/extensions/core/fields/fields.md b/docs/src/api/stac_fastapi/extensions/core/fields/fields.md
diff --git a/docs/src/api/stac_fastapi/extensions/core/fields/index.md b/docs/src/api/stac_fastapi/extensions/core/fields/index.md
diff --git a/docs/src/api/stac_fastapi/extensions/core/fields/request.md b/docs/src/api/stac_fastapi/extensions/core/fields/request.md
diff --git a/docs/src/api/stac_fastapi/extensions/core/filter/filter.md b/docs/src/api/stac_fastapi/extensions/core/filter/filter.md
diff --git a/docs/src/api/stac_fastapi/extensions/core/filter/index.md b/docs/src/api/stac_fastapi/extensions/core/filter/index.md
diff --git a/docs/src/api/stac_fastapi/extensions/core/filter/request.md b/docs/src/api/stac_fastapi/extensions/core/filter/request.md
diff --git a/docs/src/api/stac_fastapi/extensions/core/free_text/free_text.md b/docs/src/api/stac_fastapi/extensions/core/free_text/free_text.md
diff --git a/docs/src/api/stac_fastapi/extensions/core/free_text/index.md b/docs/src/api/stac_fastapi/extensions/core/free_text/index.md
diff --git a/docs/src/api/stac_fastapi/extensions/core/free_text/request.md b/docs/src/api/stac_fastapi/extensions/core/free_text/request.md
diff --git a/docs/src/api/stac_fastapi/extensions/core/index.md b/docs/src/api/stac_fastapi/extensions/core/index.md
diff --git a/docs/src/api/stac_fastapi/extensions/core/pagination/index.md b/docs/src/api/stac_fastapi/extensions/core/pagination/index.md
diff --git a/docs/src/api/stac_fastapi/extensions/core/pagination/offset_pagination.md b/docs/src/api/stac_fastapi/extensions/core/pagination/offset_pagination.md
diff --git a/docs/src/api/stac_fastapi/extensions/core/pagination/pagination.md b/docs/src/api/stac_fastapi/extensions/core/pagination/pagination.md
diff --git a/docs/src/api/stac_fastapi/extensions/core/pagination/request.md b/docs/src/api/stac_fastapi/extensions/core/pagination/request.md
diff --git a/docs/src/api/stac_fastapi/extensions/core/pagination/token_pagination.md b/docs/src/api/stac_fastapi/extensions/core/pagination/token_pagination.md
diff --git a/docs/src/api/stac_fastapi/extensions/core/query/index.md b/docs/src/api/stac_fastapi/extensions/core/query/index.md
diff --git a/docs/src/api/stac_fastapi/extensions/core/query/query.md b/docs/src/api/stac_fastapi/extensions/core/query/query.md
diff --git a/docs/src/api/stac_fastapi/extensions/core/query/request.md b/docs/src/api/stac_fastapi/extensions/core/query/request.md
diff --git a/docs/src/api/stac_fastapi/extensions/core/sort/index.md b/docs/src/api/stac_fastapi/extensions/core/sort/index.md
diff --git a/docs/src/api/stac_fastapi/extensions/core/sort/request.md b/docs/src/api/stac_fastapi/extensions/core/sort/request.md
diff --git a/docs/src/api/stac_fastapi/extensions/core/sort/sort.md b/docs/src/api/stac_fastapi/extensions/core/sort/sort.md
diff --git a/docs/src/api/stac_fastapi/extensions/core/transaction.md b/docs/src/api/stac_fastapi/extensions/core/transaction.md
diff --git a/docs/src/api/stac_fastapi/extensions/fields/fields.md b/docs/src/api/stac_fastapi/extensions/fields/fields.md
@@ -0,0 +1,5 @@
+
+
+::: stac_fastapi.extensions.fields.fields
+    options:
+      show_source: true