diff --git a/docs/api.md b/docs/api.md
index d02a5117c..536418844 100644
--- a/docs/api.md
+++ b/docs/api.md
@@ -577,7 +577,7 @@ Initial API version.
 #### Version 7
 
 -   The format of select type custom fields has changed to return the options
-    as an array of objects with `id` and `label` fields. When creating or
-    updating a custom field value of a document for a select type custom field,
-    the value should be the `id` of the option whereas previously was the index
-    of the option.
+    as an array of objects with `id` and `label` fields as opposed to a simple
+    list of strings. When creating or updating a custom field value of a
+    document for a select type custom field, the value should be the `id` of
+    the option whereas previously was the index of the option.