diff --git a/doc/sphinx-guides/source/api/native-api.rst b/doc/sphinx-guides/source/api/native-api.rst
index 42f70c1bd8d..d2a2c1a795b 100644
--- a/doc/sphinx-guides/source/api/native-api.rst
+++ b/doc/sphinx-guides/source/api/native-api.rst
@@ -72,6 +72,15 @@ List Facets Configured for a Dataverse
 
   GET http://$SERVER/api/dataverses/$id/facets?key=$apiKey
 
+Set Facets for a Dataverse
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Assign search facets for a given dataverse with alias ``$alias``
+
+``curl -H "X-Dataverse-key: $apiKey" -X POST http://$server/api/dataverses/$alias/facets --upload-file facets.json``
+
+Where ``facets.json`` contains a JSON encoded list of metadata keys (e.g. ``["authorName","authorAffiliation"]``).
+
 Create a New Role in a Dataverse
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~