diff --git a/data/api/client-server/profile.yaml b/data/api/client-server/profile.yaml
index a9dda534..b5ecc690 100644
--- a/data/api/client-server/profile.yaml
+++ b/data/api/client-server/profile.yaml
@@ -293,7 +293,7 @@ paths:
                   avatar_url:
                     type: string
                     format: mx-mxc-uri
-                    description: "Avatar URL value (MXC URI format)."
+                    description: The user's avatar URL if they have set one, otherwise not present.
                   displayname:
                     type: string
                     description: The user's display name if they have set one, otherwise not