From f588bb6daf791bfc307c8f73f03c112a6294cfbb Mon Sep 17 00:00:00 2001 From: Laurence Isla Date: Thu, 13 Apr 2023 18:38:07 -0500 Subject: [PATCH] Fix info on updates without filters --- docs/api.rst | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/api.rst b/docs/api.rst index dbd38c6f2..caaefa5c9 100644 --- a/docs/api.rst +++ b/docs/api.rst @@ -1866,10 +1866,12 @@ To update a row or rows in a table, use the PATCH verb. Use :ref:`h_filter` to s -X PATCH -H "Content-Type: application/json" \ -d '{ "category": "child" }' -Doing a full table update without filters is not allowed and will result in 0 updated rows. To make a an update without filters, you must limit the rows affected. See :ref:`limited_update_delete`. - Updates also support :code:`Prefer: return=representation` plus :ref:`v_filter`. +.. warning:: + + Beware of accidentally updating every row in a table. To learn to prevent that see :ref:`block_fulltable`. + .. _upsert: Upsert