api updates (#50040)

docs/api/cache.md

@@ -44,11 +44,11 @@ Invalidate cache entries.
 
 -  **`include`** All cache configuration overrides should invalidate cache too.
 
--  **`database`** A database id.
+-  **`database`** A list of database ids.
 
--  **`dashboard`** A dashboard id.
+-  **`dashboard`** A list of dashboard ids.
 
--  **`question`** A question id.
+-  **`question`** A list of question ids.
 
 ## `PUT /api/cache/`
 

docs/api/collection.md

@@ -223,10 +223,14 @@ Modify an existing Collection, including archiving or unarchiving it, or moving
 
 ## `PUT /api/collection/graph`
 
-Do a batch update of Collections Permissions by passing in a modified graph.
-  Will overwrite parts of the graph that are present in the request, and leave the rest unchanged.
+Do a batch update of Collections Permissions by passing in a modified graph. Will overwrite parts of the graph that
+  are present in the request, and leave the rest unchanged.
 
-  If the `skip_graph` query parameter is true, it will only return the current revision.
+  If the `force` query parameter is `true`, a `revision` number is not required. The provided graph will be persisted
+  as-is, and has the potential to clobber other writes that happened since the last read.
+
+  If the `skip_graph` query parameter is `true`, it will only return the current revision, not the entire permissions
+  graph.
 
 You must be a superuser to do this.
 
@@ -234,11 +238,13 @@ You must be a superuser to do this.
 
 -  **`namespace`** nullable value must be a non-blank string.
 
--  **`revision`** value must be an integer.
+-  **`revision`** nullable value must be an integer.
 
 -  **`groups`** map.
 
--  **`skip_graph`** nullable value must be a valid boolean string ('true' or 'false').
+-  **`skip-graph`** nullable value must be a valid boolean string ('true' or 'false').
+
+-  **`force`** nullable value must be a valid boolean string ('true' or 'false').
 
 ---
 

docs/api/ee/advanced-permissions-application.md

@@ -24,6 +24,14 @@ Do a batch update of Application Permissions by passing a modified graph.
 
 You must be a superuser to do this.
 
+### PARAMS:
+
+-  **`skip-graph`** nullable value must be a valid boolean string ('true' or 'false').
+
+-  **`force`** nullable value must be a valid boolean string ('true' or 'false').
+
+-  **`body`** map.
+
 ---
 
 [<< Back to API index](../../api-documentation.md)
\ No newline at end of file

docs/api/permissions.md

@@ -118,7 +118,9 @@ You must be a superuser to do this.
 
 ### PARAMS:
 
--  **`skip-graph`** nullable boolean.
+-  **`skip-graph`** nullable value must be a valid boolean string ('true' or 'false').
+
+-  **`force`** nullable value must be a valid boolean string ('true' or 'false').
 
 -  **`body`** map.