summary refs log tree commit diff
path: root/docs/admin_api/version_api.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/admin_api/version_api.md')
-rw-r--r--docs/admin_api/version_api.md21
1 files changed, 21 insertions, 0 deletions
diff --git a/docs/admin_api/version_api.md b/docs/admin_api/version_api.md
new file mode 100644
index 0000000000..efb4a0c0f7
--- /dev/null
+++ b/docs/admin_api/version_api.md
@@ -0,0 +1,21 @@
+# Version API
+
+This API returns the running Synapse version and the Python version
+on which Synapse is being run. This is useful when a Synapse instance
+is behind a proxy that does not forward the 'Server' header (which also
+contains Synapse version information).
+
+The api is:
+
+```
+GET /_synapse/admin/v1/server_version
+```
+
+It returns a JSON body like the following:
+
+```json
+{
+    "server_version": "0.99.2rc1 (b=develop, abcdef123)",
+    "python_version": "3.6.8"
+}
+```