AuthController.php

class AuthController extends Controller
{
    /**
     * User Login
     *
     *  @OA\Post(
     *      path="api/auth/login",
     *      tags={"Auth"},
     *      @OA\RequestBody(ref="#/components/requestBodies/LoginRequest"),
     *      @OA\Response(
     *          response=400,
     *          description="Bad request",
     *          @OA\JsonContent(
     *              ref="#/components/schemas/Error",
     *              example={"code": "auth.incorrect", "message": "Incorrect information."},
     *          )
     *      ),
     *      @OA\Response(
     *          response=200,
     *          description="OK",
     *          @OA\JsonContent(
     *              allOf={@OA\Schema(ref="#/components/schemas/Success")},
     *              @OA\Property(
     *                  property="data",
     *                  type="object",
     *                  @OA\Property(property="token", type="string", format="uuid", example="Authorization token", example="71c943d9-944f-4584-a523-2592064ae282"),
     *              )
     *          )
     *      )
     * )
     */
    public function login(LoginRequest $request)
    {
      // ...
    }
}