diff --git a/src/api/index.md b/src/api/index.md
index 1b02bc416e..a8dabfe2e2 100644
--- a/src/api/index.md
+++ b/src/api/index.md
@@ -2161,3 +2161,37 @@ type: api
   })
   </script>
   {% endraw %}
+
+## Array Extension Methods
+
+### array.$set(index, value)
+
+- **Arguments**
+  - `{Number} index`
+  - `{*} value`
+
+- **Usage**
+  
+  Set an element in the array to a value by index and trigger view updates.
+
+  ``` js
+    vm.animals.$set(0, { name: 'Aardvark' })
+  ```
+
+- **See also:** [Mutation Methods](/guide/list.html#Mutation-Methods)
+
+### array.$remove(reference)
+
+- **Arguments**
+  - `{Reference} reference`
+
+- **Usage**
+  
+  Remove an element from an array by reference and trigger view updates.
+
+  ``` js
+    var aardvark = vm.animals[0]
+    vm.animals.$remove(aardvark)
+  ```
+
+- **See also:** [Mutation Methods](/guide/list.html#Mutation-Methods)
\ No newline at end of file