Swagger api documentaion

[elie-irani]

I need help with a few scenarios. I couldn't find any help.

PHP laravel
Scenario 1:

Route::post('/account/devices/disconnect-device, 'UsersController@disconnectDevices')->middleware(['auth:api']);

Do I do anything with the middleware? is there a tag to add to the annotation to show the middleware?

Scenario 2:
`/**
* Disconnect wallet
*
* @param Request $request
* @return JsonResponse
* @throws Exception
*/
public function disconnectDevices(Request $request): JsonResponse
{
.........
........

    return response()->json([
        'success' => true,
        'data' => $user,
    ]);
}`

$request is a parameter, How do I represent it in an annotation?

Scenario 3:
In the example above, what are all the possible responses? how do I find them?
404 of course and 200? because in the function, the response is not specified.

/** * ********************** * Disconnect Wallet * ********************** * * @OA\Post( * path="/user/profile/disconnect-device", * summary="Disconnects device", * @OA\Parameter( * description="Parameter with mutliple examples", * in="path", * name="id", * required=true, * @OA\Schema(type="string"), * @OA\Examples(example="int", value="1", summary="An int value."), * @OA\Examples(example="uuid", value="0006faf6-7a61-426c-9034-579f2cfcfa83", summary="An UUID value."), * ), * @OA\Response( * response=200, * description="Device disconnected", * @OA\JsonContent() * ), * @OA\Response( * response=404, * description="Not Found" * ) * ) */

is this a good one? Except for the parameter, i don't know what to put