From d74c1855c33c7bf243ec987902fa2ee0d7ef0570 Mon Sep 17 00:00:00 2001 From: anoadragon453 Date: Tue, 11 Nov 2025 10:38:24 +0000 Subject: [PATCH] deploy: 8feb862ff6ca4cc6ffeb1815aaf9b2051eabed99 --- latest/404.html | 2 +- latest/CAPTCHA_SETUP.html | 2 +- latest/admin_api/account_validity.html | 2 +- .../client_server_api_extensions.html | 2 +- latest/admin_api/event_reports.html | 2 +- latest/admin_api/experimental_features.html | 2 +- latest/admin_api/fetch_event.html | 2 +- latest/admin_api/media_admin_api.html | 2 +- latest/admin_api/purge_history_api.html | 2 +- latest/admin_api/register_api.html | 2 +- latest/admin_api/room_membership.html | 2 +- latest/admin_api/rooms.html | 65 +++++- latest/admin_api/scheduled_tasks.html | 2 +- latest/admin_api/server_notices.html | 2 +- latest/admin_api/statistics.html | 2 +- latest/admin_api/user_admin_api.html | 2 +- latest/admin_api/version_api.html | 2 +- latest/application_services.html | 2 +- latest/auth_chain_difference_algorithm.html | 2 +- latest/code_style.html | 2 +- latest/consent_tracking.html | 2 +- latest/delegate.html | 2 +- latest/deprecation_policy.html | 8 +- latest/development/cas.html | 2 +- latest/development/contributing_guide.html | 4 +- latest/development/database_schema.html | 2 +- latest/development/demo.html | 2 +- latest/development/dependencies.html | 10 +- latest/development/experimental_features.html | 2 +- latest/development/git.html | 2 +- .../internal_documentation/index.html | 2 +- .../release_notes_review_checklist.html | 216 ++++++++++++++++++ latest/development/releases.html | 2 +- latest/development/reviews.html | 2 +- latest/development/room-dag-concepts.html | 2 +- latest/development/saml.html | 2 +- .../synapse_architecture/cancellation.html | 2 +- .../synapse_architecture/faster_joins.html | 2 +- .../synapse_architecture/streams.html | 2 +- latest/federate.html | 2 +- latest/index.html | 2 +- latest/jwt.html | 2 +- latest/log_contexts.html | 2 +- latest/manhole.html | 2 +- latest/media_repository.html | 2 +- latest/message_retention_policies.html | 2 +- latest/metrics-howto.html | 2 +- latest/modules/account_data_callbacks.html | 2 +- .../modules/account_validity_callbacks.html | 2 +- ...xtra_fields_to_client_events_unsigned.html | 2 +- ...ackground_update_controller_callbacks.html | 2 +- latest/modules/index.html | 2 +- .../modules/media_repository_callbacks.html | 2 +- .../password_auth_provider_callbacks.html | 2 +- latest/modules/porting_legacy_module.html | 2 +- latest/modules/presence_router_callbacks.html | 2 +- latest/modules/ratelimit_callbacks.html | 2 +- latest/modules/spam_checker_callbacks.html | 2 +- .../modules/third_party_rules_callbacks.html | 2 +- latest/modules/writing_a_module.html | 2 +- latest/openid.html | 2 +- latest/opentracing.html | 2 +- ...ing_synapse_on_single_board_computers.html | 2 +- latest/password_auth_providers.html | 2 +- latest/postgres.html | 2 +- latest/print.html | 124 ++++++++-- latest/replication.html | 2 +- latest/reverse_proxy.html | 2 +- latest/room_and_user_statistics.html | 6 +- latest/schema/synapse-config.schema.json | 2 +- latest/searchindex.js | 2 +- latest/searchindex.json | 2 +- latest/server_notices.html | 2 +- latest/setup/forward_proxy.html | 2 +- latest/setup/installation.html | 20 +- latest/setup/turn/coturn.html | 2 +- latest/setup/turn/eturnal.html | 2 +- latest/sso_mapping_providers.html | 2 +- latest/structured_logging.html | 2 +- latest/synctl_workers.html | 2 +- latest/systemd-with-workers/index.html | 2 +- latest/tcp_replication.html | 2 +- latest/templates.html | 2 +- latest/turn-howto.html | 2 +- latest/upgrade.html | 16 +- .../admin_api/background_updates.html | 2 +- .../administration/admin_api/federation.html | 2 +- .../usage/administration/admin_api/index.html | 2 +- .../admin_api/registration_tokens.html | 2 +- latest/usage/administration/admin_faq.html | 2 +- latest/usage/administration/backups.html | 2 +- .../database_maintenance_tools.html | 2 +- latest/usage/administration/index.html | 2 +- ...reporting_homeserver_usage_statistics.html | 2 +- .../administration/monthly_active_users.html | 2 +- latest/usage/administration/request_log.html | 2 +- latest/usage/administration/state_groups.html | 2 +- ...anding_synapse_through_grafana_graphs.html | 2 +- .../administration/useful_sql_for_admins.html | 2 +- .../configuration/config_documentation.html | 2 +- .../homeserver_sample_config.html | 2 +- latest/usage/configuration/index.html | 2 +- .../configuration/logging_sample_config.html | 2 +- .../user_authentication/index.html | 2 +- .../user_authentication/refresh_tokens.html | 2 +- .../single_sign_on/cas.html | 2 +- .../single_sign_on/index.html | 2 +- .../single_sign_on/saml.html | 2 +- latest/user_directory.html | 2 +- latest/welcome_and_overview.html | 2 +- latest/workers.html | 5 +- 111 files changed, 532 insertions(+), 144 deletions(-) create mode 100644 latest/development/internal_documentation/release_notes_review_checklist.html diff --git a/latest/404.html b/latest/404.html index 565ba98c1d..09d9b543f8 100644 --- a/latest/404.html +++ b/latest/404.html @@ -78,7 +78,7 @@ diff --git a/latest/CAPTCHA_SETUP.html b/latest/CAPTCHA_SETUP.html index f39543058c..67f13c5cb2 100644 --- a/latest/CAPTCHA_SETUP.html +++ b/latest/CAPTCHA_SETUP.html @@ -77,7 +77,7 @@ diff --git a/latest/admin_api/account_validity.html b/latest/admin_api/account_validity.html index 55c21cfb15..29196b5a2e 100644 --- a/latest/admin_api/account_validity.html +++ b/latest/admin_api/account_validity.html @@ -77,7 +77,7 @@ diff --git a/latest/admin_api/client_server_api_extensions.html b/latest/admin_api/client_server_api_extensions.html index 56cef8a42b..a570d6f711 100644 --- a/latest/admin_api/client_server_api_extensions.html +++ b/latest/admin_api/client_server_api_extensions.html @@ -77,7 +77,7 @@ diff --git a/latest/admin_api/event_reports.html b/latest/admin_api/event_reports.html index b7eaf28127..4583d61997 100644 --- a/latest/admin_api/event_reports.html +++ b/latest/admin_api/event_reports.html @@ -77,7 +77,7 @@ diff --git a/latest/admin_api/experimental_features.html b/latest/admin_api/experimental_features.html index 5f40dd8f96..28e75e8367 100644 --- a/latest/admin_api/experimental_features.html +++ b/latest/admin_api/experimental_features.html @@ -77,7 +77,7 @@ diff --git a/latest/admin_api/fetch_event.html b/latest/admin_api/fetch_event.html index 14686ca427..300d85a692 100644 --- a/latest/admin_api/fetch_event.html +++ b/latest/admin_api/fetch_event.html @@ -77,7 +77,7 @@ diff --git a/latest/admin_api/media_admin_api.html b/latest/admin_api/media_admin_api.html index dd2844a097..cf2ce6fd0c 100644 --- a/latest/admin_api/media_admin_api.html +++ b/latest/admin_api/media_admin_api.html @@ -77,7 +77,7 @@ diff --git a/latest/admin_api/purge_history_api.html b/latest/admin_api/purge_history_api.html index 7630f695b2..c2e746bd69 100644 --- a/latest/admin_api/purge_history_api.html +++ b/latest/admin_api/purge_history_api.html @@ -77,7 +77,7 @@ diff --git a/latest/admin_api/register_api.html b/latest/admin_api/register_api.html index 69f2f792ce..e97dbb5f22 100644 --- a/latest/admin_api/register_api.html +++ b/latest/admin_api/register_api.html @@ -77,7 +77,7 @@ diff --git a/latest/admin_api/room_membership.html b/latest/admin_api/room_membership.html index 261e9556b7..6cb9e202f0 100644 --- a/latest/admin_api/room_membership.html +++ b/latest/admin_api/room_membership.html @@ -77,7 +77,7 @@ diff --git a/latest/admin_api/rooms.html b/latest/admin_api/rooms.html index d66157d3c7..fbdf72b16d 100644 --- a/latest/admin_api/rooms.html +++ b/latest/admin_api/rooms.html @@ -77,7 +77,7 @@ @@ -1131,6 +1131,69 @@ that were deleted.

} ] } + +

Admin Space Hierarchy Endpoint

+

This API allows an admin to fetch the space/room hierarchy for a given space, +returning details about that room and any children the room may have, paginating +over the space tree in a depth-first manner to locate child rooms. This is +functionally similar to the CS Hierarchy endpoint but does not check for +room membership when returning room summaries.

+

The endpoint does not query other servers over federation about remote rooms +that the server has not joined. This is a deliberate trade-off: while this +means it will leave some holes in the hierarchy that we could otherwise +sometimes fill in, it significantly improves the endpoint's response time and +the admin endpoint is designed for managing rooms local to the homeserver +anyway.

+

Parameters

+

The following query parameters are available:

+ +

Request:

+
GET /_synapse/admin/v1/rooms/<room_id>/hierarchy
+
+

Response:

+
{
+  "rooms":
+      [
+        { "children_state": [
+            {
+              "content": {
+                "via": ["local_test_server"]
+              },
+              "origin_server_ts": 1500,
+              "sender": "@user:test",
+              "state_key": "!QrMkkqBSwYRIFNFCso:test",
+              "type": "m.space.child"
+            }
+        ],
+        "name": "space room",
+        "guest_can_join": false,
+        "join_rule": "public",
+        "num_joined_members": 1,
+        "room_id": "!sPOpNyMHbZAoAOsOFL:test",
+        "room_type": "m.space",
+        "world_readable": false
+      },
+
+      {
+        "children_state": [],
+        "guest_can_join": true,
+        "join_rule": "invite",
+        "name": "nefarious",
+        "num_joined_members": 1,
+        "room_id": "!QrMkkqBSwYRIFNFCso:test",
+        "topic": "being bad",
+        "world_readable": false}
+    ],
+  "next_batch": "KUYmRbeSpAoaAIgOKGgyaCEn"
+}
diff --git a/latest/admin_api/scheduled_tasks.html b/latest/admin_api/scheduled_tasks.html index 872ec5c44a..732bdd5fa1 100644 --- a/latest/admin_api/scheduled_tasks.html +++ b/latest/admin_api/scheduled_tasks.html @@ -77,7 +77,7 @@ diff --git a/latest/admin_api/server_notices.html b/latest/admin_api/server_notices.html index 9b03ce16f2..ac2bddadd5 100644 --- a/latest/admin_api/server_notices.html +++ b/latest/admin_api/server_notices.html @@ -77,7 +77,7 @@ diff --git a/latest/admin_api/statistics.html b/latest/admin_api/statistics.html index 3e8e739448..379f5f2dac 100644 --- a/latest/admin_api/statistics.html +++ b/latest/admin_api/statistics.html @@ -77,7 +77,7 @@ diff --git a/latest/admin_api/user_admin_api.html b/latest/admin_api/user_admin_api.html index b61b736fd1..d47ead01f6 100644 --- a/latest/admin_api/user_admin_api.html +++ b/latest/admin_api/user_admin_api.html @@ -77,7 +77,7 @@ diff --git a/latest/admin_api/version_api.html b/latest/admin_api/version_api.html index 88986d786e..0759d53811 100644 --- a/latest/admin_api/version_api.html +++ b/latest/admin_api/version_api.html @@ -77,7 +77,7 @@ diff --git a/latest/application_services.html b/latest/application_services.html index b11aa638cb..56295e02df 100644 --- a/latest/application_services.html +++ b/latest/application_services.html @@ -77,7 +77,7 @@ diff --git a/latest/auth_chain_difference_algorithm.html b/latest/auth_chain_difference_algorithm.html index 7946b839fb..0a3db9c1f4 100644 --- a/latest/auth_chain_difference_algorithm.html +++ b/latest/auth_chain_difference_algorithm.html @@ -77,7 +77,7 @@ diff --git a/latest/code_style.html b/latest/code_style.html index ffc750fc80..d108fa4b1f 100644 --- a/latest/code_style.html +++ b/latest/code_style.html @@ -77,7 +77,7 @@ diff --git a/latest/consent_tracking.html b/latest/consent_tracking.html index 73b07a3995..4136a4b644 100644 --- a/latest/consent_tracking.html +++ b/latest/consent_tracking.html @@ -77,7 +77,7 @@ diff --git a/latest/delegate.html b/latest/delegate.html index 205a74b867..5115c74b24 100644 --- a/latest/delegate.html +++ b/latest/delegate.html @@ -77,7 +77,7 @@ diff --git a/latest/deprecation_policy.html b/latest/deprecation_policy.html index a6d97782a7..d570e8a0dd 100644 --- a/latest/deprecation_policy.html +++ b/latest/deprecation_policy.html @@ -77,7 +77,7 @@ @@ -176,7 +176,7 @@ the minimum required version may be bumped up to a recent Rust version, and so people building from source should ensure they can fetch recent versions of Rust (e.g. by using rustup).

The oldest supported version of SQLite is the version -provided by +provided by Debian oldstable.

Context

It is important for system admins to have a clear understanding of the platform @@ -231,7 +231,7 @@ package Rust libraries, but this appears to be the outlier rather than the norm.