diff --git a/api-ref/source/samples/share-replica-promote-request.json b/api-ref/source/samples/share-replica-promote-request.json
new file mode 100644
index 0000000000..537dd96170
--- /dev/null
+++ b/api-ref/source/samples/share-replica-promote-request.json
@@ -0,0 +1,3 @@
+{
+    "promote": null
+}
diff --git a/api-ref/source/samples/share-replica-resync-request.json b/api-ref/source/samples/share-replica-resync-request.json
new file mode 100644
index 0000000000..4f01a1f8cb
--- /dev/null
+++ b/api-ref/source/samples/share-replica-resync-request.json
@@ -0,0 +1,3 @@
+{
+    "resync": null
+}
diff --git a/api-ref/source/share-replicas.inc b/api-ref/source/share-replicas.inc
index 54b693c318..6737fe2e02 100644
--- a/api-ref/source/share-replicas.inc
+++ b/api-ref/source/share-replicas.inc
@@ -155,6 +155,12 @@ Request
    - project_id: project_id_path
    - share_replica_id: share_replica_id_path
 
+Request example
+---------------
+
+.. literalinclude:: samples/share-replica-promote-request.json
+   :language: javascript
+
 
 Resync share replica
 ====================
@@ -188,6 +194,13 @@ Request
    - share_replica_id: share_replica_id_path
 
 
+Request example
+---------------
+
+.. literalinclude:: samples/share-replica-resync-request.json
+   :language: javascript
+
+
 List share replicas
 ===================