From 4deb24437578e91100308ab5373727fe1414deee Mon Sep 17 00:00:00 2001
From: Arne Luenser <arne.luenser@ory.sh>
Date: Wed, 6 Aug 2025 14:32:51 +0200
Subject: [PATCH 1/2] feat: add getCollectionsParameters

---
 openapi.yml | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/openapi.yml b/openapi.yml
index fcfcd0c..ea7c7b2 100644
--- a/openapi.yml
+++ b/openapi.yml
@@ -99,6 +99,23 @@ paths:
         returned sorted by creation date, with the most recent collections appearing
         first.
       operationId: getCollections
+      parameters:
+        - name: getCollectionsParameters
+          in: query
+          schema:
+            type: object
+            properties:
+              exclude_fields:
+                description: Comma-separated list of fields from the collection to exclude from the response
+                type: string
+              limit:
+                description: >
+                  Number of collections to fetch.
+                  Default: returns all collections.
+                type: integer
+              offset:
+                description: Identifies the starting point to return collections when paginating.
+                type: integer
       responses:
         '200':
           description: List of all collections

From 239e4cb3b71c3714067e3c289a24f1727e81449b Mon Sep 17 00:00:00 2001
From: Arne Luenser <arne.luenser@ory.sh>
Date: Wed, 6 Aug 2025 16:07:19 +0200
Subject: [PATCH 2/2] feat: add metadata to CollectionSchema and
 CollectionUpdateSchema

---
 openapi.yml | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/openapi.yml b/openapi.yml
index ea7c7b2..a6a03be 100644
--- a/openapi.yml
+++ b/openapi.yml
@@ -2099,6 +2099,10 @@ components:
           default: []
         voice_query_model:
           $ref: "#/components/schemas/VoiceQueryModelCollectionConfig"
+        metadata:
+          type: object
+          description: >
+            Optional details about the collection, e.g., when it was created, who created it etc.
     CollectionUpdateSchema:
       required:
         - fields
@@ -2119,6 +2123,10 @@ components:
               facet: true
           items:
             $ref: "#/components/schemas/Field"
+        metadata:
+          type: object
+          description: >
+            Optional details about the collection, e.g., when it was created, who created it etc.
     CollectionResponse:
       allOf:
         - $ref: "#/components/schemas/CollectionSchema"