feat(API): add name filter query parameter to spaces list #STRINGS-3036

doc/compiled.json

@@ -26657,6 +26657,16 @@
           },
           {
             "$ref": "#/components/parameters/per_page"
+          },
+          {
+            "name": "q",
+            "in": "query",
+            "description": "Filter results by name. Supports the prefix-match syntax `name:<value>`, which returns only spaces whose names begin with `<value>`. Other query formats are ignored; omitting `q` returns all accessible spaces.\n",
+            "required": false,
+            "schema": {
+              "type": "string",
+              "example": "name:Engineering"
+            }
           }
         ],
         "responses": {
@@ -26693,6 +26703,12 @@
           "400": {
             "$ref": "#/components/responses/400"
           },
+          "401": {
+            "$ref": "#/components/responses/401"
+          },
+          "403": {
+            "$ref": "#/components/responses/403"
+          },
           "404": {
             "$ref": "#/components/responses/404"
           },

paths/spaces/index.yaml

@@ -9,6 +9,16 @@ parameters:
 - "$ref": "../../parameters.yaml#/account_id"
 - "$ref": "../../parameters.yaml#/page"
 - "$ref": "../../parameters.yaml#/per_page"
+- name: q
+  in: query
+  description: >
+    Filter results by name. Supports the prefix-match syntax `name:<value>`,
+    which returns only spaces whose names begin with `<value>`.
+    Other query formats are ignored; omitting `q` returns all accessible spaces.
+  required: false
+  schema:
+    type: string
+    example: "name:Engineering"
 responses:
   '200':
     description: OK
@@ -31,6 +41,10 @@ responses:
         "$ref": "../../headers.yaml#/Pagination"
   '400':
     "$ref": "../../responses.yaml#/400"
+  '401':
+    "$ref": "../../responses.yaml#/401"
+  '403':
+    "$ref": "../../responses.yaml#/403"
   '404':
     "$ref": "../../responses.yaml#/404"
   '429':