From bc6e181d03ce39bd5dfcd99b63781cfadba0d129 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Steve=20Ch=C3=A1vez?= <stevechavezast@gmail.com>
Date: Wed, 11 Sep 2019 12:05:51 -0500
Subject: [PATCH] Add params=multiple-objects to api reference (#253)

---
 api.rst | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/api.rst b/api.rst
index 97f3cf8b7..42fa40a7f 100644
--- a/api.rst
+++ b/api.rst
@@ -602,7 +602,7 @@ It's also possible to embed `Materialized Views <https://www.postgresql.org/docs
 
 .. warning::
 
-   Is not guaranteed that all kinds of views will be embeddable. In particular, views that contain
+   It's not guaranteed that all kinds of views will be embeddable. In particular, views that contain
    UNIONs will not be made embeddable.
 
    Why? PostgREST detects source table foreign keys in the view by querying and parsing `pg_rewrite <https://www.postgresql.org/docs/11/catalog-pg-rewrite.html>`_.
@@ -780,12 +780,14 @@ PostgREST will detect if the function is scalar or table-valued and will shape t
 Bulk Call
 ---------
 
-It's possible to call a function in a bulk way, analoguosly to :ref:`bulk_insert`.
+It's possible to call a function in a bulk way, analoguosly to :ref:`bulk_insert`. To do this, you need to add the
+``Prefer: params=multiple-objects`` header to your request.
 
 .. code-block:: http
 
    POST /rpc/add_them HTTP/1.1
    Content-Type: application/json
+   Prefer: params=multiple-objects
 
    [
       {"a": 1, "b": 2},