docs: add note on permissions to certain mutations (close #5058) (#5135)

docs/graphql/manual/mutations/delete.rst

@@ -105,6 +105,10 @@ row object or ``null`` if the row does not exist.
       }
     }
 
+.. note:: 
+
+   ``delete_<table>_by_pk`` will **only** be available if you have select permissions on the table, as it returns the deleted row.
+
 .. admonition:: Supported from
 
    The ``delete_<table>_by_pk`` mutation is supported in versions ``v1.2.0``
@@ -183,4 +187,4 @@ evaluates to ``true`` for all objects.
           "affected_rows": 20
         }
       }
-    }
+    }

docs/graphql/manual/mutations/insert.rst

@@ -110,6 +110,10 @@ Using variables:
       }
     }
 
+.. note:: 
+
+   ``insert_<object>_one`` will **only** be available if you have select permissions on the table, as it returns the inserted row.
+
 .. admonition:: Supported from
 
    The ``insert_<object>_one`` mutation is supported in versions ``v1.2.0``

docs/graphql/manual/mutations/update.rst

@@ -110,6 +110,10 @@ row object or ``null`` if the row does not exist.
       }
     }
 
+.. note:: 
+
+   ``update_<table>_by_pk`` will **only** be available if you have select permissions on the table, as it returns the updated row.
+
 .. admonition:: Supported from
 
    The ``update_<table>_by_pk`` mutation is supported in versions ``v1.2.0``