diff --git a/releasenotes/notes/metadata-api-e95d4559e7bf9ca9.yaml b/releasenotes/notes/metadata-api-e95d4559e7bf9ca9.yaml
new file mode 100644
index 000000000..090b05c2d
--- /dev/null
+++ b/releasenotes/notes/metadata-api-e95d4559e7bf9ca9.yaml
@@ -0,0 +1,8 @@
+---
+prelude: >
+    The Mitaka release includes a new API to add arbitrary user-defined
+    metadata to Secrets.
+upgrade:
+  - The Metadata API requires an update to the Database Schema. Existing
+    deployments that are being upgraded to Mitaka should use the
+    'barbican-manage' utility to update the schema.