diff --git a/Docs/api/flags.org b/Docs/api/flags.org
new file mode 100644
index 0000000..4262aec
--- /dev/null
+++ b/Docs/api/flags.org
@@ -0,0 +1,4 @@
+* /api/flags
+returns a plaintext list of all the resolved flags, seperated by
+newline characters (\n). This is maintained by the database service
+and updated whenever changes are committed to the flag console.