feat(api): add tag filtering on the applications list endpoint (#7360)

app/Http/Controllers/Api/ApplicationsController.php

@@ -64,6 +64,17 @@ class ApplicationsController extends Controller
             ['bearerAuth' => []],
         ],
         tags: ['Applications'],
+        parameters: [
+            new OA\Parameter(
+                name: 'tag',
+                in: 'query',
+                description: 'Filter applications by tag name.',
+                required: false,
+                schema: new OA\Schema(
+                    type: 'string',
+                )
+            ),
+        ],
         responses: [
             new OA\Response(
                 response: 200,
@@ -94,13 +105,19 @@ class ApplicationsController extends Controller
         if (is_null($teamId)) {
             return invalidTokenResponse();
         }
-        $projects = Project::where('team_id', $teamId)->get();
+
-        $applications = collect();
+        $tagName = $request->query('tag');
-        $applications->push($projects->pluck('applications')->flatten());
+
-        $applications = $applications->flatten();
+        $applications = Application::ownedByCurrentTeamAPI($teamId)
-        $applications = $applications->map(function ($application) {
+            ->when($tagName, function ($query, $tagName) {
-            return $this->removeSensitiveData($application);
+                $query->whereHas('tags', function ($query) use ($tagName) {
-        });
+                    $query->where('name', $tagName);
+                });
+            })
+            ->get()
+            ->map(function ($application) {
+                return $this->removeSensitiveData($application);
+            });
 
         return response()->json($applications);
     }

openapi.json

@@ -19,6 +19,17 @@
                 "summary": "List",
                 "description": "List all applications.",
                 "operationId": "list-applications",
+                "parameters": [
+                    {
+                        "name": "tag",
+                        "in": "query",
+                        "description": "Filter applications by tag name.",
+                        "required": false,
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                ],
                 "responses": {
                     "200": {
                         "description": "Get all applications.",

openapi.yaml

@@ -14,6 +14,14 @@ paths:
       summary: List
       description: 'List all applications.'
       operationId: list-applications
+      parameters:
+        -
+          name: tag
+          in: query
+          description: 'Filter applications by tag name.'
+          required: false
+          schema:
+            type: string
       responses:
         '200':
           description: 'Get all applications.'