From 077c5100893605d1e78ef01bbf125ebc482c1db6 Mon Sep 17 00:00:00 2001 From: mzl2233 Date: Thu, 14 May 2026 15:54:23 +0000 Subject: [PATCH 1/2] Clarify autocomplete share type values --- developer_manual/client_apis/OCS/ocs-api-overview.rst | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/developer_manual/client_apis/OCS/ocs-api-overview.rst b/developer_manual/client_apis/OCS/ocs-api-overview.rst index dcdbe148761..5c3fcfe34e4 100644 --- a/developer_manual/client_apis/OCS/ocs-api-overview.rst +++ b/developer_manual/client_apis/OCS/ocs-api-overview.rst @@ -253,7 +253,10 @@ It can be an option for filtering on a later stage but you can also leave them o curl -i -u master -X GET -H "OCS-APIRequest: true" 'https://my.nextcloud/ocs/v2.php/core/autocomplete/get?search=JOANNE%40EMAIL.ISP&shareTypes[]=8&limit=2' -The shareType defaults to regular users if you left it out), the limit defaults to 10. +The ``shareTypes`` filter uses the sharing API type values: ``0`` for users, ``1`` for groups, +``4`` for email, ``6`` for federated cloud shares, ``7`` for circles, ``8`` for guest accounts, +and ``10`` for Talk conversations. If ``shareTypes`` is left out it defaults to regular users; +the limit defaults to 10. Filtering the auto-complete results ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ From 7916b5670510fd81d4df9b56b2b2fda71fdea567 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?John=20Molakvo=C3=A6=20=28skjnldsv=29?= Date: Wed, 20 May 2026 09:32:23 +0200 Subject: [PATCH 2/2] docs: convert shareTypes list to table in autocomplete API docs MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: John Molakvoæ (skjnldsv) --- .../client_apis/OCS/ocs-api-overview.rst | 26 ++++++++++++++++--- 1 file changed, 22 insertions(+), 4 deletions(-) diff --git a/developer_manual/client_apis/OCS/ocs-api-overview.rst b/developer_manual/client_apis/OCS/ocs-api-overview.rst index 5c3fcfe34e4..6eb2697fc10 100644 --- a/developer_manual/client_apis/OCS/ocs-api-overview.rst +++ b/developer_manual/client_apis/OCS/ocs-api-overview.rst @@ -253,10 +253,28 @@ It can be an option for filtering on a later stage but you can also leave them o curl -i -u master -X GET -H "OCS-APIRequest: true" 'https://my.nextcloud/ocs/v2.php/core/autocomplete/get?search=JOANNE%40EMAIL.ISP&shareTypes[]=8&limit=2' -The ``shareTypes`` filter uses the sharing API type values: ``0`` for users, ``1`` for groups, -``4`` for email, ``6`` for federated cloud shares, ``7`` for circles, ``8`` for guest accounts, -and ``10`` for Talk conversations. If ``shareTypes`` is left out it defaults to regular users; -the limit defaults to 10. +The ``shareTypes`` parameter filters results by share type. If omitted, it defaults to regular +users (``0``). The limit defaults to ``10``. + +.. list-table:: + :header-rows: 1 + + * - Value + - Share type + * - ``0`` + - Users (default) + * - ``1`` + - Groups + * - ``4`` + - Email + * - ``6`` + - Federated cloud shares + * - ``7`` + - Circles + * - ``8`` + - Guest accounts + * - ``10`` + - Talk conversations Filtering the auto-complete results ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^