diff --git a/data/api/client-server/capabilities.yaml b/data/api/client-server/capabilities.yaml
index 4a9209ac..90075382 100644
--- a/data/api/client-server/capabilities.yaml
+++ b/data/api/client-server/capabilities.yaml
@@ -114,8 +114,11 @@ paths:
                               - "org.example/job_title"
                           disallowed:
                             type: array
-                            description: List of disallowed additional custom profile field keys. A `*` can be used as
-                              a wildcard to match any sequence of characters. Ignored if an allowed list is provided.
+                            description: If `enabled` is `true`, a list of profile fields that clients are _not_ allowed to
+                              create, modify or delete. Clients SHOULD assume all fields not in this list to be unmanaged
+                              and available for their use.
+                              
+                              Only one of `allowed` and `disallowed` is permitted at the same time.
                             items:
                               type: string
                             example: