Prod build

app/Http/Controllers/Api/V1/ApiMyTeamController.php

@@ -13,7 +13,13 @@
 use App\Models\Team;
 use Illuminate\Http\JsonResponse;
 use Illuminate\Support\Facades\Auth;
+use Knuckles\Scribe\Attributes\Authenticated;
+use Knuckles\Scribe\Attributes\Endpoint;
+use Knuckles\Scribe\Attributes\Group;
+use Knuckles\Scribe\Attributes\QueryParam;
+use Knuckles\Scribe\Attributes\Response;
 
+#[Group('/my-team', 'Retrieve your team details.')]
 class ApiMyTeamController extends Controller
 {
     use HandlesAPIRequests;
@@ -34,6 +40,31 @@ class ApiMyTeamController extends Controller
      *
      * @throws DisallowedApiFieldException
      */
+    #[Endpoint(
+        title        : 'GET /',
+        description  : 'Retrieve your team. Automatically filtered to your current team.',
+        authenticated: true
+    )]
+    #[Authenticated]
+    #[QueryParam(
+        name       : 'cached',
+        type       : 'bool',
+        description: 'Request the response to be cached. Default: `true`.',
+        required   : false,
+        example    : true
+    )]
+    #[QueryParam(
+        name       : 'fields',
+        type       : 'string',
+        description: 'Comma-separated list of database fields to return within the object.',
+        required   : false,
+        example    : 'id,created_at'
+    )]
+    #[Response(
+        content    : '{"meta": {"responseCode": 200, "limit": 50, "offset": 0, "message": "", "cached": false, "availableRelations": []}, "data": {"current_page": 1, "data": {"id": 1, "name": "Team A", "created_at": "2024-08-16T06:54:28.000000Z", "updated_at": "2024-08-16T06:54:28.000000Z", "deleted_at": null}], "first_page_url": "https:\/\/vine.test\/api\/v1\/my-teams?page=1", "from": 1, "last_page": 1, "last_page_url": "https:\/\/vine.test\/api\/v1\/my-teams?page=1", "links": [{"url": null, "label": "« Previous", "active": false}, {"url": "https:\/\/vine.test\/api\/v1\/my-teams?page=1", "label": "1", "active": true}, {"url": null, "label": "Next »", "active": false}], "next_page_url": null, "path": "https:\/\/vine.test\/api\/v1\/my-teams", "per_page": 50, "prev_page_url": null, "to": 2, "total": 2}}',
+        status     : 200,
+        description: ''
+    )]
     public function index(): JsonResponse
     {
         $this->query = Team::with($this->associatedData);
@@ -45,7 +76,7 @@ public function index(): JsonResponse
 
     /**
      * POST /
-     *
+     * @hideFromAPIDocumentation
      * @return JsonResponse
      */
     public function store(): JsonResponse
@@ -58,9 +89,8 @@ public function store(): JsonResponse
 
     /**
      * GET / {id}
-     *
+     * @hideFromAPIDocumentation
      * @param string $id
-     *
      * @return JsonResponse
      */
     public function show(string $id)
@@ -73,9 +103,8 @@ public function show(string $id)
 
     /**
      * PUT / {id}
-     *
+     * @hideFromAPIDocumentation
      * @param string $id
-     *
      * @return JsonResponse
      */
     public function update(string $id)
@@ -88,9 +117,8 @@ public function update(string $id)
 
     /**
      * DELETE / {id}
-     *
+     * @hideFromAPIDocumentation
      * @param string $id
-     *
      * @return JsonResponse
      */
     public function destroy(string $id)