diff --git a/examples/gameserverallocation.yaml b/examples/gameserverallocation.yaml
index 61594591b9..36cb4a58de 100644
--- a/examples/gameserverallocation.yaml
+++ b/examples/gameserverallocation.yaml
@@ -116,3 +116,6 @@ spec:
         - x7un
         - 8inz
       capacity: 40  # Updates the maximum capacity of the Counter to this number. Min 0, Max 1000.
+      deleteValues:  # removes values from a List's Valules array. Any nonexistant values are ignored.
+        - alice
+        - bob
diff --git a/site/content/en/docs/Guides/access-api.md b/site/content/en/docs/Guides/access-api.md
index 1c3843ec02..272cf865ca 100644
--- a/site/content/en/docs/Guides/access-api.md
+++ b/site/content/en/docs/Guides/access-api.md
@@ -10,7 +10,7 @@ description: >
 ---
 
 Installing Agones creates several [Custom Resource Definitions (CRD)](https://kubernetes.io/docs/concepts/api-extension/custom-resources),
-which can be accessed and manipulated through the Kubernetes API. 
+which can be accessed and manipulated through the Kubernetes API.
 
 The detailed list of Agones CRDs with their parameters could be found here - [Agones CRD API Reference](../../reference/agones_crd_api_reference/).
 
@@ -402,7 +402,19 @@ curl http://localhost:8001/apis/agones.dev/v1/namespaces/default/gameservers
 
 ### Allocate a gameserver from a fleet named 'simple-game-server', with GameServerAllocation
 ```bash
-curl -d '{"apiVersion":"allocation.agones.dev/v1","kind":"GameServerAllocation","spec":{"required":{"matchLabels":{"agones.dev/fleet":"simple-game-server"}}}}' -H "Content-Type: application/json" -X POST http://localhost:8001/apis/allocation.agones.dev/v1/namespaces/default/gameserverallocations
+curl -d '{
+  "apiVersion": "allocation.agones.dev/v1",
+  "kind": "GameServerAllocation",
+  "spec": {
+    "selectors": [
+      {
+        "matchLabels": {
+          "agones.dev/fleet": "simple-game-server"
+        }
+      }
+    ]
+  }
+}' -H "Content-Type: application/json" -X POST http://localhost:8001/apis/allocation.agones.dev/v1/namespaces/default/gameserverallocations
 ```
 ```
 {
diff --git a/site/content/en/docs/Reference/gameserverallocation.md b/site/content/en/docs/Reference/gameserverallocation.md
index 41c21720ff..a9e9a7a676 100644
--- a/site/content/en/docs/Reference/gameserverallocation.md
+++ b/site/content/en/docs/Reference/gameserverallocation.md
@@ -59,7 +59,7 @@ spec:
           containsValue: "x6k8z" # only match GameServers who has this value in the list. Defaults to "", which is all.
           minAvailable: 1 # minimum available (current capacity - current count). Defaults to 0.
           maxAvailable: 10 # maximum available (current capacity - current count) Defaults to 0, which translates to max(int64)
-      # [Stage:Alpha]      
+      # [Stage:Alpha]
       # [FeatureFlag:PlayerAllocationFilter]
       # Provides a filter on minimum and maximum values for player capacity when retrieving a GameServer
       # through Allocation. Defaults to no limits.
@@ -111,6 +111,9 @@ spec:
         - x7un
         - 8inz
       capacity: 40 # Updates the maximum capacity of the Counter to this number. Min 0, Max 1000.
+      deleteValues: # removes values from a List's Values array. Any nonexistant values are ignored.
+        - alice
+        - bob
   {{< /tab >}}
   {{< tab header="required & preferred (deprecated)" lang="yaml" >}}
 apiVersion: "allocation.agones.dev/v1"
@@ -170,7 +173,7 @@ spec:
     annotations:
       map:  garden22
   {{< /tab >}}
-{{< /tabpane >}}  
+{{< /tabpane >}}
 
 The `spec` field is the actual `GameServerAllocation` specification, and it is composed as follows: