diff --git a/spec/supabase_js_v1_legacy.yml b/spec/supabase_js_v1_legacy.yml
index c5358848c23..8f106cac142 100644
--- a/spec/supabase_js_v1_legacy.yml
+++ b/spec/supabase_js_v1_legacy.yml
@@ -961,6 +961,7 @@ pages:
     notes: |
       - Primary keys should be included in the data payload in order for an update to work correctly.
       - Primary keys  must be natural, not surrogate. There are however, [workarounds](https://github.com/PostgREST/postgrest/issues/1118) for surrogate primary keys.
+      - It is currently not possible to insert new data and update existing data at the same time. However, a [workaround](https://github.com/supabase/postgrest-js/issues/173#issuecomment-825124550) can be employed using Postgres functions/triggers.
     examples:
       - name: Upsert your data
         isSpotlight: true