diff --git a/api-ref/src/docbkx/ch_compute-v2.1.xml b/api-ref/src/docbkx/ch_compute-v2.1.xml
index 2af0e5633..3e8c95ef5 100644
--- a/api-ref/src/docbkx/ch_compute-v2.1.xml
+++ b/api-ref/src/docbkx/ch_compute-v2.1.xml
@@ -382,7 +382,11 @@
   <section xml:id="os-flavor-access-v2.1">
     <title>Flavors access (flavors, os-flavor-access, action)</title>
     <para>
-      Provides flavor access support.
+      Lists tenants who have access to a private flavor and adds private
+      flavor access to and removes private flavor access from tenants. By
+      default, only administrators can manage private flavor access. A private
+      flavor has <code>is_public</code> set to <code>false</code> while a
+      public flavor has <code>is_public</code> set to <code>true</code>.
     </para>
     <wadl:resources xmlns:wadl="http://wadl.dev.java.net/2009/02">
       <wadl:resource href="../wadls/compute-api/src/v2.1/wadl/os-flavor-access-v2.1.wadl#os-flavor-access">