From 6c4ce1e0417ccdbc129b396de23308d69768d8d5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Rodrigo=20L=C3=B3pez=20Dato?=
 <rodrigo.lopezdato@flagsmith.com>
Date: Wed, 19 Jun 2024 15:01:40 -0300
Subject: [PATCH] docs: Fix bulk-identities API example

---
 docs/docs/clients/rest.md | 50 ++++++++++++++++++++++++++-------------
 1 file changed, 34 insertions(+), 16 deletions(-)

diff --git a/docs/docs/clients/rest.md b/docs/docs/clients/rest.md
index 4029f8723895..e1942219030c 100644
--- a/docs/docs/clients/rest.md
+++ b/docs/docs/clients/rest.md
@@ -378,23 +378,41 @@ assert delete_identity_response.status_code == 204
 
 ### Bulk Uploading Identities and Traits
 
-You can achieve this with a `POST` to the `identities` endpoint:
+You can achieve this with a `POST` to the `bulk-identities` endpoint:
 
 ```bash
-curl -X "POST" "https://edge.api.flagsmith.com/api/v1/identities/?identifier=<identity_id>" \
-     -H 'X-Environment-Key: <Your Environment Key>' \
-     -H 'Content-Type: application/json; charset=utf-8' \
+curl -i -X POST "https://edge.api.flagsmith.com/api/v1/bulk-identities" \
+     -H "X-Environment-Key: ${FLAGSMITH_ENVIRONMENT_KEY}" \
+     -H 'Content-Type: application/json' \
      -d $'{
-  "traits":   "traits": [
-    {
-      "trait_key": "this_key",
-      "trait_value": "this_value"
-    },
-    {
-      "trait_key": "this_key2",
-      "trait_value": "this_value2"
-    }
-  ],
-  "identifier": "<identity_id>"
-}'
+      "data": [
+        {
+          "identifier": "my_identifier_1",
+          "traits": [
+            {
+              "trait_key": "my_key_name",
+              "trait_value": "set from POST /bulk-identities"
+            }
+          ]
+        },
+        {
+            "identifier": "my_identifier_2",
+            "traits": [
+                {
+                    "trait_key": "some_other_key_name",
+                    "trait_value": "if this identity does not exist, it will be created by this request"
+                }
+            ]
+        },
+        {
+            "identifier": "my_identifier_3",
+            "traits": [
+                {
+                    "trait_key": "this_trait_will_be_deleted",
+                    "trait_value": null
+                }
+            ]
+        }
+      ]
+    }'
 ```